Popularity
1.3
Stable
Activity
7.1
Stable
29
1
0

Description

Simple library to made parsing CLI arguments easy. Library allows to print usage help "out of box".

For example of usage check Examples directory.

Programming language: C#
Tags: NetCore     Parser     Command     Argument     Shell     Core     CLI    

NFlags alternatives and similar packages

Based on the "CLI" category

Do you think we are missing an alternative of NFlags or a related project?

Add another 'CLI' Package

README

NFlags

Build Status NuGet License

Simple yet powerfull library to made parsing CLI arguments easy. Library also allow to print usage help "out of box".

For example of usage check Examples directory.

QuickStart

  1. Install NFLags from NuGet.
  2. Start new console project.
  3. Configure NFLags: c# Cli.Configure(configure => configure .SetDialect(Dialect.Gnu) .SetName("QuickStart") .SetDescription("This is NFlags") ) .Root(rc => rc .RegisterFlag("flag1", "f", "Flag description", false) .RegisterOption("option", "o", "Option description", "optionDefaultValue") .RegisterParameter("param", "Param description", "ParamDefaultValue") .RegisterCommand("subcommand", "Subcommand Description", sc => sc .SetExecute((commandArgs, output) => output.WriteLine("This is subcommand: " + commandArgs.GetParameter<string>("SubParameter"))) .RegisterParameter("SubParameter", "SubParameter description", "SubParameterValue") ) .RegisterParamSeries("paramSeries", "paramSeriesDescription") .SetExecute((commandArgs, output) => output.WriteLine("This is root command: " + commandArgs.GetParameter<string>("param"))) ). Run(args); Run application and enjoy: ``` $> dotnet NFlags.QuickStart.dll This is root command: ParamDefaultValue% $> dotnet NFlags.QuickStart.dll xxx This is root command: xxx $> dotnet NFlags.QuickStart.dll --help Usage: QuickStart [COMMAND] [OPTIONS]... [PARAMETERS]...

This is NFlags

    Commands:
    command Sub command Description

    Parameters:
    <param> Param description (Default: 'ParamDefaultValue')
    <paramSeries...>        paramSeriesDescription

    Options:
    --flag1, -f     Flag description
    --option <option>, -o <option>  Option description (Default: 'optionDefaultValue')
    --help, -h      Prints this help

$> dotnet NFlags.QuickStart.dll subcommand This is subcommand: SubParameterValue $> dotnet NFlags.QuickStart.dll subcommand yyy This is subcommand: yyy $> dotnet NFlags.QuickStart.dll command --help Usage: QuickStart command [OPTIONS]... [PARAMETERS]...

This is NFlags

    Parameters:
    <Parameter>     Sub parameter description (Default: 'SubParameterValue')

    Options:
    --help, -h      Prints this help

$>


## Documentation

[See details on NFlags GitHub pages](https://bartoszgolek.github.io/NFlags/)


*Note that all licence references and agreements mentioned in the NFlags README section above are relevant to that project's source code only.