|D. Moonfire 6a0b9d1e94||7 months ago|
|.config||7 months ago|
|scripts||7 months ago|
|src||7 months ago|
|tests||7 months ago|
|.editorconfig||7 months ago|
|.envrc||7 months ago|
|.gitignore||7 months ago|
|.prettierignore||7 months ago|
|.woodpecker.yml||7 months ago|
|CODE-OF-CONDUCT.md||7 months ago|
|LICENSE.md||1 year ago|
|LICENSE.txt||7 months ago|
|MfGames.ToolBuilder.sln||1 year ago|
|MfGames.ToolBuilder.sln.DotSettings||2 years ago|
|NuGet.Config||7 months ago|
|README.md||1 year ago|
|flake.lock||7 months ago|
|flake.nix||7 months ago|
|lefthook.yml||7 months ago|
An opinionated library for easily creating command-line tools in C#.
MfGames.ToolBuilder is a library to encapsulate the setup and running of tools, CLI components arranged with verbs (like
git). It includes some opinionated decisions on default setup.
To make sure the environment is correctly set up for build:
To build the project:
To test the project:
This library is built on top of System.CommandLine and .NET 6 generic hosting. The commands are combined together using dependency injection (see below) which allows for them to be included as parameters for the constructor or dynamically discovered.
All commands are assumed to be asynchronous and include a cancellation token in their calls.
System.CommandLine was chosen because it allows for composition of features instead on needing inheritance to give a tool the ability to render a table or handle additional features.
While most libraries should only use the included service provider infrastructure with the base library, this tool sets up Autofac to handle services. This allows for both service provider usage (via
ConfigureServices) and Autofac (via
Autofac was chosen because of a number of quality of life features and personal preferences of the developer. A tool can easily ignore that functionality in favor of using only
Likewise, tools are set up to use Serilog for logging instead of the built-in logging code. However, both are served by Serilog so
ILoggerFactory<T> can be used.
Like Autofac, Serilog was given because of the variety of sinks, certain quality of life, but also the ability to log more detailed objects. It also produces some coloring to log details based on data types.
To use the Serilog functionality with
ILoggerFactory, objects needed to be included as parameters instead of inlined with string interpolation.