AutomationIoC.CommandLine 3.0.0-beta1

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 : IAutomationCommand
{
    public void Initialize(AutomationCommand command)
    {
        Option<string> configurationKeyOption = new(name: "--key")
        {
            Description = "Name of key to pull from configuration."
        };

        command.Options.Add(configurationKeyOption);

        command.SetAction(async (parseResult, context, cancellationToken) =>
        {
            string configurationKey = parseResult.GetValue(configurationKeyOption);

            IServiceProvider serviceProvider = context.ServiceProvider;

            TestConfigurationService testConfigurationService =
                serviceProvider.GetRequiredService<TestConfigurationService>();

            string configurationValue =
                await testConfigurationService
                    .GetConfigurationValueAsync(configurationKey, cancellationToken)
                    .ConfigureAwait(false);

            Console.WriteLine($"Configuration Value Requested: {configurationValue}");
        });
    }
}

// Sample test configuration service to retrieve configuration values
public class TestConfigurationService(IConfiguration configuration)
{
    public string GetConfigurationValue(string key) =>
        configuration.GetValue<string>(key) ?? throw new KeyNotFoundException($"Configuration key '{key}' not found.");

    public Task<string> GetConfigurationValueAsync(string key, CancellationToken cancellationToken = default) =>
        Task.FromResult(GetConfigurationValue(key));
}

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>("check-config")
                // Build IConfiguration
                .Configure((context, configurationBuilder) =>
                {
                    var appSettings = new Dictionary<string, string>
                    {
                        {
                            "MyConfigurationKey", Guid.NewGuid().ToString()
                        }
                    };
                    configurationBuilder.AddInMemoryCollection(appSettings);
                })
                // Register services
                .ConfigureServices((context, services) =>
                {
                    services.AddTransient<TestConfigurationService>();
                });

        IAutomationConsole console = builder.Build();

        console.Run();
    }
}

Run command

dotnet run -- check-config --key MyConfigurationKey

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