Skip to content

NConsole is a .NET library to parse command line arguments and execute commands.

License

Notifications You must be signed in to change notification settings

RicoSuter/NConsole

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

94 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

NConsole for .NET

Build status NuGet Version

NConsole is a .NET library to parse command line arguments and execute commands. If the command name or some non-optional parameters are missing, the library automatically switches to an interactive mode where the user is prompted to enter the missing parameters. Using descriptive attributes on the command class and its parameters, a nicely formatted help page can be generated.

To use the library in your application, install the NuGet package NConsole.

Features:

  • Interactive mode when parameters are missing
  • Customizable parameter reading
  • Automatically generated help page
  • Support for optional parameters
  • Dependency injection to inject services into command instances

Usage

The usage is simple: Create an instance of the CommandLineProcessor class, register the commands and execute a command by calling the Process() method with the command line arguments.

namespace MyApplication
{
    class Program
    {
        static void Main(string[] args)
        {
            var processor = new CommandLineProcessor(new ConsoleHost());
            processor.RegisterCommand<SumCommand>("sum");
            processor.Process(args);
        }
    }

    [Description("Calculates the sum of two values.")]
    public class SumCommand : IConsoleCommand
    {
        [Description("The first value.")]
        [Argument(Name = "FirstValue")]
        public int FirstValue { get; set; }

        [Description("The second value.")]
        [Argument(Name = "SecondValue", IsRequired = false)]
        public int SecondValue { get; set; } = 10;

        public async Task<object> RunAsync(CommandLineProcessor processor, IConsoleHost host)
        {
            host.WriteMessage((FirstValue + SecondValue).ToString());
            return null;
        }
    }
}

The command sum can now be executed using the following command line call:

MyApplication.exe sum /firstvalue:5 /secondvalue:6
Output: 11

The SecondValue has is not required (IsRequired set to ``false`). The default value is set via a C# property initializer. This parameter is not required:

MyApplication.exe sum /firstvalue:5
Output: 15

Execute the following command to show a list of all available commands:

MyApplication.exe help

About

NConsole is a .NET library to parse command line arguments and execute commands.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages