darted_cli 1.0.0

darted_cli is a customizable Dart CLI framework for building command-line tools with hierarchical command structures, argument parsing, and flag management.

1.0.0: Stable, production ready release.

FIX: Hardened ConsoleHelper.chooseOption with terminal raw mode cleanup in try/finally, non-TTY terminal fallback, and SIGINT handling.

FIX: Fixed ConsoleHelper.getUserInput stream listening conflicts.

FIX: Fixed ConsoleHelper.loadWithTask timer leak on task failure.

FIX: Fixed FileHelper.writeBytes ignoring the rewrite parameter.

FIX: Fixed searchFilesContent RangeError when match starts at index 0.

FIX: Fixed YamlModule scalar conversion quoting and dynamic Map support.

FEAT: Added Configuration File Support (.yaml/.json) with structural validation, unknown key rejection, and scoped command sections.

FEAT: Added built-in generate-sample-config command (<toolName> generate-sample-config) opted in via generateSampleConfig: true.

FEAT: Added Environment Variable Integration allowing arguments and flags to bind directly to process environment variables via environmentVariable.

FEAT: Added Unified 4-Tier Precedence Engine (CLI Arguments & Flags -> Environment Variables -> Configuration File -> Declared Defaults).

FEAT: Added POSIX/GNU compliant tokenization supporting attached values (--key=value, -ovalue), combined short flags (-rf), kebab-case normalization, and -- end-of-options delimiter.

FEAT: Added dartedExecute function for non-terminating, programmatic execution and testability returning a typed DartedExecutionResult.

FEAT: Added structured DartedValidationException hierarchy (UnknownCommandException, UnknownOptionException, ConfigException, etc.).

FEAT: Added isConfigurableInFile property to DartedCommand, DartedArgument, and DartedFlag to control configuration eligibility.

TEST: Added comprehensive unit, regression, and integration tests covering command parsing, validation, configuration files, environment variables, precedence resolution, console safety, filesystem operations, YAML serialization, execution behavior, and exit codes. Added GitHub Actions CI for formatting, static analysis, and automated test execution.

DOCS: Updated README and usage examples to document configuration files, sample configuration generation, environment variable integration, precedence rules, command parsing, programmatic execution, structured exceptions, and new API properties.

---

0.2.1

FIX: Fixed issues in subcommands main argument parsing.

0.2.0

FEAT: Added an option to set an argument as 'main' which would allow the user to pass it in as a required positioned argument without it's name. e.g. your_package command neededArg --otherOptionalArgName otherArgValue. Breaking Change: Added functionality to find the closest match of misspelled commands and arguments, and are now passed in the custom Error Callbacks. FEAT: updated 'defaultHelperMessage' implementation. FEAT: updated Darted models with .copyWith() implementation. DOCS: updated CHANGELOG file to be newest-first.

---

0.1.27

FIX: updated executeCommand function to run in shell with in the Windows platform to allow for executables to run. FEAT: updated executeCommand function to pass-through stdout text.

0.1.26

FIX: updated misspelled 'description' wording. FIX: updated getUserInput function to work with consecutive requests as it threw 'Stream has already been listened to' before.

0.1.25

FIX: Recursive map validation wasn't behaving as expected with nested required fields. FEAT: Updated the matchesPattern parameter of the schema validation to apply to List types.

0.1.24

FEAT: Added DartToYaml Converter to revert back the extraction process.

0.1.23

FIX: Copy methods for both files and directories not working. DOC: Updated License file for 2025.

0.1.22

FEAT: Added custom validation exceptions for the YAML module. FEAT: Added Recursive map validation for structure-like YAML components. DOC: Updated the format of the CHANGELOG file. DOC: Updated the example file.

0.1.21

FEAT: New updates to the YAML validation module!

0.1.20

FEAT: Added option to enable recursion in the 'listAll' functions of both files and directories.

0.1.19

FEAT: Added YAML Data Extraction functionality into Map<String,dynamic>.

0.1.18

FEAT: Added YAML Validation functionality using a schema, See the example main.dart for usage.

0.1.17

FEAT: Added description to dartedFlag and dartedArgument models.

0.1.16

DEPS: Updated dependencies & Added allowed and excluded parameters in the ListAll functions.

0.1.15

FIX: Fix in the searchFiles function for incorrect line content indentations.

0.1.14

FIX: Fix in the searchFiles function for incorrect position matches.

0.1.13

FEAT: Updated the searchFiles method to include the matches' starting position to make it easier to manipulate + Added 'allowed' parameter for it to search only certain files based on a RegExp pattern.

0.1.12

CHORE: Static Analysis Updates.

0.1.11

FEAT: Added 'chooseOption' method that Prompts the user to choose an option (Single/Multi).

0.1.10

CHORE: Some minor fixes.

0.1.9

FEAT: Added 'executeCommand' to the console helper.

0.1.8

FEAT: Added new 'Copy' methods.

0.1.7

FEAT: Updated the implementation to create Files.

0.1.6

FEAT: Added two methods for the IO Helper to list files/directories in a root path.

0.1.5

FIX: Fixed 'help/version flags that are applied by default not being parsed'.

0.1.4

FIX: asset-related fixes.

0.1.3

DOC: Documentation Fixes.

0.1.2

FIX: Fixed some assets-related issues.

0.1.1

FEAT: Added custom ASCII Fonts for the Art.

0.1.0

INIT: Initial Release.