• Stars
    star
    28
  • Rank 852,272 (Top 18 %)
  • Language
    C#
  • License
    MIT License
  • Created over 8 years ago
  • Updated about 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Just a quick way to create your own command line tool

JustCli

That’s just a quick way to create your own command line tool.

The idea is to have one command in one class. A set of attributes helps you to map command line arguments to the command class properties and provide additional information. JustCli scans your project, generates help and allows you to run the commands.

Download

You can install it using NuGet.

Example

Let’s create a β€œsayhello” command. First of all we need a console application with JustCli entry point.

static int Main(string[] args)
{
    return CommandLineParser.Default.ParseAndExecuteCommand(args);
}

Create SayHelloCommand class and implement command logic.

[Command(
    "sayhello",
    "Prints a greeting.",
    @"Very useful command that print hello to the output with the word you provide.
This command is greatly described in this help text so you should be able to use it properly after you read it.
More examples at http://hello.world/greetings/examples")]
class SayHelloCommand : ICommand
{
    [CommandArgument("n", "name", Description = "The someone to greet.", DefaultValue = "World")]
    public string Name { get; set; }

    [CommandOutput]
    public IOutput Output { get; set; }

    public int Execute()
    {
        Output.WriteInfo("Hello {0}!", Name);
        return ReturnCode.Success;
    }
}

CommandOutput attribute marks property where the common output is injected. Colored console is used by default.

When run the command line tool we can see command list.

cmd> TestApp.exe
Command list:
sayhello - Prints a greeting.

Also you can get help for a special command.

cmd> TestApp.exe sayhello ? 
sayhello - Prints a greeting.
  Very useful command that print hello to the output with the word you provide.
  This command is greatly described in this help text so you should be able to use it properly after you read it.
  More examples at http://hello.world/greetings/examples
Options:
  -n  --name  [string]  The someone to greet. [default: World]  

That is what JustCli makes for you.

Let's test "sayhello" command.

cmd> TestApp.exe sayhello
Hello World!
cmd> TestApp.exe sayhello -n Bob
Hello Bob!

Now you know how to create command line tool quickly and easily! :)

More Repositories