smart_arg_fork 4.0.0-dev.1

A smart command line argument parser for Dart that provides argument validation, static type checking, command execution, beautiful help generation and more.

4.0.0-dev.1

• Added:
  • DefaultCommand to allow invoking execution of an annotated Command by default if no args invoke another command
  • Parser.exitOnHelp (defaults to true) to exit(0) after help is requested.
  • Parser.printUsageOnExitFailure (defaults to false) to print the usage if SmartArg threw an error during parsing
  • meta dependency
• Changed:
  • During parse, commands are not instantiated by default. Instead smart_arg will attempt to use the pre-defined class variable. If that fails, then a new instance of the Command type will be constructed and executed.
• Breaking:
  • ParsedResult is now private and no-longer exported
  • non-async command hooks in favour of the async counterparts
  • SmartArgCommand. Extend SmartArg and override Future<void> execute() instead.
  • All extensions of SmartArg have a HelpArgument by default.
• Style:
  • Upgraded analysis rules and fixed warnings

3.1.0

• Added:
  • async compatible pre and post command hooks for ease of background processing before and after command execution
    • preCommandParse
    • postCommandParse
    • preCommandExecute
    • postCommandExecute
• Deprecated:
  • non-async command hooks in favour of the async counterparts
    • beforeCommandParse
    • afterCommandParse
    • beforeCommandExecute
    • afterCommandExecute

3.0.1

• Fix:
  • Invocation order of before* and after* command lifecycle callbacks

3.0.0

• Breaking:
  • Converted SmartArg.parse and SmartArgCommand.execute to be async

2.4.0

• Added:
  • Support for using extended classes of SmartArg to be added as @Commands to other SmartArg classes.

2.3.0

• Added:
  • Support for parsing and validating @EnumArguments

2.2.0

• Added:
  • Help text for Commands can be specified as either @Command(help: '') or within the implementations @Parser(description: '').

2.1.1

• Fixed:
  • Changed Help output to:
    • Use a maximum of 80 columns
    • Keep a consistent Command/Argument column width of 25 (introducing a linebreak on overflow)
    • Sort commands by displayKey
• Style:
  • Updated linting rules to help enforce more consitency

2.1.0

• Added:
  • Support for SmartArg Argument inheritance defined in super classes or via mixins
  • Support for SubCommands, including before/after command callback invocation
  • Nullable parent property to SmartArg and SmartArgCommand instances

2.0.0

• Breaking:
  • Upgraded for Null Type Safety. Requires minimum Dart version 2.12.0
  • Upgraded reflectable to 3.0.4
• Added:
  • Extra methods to SmartArg for handling lifecycle operations. Useful for DI instantiation
    • beforeCommandParse
    • beforeCommandExecute
    • afterCommandExecute
  • Support for reading arguments from Environment Variables if not provided during parsing
• Fixed:
  • Linter warnings
  • Allow properties of classes extending SmartArg to not require an Argument annotation
• Miscellaneous:
  • Upgraded dev_dependencies
    • test to ^1.18.2
    • build_runner to ^2.1.4
    • build_test to ^2.1.4
  • Replaced pandantic with lints ^1.0.1

1.1.2

• Updated dependencies pedantic, test, path, build_runner, build_test and reflectable
• Fixed new linting errors "unnecessary_brace_in_string_interps"

1.1.1

• Fixed linting errors from dartanalyzer
• Updated reflectable to 2.2.1

1.1.0

• Moved from dart:mirrors to source generation using reflectable

1.0.0+1

• Updated description in pubspec.yaml due to pub.dev Maintenance suggestions.

1.0.0

• Initial version