`mini\CLI\ArgManager` class

Show private and protected members

Documentation

Command-line argument parser with subcommand support

Provides an immutable, fluent interface for parsing CLI arguments with support for subcommands, option validation, and positional arguments.

Features

Subcommand support: Parse nested command structures (git commit -m "message")
Short options: -v, -vvv, -i value, -ivalue
Long options: --verbose, --match=pattern, --match pattern
Unified short/long: Query by either name, get same result
Option validation: Required/optional values with automatic error handling
Immutable design: All operations return new instances
Command delegation: Easy pass-through to external tools

Quick Start

// Simple command: myapp -v --output=file.txt
$args = mini\args(
    (new ArgManager())
        ->withFlag('v', 'verbose')
        ->withRequiredValue('o', 'output')
);

if ($args->getUnparsedArgs()) {
    die("Unexpected: " . implode(', ', $args->getUnparsedArgs()));
}

$verbosity = $args->getFlag('verbose');
$output = $args->getOption('output');

Subcommands

// myapp -v run --fast target
$args = mini\args(
    (new ArgManager())
        ->withFlag('v', 'verbose')
        ->withSubcommand('run', 'build', 'test')
);

if ($args->getUnparsedArgs()) {
    die("Unexpected: " . implode(', ', $args->getUnparsedArgs()));
}

$sub = $args->nextCommand();
if ($sub?->getCommand() === 'run') {
    $run = $sub->withFlag(null, 'fast');
    $target = $run->getUnparsedArgs()[0] ?? null;
}

Stopping Option Parsing

Use -- to stop option parsing and treat everything after as unparsed arguments:

// myapp -v -- --not-an-option file.txt
$args = mini\args((new ArgManager())->withFlag('v', 'verbose'));
$args->getUnparsedArgs(); // ['--not-an-option', 'file.txt']