mud-git 1.1.7__tar.gz → 1.1.8__tar.gz

{mud_git-1.1.7 → mud_git-1.1.8}/AGENTS.md

@@ -17,17 +17,18 @@ pytest tests/test_run.py  # run a single file
 
 ## Entry point
 
-`mud` CLI → `mud:run` in `src/mud/__init__.py` → `App` in `src/mud/app.py`
+`mud` CLI → `mud:run` in `src/mud/__init__.py` → `App` in `src/mud/app.py`; `mud completion` is dispatched to `completion.complete()` before writable settings are initialised.
 
 ## Module map
 
 | File | Purpose |
 |---|---|
-| `src/mud/__init__.py` | Entry point; initialises `Settings`, creates `App`, calls `run()` |
+| `src/mud/__init__.py` | Entry point; creates `App`, dispatches completion or initialises `Settings` and calls `run()` |
 | `src/mud/app.py` | CLI dispatch; parses args, applies filters, calls `Runner` |
+| `src/mud/completion.py` | Exports the Carapace spec and provides read-only dynamic completion via `C_ARG<n>` / `C_VALUE` |
 | `src/mud/runner.py` | All display commands and execution modes |
 | `src/mud/config.py` | `.mudconfig` TSV read/write; `init`, `add`, `remove`, `prune` |
-| `src/mud/settings.py` | `~/.config/mud/settings.ini` read/write |
+| `src/mud/settings.py` | `~/.config/mud/settings.ini` read/write; read-only initialisation for completion |
 | `src/mud/commands.py` | Constants for every command name and filter flag prefix |
 | `src/mud/styles.py` | ANSI escape codes and Nerd Font glyphs |
 | `src/mud/utils.py` | Shared helpers: table creation, error printing, configure wizard |
@@ -38,9 +39,13 @@ pytest tests/test_run.py  # run a single file
 
 **Command dispatch** — `App.run()` routes to either a native `Runner` method (matched against constants in `commands.py`) or a shell pass-through. The `--` separator and `-c=<cmd>` flag both reach the shell path.
 
+**Carapace completion** — `mud completion carapace` exports a shell-independent spec; its fixed `mud completion values` callback handles mud's equals-only flags without executing user input. Command/flag descriptions come from the argparse definitions, aliases from settings, and label/path/branch values from the discovered config. Local and remote branch names reuse `Runner._get_unique_branch_names()`. Nothing is completed after `--`, inside `-c=`, or in arbitrary shell/alias arguments. Filters remain available after a completed `-c=` token. Neither spec export nor completion creates settings files.
+
+**Argument metadata** — argparse registers value-taking options without trailing `=` and toggles as booleans, so empty values and `-t` cannot consume native commands. The execution scanner still requires `-flag=value`; completion inserts the equals sign.
+
 **Execution modes** — three modes controlled by `run_async` + `run_table` settings (toggled by `-a` / `-t` flags): sequential, async streamed, async live-table.
 
-**Filter chain** — `App._filter_with_arguments()` applies up to eight filters in sequence (ignore label, include/exclude label, include/exclude branch, name substring, modified, diverged). Each step removes non-matching repos.
+**Filter chain** — `App._filter_with_arguments()` applies up to nine filters in sequence (ignore label, include/exclude label, include/exclude branch, include/exclude name substring, modified, diverged). Each step removes non-matching repos. Repeated `-N=` / `--not-name=` values exclude any matching path substring; empty exclusions are ignored.
 
 **Nerd Fonts** — every glyph in `styles.GLYPHS` has an ASCII fallback. `utils.glyphs(key)` selects between them based on the `nerd_fonts` setting, so mud works with or without a patched font.
 
@@ -53,9 +58,12 @@ Tests are black-box CLI tests — each runs `python -m mud` as a subprocess agai
 | `tests/test_config.py` | `init`, `add`, `remove`, `prune` |
 | `tests/test_display.py` | `status`, `info`, `log`, `labels`, `branches`, `tags` |
 | `tests/test_run.py` | Execution modes and flags |
-| `tests/test_filters.py` | `-l=`, `-L=`, `-b=`, `-B=`, `-n=` filter flags |
+| `tests/test_filters.py` | `-l=`, `-L=`, `-b=`, `-B=`, `-n=`, `-N=` filter flags and native-command parsing regressions |
+| `tests/test_completion.py` | Completion callback, dynamic values, command boundaries, read-only discovery, and optional real Carapace/Nushell integration |
 | `tests/test_states.py` | Edge-case repo states (unborn, detached, rebasing) |
 
+Carapace integration tests run when `carapace` is on `PATH`; the Nushell round-trip test also requires `nu`. Tests isolate `HOME`, Carapace config/cache directories, and use the current Python environment's `mud` executable.
+
 ## Knowledge base update rule
 After editing any file under `src/mud/`, update the affected sections of this file before finishing the task.
 `README.md` is the source of truth for user-facing behaviour — if commands, flags, or settings changed, update the relevant table rows there. Table edits only — no new prose.

