clapnet 0.1.0

clapnet

Small helper library that provides a simple way to use System.CommandLine by just passing a bunch of functions into a builder and creating a command line application.

Usage

It works great with the newly introduced dotnet scripts. More about the scripts here.

Example usage:

#!/usr/bin/env dotnet run
#:project clapnet@0.1.0

var builder = clapnet.CommandBuilder.New();
return builder
    .WithSettings<SomeSettings>()
    .With(()=> Console.WriteLine("ssss"), "", "lambda_two")
    .With(Gather, "Documentation for gather command")
    .With(Failing, "This command will fail")
    .With(()=> Console.WriteLine("ssss"),"Test command", "lambda")
    .WithRootCommand(Other, "Super command to show what can be done")
    .Run(args);

void Gather(string test = "some", bool assert = false)
{
    Console.WriteLine("Hello World, argument test: {0}", test);
}

void Other(SomeSettings settings)
{
    Console.WriteLine("Hello World from the root command");
    Console.WriteLine("Hello World from the root command");
}

int Failing()
{
    /// Returning non zero value
    return 1;
}

class SomeSettings
{
    /// <summary>
    /// Test value, it will be possible to set its value by passing `--test true/false`.
    /// </summary>
    public bool Test = false;
    /// <summary>
    /// Test value, it will be possible to set its value by passing `--other "string value"`.
    /// </summary>
    public string other = "Default Value";
}

Now when called from the CLI it will print out:

 ./Test.cs -- --help
Description:
  Super command to show what can be done

Usage:
  Test [command] [options]

Options:
  --test
  --other <other>
  -?, -h, --help   Show help and usage information
  --version        Show version information

Commands:
  lambda_two
  gather <test> <assert>  Documentation for gather command [default: some]
  failing                 This command will fail
  lambda                  Test command

Take a look at the examples directory for a simple example of how to use clapnet.