Muonroi.BuildingBlock 1.3.6

.NET 8.0

dotnet add package Muonroi.BuildingBlock --version 1.3.6

NuGet\Install-Package Muonroi.BuildingBlock -Version 1.3.6

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Muonroi.BuildingBlock" Version="1.3.6" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

paket add Muonroi.BuildingBlock --version 1.3.6

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Muonroi.BuildingBlock, 1.3.6"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

// Install Muonroi.BuildingBlock as a Cake Addin
#addin nuget:?package=Muonroi.BuildingBlock&version=1.3.6

// Install Muonroi.BuildingBlock as a Cake Tool
#tool nuget:?package=Muonroi.BuildingBlock&version=1.3.6

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

API Library with Dependency Injection and Serilog Configuration

Introduction

This library provides entities such as User, Role, Permission, and Language, and comes with built-in Dependency Injection features, Bearer Token management, JSON handling utilities, string conversion, and localization for multiple languages.

Usage Guide

1. Configuring `Program.cs`

Here's how to configure your Program.cs file:

using Serilog;
using Autofac;
using Microsoft.AspNetCore.Builder;
using Microsoft.Extensions.Configuration;
using Microsoft.Extensions.DependencyInjection;
using System.Reflection;

Log.Logger = new LoggerConfiguration()
    .WriteTo.Console()
    .CreateBootstrapLogger();

WebApplicationBuilder builder = WebApplication.CreateBuilder(args);

// Add application configurations
_ = builder.AddAppConfigurations();

// Add Autofac configuration
_ = builder.AddAutofacConfiguration();

// Configure Serilog
_ = builder.Host.UseSerilog(MSerilogAction.Configure);

Log.Information("Starting {ApplicationName} API up", builder.Environment.ApplicationName);

try
{
    IConfiguration configuration = builder.Configuration;
    Assembly assembly = Assembly.GetExecutingAssembly();
    IServiceCollection services = builder.Services;

    // Add services to DI container
    _ = services.AddApplication(assembly);
    _ = services.AddInfrastructure(configuration);
    _ = services.AddDbContextConfigure<ApiDbContext>(configuration);
    _ = services.SwaggerConfig(builder.Environment.ApplicationName);
    _ = services.AddScopeServices(typeof(ApiDbContext).Assembly);
    _ = services.AddValidateBearerToken<MTokenInfo>();

    WebApplication app = builder.Build();

    // Add localization and middleware
    _ = app.AddLocalization(assembly);
    _ = app.UseRouting();
    _ = app.UseAuthentication();
    _ = app.UseAuthorization();
    _ = app.ConfigureEndpoints();
    _ = app.MigrateDatabase();
    _ = app.UseMiddleware<MExceptionMiddleware>();

    await app.RunAsync();
}
catch (Exception ex)
{
    string type = ex.GetType().Name;

    if (type.Equals("StopTheHostException", StringComparison.Ordinal))
    {
        throw;
    }

    Log.Fatal(ex, "Unhandled exception: ", ex.Message);
}
finally
{
    Log.Information("Shut down ", builder.Environment.ApplicationName + " complete");
    await Log.CloseAndFlushAsync();
}

2. Example `appsettings.json` Configuration

Here's an example of the appsettings.json configuration that can be used with this library:

{
  "ConnectionStrings": {
    "DefaultConnection": ""
  },
  "ApiKey": "",
  "TokenConfigs": {
    "Issuer": "https://exampledomain.com",
    "Audience": "https://searchpartners.exampledomain.com",
    "SigningKeys": "",
    "ExpiryMinutes": 30,
    "PublicKey": "-----BEGIN PUBLIC KEY-----\n-----END PUBLIC KEY-----",
    "PrivateKey": "-----BEGIN RSA PRIVATE KEY-----

-----END RSA PRIVATE KEY-----"
  },
  "PaginationConfigs": {
    "DefaultPageIndex": 1,
    "DefaultPageSize": 10,
    "MaxPageSize": 10
  },
  "ResourceSetting": {
    "ResourceName": "Resources.ErrorMessages",
    "lang": "vi-VN"
  },
  "Serilog": {
    "Using": [ "Serilog.Sinks.Console", "Serilog.Sinks.Elasticsearch" ],
    "MinimumLevel": {
      "Default": "Information",
      "Override": {
        "Microsoft.AspNetCore": "Warning",
        "System": "Warning"
      }
    },
    "WriteTo": [
      {
        "Name": "Console"
      },
      {
        "Name": "Elasticsearch",
        "Args": {
          "nodeUris": "http://localhost:9200",
          "autoRegisterTemplate": true,
          "indexFormat": "notifications_system-{0:yyyy.MM.dd}",
          "inlineFields": true,
          "numberOfShards": 2,
          "numberOfReplicas": 2,
          "autoRegisterTemplateVersion": "ESv7"
        }
      }
    ],
    "Enrich": [ "FromLogContext", "WithMachineName", "WithThreadId" ],
    "Properties": {
      "Application": "Notifications"
    }
  },
  "ErrorInAverageEveryNTime": 2,
  "WarningInAverageEveryNTime": 2
}

Main Components

1. Entities

User: Manages users.
Role: Manages user roles.
Permission: Manages access permissions.
Language: Manages languages.

2. Dependency Injection

Integrates necessary services via Dependency Injection (DI) to manage the application lifecycle.

3. Bearer Token

Manages Bearer Token, authentication, and authorization.

4. JSON Utilities

Provides utilities for handling JSON, such as converting between strings and objects.

5. Localization

Supports language localization within the application for various languages.

Contribution

Please submit pull requests or open issues on GitHub to contribute or report bugs for this project.

License

This library is licensed under the MIT License. Please see the LICENSE file for more details.

Please customize the configuration details (such as ConnectionStrings, ApiKey, TokenConfigs, etc.) according to your application�s requirements.

