# repo-utils
Utilities for google's repo-tool written in Rust
A collection of commands to work on git repositories managed by google's repo tool.
## Installation
repo-utils is written in rust. You need the rust toolchain installed to be able to use it:
https://www.rust-lang.org/tools/install
Then you simply install the latest repo-utils release with:
```
cargo install repo-utils
```
from the central crates.io repository
## Usage
### repo-forall
```
Execute commands on git repositories managed by repo, see https://github.com/elektronenhirn/repo-utils
Usage: repo-forall [OPTIONS] [COMMAND]...
Arguments:
[COMMAND]...
Options:
-C, --cwd <DIR> change working directory (mostly useful for testing)
-m, --manifest <FILE> ignore projects which are not defined in the given manifest file(s)
-g, --group <GROUP> ignore projects which are not part of the given group(s)
-v, --verbose Verbose output
-f, --fail-fast Stop running commands for anymore projects whenever one failed
-p, --print-project-path Print project path before printing command output
-h, --help Print help information
-V, --version Print version information
```
Supports the following environment variables in the command:
- `REPO_PATH`: relative path to the project
Example:
```
repo-forall 'echo $REPO_PATH'
```
### repo-status
```
Check if repos managed by git-repo have uncommited changes, see https://github.com/elektronenhirn/repo-utils
Usage: repo-status [OPTIONS]
Options:
-C, --cwd <DIR> change working directory (mostly useful for testing)
-m, --manifest <FILE> ignore projects which are not defined in the given manifest file(s)
-g, --group <GROUP> ignore projects which are not part of the given group(s)
-v, --verbose Verbose output, e.g. print local path before executing command
-h, --help Print help information
-V, --version Print version information
```