{mud_git-1.1.7 → mud_git-1.1.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mud-git
-Version: 1.1.7
+Version: 1.1.8
 Summary: Multi repository git utility. Manage multiple git-repositories simultaneously.
 Author-email: Jasur Sadikov <jasur@sadikoff.com>
 License-Expression: MIT
@@ -65,18 +65,23 @@ mud --diverged git pull
 ### Commands
 | Command                         | Description                                                                                                                       |
 |---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------|
-| `mud set-global`                | sets the current `.mudconfig` as a global configuration so it will be used as a fallback configuration to run from any directory. |
+| `mud init`                     | creates `.mudconfig` and adds repositories beneath the current directory. |
+| `mud configure`/`mud config`    | runs the interactive settings wizard. |
+| `mud help`/`mud --help`/`mud -h` | displays available commands and flags. |
+| `mud set-global [path]`         | sets the current `.mudconfig`, or the specified configuration path, as the fallback configuration to run from any directory. |
 | `mud get-config`                | prints the current `.mudconfig` location.                                                                                         |
 | `mud prune`                     | removes all invalid repositories from the `.mudconfig`.                                                                           |
 | `mud info`/`mud i`              | displays branch divergence and working directory changes.                                                                         |
 | `mud status`/`mud st`           | displays working directory changes.                                                                                               |
 | `mud log`/`mud l`               | displays the latest commit message, its time, and its author.                                                                     |
 | `mud labels`/`mud lb`           | displays mud labels across repositories.                                                                                          |
-| `mud branches`/`mud br`         | displays all branches in repositories.                                                                                            |
-| `mud remote-branches`/`mud rbr` | displays all remote branches in repositories.                                                                                     |
+| `mud branch`/`mud branches`/`mud br` | displays all branches in repositories.                                                                                        |
+| `mud remote-branch`/`mud remote-branches`/`mud rbr` | displays all remote branches in repositories.                                                               |
 | `mud complete-branch`           | prints unique current branch names across repositories for shell completion.                                                      |
 | `mud complete-branch-all`       | prints unique local and remote branch names across repositories for shell completion.                                             |
-| `mud tags`/`mud t`              | displays git tags in repositories.                                                                                                |
+| `mud completion carapace`       | exports a Carapace spec for all commands, aliases, flags, and native arguments; dynamically completes labels, local/remote branch names, and configured repository paths. |
+| `mud completion values`         | internal read-only Carapace callback; reads completion context from `C_ARG<n>` and `C_VALUE`, never executing command text. |
+| `mud tags`/`mud tag`/`mud t`     | displays git tags in repositories.                                                                                                |
 
 `--` format is also supported. An example would be `mud -- git status`.
 
@@ -87,11 +92,13 @@ mud --diverged git pull
 | Flag                                     | Description                                                                          |
 |------------------------------------------|--------------------------------------------------------------------------------------|
 | `-n=<str>` or `--name=<str>`             | includes repositories that contains provided string.                                 |
+| `-N=<str>` or `--not-name=<str>`         | excludes repositories whose path contains the provided string; repeat to exclude multiple substrings. |
 | `-l=<label>` or `--label=<label>`        | includes repositories with the provided label.                                       |
 | `-L=<label>` or `--not-label=<label>`    | excludes repositories with the provided label.                                       |
 | `-b=<branch>` or `--branch=<branch>`     | includes repositories with the provided branch.                                      |
 | `-B=<branch>` or `--not-branch=<branch>` | excludes repositories with the provided branch.                                      |
-| `-c` or `--command`                      | explicit command argument. Use this whenever you're trying to run a complex command. |
+| `-c="<command>"` or `--command="<command>"` | explicit shell command; no completion inside its value, but mud filters remain available in following arguments. |
+| `--`                                    | starts an opaque shell command; no mud completion or filtering after this separator. |
 | `-m` or `--modified`                     | filters out modified repositories.                                                   |
 | `-d` or `--diverged`                     | filters repositories with diverged branches.                                         |
 | `-t` or `--table`                        | toggles the default table view setting for execution.                                |
@@ -117,6 +124,18 @@ mud complete-branch
 mud complete-branch-all
 ```
 
+| Carapace Setup | Instructions |
+|----------------|--------------|
+| Requirements | Install `mud` and [Carapace](https://carapace-sh.github.io/carapace-bin/install.html) on `PATH`; the same spec works across Carapace-supported shells. |
+| Install Spec (Nushell, Linux) | `let specs = (($env.XDG_CONFIG_HOME? \| default ($nu.home-path \| path join .config)) \| path join carapace specs)`; `mkdir $specs`; `mud completion carapace \| save --force ($specs \| path join mud.yaml)` |
+| Install Spec (Bash/Zsh, Linux) | `mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}/carapace/specs"`; `mud completion carapace > "${XDG_CONFIG_HOME:-$HOME/.config}/carapace/specs/mud.yaml"` |
+| Nushell Hook | Follow [Carapace's Nushell setup](https://carapace-sh.github.io/carapace-bin/setup.html#nushell), or use `{\|spans\| carapace $spans.0 nushell ...$spans \| from json }` as your external completer; preserve empty results for mud rather than falling back to file or command completion. |
+| Bash/Zsh Hook | `source <(carapace _carapace)`; Zsh also requires `autoload -U compinit && compinit`. |
+| Fish Hook | `carapace _carapace fish \| source` |
+| Other Platforms/Shells | Install `mud.yaml` in [Carapace's user spec directory](https://carapace-sh.github.io/carapace-bin/spec/user.html), then follow the appropriate [shell setup](https://carapace-sh.github.io/carapace-bin/setup.html). Restart the shell after first installing the spec. |
+| Dynamic Values | Labels and paths come from the nearest ancestor `.mudconfig` or global fallback; branches include unique local and remote names with remote prefixes removed. Branch filters still match the current branch. No settings or repositories are written during completion. |
+| Command Boundaries | Complete mud filters before a command or `--`, or after a completed `-c="..."` argument. Arbitrary shell commands and alias arguments are not completed. |
+
 ## Settings
 
 Settings are stored at `~/.config/mud/settings.ini`.
@@ -150,7 +169,7 @@ You can modify your `.mudconfig` file using the following commands:
 
 | Command                     | Description                                    |
 |-----------------------------|------------------------------------------------|
-| `mud add <path>`            | adds a path without a label.                   |
-| `mud add <path> <label>`    | adds a path with an optional label.            |
-| `mud remove <path>`         | removes the directory with the specified path. |
-| `mud remove <path> <label>` | removes the label from a directory.            |
+| `mud add <path>`/`mud a <path>` | adds a path without a label.                |
+| `mud add <path> <label>`/`mud a <path> <label>` | adds a path with an optional label. |
+| `mud remove <path>`/`mud rm <path>` | removes the directory with the specified path. |
+| `mud remove <path> <label>`/`mud rm <path> <label>` | removes the label from a directory. |

{mud_git-1.1.7 → mud_git-1.1.8}/README.md

@@ -48,18 +48,23 @@ mud --diverged git pull
 ### Commands
 | Command                         | Description                                                                                                                       |
 |---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------|
-| `mud set-global`                | sets the current `.mudconfig` as a global configuration so it will be used as a fallback configuration to run from any directory. |
+| `mud init`                     | creates `.mudconfig` and adds repositories beneath the current directory. |
+| `mud configure`/`mud config`    | runs the interactive settings wizard. |
+| `mud help`/`mud --help`/`mud -h` | displays available commands and flags. |
+| `mud set-global [path]`         | sets the current `.mudconfig`, or the specified configuration path, as the fallback configuration to run from any directory. |
 | `mud get-config`                | prints the current `.mudconfig` location.                                                                                         |
 | `mud prune`                     | removes all invalid repositories from the `.mudconfig`.                                                                           |
 | `mud info`/`mud i`              | displays branch divergence and working directory changes.                                                                         |
 | `mud status`/`mud st`           | displays working directory changes.                                                                                               |
 | `mud log`/`mud l`               | displays the latest commit message, its time, and its author.                                                                     |
 | `mud labels`/`mud lb`           | displays mud labels across repositories.                                                                                          |
-| `mud branches`/`mud br`         | displays all branches in repositories.                                                                                            |
-| `mud remote-branches`/`mud rbr` | displays all remote branches in repositories.                                                                                     |
+| `mud branch`/`mud branches`/`mud br` | displays all branches in repositories.                                                                                        |
+| `mud remote-branch`/`mud remote-branches`/`mud rbr` | displays all remote branches in repositories.                                                               |
 | `mud complete-branch`           | prints unique current branch names across repositories for shell completion.                                                      |
 | `mud complete-branch-all`       | prints unique local and remote branch names across repositories for shell completion.                                             |
-| `mud tags`/`mud t`              | displays git tags in repositories.                                                                                                |
+| `mud completion carapace`       | exports a Carapace spec for all commands, aliases, flags, and native arguments; dynamically completes labels, local/remote branch names, and configured repository paths. |
+| `mud completion values`         | internal read-only Carapace callback; reads completion context from `C_ARG<n>` and `C_VALUE`, never executing command text. |
+| `mud tags`/`mud tag`/`mud t`     | displays git tags in repositories.                                                                                                |
 
 `--` format is also supported. An example would be `mud -- git status`.
 
@@ -70,11 +75,13 @@ mud --diverged git pull
 | Flag                                     | Description                                                                          |
 |------------------------------------------|--------------------------------------------------------------------------------------|
 | `-n=<str>` or `--name=<str>`             | includes repositories that contains provided string.                                 |
+| `-N=<str>` or `--not-name=<str>`         | excludes repositories whose path contains the provided string; repeat to exclude multiple substrings. |
 | `-l=<label>` or `--label=<label>`        | includes repositories with the provided label.                                       |
 | `-L=<label>` or `--not-label=<label>`    | excludes repositories with the provided label.                                       |
 | `-b=<branch>` or `--branch=<branch>`     | includes repositories with the provided branch.                                      |
 | `-B=<branch>` or `--not-branch=<branch>` | excludes repositories with the provided branch.                                      |
-| `-c` or `--command`                      | explicit command argument. Use this whenever you're trying to run a complex command. |
+| `-c="<command>"` or `--command="<command>"` | explicit shell command; no completion inside its value, but mud filters remain available in following arguments. |
+| `--`                                    | starts an opaque shell command; no mud completion or filtering after this separator. |
 | `-m` or `--modified`                     | filters out modified repositories.                                                   |
 | `-d` or `--diverged`                     | filters repositories with diverged branches.                                         |
 | `-t` or `--table`                        | toggles the default table view setting for execution.                                |
@@ -100,6 +107,18 @@ mud complete-branch
 mud complete-branch-all
 ```
 
+| Carapace Setup | Instructions |
+|----------------|--------------|
+| Requirements | Install `mud` and [Carapace](https://carapace-sh.github.io/carapace-bin/install.html) on `PATH`; the same spec works across Carapace-supported shells. |
+| Install Spec (Nushell, Linux) | `let specs = (($env.XDG_CONFIG_HOME? \| default ($nu.home-path \| path join .config)) \| path join carapace specs)`; `mkdir $specs`; `mud completion carapace \| save --force ($specs \| path join mud.yaml)` |
+| Install Spec (Bash/Zsh, Linux) | `mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}/carapace/specs"`; `mud completion carapace > "${XDG_CONFIG_HOME:-$HOME/.config}/carapace/specs/mud.yaml"` |
+| Nushell Hook | Follow [Carapace's Nushell setup](https://carapace-sh.github.io/carapace-bin/setup.html#nushell), or use `{\|spans\| carapace $spans.0 nushell ...$spans \| from json }` as your external completer; preserve empty results for mud rather than falling back to file or command completion. |
+| Bash/Zsh Hook | `source <(carapace _carapace)`; Zsh also requires `autoload -U compinit && compinit`. |
+| Fish Hook | `carapace _carapace fish \| source` |
+| Other Platforms/Shells | Install `mud.yaml` in [Carapace's user spec directory](https://carapace-sh.github.io/carapace-bin/spec/user.html), then follow the appropriate [shell setup](https://carapace-sh.github.io/carapace-bin/setup.html). Restart the shell after first installing the spec. |
+| Dynamic Values | Labels and paths come from the nearest ancestor `.mudconfig` or global fallback; branches include unique local and remote names with remote prefixes removed. Branch filters still match the current branch. No settings or repositories are written during completion. |
+| Command Boundaries | Complete mud filters before a command or `--`, or after a completed `-c="..."` argument. Arbitrary shell commands and alias arguments are not completed. |
+
 ## Settings
 
 Settings are stored at `~/.config/mud/settings.ini`.
@@ -133,7 +152,7 @@ You can modify your `.mudconfig` file using the following commands:
 
 | Command                     | Description                                    |
 |-----------------------------|------------------------------------------------|
-| `mud add <path>`            | adds a path without a label.                   |
-| `mud add <path> <label>`    | adds a path with an optional label.            |
-| `mud remove <path>`         | removes the directory with the specified path. |
-| `mud remove <path> <label>` | removes the label from a directory.            |
+| `mud add <path>`/`mud a <path>` | adds a path without a label.                |
+| `mud add <path> <label>`/`mud a <path> <label>` | adds a path with an optional label. |
+| `mud remove <path>`/`mud rm <path>` | removes the directory with the specified path. |
+| `mud remove <path> <label>`/`mud rm <path> <label>` | removes the label from a directory. |

{mud_git-1.1.7 → mud_git-1.1.8}/src/mud/__init__.py

@@ -2,15 +2,23 @@
 
 import mud.utils
 import mud.settings
+import sys
 
 from mud.app import App
+from mud.commands import COMPLETION
 
 
 def run():
 	try:
+		app: App = App()
+		if sys.argv[1:2] == COMPLETION:
+			from mud.completion import complete
+
+			complete(app.parser)
+			return
+
 		utils.settings = settings.Settings(utils.SETTINGS_FILE_NAME, utils.OLD_SETTINGS_FILE_NAME)
 
-		app: App = App()
 		app.run()
 	except KeyboardInterrupt:
 		utils.print_error(0)

{mud_git-1.1.7 → mud_git-1.1.8}/src/mud/app.py

@@ -51,6 +51,8 @@ class App:
 		subparsers.add_parser(REMOTE_BRANCHES[0], aliases=REMOTE_BRANCHES[1:], help='Displays all remote branches in repositories.')
 		subparsers.add_parser(COMPLETE_BRANCH[0], help='Prints unique current branch names across repositories for shell completion.')
 		subparsers.add_parser(COMPLETE_BRANCH_ALL[0], help='Prints unique local and remote branch names across repositories for shell completion.')
+		completion_parser = subparsers.add_parser(COMPLETION[0], help='Prints shell completion support.')
+		completion_parser.add_argument('shell', choices=['carapace', 'values'], help='Completion format (values is the Carapace callback).')
 		subparsers.add_parser(CONFIGURE[0], aliases=CONFIGURE[1:], help='Runs the interactive configuration wizard.')
 		subparsers.add_parser(GET_CONFIG[0], aliases=GET_CONFIG[1:], help='Prints current .mudconfig path.')
 		subparsers.add_parser(SET_GLOBAL[0], aliases=SET_GLOBAL[1:], help='Sets .mudconfig in the current repository as your fallback .mudconfig.')
@@ -65,13 +67,17 @@ class App:
 
 		subparsers.add_parser(PRUNE[0], help='Removes invalid paths from .mudconfig.')
 
-		parser.add_argument(*COMMAND_ATTR, metavar='COMMAND', help=f'Explicit command argument. Use this when you want to run a command that has a special characters.', nargs='?', default='', type=str)
-		parser.add_argument(*TABLE_ATTR, metavar='TABLE', help=f'Switches table view, runs in table view it is disabled in .mudsettings.', nargs='?', default='', type=str)
-		parser.add_argument(*NAME_PREFIX, metavar='NAME', help='Includes repositories where name contains provided value.', nargs='?', default='', type=str)
-		parser.add_argument(*LABEL_PREFIX, metavar='LABEL', help='Includes repositories with provided label.', nargs='?', default='', type=str)
-		parser.add_argument(*NOT_LABEL_PREFIX, metavar='NOT_LABEL', help=f'Excludes repositories with provided label.', nargs='?', default='', type=str)
-		parser.add_argument(*BRANCH_PREFIX, metavar='BRANCH', help='Includes repositories on a provided branch.', nargs='?', default='', type=str)
-		parser.add_argument(*NOT_BRANCH_PREFIX, metavar='NOT_BRANCH', help='Excludes repositories on a provided branch.', nargs='?', default='', type=str)
+		for prefixes, metavar, description in [
+			(COMMAND_ATTR, 'COMMAND', 'Explicit shell command; use for complex commands.'),
+			(NAME_PREFIX, 'NAME', 'Includes repositories where name contains provided value.'),
+			(NOT_NAME_PREFIX, 'NOT_NAME', 'Excludes repositories where name contains provided value.'),
+			(LABEL_PREFIX, 'LABEL', 'Includes repositories with provided label.'),
+			(NOT_LABEL_PREFIX, 'NOT_LABEL', 'Excludes repositories with provided label.'),
+			(BRANCH_PREFIX, 'BRANCH', 'Includes repositories on a provided branch.'),
+			(NOT_BRANCH_PREFIX, 'NOT_BRANCH', 'Excludes repositories on a provided branch.'),
+		]:
+			parser.add_argument(*(prefix.rstrip('=') for prefix in prefixes), metavar=metavar, help=description, default='', type=str)
+		parser.add_argument(*TABLE_ATTR, action='store_true', help='Toggles the table view setting for execution.')
 		parser.add_argument(*MODIFIED_ATTR, action='store_true', help='Filters modified repositories.')
 		parser.add_argument(*DIVERGED_ATTR, action='store_true', help='Filters repositories with diverged branches.')
 		parser.add_argument(*ASYNC_ATTR, action='store_true', help='Switches asynchronous run feature.')
@@ -229,6 +235,7 @@ class App:
 		include_labels = []
 		exclude_labels = []
 		contains_strings = []
+		not_contains_strings = []
 		include_branches = []
 		exclude_branches = []
 		modified = False
@@ -253,6 +260,10 @@ class App:
 				exclude_branches.append(arg.split('=', 1)[1])
 			elif any(arg.startswith(prefix) for prefix in NAME_PREFIX):
 				contains_strings.append(arg.split('=', 1)[1])
+			elif any(arg.startswith(prefix) for prefix in NOT_NAME_PREFIX):
+				value = arg.split('=', 1)[1]
+				if value:
+					not_contains_strings.append(value)
 			elif arg in MODIFIED_ATTR:
 				modified = True
 			elif arg in DIVERGED_ATTR:
@@ -297,6 +308,8 @@ class App:
 				delete = True
 			if any(contains_strings) and not any(substr in path for substr in contains_strings):
 				delete = True
+			if any(not_contains_strings) and any(substr in path for substr in not_contains_strings):
+				delete = True
 
 			if not delete and not repo.head_is_unborn and (any(include_branches) or any(exclude_branches)):
 				if any(include_branches) and repo.head.shorthand not in include_branches:

{mud_git-1.1.7 → mud_git-1.1.8}/src/mud/commands.py

@@ -12,12 +12,13 @@ BRANCHES = ['branch', 'branches', 'br']
 REMOTE_BRANCHES = ['remote-branch', 'remote-branches', 'rbr']
 COMPLETE_BRANCH = ['complete-branch']
 COMPLETE_BRANCH_ALL = ['complete-branch-all']
+COMPLETION = ['completion']
 HELP = ['help', '--help', '-h']
 CONFIGURE = ['configure', 'config']
 GET_CONFIG = ['get-config']
 SET_GLOBAL = ['set-global']
 
-COMMANDS = ADD + REMOVE + PRUNE + LOG + INFO + INIT + TAGS + LABELS + STATUS + BRANCHES + REMOTE_BRANCHES + COMPLETE_BRANCH + COMPLETE_BRANCH_ALL + HELP + CONFIGURE + SET_GLOBAL + GET_CONFIG
+COMMANDS = ADD + REMOVE + PRUNE + LOG + INFO + INIT + TAGS + LABELS + STATUS + BRANCHES + REMOTE_BRANCHES + COMPLETE_BRANCH + COMPLETE_BRANCH_ALL + COMPLETION + HELP + CONFIGURE + SET_GLOBAL + GET_CONFIG
 
 # Filters
 ASYNC_ATTR = '-a', '--async'
@@ -25,6 +26,7 @@ TABLE_ATTR = '-t', '--table'
 MODIFIED_ATTR = '-m', '--modified'
 DIVERGED_ATTR = '-d', '--diverged'
 NAME_PREFIX = '-n=', '--name='
+NOT_NAME_PREFIX = '-N=', '--not-name='
 LABEL_PREFIX = '-l=', '--label='
 COMMAND_ATTR = '-c=', '--command='
 BRANCH_PREFIX = '-b=', '--branch='

mud_git-1.1.8/src/mud/completion.py

@@ -0,0 +1,143 @@
+import configparser
+import io
+import os
+from argparse import ArgumentParser, _SubParsersAction
+from contextlib import redirect_stdout
+from pathlib import Path
+
+from pygit2 import GitError
+
+from mud import utils
+from mud.commands import (
+	ADD, REMOVE, SET_GLOBAL, CONFIGURE, COMPLETION, HELP, COMMAND_ATTR,
+	LABEL_PREFIX, NOT_LABEL_PREFIX, BRANCH_PREFIX, NOT_BRANCH_PREFIX,
+	NAME_PREFIX, NOT_NAME_PREFIX,
+)
+from mud.config import Config
+from mud.runner import Runner
+from mud.settings import Settings
+
+
+def complete(parser: ArgumentParser) -> None:
+	args = parser.parse_args()
+	if args.shell == 'carapace':
+		print('''name: mud
+description: Run commands across multiple repositories
+parsing: disabled
+completion:
+  positionalany:
+    - "$(mud completion values)"
+    - "$nospace(=/)"
+  dashany: []''')
+		return
+
+	arguments = []
+	while f'C_ARG{len(arguments)}' in os.environ:
+		arguments.append(os.environ[f'C_ARG{len(arguments)}'])
+	value = os.environ.get('C_VALUE', '')
+	try:
+		utils.settings = Settings(utils.SETTINGS_FILE_NAME, utils.OLD_SETTINGS_FILE_NAME, read_only=True)
+		candidates = _candidates(parser, arguments, value)
+	except (OSError, ValueError, configparser.Error, GitError):
+		return
+
+	for candidate, description in sorted(set(candidates), key=lambda item: (item[0].casefold(), item[0])):
+		if candidate.startswith(value) and candidate.isprintable():
+			description = ''.join(char if char.isprintable() else ' ' for char in description)
+			print(f'{candidate}\t{description}')
+
+
+def _repositories() -> dict[str, list[str]]:
+	config = Config()
+	directory, _ = config.find()
+	if not directory:
+		return {}
+
+	previous_directory = os.getcwd()
+	try:
+		os.chdir(directory)
+		# Missing paths must not turn diagnostics into completion candidates.
+		with redirect_stdout(io.StringIO()):
+			config.load(os.path.join(directory, utils.CONFIG_FILE_NAME))
+	except (OSError, ValueError, IndexError):
+		return {}
+	finally:
+		os.chdir(previous_directory)
+	return config.data
+
+
+def _candidates(parser: ArgumentParser, arguments: list[str], value: str) -> list[tuple[str, str]]:
+	if '--' in arguments:
+		return []
+	subparsers = next(action.choices for action in parser._actions if isinstance(action, _SubParsersAction))
+	explicit_command = False
+	for index, argument in enumerate(arguments):
+		if argument.startswith(COMMAND_ATTR):
+			explicit_command = True
+		if not argument.startswith('-'):
+			if explicit_command:
+				return []
+			positionals = arguments[index:]
+			if argument in SET_GLOBAL + CONFIGURE + COMPLETION + HELP and index != 0:
+				return []
+			if value.startswith('-') and argument in subparsers and argument not in SET_GLOBAL + CONFIGURE:
+				return [
+					(flag, action.help or '') for action in subparsers[argument]._actions
+					for flag in action.option_strings
+				]
+			if argument in COMPLETION and len(positionals) == 1:
+				return [('carapace', 'Export the Carapace spec')]
+			if argument in ADD + REMOVE and len(positionals) == 2:
+				return [(label, 'Label') for labels in _repositories().values() for label in labels]
+			if argument in REMOVE and len(positionals) == 1:
+				return [(path, 'Repository') for path in _repositories()]
+			if argument in ADD + SET_GLOBAL and len(positionals) == 1:
+				parent = os.path.dirname(value)
+				directory = Path(parent or '.').expanduser()
+				if argument in ADD:
+					directory = Path(Config.find()[0]) / directory
+				return [
+					(os.path.join(parent, path.name) + ('/' if path.is_dir() else ''), '')
+					for path in directory.iterdir()
+					if argument in SET_GLOBAL or path.is_dir()
+				]
+			return []
+
+	if value.startswith(COMMAND_ATTR):
+		return []
+	if value.startswith(LABEL_PREFIX + NOT_LABEL_PREFIX + NAME_PREFIX + NOT_NAME_PREFIX):
+		prefix = value.split('=', 1)[0] + '='
+		repos = _repositories()
+		if value.startswith(LABEL_PREFIX + NOT_LABEL_PREFIX):
+			return [(prefix + label, 'Label') for labels in repos.values() for label in labels]
+		return [(prefix + path, 'Repository') for path in repos]
+	if value.startswith(BRANCH_PREFIX + NOT_BRANCH_PREFIX):
+		prefix = value.split('=', 1)[0] + '='
+		directory, _ = Config.find()
+		branches = []
+		for path in _repositories():
+			path = os.path.join(directory, path)
+			if not os.path.isdir(os.path.join(path, '.git')):
+				continue
+			try:
+				branches.extend(Runner._get_unique_branch_names([path], include_remote=True))
+			except (OSError, ValueError, GitError):
+				continue
+		return [(prefix + branch, 'Branch') for branch in branches]
+
+	candidates = []
+	for action in parser._actions:
+		candidates.extend((flag + ('=' if action.nargs != 0 else ''), action.help or '') for flag in action.option_strings)
+		if isinstance(action, _SubParsersAction) and not explicit_command and not value.startswith('-'):
+			for command in action._choices_actions:
+				candidates.extend(
+					(name, command.help or '') for name, subparser in action.choices.items()
+					if subparser is action.choices[command.dest]
+					and not (arguments and name in SET_GLOBAL + CONFIGURE + COMPLETION)
+				)
+	if not explicit_command and not value.startswith('-'):
+		if not arguments:
+			candidates.append((HELP[0], 'Show help'))
+		candidates.extend((alias, command) for alias, command in (utils.settings.alias_settings or {}).items())
+	candidates.append(('--', 'Run an opaque shell command'))
+	return candidates

{mud_git-1.1.7 → mud_git-1.1.8}/src/mud/settings.py

@@ -6,7 +6,7 @@ ALIAS_SCOPE = 'alias'
 
 
 class Settings:
-	def __init__(self, file_name: str, old_file_name: str) -> None:
+	def __init__(self, file_name: str, old_file_name: str, read_only: bool = False) -> None:
 		use_old = os.path.exists(os.path.join(os.path.expanduser('~'), old_file_name))
 		file_name = old_file_name if use_old else file_name
 		directory = os.path.expanduser('~' if use_old else '~/.config/mud')
@@ -15,6 +15,7 @@ class Settings:
 		self.alias_settings = None
 		self.config = configparser.ConfigParser()
 		self.settings_file = os.path.join(directory, file_name)
+		self.read_only = read_only
 		self.defaults = {
 			'mud': {
 				'config_path': '',
@@ -38,7 +39,8 @@ class Settings:
 	def load_settings(self) -> None:
 		if not os.path.exists(self.settings_file):
 			self.config.read_dict(self.defaults)
-			self.save()
+			if not self.read_only:
+				self.save()
 		else:
 			self.config.read(self.settings_file)
 

{mud_git-1.1.7 → mud_git-1.1.8}/src/mud_git.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mud-git
-Version: 1.1.7
+Version: 1.1.8
 Summary: Multi repository git utility. Manage multiple git-repositories simultaneously.
 Author-email: Jasur Sadikov <jasur@sadikoff.com>
 License-Expression: MIT
@@ -65,18 +65,23 @@ mud --diverged git pull
 ### Commands
 | Command                         | Description                                                                                                                       |
 |---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------|
-| `mud set-global`                | sets the current `.mudconfig` as a global configuration so it will be used as a fallback configuration to run from any directory. |
+| `mud init`                     | creates `.mudconfig` and adds repositories beneath the current directory. |
+| `mud configure`/`mud config`    | runs the interactive settings wizard. |
+| `mud help`/`mud --help`/`mud -h` | displays available commands and flags. |
+| `mud set-global [path]`         | sets the current `.mudconfig`, or the specified configuration path, as the fallback configuration to run from any directory. |
 | `mud get-config`                | prints the current `.mudconfig` location.                                                                                         |
 | `mud prune`                     | removes all invalid repositories from the `.mudconfig`.                                                                           |
 | `mud info`/`mud i`              | displays branch divergence and working directory changes.                                                                         |
 | `mud status`/`mud st`           | displays working directory changes.                                                                                               |
 | `mud log`/`mud l`               | displays the latest commit message, its time, and its author.                                                                     |
 | `mud labels`/`mud lb`           | displays mud labels across repositories.                                                                                          |
-| `mud branches`/`mud br`         | displays all branches in repositories.                                                                                            |
-| `mud remote-branches`/`mud rbr` | displays all remote branches in repositories.                                                                                     |
+| `mud branch`/`mud branches`/`mud br` | displays all branches in repositories.                                                                                        |
+| `mud remote-branch`/`mud remote-branches`/`mud rbr` | displays all remote branches in repositories.                                                               |
 | `mud complete-branch`           | prints unique current branch names across repositories for shell completion.                                                      |
 | `mud complete-branch-all`       | prints unique local and remote branch names across repositories for shell completion.                                             |
-| `mud tags`/`mud t`              | displays git tags in repositories.                                                                                                |
+| `mud completion carapace`       | exports a Carapace spec for all commands, aliases, flags, and native arguments; dynamically completes labels, local/remote branch names, and configured repository paths. |
+| `mud completion values`         | internal read-only Carapace callback; reads completion context from `C_ARG<n>` and `C_VALUE`, never executing command text. |
+| `mud tags`/`mud tag`/`mud t`     | displays git tags in repositories.                                                                                                |
 
 `--` format is also supported. An example would be `mud -- git status`.
 
@@ -87,11 +92,13 @@ mud --diverged git pull
 | Flag                                     | Description                                                                          |
 |------------------------------------------|--------------------------------------------------------------------------------------|
 | `-n=<str>` or `--name=<str>`             | includes repositories that contains provided string.                                 |
+| `-N=<str>` or `--not-name=<str>`         | excludes repositories whose path contains the provided string; repeat to exclude multiple substrings. |
 | `-l=<label>` or `--label=<label>`        | includes repositories with the provided label.                                       |
 | `-L=<label>` or `--not-label=<label>`    | excludes repositories with the provided label.                                       |
 | `-b=<branch>` or `--branch=<branch>`     | includes repositories with the provided branch.                                      |
 | `-B=<branch>` or `--not-branch=<branch>` | excludes repositories with the provided branch.                                      |
-| `-c` or `--command`                      | explicit command argument. Use this whenever you're trying to run a complex command. |
+| `-c="<command>"` or `--command="<command>"` | explicit shell command; no completion inside its value, but mud filters remain available in following arguments. |
+| `--`                                    | starts an opaque shell command; no mud completion or filtering after this separator. |
 | `-m` or `--modified`                     | filters out modified repositories.                                                   |
 | `-d` or `--diverged`                     | filters repositories with diverged branches.                                         |
 | `-t` or `--table`                        | toggles the default table view setting for execution.                                |
@@ -117,6 +124,18 @@ mud complete-branch
 mud complete-branch-all
 ```
 
+| Carapace Setup | Instructions |
+|----------------|--------------|
+| Requirements | Install `mud` and [Carapace](https://carapace-sh.github.io/carapace-bin/install.html) on `PATH`; the same spec works across Carapace-supported shells. |
+| Install Spec (Nushell, Linux) | `let specs = (($env.XDG_CONFIG_HOME? \| default ($nu.home-path \| path join .config)) \| path join carapace specs)`; `mkdir $specs`; `mud completion carapace \| save --force ($specs \| path join mud.yaml)` |
+| Install Spec (Bash/Zsh, Linux) | `mkdir -p "${XDG_CONFIG_HOME:-$HOME/.config}/carapace/specs"`; `mud completion carapace > "${XDG_CONFIG_HOME:-$HOME/.config}/carapace/specs/mud.yaml"` |
+| Nushell Hook | Follow [Carapace's Nushell setup](https://carapace-sh.github.io/carapace-bin/setup.html#nushell), or use `{\|spans\| carapace $spans.0 nushell ...$spans \| from json }` as your external completer; preserve empty results for mud rather than falling back to file or command completion. |
+| Bash/Zsh Hook | `source <(carapace _carapace)`; Zsh also requires `autoload -U compinit && compinit`. |
+| Fish Hook | `carapace _carapace fish \| source` |
+| Other Platforms/Shells | Install `mud.yaml` in [Carapace's user spec directory](https://carapace-sh.github.io/carapace-bin/spec/user.html), then follow the appropriate [shell setup](https://carapace-sh.github.io/carapace-bin/setup.html). Restart the shell after first installing the spec. |
+| Dynamic Values | Labels and paths come from the nearest ancestor `.mudconfig` or global fallback; branches include unique local and remote names with remote prefixes removed. Branch filters still match the current branch. No settings or repositories are written during completion. |
+| Command Boundaries | Complete mud filters before a command or `--`, or after a completed `-c="..."` argument. Arbitrary shell commands and alias arguments are not completed. |
+
 ## Settings
 
 Settings are stored at `~/.config/mud/settings.ini`.
@@ -150,7 +169,7 @@ You can modify your `.mudconfig` file using the following commands:
 
 | Command                     | Description                                    |
 |-----------------------------|------------------------------------------------|
-| `mud add <path>`            | adds a path without a label.                   |
-| `mud add <path> <label>`    | adds a path with an optional label.            |
-| `mud remove <path>`         | removes the directory with the specified path. |
-| `mud remove <path> <label>` | removes the label from a directory.            |
+| `mud add <path>`/`mud a <path>` | adds a path without a label.                |
+| `mud add <path> <label>`/`mud a <path> <label>` | adds a path with an optional label. |
+| `mud remove <path>`/`mud rm <path>` | removes the directory with the specified path. |
+| `mud remove <path> <label>`/`mud rm <path> <label>` | removes the label from a directory. |

{mud_git-1.1.7 → mud_git-1.1.8}/src/mud_git.egg-info/SOURCES.txt

@@ -14,6 +14,7 @@ src/mud/__init__.py
 src/mud/__main__.py
 src/mud/app.py
 src/mud/commands.py
+src/mud/completion.py
 src/mud/config.py
 src/mud/runner.py
 src/mud/settings.py
@@ -29,6 +30,7 @@ src/mud_git.egg-info/scm_version.json
 src/mud_git.egg-info/top_level.txt
 tests/conftest.py
 tests/helpers.py
+tests/test_completion.py
 tests/test_config.py
 tests/test_display.py
 tests/test_filters.py

{mud_git-1.1.7 → mud_git-1.1.8}/src/mud_git.egg-info/scm_file_list.json

@@ -16,6 +16,7 @@
     "src/mud/__main__.py",
     "src/mud/app.py",
     "src/mud/commands.py",
+    "src/mud/completion.py",
     "src/mud/config.py",
     "src/mud/runner.py",
     "src/mud/settings.py",
@@ -23,6 +24,7 @@
     "src/mud/utils.py",
     "tests/conftest.py",
     "tests/helpers.py",
+    "tests/test_completion.py",
     "tests/test_config.py",
     "tests/test_display.py",
     "tests/test_filters.py",

mud_git-1.1.8/src/mud_git.egg-info/scm_version.json

@@ -0,0 +1,8 @@
+{
+  "tag": "1.1.8",
+  "distance": 0,
+  "node": "g1cc3dd62f361e5e13d6c3979cc1a747db28a846d",
+  "dirty": false,
+  "branch": "HEAD",
+  "node_date": "2026-09-14"
+}

mud_git-1.1.8/tests/test_completion.py

@@ -0,0 +1,232 @@
+import json
+import os
+import shutil
+import subprocess
+import sys
+from pathlib import Path
+
+import pytest
+
+from helpers import make_detached_repo, make_empty_repo, make_git_repo, run_mud
+
+
+@pytest.fixture
+def complete(repos_labeled: Path, home: Path):
+	def invoke(*arguments, cwd=repos_labeled):
+		env = {key: value for key, value in os.environ.items() if not key.startswith('C_ARG')}
+		env['HOME'] = str(home)
+		env['C_VALUE'] = arguments[-1]
+		env.update({f'C_ARG{index}': argument for index, argument in enumerate(arguments[:-1])})
+		result = subprocess.run(
+			[sys.executable, '-m', 'mud', 'completion', 'values'],
+			cwd=cwd, env=env, capture_output=True, text=True, check=True,
+		)
+		assert result.stderr == ''
+		return [line.split('\t', 1)[0] for line in result.stdout.splitlines()]
+	return invoke
+
+
+def test_command_and_flag_inventory(complete):
+	from mud.app import App
+	from mud.commands import COMMANDS
+
+	values = complete('')
+	assert set(COMMANDS) <= set(values)
+	for action in App._create_parser()._actions:
+		assert {flag + ('=' if action.nargs != 0 else '') for flag in action.option_strings} <= set(values)
+	assert {'fetch', 'pull', 'push', '--'} <= set(values)
+	assert '-l=' in complete('-l')
+	assert '--not-name=' in complete('--not-n')
+	assert complete('completion', '') == ['carapace']
+
+
+@pytest.mark.parametrize('prefix', ['-l=', '-L=', '--label=', '--not-label='])
+def test_label_values(complete, repos_labeled: Path, prefix):
+	(repos_labeled / '.mudconfig').write_text('repo_a\twork, shared\nrepo_b\tpersonal,shared\n')
+	assert complete(prefix) == [prefix + label for label in ['personal', 'shared', 'work']]
+	assert complete('-l=work', prefix + 'sh') == [prefix + 'shared']
+
+
+@pytest.mark.parametrize('prefix', ['-n=', '-N=', '--name=', '--not-name='])
+def test_name_values(complete, repos_labeled: Path, prefix):
+	(repos_labeled / 'repo_a').rename(repos_labeled / 'repo with spaces')
+	(repos_labeled / '.mudconfig').write_text('repo with spaces\twork\nrepo_b\tpersonal\n')
+	assert complete(prefix) == [prefix + 'repo with spaces', prefix + 'repo_b']
+
+
+@pytest.mark.parametrize('prefix', ['-b=', '-B=', '--branch=', '--not-branch='])
+def test_all_branch_values(complete, repos_labeled: Path, prefix):
+	for name in ['repo_a', 'repo_b']:
+		path = repos_labeled / name
+		for command in [
+			['branch', '-M', 'master'],
+			['branch', 'feature/inactive'],
+			['update-ref', 'refs/remotes/origin/release/remote', 'HEAD'],
+			['symbolic-ref', 'refs/remotes/origin/HEAD', 'refs/remotes/origin/release/remote'],
+		]:
+			subprocess.run(['git', *command], cwd=path, capture_output=True, check=True)
+	assert complete(prefix) == [prefix + name for name in ['feature/inactive', 'master', 'release/remote']]
+	assert complete(prefix + 'feature/') == [prefix + 'feature/inactive']
+
+
+@pytest.mark.parametrize('arguments', [
+	('--', ''), ('--', '-l='), ('--', 'git', ''),
+	('-c=',), ('--command=git ',), ('-c=git status', 'git', ''),
+	('git', ''), ('git', '-l='), ('fetch', ''), ('status', '-l='), ('add', '--', ''),
+	('-l=work', 'completion', ''),
+	('add', 'repo_a', 'work', ''),
+])
+def test_opaque_commands(complete, arguments):
+	assert complete(*arguments) == []
+
+
+def test_filters_after_explicit_command(complete):
+	values = complete('-c=git status', '')
+	assert '-l=' in values
+	assert not {'status', 'fetch', 'init'} & set(values)
+	assert complete('--command=git status', '-L=') == ['-L=label_a', '-L=label_b']
+
+
+def test_native_positionals(complete, repos_labeled: Path):
+	assert complete('remove', '') == ['repo_a', 'repo_b']
+	assert complete('rm', 'repo_a', '') == ['label_a', 'label_b']
+	assert complete('a', 'repo_') == ['repo_a/', 'repo_b/']
+	assert complete('add', 'repo_a', 'label_') == ['label_a', 'label_b']
+	assert complete('set-global', '.mud') == ['.mudconfig']
+	assert complete('add', 'repo_', cwd=repos_labeled / 'repo_a') == ['repo_a/', 'repo_b/']
+	assert complete('status', '--h') == ['--help']
+	assert 'completion' not in complete('-l=work', '')
+
+
+def test_read_only_discovery(complete, repos_labeled: Path, home: Path, tmp_path_factory):
+	assert complete('-l=', cwd=repos_labeled / 'repo_a') == ['-l=label_a', '-l=label_b']
+	assert not (home / '.config').exists()
+	settings = home / '.config' / 'mud' / 'settings.ini'
+	settings.parent.mkdir(parents=True)
+	settings.write_text(f'[mud]\nconfig_path = {repos_labeled / ".mudconfig"}\n[alias]\nto = git checkout\n')
+	assert complete('-n=', cwd=tmp_path_factory.mktemp('outside-config')) == ['-n=repo_a', '-n=repo_b']
+	assert 'to' in complete('')
+
+
+def test_invalid_and_empty_configs(complete, repos_labeled: Path, home: Path):
+	config = repos_labeled / '.mudconfig'
+	config.unlink()
+	assert complete('-l=', cwd=home) == []
+	config.write_text('missing\tbad\nrepo_a\tgood\n')
+	assert complete('-l=') == ['-l=good']
+	for contents in ['', '\n', 'missing\tbad\n']:
+		config.write_text(contents)
+		assert complete('-b=') == []
+		assert complete('-l=') == []
+
+
+def test_unborn_and_detached_repositories(complete, repos_labeled: Path):
+	make_empty_repo(repos_labeled / 'unborn')
+	make_detached_repo(repos_labeled / 'detached')
+	(repos_labeled / '.mudconfig').write_text('unborn\tx\ndetached\ty\n')
+	assert complete('-l=') == ['-l=x', '-l=y']
+	assert all('HEAD' not in value for value in complete('-b='))
+
+
+@pytest.fixture
+def carapace(repos_labeled: Path, home: Path):
+	if not shutil.which('carapace'):
+		pytest.skip('carapace is not installed')
+	spec = run_mud('completion', 'carapace', cwd=home, home=home)
+	assert spec.returncode == 0, spec.stderr
+	assert not (home / '.config').exists()
+	spec_directory = home / '.config' / 'carapace' / 'specs'
+	spec_directory.mkdir(parents=True)
+	(spec_directory / 'mud.yaml').write_text(spec.stdout)
+	env = os.environ.copy()
+	env.update({
+		'HOME': str(home), 'XDG_CONFIG_HOME': str(home / '.config'),
+		'XDG_CACHE_HOME': str(home / '.cache'), 'CARAPACE_BRIDGES': '',
+		'PATH': str(Path(sys.executable).parent) + os.pathsep + env['PATH'],
+	})
+
+	def invoke(*arguments, shell='export'):
+		result = subprocess.run(
+			['carapace', 'mud', shell, 'mud', *arguments], cwd=repos_labeled,
+			env=env, capture_output=True, text=True, check=True,
+		)
+		assert result.stderr == ''
+		return json.loads(result.stdout) if shell in ['export', 'nushell'] else result.stdout
+	return invoke
+
+
+def test_carapace_protocol(carapace):
+	result = carapace('-l=')
+	assert [value['value'] for value in result['values']] == ['-l=label_a', '-l=label_b']
+	assert all(value['description'] == 'Label' for value in result['values'])
+
+
+@pytest.mark.parametrize('prefix', [
+	'-l=', '-L=', '--label=', '--not-label=',
+	'-n=', '-N=', '--name=', '--not-name=',
+	'-b=', '-B=', '--branch=', '--not-branch=',
+])
+def test_carapace_dynamic_flags(carapace, complete, prefix):
+	assert [item['value'] for item in carapace(prefix)['values']] == complete(prefix)
+
+
+@pytest.mark.parametrize('arguments', [
+	('--', ''), ('--', '-l='), ('--', 'git', ''),
+	('-c=',), ('--command=git ',), ('git', ''), ('git', '-l='),
+])
+def test_carapace_opaque_commands(carapace, arguments):
+	assert carapace(*arguments)['values'] == []
+	assert carapace(*arguments, shell='nushell') == []
+
+
+def test_carapace_filters_after_command(carapace):
+	values = {item['value'] for item in carapace('-c=git status', '')['values']}
+	assert {'-l=', '--not-name='} <= values
+	assert not {'status', 'fetch'} & values
+	assert [item['value'] for item in carapace('-c=git status', '-N=')['values']] == ['-N=repo_a', '-N=repo_b']
+
+
+@pytest.mark.parametrize('shell', ['nushell', 'bash', 'zsh', 'fish'])
+def test_carapace_shell_formats(carapace, shell):
+	result = carapace('-l=label_a', shell=shell)
+	if shell == 'nushell':
+		assert [item['value'] for item in result] == ['-l=label_a ']
+	else:
+		assert '-l=label_a' in result
+
+
+def test_carapace_quoting_and_no_execution(carapace, repos_labeled: Path, home: Path):
+	(repos_labeled / 'repo_a').rename(repos_labeled / 'repo with spaces')
+	(repos_labeled / '.mudconfig').write_text('repo with spaces\twork\nrepo_b\tpersonal\n')
+	values = carapace('-n=', shell='nushell')
+	assert [item['value'] for item in values] == ['"-n=repo with spaces" ', '-n=repo_b ']
+	assert [item['value'] for item in carapace('-n', shell='nushell')] == ['-n=']
+	marker = home / 'executed'
+	for command in [f'$(touch {marker})', f'`touch {marker}`', f'"; touch {marker}; #']:
+		assert carapace('-c=' + command)['values'] == []
+		assert len(carapace('-c=' + command, '-l=')['values']) == 2
+		assert carapace('--', command, '')['values'] == []
+	assert not marker.exists()
+	assert not (home / '.config' / 'mud').exists()
+
+
+def test_nushell_completion_round_trip(carapace, repos_labeled: Path, home: Path):
+	if not shutil.which('nu'):
+		pytest.skip('nushell is not installed')
+	(repos_labeled / 'repo_a').rename(repos_labeled / 'repo with spaces')
+	(repos_labeled / '.mudconfig').write_text('repo with spaces\twork\n')
+	value = carapace('-n=', shell='nushell')[0]['value']
+	result = subprocess.run(
+		['nu', '--no-config-file', '-c',
+		 f'^{sys.executable} -c \'import json, sys; print(json.dumps(sys.argv[1:]))\' {value}'],
+		cwd=home, env={**os.environ, 'HOME': str(home), 'XDG_CONFIG_HOME': str(home / '.config')},
+		capture_output=True, text=True, check=True,
+	)
+	assert json.loads(result.stdout) == ['-n=repo with spaces']
+
+
+def test_carapace_alias_description_is_single_line(carapace, home: Path):
+	(home / '.mudsettings').write_text('[alias]\ncustom = git status\n forged-token\tForged description\x1b\n')
+	values = carapace('')['values']
+	assert 'forged-token' not in {item['value'] for item in values}
+	assert all('\x1b' not in item['description'] for item in values)

{mud_git-1.1.7 → mud_git-1.1.8}/tests/test_filters.py

@@ -5,6 +5,7 @@ All shell commands here use -a to run in ordered mode so the output is
 straightforward to assert on.
 """
 import subprocess
+import pytest
 from pathlib import Path
 from helpers import run_mud
 
@@ -41,6 +42,41 @@ def test_name_filter(repos: Path, home: Path):
 	assert "repo_b" not in result.stdout
 
 
+@pytest.mark.parametrize("command", [
+	("status",),
+	("echo", "hello"),
+	("--", "echo", "hello"),
+	("-c=echo hello",),
+], ids=["native", "passthrough", "separator", "explicit-command"])
+@pytest.mark.parametrize("filters, expected", [
+	(("-N=po_a",), ("repo_b",)),
+	(("--not-name=po_b",), ("repo_a",)),
+	(("-N=po_a", "-N=po_b"), ()),
+	(("--not-name=po_a", "--not-name=po_b"), ()),
+	(("-N=po_a", "--not-name=po_b"), ()),
+	(("-n=repo", "-N=po_a"), ("repo_b",)),
+	(("--name=repo", "--not-name=po_b"), ("repo_a",)),
+	(("-n=po_a", "-N=po_a"), ()),
+	(("-N=missing",), ("repo_a", "repo_b")),
+	(("--not-name=PO_A",), ("repo_a", "repo_b")),
+	(("-N=",), ("repo_a", "repo_b")),
+	(("-N=", "-N=repo_a"), ("repo_b",)),
+])
+def test_name_exclude_filter(repos: Path, home: Path, command, filters, expected):
+	result = run_mud("-a", *filters, *command, cwd=repos, home=home)
+	assert result.returncode == 0, result.stderr
+	for name in ("repo_a", "repo_b"):
+		assert (name in result.stdout) == (name in expected), result.stdout
+
+
+@pytest.mark.parametrize('flag', ['-t', '--table', '-n=', '-N=', '-l=', '-L=', '-b=', '-B='])
+def test_flags_do_not_consume_native_command(repos: Path, home: Path, flag):
+	result = run_mud(flag, 'status', cwd=repos, home=home)
+	assert result.returncode == 0, result.stderr
+	assert 'repo_a' in result.stdout
+	assert 'repo_b' in result.stdout
+
+
 def test_branch_filter(repos_labeled: Path, home: Path):
 	"""-b=<branch> restricts execution to repos currently on that branch."""
 	# Put repo_a on a feature branch; repo_b stays on the default branch.

mud_git-1.1.7/src/mud_git.egg-info/scm_version.json

@@ -1,8 +0,0 @@
-{
-  "tag": "1.1.7",
-  "distance": 0,
-  "node": "ge2409c646f484a43da494781859f961bb3c79713",
-  "dirty": false,
-  "branch": "HEAD",
-  "node_date": "2026-08-16"
-}