AutomationIoC.CommandLine 3.0.0-alpha1

AutomationIoC.Runtime

Dependency Injection Framework for C# Console Applications

NuGet Packages

Documentation

Please visit the AutomationIoC Documentation Site for installation, getting started, and API documentation.

Samples

Please visit and/or download our AutomationIoC.CommandLine Sample Solution to get a more in-depth view of usage.

Installation

.NET CLI

dotnet add package AutomationIoC.CommandLine

Development

Create Automation Console Command to run

public class TestCommand : StandardCommand
{
    public override void ConfigureCommand(IServiceBinderFactory serviceBinderFactory, Command command)
    {
        var greetingOption = new Option<string>(
            name: "--greeting",
            description: "New greeting to display.");

        command.AddOption(greetingOption);

        command.SetHandler(UpdateGreeting,
            greetingOption,
            serviceBinderFactory.Bind<ITestService>(),
            serviceBinderFactory.Bind<IConfiguration>());
    }

    public override void Configure(HostBuilderContext hostBuilderContext, IConfigurationBuilder configurationBuilder)
    {
        var appSettings = new Dictionary<string, string>()
        {
            ["CurrentGreetingMessage"] = "Current Greeting: {0}",
            ["NewGreetingMessage"] = "New Greeting: {0}"
        };

        configurationBuilder.AddInMemoryCollection(appSettings);
    }

    public override void ConfigureServices(HostBuilderContext hostBuilderContext, IServiceCollection services)
    {
        serviceCollection.AddScoped<ITestService, TestService>();
    }

    private void UpdateGreeting(
        string newGreeting,
        ITestService testService,
        IConfiguration configuration)
    {
        string unformattedCurrentGreeting = configuration.GetValue<string>("CurrentGreetingMessage");
        string unformattedNewGreeting = configuration.GetValue<string>("NewGreetingMessage");

        string currentGreeting = testService.GetGreeting();

        Console.WriteLine(unformattedCurrentGreeting, currentGreeting);

        string updatedGreeting = testService.UpdateGreeting(newGreeting);

        Console.WriteLine(unformattedNewGreeting, updatedGreeting);
    }
}

Add Automation Console Builder in startup

class Program
{
    static void Main(string[] args)
    {
        IAutomationConsoleBuilder builder =
            // Passing in "args" is optional
            AutomationConsole.CreateDefaultBuilder(args)
                // Add command name/path here
                .AddCommand<TestCommand>("greet");

        IAutomationConsole console = builder.Build();

        console.Run();
    }
}

Run command

dotnet run -- greet --greeting "Hello World"

Other Resources

• .NET Command-Line-Api Project
• Tutorial: Create a .NET tool using the .NET CLI
• Tutorial: Install and use a .NET global tool using the .NET CLI
• Tutorial: Install and use a .NET local tool using the .NET CLI

Related Packages