h/fish-shell
1
Fork 0
mirror of https://github.com/fish-shell/fish-shell.git synced 2026-05-21 03:11:13 -03:00
Code Issues Packages Projects Releases Wiki Activity

Added way to tell argparse to delete an option from $argv_opts.

Browse Source 
The intention is that if you want to parse some of your options verbatim to
another command, but you want to modfy other options (e.g. change their value,
convert them to other options, or delete them entirely), you mark the options
you want to modify with an &, and argparse will not add them to argv_opts. You
can then call the other command with argv_opts together with any new/modified
options, ensuring that the other command doesn't set the pre-modified options.
As with other known options, & options will be removed from $argv, and have
their $_flag_ variables set.

The `&` goes at the end of the option spec, or if the option spec contains a
validation script, immediately before the `!`. There is also now a -d/--delete
flag to fish_opt that will generate such an option spec.

See the changes in doc_src/cmds/argparse.rst for more details and an example use
case.
This commit is contained in:
Isaac Oscar Gariano
2025-08-03 10:07:08 +10:00
parent ddcb1813a7
commit f780b01ac9
15 changed files with 190 additions and 38 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
doc_src/cmds/fish_opt.rst
View File

@@ -8,7 +8,7 @@ Synopsis
.. synopsis::
fish_opt -s ALPHANUM [-l LONG-NAME] [-or] [--multiple-vals] [--long-only]
fish_opt -s ALPHANUM [-l LONG-NAME] [-ord] [--multiple-vals] [--long-only]
fish_opt --help
Description
@@ -36,6 +36,10 @@ The following ``argparse`` options are available:
**--multiple-vals**
The option being defined requires a value each time it is seen. Each instance is stored. This means the resulting flag variable created by ``argparse`` will have one element for each instance of this option in the arguments.
**-d** or **--delete**
The option and any values will be deleted from the ``$argv_opts`` variables set by ``argparse``
(as with other options, it will also be deleted from ``$argv``).
**-h** or **--help**
Displays help about using this command.