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

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

@@ -1,13 +1,12 @@
 Metadata-Version: 2.4
 Name: git-rexec
-Version: 1.0.1
+Version: 1.0.3
 Summary: Locate Git repositories and execute commands against them in parallel.
 Author: James Cherti
-License: GPL-3.0-or-later
+License-Expression: GPL-3.0-or-later
 Project-URL: Homepage, https://github.com/jamescherti/git-rexec
 Keywords: git,parallel,executor,automation
 Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Operating System :: OS Independent
 Classifier: Environment :: Console
 Classifier: Topic :: Software Development :: Version Control :: Git
@@ -48,6 +47,11 @@ Here are examples demonstrating how to use `git-rexec`:
   git-rexec --if-exec 'sh -c "test -f README.md"' --parallel -- wc -l README.md
   ```
 
+- Print the paths of all discovered Git repositories:
+  ```bash
+  git-rexec --print
+  ```
+
 If this helps your workflow, please support the project by **⭐ starring git-rexec on GitHub** and sharing it on your website, blog, Mastodon, Reddit, X, LinkedIn, or other social media platforms to help more Git users discover its benefits.
 
 ## Features
@@ -57,6 +61,7 @@ If this helps your workflow, please support the project by **⭐ starring git-re
 - Execute shell commands across multiple repositories in parallel using worker threads.
 - Filter target repositories based on the exit code of a conditional check (`--if-exec`).
 - Exclude specific directories from the search path.
+- Export discovered repository paths for integration with other shell tools (using `--print` or `--print0`).
 
 ## Installation
 
@@ -96,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.)*
@@ -107,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.1 → git_rexec-1.0.3}/README.md

@@ -29,6 +29,11 @@ Here are examples demonstrating how to use `git-rexec`:
   git-rexec --if-exec 'sh -c "test -f README.md"' --parallel -- wc -l README.md
   ```
 
+- Print the paths of all discovered Git repositories:
+  ```bash
+  git-rexec --print
+  ```
+
 If this helps your workflow, please support the project by **⭐ starring git-rexec on GitHub** and sharing it on your website, blog, Mastodon, Reddit, X, LinkedIn, or other social media platforms to help more Git users discover its benefits.
 
 ## Features
@@ -38,6 +43,7 @@ If this helps your workflow, please support the project by **⭐ starring git-re
 - Execute shell commands across multiple repositories in parallel using worker threads.
 - Filter target repositories based on the exit code of a conditional check (`--if-exec`).
 - Exclude specific directories from the search path.
+- Export discovered repository paths for integration with other shell tools (using `--print` or `--print0`).
 
 ## Installation
 
@@ -77,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.)*
@@ -88,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.1 → git_rexec-1.0.3}/git-rexec

@@ -6,7 +6,7 @@
 #
 # Author: James Cherti
 # URL: https://github.com/jamescherti/git-rexec
-# Version: 1.0.1
+# Version: 1.0.3
 #
 # Copyright (C) 2019-2026 James Cherti
 #
@@ -125,6 +125,7 @@ def git_py_find_repo(root: Path) -> tuple[set[Path], set[Path]]:
 
     return repos, sub_repos
 
+
 def get_sub_repos(repo_path: Path) -> set[Path]:
     """Extract worktrees and submodules from a Git repository.
 
@@ -191,7 +192,6 @@ def get_sub_repos(repo_path: Path) -> set[Path]:
     return sub_repos
 
 
-
 def run_command_get_output(repo_path: Path, cmd_list: list[str],
                            capture: bool = True) -> CommandResult:
     """Execute a shell command within a specific directory.
@@ -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(
@@ -423,6 +424,19 @@ def parse_args() -> argparse.Namespace:
         help="Include sub-repositories (e.g., Git worktrees and submodules)",
         default=False
     )
+    parser.add_argument(
+        "--print",
+        action="store_true",
+        help="Print the paths (only when no command is provided)",
+        default=False
+    )
+    parser.add_argument(
+        "--print0",
+        action="store_true",
+        help=("Separate the paths with a null character (only when no "
+              "command is provided)"),
+        default=False
+    )
     parser.add_argument(
         "exec_cmd",
         type=str,
@@ -484,6 +498,11 @@ def main() -> None:
 
     args: argparse.Namespace = parse_args()
 
+    # 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(2)
+
     # Verify that the execution command exists
     if args.exec_cmd and not shutil.which(args.exec_cmd[0]):
         print(
@@ -566,7 +585,10 @@ def main() -> None:
 
         # If no commands were run, just list the repo
         if not args.exec_cmd:
-            print(repo_path)
+            if args.print0:
+                print(repo_path, end="\0")
+            elif args.print:
+                print(repo_path)
 
     # Final Error Summary
     sys.exit(print_error_summary(execution_errors))
@@ -575,6 +597,9 @@ def main() -> None:
 if __name__ == "__main__":
     try:
         main()
-    except (KeyboardInterrupt, BrokenPipeError):
+    except KeyboardInterrupt:
+        print("\nInterrupting...", file=sys.stderr)
+        sys.exit(130)
+    except BrokenPipeError:
         print("\nInterrupting...", file=sys.stderr)
-        sys.exit(1)
+        sys.exit(141)

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

@@ -1,13 +1,12 @@
 Metadata-Version: 2.4
 Name: git-rexec
-Version: 1.0.1
+Version: 1.0.3
 Summary: Locate Git repositories and execute commands against them in parallel.
 Author: James Cherti
-License: GPL-3.0-or-later
+License-Expression: GPL-3.0-or-later
 Project-URL: Homepage, https://github.com/jamescherti/git-rexec
 Keywords: git,parallel,executor,automation
 Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
 Classifier: Operating System :: OS Independent
 Classifier: Environment :: Console
 Classifier: Topic :: Software Development :: Version Control :: Git
@@ -48,6 +47,11 @@ Here are examples demonstrating how to use `git-rexec`:
   git-rexec --if-exec 'sh -c "test -f README.md"' --parallel -- wc -l README.md
   ```
 
+- Print the paths of all discovered Git repositories:
+  ```bash
+  git-rexec --print
+  ```
+
 If this helps your workflow, please support the project by **⭐ starring git-rexec on GitHub** and sharing it on your website, blog, Mastodon, Reddit, X, LinkedIn, or other social media platforms to help more Git users discover its benefits.
 
 ## Features
@@ -57,6 +61,7 @@ If this helps your workflow, please support the project by **⭐ starring git-re
 - Execute shell commands across multiple repositories in parallel using worker threads.
 - Filter target repositories based on the exit code of a conditional check (`--if-exec`).
 - Exclude specific directories from the search path.
+- Export discovered repository paths for integration with other shell tools (using `--print` or `--print0`).
 
 ## Installation
 
@@ -96,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.)*
@@ -107,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.1 → git_rexec-1.0.3}/pyproject.toml

@@ -4,18 +4,17 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "git-rexec"
-version = "1.0.1"
+version = "1.0.3"
 description = "Locate Git repositories and execute commands against them in parallel."
 readme = "README.md"
 requires-python = ">=3.9"
-license = {text = "GPL-3.0-or-later"}
+license = "GPL-3.0-or-later"
 authors = [
   {name = "James Cherti"}
 ]
 keywords = ["git", "parallel", "executor", "automation"]
 classifiers = [
   "Programming Language :: Python :: 3",
-  "License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)",
   "Operating System :: OS Independent",
   "Environment :: Console",
   "Topic :: Software Development :: Version Control :: Git"