ArgParser class Null safety

A class for taking a list of raw command line arguments and parsing out options and flags from them.

Constructors

ArgParser({bool allowTrailingOptions = true, int? usageLineLength})

Creates a new ArgParser.

factory

ArgParser.allowAnything()

Creates a new ArgParser that treats all input as non-option arguments.

factory

Properties

allowsAnything → bool

Whether or not this parser treats unrecognized options as non-option arguments.

read-only

allowTrailingOptions → bool

Whether or not this parser parses options that appear after non-option arguments.

final

commands → Map<String, ArgParser>

The commands that have been defined for this parser.

final

hashCode → int

The hash code for this object.

read-only, inherited

options → Map<String, Option>

The options that have been defined for this parser.

final

runtimeType → Type

A representation of the runtime type of the object.

read-only, inherited

usage → String

Generates a string displaying usage information for the defined options.

read-only

usageLineLength → int?

An optional maximum line length for usage messages.

final

Methods

addCommand(String name, [ArgParser? parser]) → ArgParser

Defines a command.

addFlag(String name, {String? abbr, String? help, bool? defaultsTo = false, bool negatable = true, void callback(bool)?, bool hide = false, List<String> aliases = const []}) → void

Defines a boolean flag.

addMultiOption(String name, {String? abbr, String? help, String? valueHelp, Iterable<String>? allowed, Map<String, String>? allowedHelp, Iterable<String>? defaultsTo, void callback(List<String>)?, bool splitCommas = true, bool hide = false, List<String> aliases = const []}) → void

Defines an option that takes multiple values.

addOption(String name, {String? abbr, String? help, String? valueHelp, Iterable<String>? allowed, Map<String, String>? allowedHelp, String? defaultsTo, void callback(String?)?, bool mandatory = false, bool hide = false, List<String> aliases = const []}) → void

Defines an option that takes a value.

addSeparator(String text) → void

Adds a separator line to the usage.

defaultFor(String option) → dynamic

Returns the default value for option.

findByAbbreviation(String abbr) → Option?

Finds the option whose abbreviation is abbr, or null if no option has that abbreviation.

findByNameOrAlias(String name) → Option?

Finds the option whose name or alias matches name, or null if no option has that name or alias.

getDefault(String option) → dynamic

@Deprecated('Use defaultFor instead.')

noSuchMethod(Invocation invocation) → dynamic

Invoked when a non-existent method or property is accessed.

inherited

parse(Iterable<String> args) → ArgResults

Parses args, a list of command-line arguments, matches them against the flags and options defined by this parser, and returns the result.

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited