Repository navigation
Commit d07e50e
authored
feat(parse): parse Args without an enclosing CLI (#1419)
Adapters and embedded command surfaces can now parse one derived `Args`
type without constructing or parsing the application’s root CLI. This
lets callers reuse the command’s compiled flags, positional arguments,
defaults, validation, subcommand routing, and typed construction
directly.
```rust
let install = usage::parse_args_from::<Install>(&args)?;
let install = usage::parse_args_from_argv::<Install>(&argv)?;
```
The second form follows the full-argv convention and strips argv0. Both
return ordinary usage parse errors, including help requests, for the
selected command.
Validation: `mise run ci` (Rust workspace tests and doctests, Clippy,
formatting, semver checks, Prettier, and Go tests).
*AI-assisted — Tool: Codex; model: openai/gpt-5; version: unavailable.*
<!-- CURSOR_SUMMARY -->
---
> [!NOTE]
> **Low Risk**
> Additive public API on the existing parser path; behavior is covered
by new integration tests with no changes to root CLI parsing.
>
> **Overview**
> Adds **`parse_args_from`** and **`parse_args_from_argv`** so a derived
**`CommandArgs`** / **`Args`** type can be parsed without a root
**`Cli`**. Parsing starts at that command’s tables (flags, positionals,
defaults, validation, nested subcommands) and returns the same
**`Error`** variants as full-app parsing, including help, version, and
missing-args help.
>
> **`parse_args_from`** treats the slice as that command’s words only;
**`parse_args_from_argv`** strips argv0 first. Both are re-exported from
**`usage-rs`** (via **`usage_argv`**) behind the **`spec`** feature.
Docs and facade tests cover success paths, choices, help, and subcommand
routing.
>
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
9149f89. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->
<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit
- **New Features**
- Added standalone argument parsing for individual command definitions
without requiring a complete CLI application.
- Supports defaults, positional arguments, choice validation, help,
version, required arguments, and nested subcommands.
- Exposed public parsing entry points for adapter and integration use.
- **Documentation**
- Added guidance and examples for standalone argument parsing.
- **Tests**
- Added coverage for successful parsing, defaults, choices, positional
arguments, nested commands, help, and invalid or missing input.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->1 parent cf27852 commit d07e50e
4 files changed
Lines changed: 183 additions & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
177 | 177 | | |
178 | 178 | | |
179 | 179 | | |
| 180 | + | |
| 181 | + | |
180 | 182 | | |
181 | 183 | | |
182 | 184 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
22 | 22 | | |
23 | 23 | | |
24 | 24 | | |
| 25 | + | |
25 | 26 | | |
26 | 27 | | |
27 | 28 | | |
| |||
3790 | 3791 | | |
3791 | 3792 | | |
3792 | 3793 | | |
| 3794 | + | |
| 3795 | + | |
| 3796 | + | |
| 3797 | + | |
| 3798 | + | |
| 3799 | + | |
| 3800 | + | |
| 3801 | + | |
| 3802 | + | |
| 3803 | + | |
| 3804 | + | |
| 3805 | + | |
| 3806 | + | |
| 3807 | + | |
| 3808 | + | |
| 3809 | + | |
| 3810 | + | |
| 3811 | + | |
| 3812 | + | |
| 3813 | + | |
| 3814 | + | |
| 3815 | + | |
| 3816 | + | |
| 3817 | + | |
| 3818 | + | |
| 3819 | + | |
| 3820 | + | |
| 3821 | + | |
| 3822 | + | |
| 3823 | + | |
| 3824 | + | |
| 3825 | + | |
| 3826 | + | |
| 3827 | + | |
| 3828 | + | |
| 3829 | + | |
| 3830 | + | |
| 3831 | + | |
| 3832 | + | |
| 3833 | + | |
| 3834 | + | |
| 3835 | + | |
| 3836 | + | |
| 3837 | + | |
| 3838 | + | |
| 3839 | + | |
| 3840 | + | |
| 3841 | + | |
| 3842 | + | |
| 3843 | + | |
| 3844 | + | |
| 3845 | + | |
| 3846 | + | |
| 3847 | + | |
| 3848 | + | |
| 3849 | + | |
| 3850 | + | |
| 3851 | + | |
| 3852 | + | |
| 3853 | + | |
| 3854 | + | |
| 3855 | + | |
| 3856 | + | |
| 3857 | + | |
3793 | 3858 | | |
3794 | 3859 | | |
3795 | 3860 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
62 | 62 | | |
63 | 63 | | |
64 | 64 | | |
| 65 | + | |
| 66 | + | |
| 67 | + | |
| 68 | + | |
| 69 | + | |
| 70 | + | |
| 71 | + | |
| 72 | + | |
| 73 | + | |
| 74 | + | |
| 75 | + | |
| 76 | + | |
| 77 | + | |
| 78 | + | |
| 79 | + | |
| 80 | + | |
| 81 | + | |
| 82 | + | |
| 83 | + | |
| 84 | + | |
| 85 | + | |
| 86 | + | |
| 87 | + | |
| 88 | + | |
| 89 | + | |
| 90 | + | |
| 91 | + | |
| 92 | + | |
65 | 93 | | |
66 | 94 | | |
67 | 95 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
618 | 618 | | |
619 | 619 | | |
620 | 620 | | |
| 621 | + | |
| 622 | + | |
| 623 | + | |
| 624 | + | |
| 625 | + | |
| 626 | + | |
| 627 | + | |
| 628 | + | |
| 629 | + | |
| 630 | + | |
| 631 | + | |
| 632 | + | |
| 633 | + | |
| 634 | + | |
| 635 | + | |
| 636 | + | |
| 637 | + | |
| 638 | + | |
| 639 | + | |
| 640 | + | |
| 641 | + | |
| 642 | + | |
| 643 | + | |
| 644 | + | |
| 645 | + | |
| 646 | + | |
| 647 | + | |
| 648 | + | |
| 649 | + | |
| 650 | + | |
| 651 | + | |
| 652 | + | |
| 653 | + | |
| 654 | + | |
| 655 | + | |
| 656 | + | |
| 657 | + | |
| 658 | + | |
| 659 | + | |
| 660 | + | |
| 661 | + | |
| 662 | + | |
| 663 | + | |
| 664 | + | |
| 665 | + | |
| 666 | + | |
| 667 | + | |
| 668 | + | |
| 669 | + | |
| 670 | + | |
| 671 | + | |
| 672 | + | |
| 673 | + | |
| 674 | + | |
| 675 | + | |
| 676 | + | |
| 677 | + | |
| 678 | + | |
| 679 | + | |
| 680 | + | |
| 681 | + | |
| 682 | + | |
| 683 | + | |
| 684 | + | |
| 685 | + | |
| 686 | + | |
| 687 | + | |
| 688 | + | |
| 689 | + | |
| 690 | + | |
| 691 | + | |
| 692 | + | |
| 693 | + | |
| 694 | + | |
| 695 | + | |
| 696 | + | |
| 697 | + | |
| 698 | + | |
| 699 | + | |
| 700 | + | |
| 701 | + | |
| 702 | + | |
| 703 | + | |
| 704 | + | |
| 705 | + | |
| 706 | + | |
| 707 | + | |
| 708 | + | |
621 | 709 | | |
622 | 710 | | |
623 | 711 | | |
| |||
0 commit comments