Unfucked.DI 0.0.1-beta.15

🧰 Unfucked.DI

Fix egregiously missing or broken functionality in the dependency injection/inversion of control library Microsoft.Extensions.Hosting. Inspired by Spring Framework and JSR-330.

• Installation
• Usage
  • Dependency Injection
  • Logging
• All Unfucked libraries

Installation

dotnet package add Unfucked.DI

using Unfucked;
using Unfucked.DI;

Usage

Create an application using ASP.NET Core or a .NET Generic Host:

HostApplicationBuilder appBuilder = new HostApplicationBuilder(args);
using IHost app = appBuilder.Build();
await app.RunAsync();

Dependency Injection

• In addition to searching for configuration JSON files in the current working directory, also search in the executable file's directory, so launching the program with a different CWD doesn't break configuration if that's where you're storing them.

  appBuilder.Configuration.AlsoSearchForJsonFilesInExecutableDirectory();
  

• Allow providers for a dependency service to be injected into a dependent instead of the service itself, which is useful when the dependent either has a longer lifetime than the dependency or needs to make multiple distinct instances of the dependency.

  appBuilder.Services
      .AddInjectableProviders()
      .AddSingleton<MyDependent>()
      .AddTransient<MyDependency>();
  
  class MyDependent(Provider<MyDependency> dependencyProvider){
      void Run(){
          using MyDependency dependency = dependencyProvider.Get();
      }
  }
  

• Change the exit code with which the program exits when a background service crashes, instead of 0 which incorrectly indicates success.

  appBuilder.Services.SetExitCodeOnBackgroundServiceException(1);
  

• Easily register a class in the DI context as itself and all of its interfaces and superclasses automatically, so you can inject it as any of the super types without any casting in constructors or unmaintainable multiple registration clutter.

  appBuilder.Services
      .AddSingleton<MyDependency>(alsoRegister: SuperRegistration.INTERFACES | SuperRegistration.SUPERCLASSES);
  
  class MyDependency: MyInterface;
  class MyDependent(MyInterface dependency);
  

  • Available for singletons, transients, scoped, hosted, and keyed services.

Logging

• Add a colored console with single-line, column formatted data with simple type names.

  appBuilder.Logging.AddUnfuckedConsole();
  

• Increase the log message level of specified categories/classes and event IDs, in case the author of the original class foolishly logged important messages with at most the same level as lots of unimportant messages, so you can't just decrease your logger level filter for that entire class.

  appBuilder.Logging.AmplifyMessageLevels(options =>
      options.Amplify("Microsoft.AspNetCore.SignalR.Internal.DefaultHubDispatcher", LogLevel.Warning, 2, 3, 5, 11, 13, 14, 15, 19, 21, 22, 23, 24));
  

• Shorter alternatives for logging methods that aren't as ridiculously named as LogInformation, and that correctly format parameter values according to the current culture so you don't get fucked up percentages like 50 %.

  appBuilder.Logging.AddUnfuckedConsole();
  
  ILogger<MyService> logger;
  logger.Info("Transfer {progress:P0} done", 0.5); // Transfer 50% done
  

All Unfucked libraries

• Unfucked
• Unfucked.Caching
• Unfucked.Compression
• Unfucked.DateTime
• Unfucked.DI
• Unfucked.HTTP
• Unfucked.ICS
• Unfucked.OBS
• Unfucked.PGP
• Unfucked.STUN
• Unfucked.Twitch
• Unfucked.Windows