NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #4415 most downloaded on pub.dev
a simple argument parser and handler, integrated with JSON and dart:io.
Latest stable
1.3.0
Last release 18 days ago
04 Nov 2026
Ships on a steady schedule
a new release about every 2.4 years
Nearly every release is documented
notes for 5 of 5 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
5 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
ArgsSimple.parse : parsing behaviour changes:
ArgsSimple.parse: parsing behaviour changes:
-- now ends option parsing: every following element is an argument, even if it starts with - (['--', '-x'] gives the argument -x). It used to be an option with an empty key that consumed the next element.--key=value is now split on the first =: the option key with value (which may be empty or contain =), without consuming the next element. It used to be the option keyvalue consuming the next element as its value. --key value is unchanged. --flag=true is an option, not a flag (read it with optionAsBool).--Ünïcode is now ünïcode (it used to be ncode). Keys are still lower-cased and stripped of -, _, ., spaces, punctuation and symbols, so --sys-config, --sys_config and --SysConfig remain the same key. ASCII keys are unchanged.-D/-P are a property prefix only when followed by key=value (or key:value): -Port, -Debug, -Dverbose, -P are now flags (port, debug, dverbose, p); they used to be the properties ort, ebug, verbose and '' with an empty value. -Dkey=value, -Pkey=value and -Dkey:value are unchanged.ArgsSimple:
toList: arguments starting with - (other than negative numbers) are emitted after --, so parse -> toList -> parse round-trips (an argument -x added in code used to come back as a flag). An option with an empty key is emitted as --=value.toJson: flags is now a List (it was a Set, so jsonEncode(args.toJson()) failed when there were flags). The options lists are copies.fromJson: a Map in the toJson format (only the keys arguments, flags, options, properties, with the matching types) now loads all four sections, so toJson -> fromJson round-trips. Any other Map is still read as options.normalizeKey: documented; uses a Unicode-aware character check.TypeParser:
parserFor: nullable built-in types (int?, String?, List?, ...) now get the parser of their non-nullable type (it returned null), so option<int?>('port') parses instead of throwing a TypeError.parseMap/parseMapEntry: a key or value that can't be parsed (parseMap<String, int>('a=x')) no longer throws a TypeError: the entry is skipped by parseMap and parseMapEntry returns def (consistent with keys without a value in 1.2.1). A nullable type keeps the entry with a null. This also applies to Map, MapEntry and Iterable inputs; a one-element Iterable is a key without a value.--/--key=value/Unicode/-P/-D round-trips, a randomized parse -> toList -> parse property test, and toJson -> jsonEncode -> fromJson round-trips. Tests: 127 -> 148. Line coverage: 100%.Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fixed argument/option/property (and the typed *AsInt, *AsDouble, *AsBool, ... accessors) throwing a TypeError when a value can't be parsed (e.g. --por
ArgsSimple:
argument/option/property (and the typed *AsInt, *AsDouble, *AsBool, ... accessors) throwing a TypeError when a value can't be parsed (e.g. --port abc with optionAsInt('port', 8080)): they now return the default (or null).TypeParser:
parseMap/parseMapEntry throwing a TypeError for a key without a value (parseMap<String, String>('a;b=1')) when the value type is non-nullable: the entry is now skipped by parseMap ({'b': '1'}) and parseMapEntry returns def. A nullable/dynamic value type still keeps the key with a null value.--, --key=value, = in values, repeated options/flags/properties, -P/-D prefixes, negative numbers vs. flags, quoting, unicode), parse -> toList -> parse round-trips, and end-to-end tests running real processes (the example CLI, and a script comparing real argv parsing with in-process parsing). Tests: 69 -> 127. Line coverage: 99.3% -> 100%.CODECOV_TOKEN secret and fails CI on error.Use Iterable.nonNulls instead of the deprecated whereNotNull from package:collection.
ArgsSimple:
toList: an option given more than once (stored as a List) is now emitted as one --key value pair per value, so toList round-trips through parse (it used to emit --key [v1, v2]).TypeParser:
parseMapEntry/parseMap: fixed whitespace around the key/value delimiter leaking into the value ('a = 1' gave the value '= 1').Iterable.nonNulls instead of the deprecated whereNotNull from package:collection.Removed unnecessary library names.
Removed dependency collection (no longer used).
Tests: added unit tests for TypeParser, TypeParserIO, the ArgsSimple accessors, fromJson, serialization and the dart:io extension, plus integration tests running the example CLI. Line coverage: 31.5% -> 99.3%.
GitHub CI: actions/checkout@v7, codecov/codecov-action@v7; tests run on SDK 3.13.0 and stable.
sdk: ^3.13.0
yaml: ^3.1.4
lints: ^6.1.0
test: ^1.33.0
dependency_validator: ^5.1.0
coverage: ^1.16.0
- ArgsSimple: - parse: allow multiple values for the same option. - Added flagOr.
Merge v1.0.1
v1.0.1
- `ArgsSimple`:
- `parse`: allow multiple values for the same option.
- Added `flagOr`.
- sdk: '>=3.0.0 <4.0.0'
- collection: ^1.18.0
- yaml: ^3.1.2
- lints: ^2.1.1
- test: ^1.24.9
- dependency_validator: ^3.2.2
- coverage: ^1.7.1
Initial version.
One column per quarter.