Grad.CsLib 2.0.12

CsLib Core Package

This package contains utilities for C# API projects.

This package is very opinionated, as it's intended for Graduate College API projects:

• FastEndpoints is used, which is a thin layer on top of .NET Core minimal APIs.
• OpenAPI/Swagger docs are generated from endpoint definitions and XML documentation. The JSON is exported to the /spec folder for generating client libraries.
  • Kiota is used to generate the OpenAPI JSON, but not the client libraries.
• Authentication is through Entra.

Requirements

• .NET Core 10

Dependencies

Outside of Microsoft packages, these are the main dependencies:

• FastEndpoints
• Mapperly
• Serilog

CsLibWeb

Here's an example of how to set up a Program.cs file for a web API project:

using ExampleData;
using ExampleServer;
using FastEndpoints.ClientGen.Kiota;
using Grad.CsLib;
using Microsoft.EntityFrameworkCore;
using Serilog;

var builder = WebApplication.CreateBuilder(args);

builder.AddSwagger(args, "ExampleServer", "0.0.1", "Example Backend Server");

builder
 .AddSerilog()
 .AddCors()
 .AddAuth();
builder.Services
 .AddDbContext<ExampleContext>(options =>
 options.UseSqlServer(
 builder.Configuration.GetConnectionString("Example")))
 .AddAuthorization(AuthPolicy.AddAuthPolicy)
 .RegisterServicesFromExampleServer();

builder.AddEndpoints(DiscoveredTypes.All);

try
{
 var app = builder.BuildAndConfigureApp(b => b.ReflectionCache.AddFromExampleData().AddFromExampleServer());

 // This is only run with the --exportswaggerjson option
 await app.ExportSwaggerJsonAndExitAsync("ExampleServer", "../spec");

 app.Run();
}
catch (Exception ex)
{
 Log.Fatal(ex, "Application start-up failed");
}
finally
{
 Log.CloseAndFlush();
}