git-rexec 1.0.2__tar.gz → 1.0.3__tar.gz

{git_rexec-1.0.2/git_rexec.egg-info → git_rexec-1.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-rexec
-Version: 1.0.2
+Version: 1.0.3
 Summary: Locate Git repositories and execute commands against them in parallel.
 Author: James Cherti
 License-Expression: GPL-3.0-or-later
@@ -101,7 +101,7 @@ pip install colorama setproctitle
 ## Usage
 
 ```bash
-git-rexec [OPTIONS] [exec_cmd ...]
+git-rexec [OPTIONS] -- [exec_cmd ...]
 ```
 
 *(Assuming the `git-rexec` script is executable and in your PATH.)*
@@ -112,14 +112,31 @@ git-rexec [OPTIONS] [exec_cmd ...]
 
 ### Options
 
-- `-C, --directory <path>`: The root directory to start searching for Git repositories. Defaults to the current working directory (`.`).
-- `--exclude-dir <path>`: Exclude a specific directory and all of its subdirectories from the search. This option can be provided multiple times.
-- `-p, --parallel`: Execute the command in parallel using threads.
-- `-i, --if-exec <command>`: Execute the main command only if this check command returns an exit code of `0`.
-- `-j, --jobs <int>`: The maximum number of concurrent workers/processors to use for parallel execution. Defaults to the number of CPU cores available.
-- `-s, --include-sub-repos`: Include sub-repositories (e.g., Git worktrees and submodules) in the search target list.
-- `-h, --help`: Show the help message and exit.
-- `-q, --quiet`: Quiet mode. Suppresses the informational tracking headers (`[EXEC]` and `[EXEC-P]`) that prefix execution output. In sequential mode, it hides the `[EXEC]` repository delimiter line entirely; in parallel mode (`-p`), it strips the yellow `[EXEC-P]` header track and removes the four-space indentation, printing only the raw, unindented stdout and stderr streams. This flag has no effect when no execution command is supplied, allowing discovered repository paths to print normally.
+```
+usage: git-rexec [-h] [-C DIRECTORY] [--exclude-dir EXCLUDE_DIR] [-p] [-i IF_EXEC] [-j MAX_WORKERS] [-q] [-s] [--print] [--print0] [exec_cmd ...]
+
+Find Git repositories and execute commands against them in parallel.
+
+positional arguments:
+  exec_cmd              The command to execute. You can use -- to pass options.
+
+options:
+  -h, --help            show this help message and exit
+  -C, --directory DIRECTORY
+                        Root directory to search (defaults to current directory)
+  --exclude-dir EXCLUDE_DIR
+                        Exclude a specific directory and all of its subdirectories
+  -p, --parallel        Execute the command in parallel using threads
+  -i, --if-exec IF_EXEC
+                        Execute commands only if this check returns exit code 0.
+  -j, --jobs MAX_WORKERS
+                        Maximum number of processors/workers to use
+  -q, --quiet           Quiet mode. Suppresses the informational log prefixes ([EXEC] and [EXEC-P]) that precede execution output.
+  -s, --include-sub-repos
+                        Include sub-repositories (e.g., Git worktrees and submodules)
+  --print               Print the paths (only when no command is provided)
+  --print0              Separate the paths with a null character (only when no command is provided)
+```
 
 ## License
 

{git_rexec-1.0.2 → git_rexec-1.0.3}/README.md

@@ -83,7 +83,7 @@ pip install colorama setproctitle
 ## Usage
 
 ```bash
-git-rexec [OPTIONS] [exec_cmd ...]
+git-rexec [OPTIONS] -- [exec_cmd ...]
 ```
 
 *(Assuming the `git-rexec` script is executable and in your PATH.)*
@@ -94,14 +94,31 @@ git-rexec [OPTIONS] [exec_cmd ...]
 
 ### Options
 
-- `-C, --directory <path>`: The root directory to start searching for Git repositories. Defaults to the current working directory (`.`).
-- `--exclude-dir <path>`: Exclude a specific directory and all of its subdirectories from the search. This option can be provided multiple times.
-- `-p, --parallel`: Execute the command in parallel using threads.
-- `-i, --if-exec <command>`: Execute the main command only if this check command returns an exit code of `0`.
-- `-j, --jobs <int>`: The maximum number of concurrent workers/processors to use for parallel execution. Defaults to the number of CPU cores available.
-- `-s, --include-sub-repos`: Include sub-repositories (e.g., Git worktrees and submodules) in the search target list.
-- `-h, --help`: Show the help message and exit.
-- `-q, --quiet`: Quiet mode. Suppresses the informational tracking headers (`[EXEC]` and `[EXEC-P]`) that prefix execution output. In sequential mode, it hides the `[EXEC]` repository delimiter line entirely; in parallel mode (`-p`), it strips the yellow `[EXEC-P]` header track and removes the four-space indentation, printing only the raw, unindented stdout and stderr streams. This flag has no effect when no execution command is supplied, allowing discovered repository paths to print normally.
+```
+usage: git-rexec [-h] [-C DIRECTORY] [--exclude-dir EXCLUDE_DIR] [-p] [-i IF_EXEC] [-j MAX_WORKERS] [-q] [-s] [--print] [--print0] [exec_cmd ...]
+
+Find Git repositories and execute commands against them in parallel.
+
+positional arguments:
+  exec_cmd              The command to execute. You can use -- to pass options.
+
+options:
+  -h, --help            show this help message and exit
+  -C, --directory DIRECTORY
+                        Root directory to search (defaults to current directory)
+  --exclude-dir EXCLUDE_DIR
+                        Exclude a specific directory and all of its subdirectories
+  -p, --parallel        Execute the command in parallel using threads
+  -i, --if-exec IF_EXEC
+                        Execute commands only if this check returns exit code 0.
+  -j, --jobs MAX_WORKERS
+                        Maximum number of processors/workers to use
+  -q, --quiet           Quiet mode. Suppresses the informational log prefixes ([EXEC] and [EXEC-P]) that precede execution output.
+  -s, --include-sub-repos
+                        Include sub-repositories (e.g., Git worktrees and submodules)
+  --print               Print the paths (only when no command is provided)
+  --print0              Separate the paths with a null character (only when no command is provided)
+```
 
 ## License
 

{git_rexec-1.0.2 → git_rexec-1.0.3}/git-rexec

@@ -6,7 +6,7 @@
 #
 # Author: James Cherti
 # URL: https://github.com/jamescherti/git-rexec
-# Version: 1.0.2
+# Version: 1.0.3
 #
 # Copyright (C) 2019-2026 James Cherti
 #
@@ -376,7 +376,8 @@ def parse_args() -> argparse.Namespace:
     :return: Parsed arguments.
     """
     parser: argparse.ArgumentParser = argparse.ArgumentParser(
-        description="Find git repos and execute commands.",
+        description=("Find Git repositories and execute commands against "
+                     "them in parallel."),
         formatter_class=argparse.RawDescriptionHelpFormatter
     )
     parser.add_argument(
@@ -413,8 +414,8 @@ def parse_args() -> argparse.Namespace:
     parser.add_argument(
         "-q", "--quiet",
         action="store_true",
-        help=("Quiet mode. Suppresses the informational tracking headers "
-              "([EXEC] and [EXEC-P]) that prefix execution output."),
+        help=("Quiet mode. Suppresses the informational log prefixes "
+              "([EXEC] and [EXEC-P]) that precede execution output."),
         default=False
     )
     parser.add_argument(
@@ -500,7 +501,7 @@ def main() -> None:
     # Check for empty action
     if not args.exec_cmd and not args.print and not args.print0:
         print("Nothing to do.", file=sys.stderr)
-        sys.exit(0)
+        sys.exit(2)
 
     # Verify that the execution command exists
     if args.exec_cmd and not shutil.which(args.exec_cmd[0]):
@@ -596,6 +597,9 @@ def main() -> None:
 if __name__ == "__main__":
     try:
         main()
-    except (KeyboardInterrupt, BrokenPipeError):
+    except KeyboardInterrupt:
         print("\nInterrupting...", file=sys.stderr)
-        sys.exit(1)
+        sys.exit(130)
+    except BrokenPipeError:
+        print("\nInterrupting...", file=sys.stderr)
+        sys.exit(141)

{git_rexec-1.0.2 → git_rexec-1.0.3/git_rexec.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: git-rexec
-Version: 1.0.2
+Version: 1.0.3
 Summary: Locate Git repositories and execute commands against them in parallel.
 Author: James Cherti
 License-Expression: GPL-3.0-or-later
@@ -101,7 +101,7 @@ pip install colorama setproctitle
 ## Usage
 
 ```bash
-git-rexec [OPTIONS] [exec_cmd ...]
+git-rexec [OPTIONS] -- [exec_cmd ...]
 ```
 
 *(Assuming the `git-rexec` script is executable and in your PATH.)*
@@ -112,14 +112,31 @@ git-rexec [OPTIONS] [exec_cmd ...]
 
 ### Options
 
-- `-C, --directory <path>`: The root directory to start searching for Git repositories. Defaults to the current working directory (`.`).
-- `--exclude-dir <path>`: Exclude a specific directory and all of its subdirectories from the search. This option can be provided multiple times.
-- `-p, --parallel`: Execute the command in parallel using threads.
-- `-i, --if-exec <command>`: Execute the main command only if this check command returns an exit code of `0`.
-- `-j, --jobs <int>`: The maximum number of concurrent workers/processors to use for parallel execution. Defaults to the number of CPU cores available.
-- `-s, --include-sub-repos`: Include sub-repositories (e.g., Git worktrees and submodules) in the search target list.
-- `-h, --help`: Show the help message and exit.
-- `-q, --quiet`: Quiet mode. Suppresses the informational tracking headers (`[EXEC]` and `[EXEC-P]`) that prefix execution output. In sequential mode, it hides the `[EXEC]` repository delimiter line entirely; in parallel mode (`-p`), it strips the yellow `[EXEC-P]` header track and removes the four-space indentation, printing only the raw, unindented stdout and stderr streams. This flag has no effect when no execution command is supplied, allowing discovered repository paths to print normally.
+```
+usage: git-rexec [-h] [-C DIRECTORY] [--exclude-dir EXCLUDE_DIR] [-p] [-i IF_EXEC] [-j MAX_WORKERS] [-q] [-s] [--print] [--print0] [exec_cmd ...]
+
+Find Git repositories and execute commands against them in parallel.
+
+positional arguments:
+  exec_cmd              The command to execute. You can use -- to pass options.
+
+options:
+  -h, --help            show this help message and exit
+  -C, --directory DIRECTORY
+                        Root directory to search (defaults to current directory)
+  --exclude-dir EXCLUDE_DIR
+                        Exclude a specific directory and all of its subdirectories
+  -p, --parallel        Execute the command in parallel using threads
+  -i, --if-exec IF_EXEC
+                        Execute commands only if this check returns exit code 0.
+  -j, --jobs MAX_WORKERS
+                        Maximum number of processors/workers to use
+  -q, --quiet           Quiet mode. Suppresses the informational log prefixes ([EXEC] and [EXEC-P]) that precede execution output.
+  -s, --include-sub-repos
+                        Include sub-repositories (e.g., Git worktrees and submodules)
+  --print               Print the paths (only when no command is provided)
+  --print0              Separate the paths with a null character (only when no command is provided)
+```
 
 ## License
 

{git_rexec-1.0.2 → git_rexec-1.0.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "git-rexec"
-version = "1.0.2"
+version = "1.0.3"
 description = "Locate Git repositories and execute commands against them in parallel."
 readme = "README.md"
 requires-python = ">=3.9"