NetCoreUsefullEndpoints 8.2024.627.800

NetCoreUsefullEndpoints

What it does

Register endpoints for

1. See environment variables
2. See current user ( implies authorization )
3. See environment
4. Throw error ( with ILogger or without )
5. Current Date
6. Digraph of current endpoints
7. JSON of current endpoints
8. Configuration View ( GetDebugView )
9. Connection details ( remote ip address, local ip address...)
10. Shutdown( and forced) the app ( use await app.RunAsync(UsefullExtensions.UsefullExtensions.cts.Token);
11. See the start date of the application
12. See the list of Hosted services / start all / stop all
13. When the PC has started ( uptime )
14. Information about the process ( memory, threads, handles, uptime )

Usage

Add this reference to your csproj in .NET 6

<ItemGroup>
    <PackageReference Include="NetCoreUsefullEndpoints" Version="6.2022.1231.1100" />
  </ItemGroup>

or in .NET 7

<ItemGroup>
    <PackageReference Include="NetCoreUsefullEndpoints" Version="7.2023.1216.1825" />
  </ItemGroup>

then use it in program.cs

using UsefullExtensions;
//code
var app = builder.Build();
app.MapUsefullAll();
app.MapHostedServices(app.Services.GetServices<IHostedService>().ToArray());
//or for just some usefull
app.MapUsefullConfiguration();

For shutdown 418 please add

builder.Services.AddSingleton<MiddlewareShutdown>();
var app = builder.Build();
//ASAP
app.UseMiddleware<MiddlewareShutdown>();

The list of API endpoints is GET=>/api/usefull/date/start GET=>/api/usefull/date/startUTC GET=>/api/usefull/user/authorization GET=>/api/usefull/user/noAuthorization GET=>/api/usefull/environment GET=>/api/usefull/errorWithILogger GET=>/api/usefull/errorPure GET=>/api/usefull/date/now GET=>/api/usefull/date/nowUTC GET=>/api/usefull/endpoints/graph GET=>/api/usefull/endpoints/text GET=>/api/usefull/configuration GET=>/api/usefull/httpContext/Connection POST=>/api/usefull/shutdown POST=>/api/usefull/shutdownForced/{id} GET=>/WeatherForecast

Security

Each function has a default implementation with AllowAnonymous ( a part user ) and without put RequireCors ; If you want a special case here, call the functions with

app.MapUsefullAll("myCors", new string[] {"myAuthPolicy"});
//or
app.MapUsefullConfiguration();

For restarting , the last line should be

await app.RunAsync(UsefullExtensions.UsefullExtensions.cts.Token);

Enjoy!