Product	Compatible and additional computed target framework versions.
.NET	net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net8.0
- Asp.Versioning.Mvc (>= 8.1.0)
- Autofac (>= 8.1.1)
- Autofac.Extensions.DependencyInjection (>= 10.0.0)
- AutoMapper (>= 13.0.1)
- Azure.Identity (>= 1.13.1)
- BCrypt.Net-Core (>= 1.6.0)
- BouncyCastle.NetCore (>= 2.2.1)
- Castle.Core (>= 5.1.1)
- Consul (>= 1.7.14.4)
- Dapper (>= 2.1.35)
- Dapper.Extensions.Caching.Redis (>= 5.1.4)
- Dapper.Extensions.MSSQL (>= 5.1.4)
- Dapper.Extensions.MySQL (>= 5.1.4)
- Dapper.Extensions.NetCore (>= 5.1.4)
- Dapper.Extensions.PostgreSQL (>= 5.1.4)
- Elastic.Serilog.Sinks (>= 8.12.2)
- FluentValidation.AspNetCore (>= 11.3.0)
- Google.Protobuf (>= 3.28.3)
- Grpc.AspNetCore.Server (>= 2.66.0)
- Grpc.Core.Api (>= 2.66.0)
- Grpc.Net.ClientFactory (>= 2.66.0)
- JetBrains.Annotations (>= 2024.3.0)
- MediatR (>= 12.4.1)
- Microsoft.AspNetCore.Authentication.JwtBearer (>= 8.0.10)
- Microsoft.AspNetCore.Identity.EntityFrameworkCore (>= 8.0.10)
- Microsoft.AspNetCore.OpenApi (>= 8.0.10)
- Microsoft.Data.SqlClient (>= 5.2.2)
- Microsoft.Data.Sqlite.Core (>= 8.0.10)
- Microsoft.EntityFrameworkCore (>= 8.0.10)
- Microsoft.EntityFrameworkCore.InMemory (>= 8.0.10)
- Microsoft.EntityFrameworkCore.Sqlite (>= 8.0.10)
- Microsoft.EntityFrameworkCore.Sqlite.Core (>= 8.0.10)
- Microsoft.EntityFrameworkCore.SqlServer (>= 8.0.1)
- Microsoft.Extensions.Caching.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Caching.StackExchangeRedis (>= 8.0.10)
- Microsoft.Extensions.Configuration (>= 8.0.0)
- Microsoft.Extensions.Configuration.EnvironmentVariables (>= 8.0.0)
- Microsoft.Extensions.Configuration.Json (>= 8.0.1)
- Microsoft.Extensions.DependencyInjection (>= 8.0.1)
- Microsoft.Extensions.Http.Resilience (>= 8.10.0)
- Microsoft.IdentityModel.Logging (>= 8.1.2)
- MongoDB.Driver (>= 3.0.0)
- MySql.EntityFrameworkCore (>= 8.0.8)
- NetJSON (>= 1.4.4)
- Npgsql.EntityFrameworkCore.PostgreSQL (>= 8.0.10)
- Polly (>= 8.4.2)
- Polly.Extensions.Http (>= 3.0.0)
- Pomelo.EntityFrameworkCore.MySql (>= 8.0.2)
- RestEase (>= 1.6.4)
- Serilog (>= 4.1.0)
- Serilog.AspNetCore (>= 8.0.3)
- Serilog.Enrichers.Environment (>= 3.0.1)
- Serilog.Enrichers.Process (>= 3.0.0)
- Serilog.Enrichers.Thread (>= 4.0.0)
- Serilog.Exceptions (>= 8.4.0)
- Serilog.Expressions (>= 5.0.0)
- Serilog.Formatting.Elasticsearch (>= 10.0.0)
- Serilog.Settings.Configuration (>= 8.0.4)
- Serilog.Sinks.Console (>= 6.0.0)
- Swashbuckle.AspNetCore (>= 6.9.0)
- System.IdentityModel.Tokens.Jwt (>= 8.1.2)
- System.Linq.Async (>= 6.0.1)
- System.Text.Json (>= 8.0.5)

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Muonroi.BuildingBlock:

Package	Downloads
MProjectTemplate.API This is sample project with MBuildingBlock library	90

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last updated
1.3.6	0	11/11/2024
1.3.5	0	11/11/2024
1.3.4	0	11/11/2024
1.3.3	35	11/10/2024
1.3.2	28	11/10/2024
1.3.1	31	11/10/2024
1.3.0	31	11/10/2024
1.2.9	37	11/8/2024
1.2.8	76	10/27/2024
1.2.7	84	10/27/2024
1.2.6	86	10/27/2024
1.2.5	80	10/27/2024
1.2.4	89	10/26/2024
1.2.3	77	10/25/2024
1.2.2	103	10/18/2024
1.2.1	107	10/1/2024
1.2.0	123	9/8/2024
1.1.9	101	9/2/2024
1.1.8	114	9/2/2024
1.1.7	108	9/1/2024
1.1.6	105	9/1/2024
1.1.5	109	9/1/2024
1.1.4	105	9/1/2024
1.1.3	106	9/1/2024
1.1.2	109	9/1/2024
1.1.1	102	8/31/2024
1.1.0	105	8/29/2024
1.0.9	108	8/29/2024
1.0.8	144	8/27/2024
1.0.7	133	8/26/2024
1.0.6	112	8/26/2024
1.0.5	131	8/25/2024
1.0.4	129	8/25/2024
1.0.3	137	8/25/2024
1.0.2	134	8/25/2024
1.0.1	128	8/25/2024
1.0.0	223	8/25/2024

This library will help you whenever you create a new project without needing much configuration, as everything is already set up, from bearer tokens to authentication, and more.