Traverse git repositories using a command.
traverse
[--amending-prefix <amending_prefix>]
[-h | --help]
[-k | --keep <revision>]
[-p | --prefix <prefix>]
[-q | --quiet]
[-v | --verbose]
<amended_repository_path>
-- {<amending_repository_path>...}
-- <command>- at each <amended_repository_path> commit that has a <prefix><body> subject to check out each <amending_repository_path> commit whose subject contains a <body> substring, execute a <command> command, and amend the former
Follow the unpath tool installation flow.
- Set up an environment.
- Traverse git repositories.
-
- Enter the nix shell using the
nix-shellcommand. - Enter <amended_repository_path>
and <amending_repository_paths> repositories
using the
cdcommand.
- Enter the nix shell using the
- Select <amended_repository_path>
and <amending_repository_paths> revisions to traverse
using the
git checkoutcommand.
- The
nix-shellcommand must be executed either from a dependee root directory or with a path to either it or theshell.nixfile supplied.
Execute the traverse <amended_repository_path> -- {<amending_repository_path>...} -- <command> command.
- The
gittool must be available in the nix shell in which the command is executed.
This tool follows the convention
followed by the bem library.
the flag and option descriptions
| Flag or option | Default value | Description |
|---|---|---|
--amending-prefix |
feat.*: |
a subject pattern to select <amending_repository_paths> commits by |
-h, --help |
0 |
whether to print the help message and then exit |
-k, --keep |
<root> | a parent revision up to which to traverse a currently checked out revision |
-p, --prefix |
feat.*: |
a subject pattern to select <amended_repository_path> commits by |
-q, --quiet |
0 |
whether to suppress output |
-v, --verbose |
0 |
whether to execute the git diff command at each iteration |