6 releases
0.3.2 | May 3, 2020 |
---|---|
0.3.1 | Jan 25, 2020 |
0.2.1 | Jan 7, 2020 |
0.1.1 | Aug 20, 2019 |
#2949 in Command line utilities
9.5MB
896 lines
Git Governance
A tool to manage multiple git repositories. This does not aim to replace git in any way but tries to reduce the work in managing multiple git repositories at once. To know about the story behind this tool, take a look at this blog -> https://medium.com/@jpninanjohn/we-built-a-tool-in-rust-9c1bcb9b655e
Installation
Using Brew:
brew tap thecasualcoder/stable
brew install gg
Installing from source:
git clone https://github.com/thecasualcoder/gg.git
cd gg
cargo install --path .
Note: Recommaded rustc/cargo version: 1.36.0 and above or 1.37.0-nightly and above
Usage:
Help:
$ gg --help
Status:
Shows status of all git repos from current directory. Traverses inside directories also.
To traverse through hidden directories use the -i
flag. By default hidden directories will not be traversed.
$ gg status
Create:
Creates a remote repository and clones it to the local path specified. Remote repository is created based on the GITHUB_TOKEN provided.
GITHUB_TOKEN can be passed as an env variable or can be given as an argument through the -t
flag
$ gg create -r <repo_name> -l <local_path>
Fetch:
Fetches from all git repositories starting from current directory. Traverses inside directories also.
Currently Fetch only uses the private key id_rsa
to authenticate and will fail to fetch if it is not enough. Failure to fetch one repo will not fail others
To traverse through hidden directories use the -i
flag. By default hidden directories will not be traversed.
$ gg fetch
Clone:
Clones repositories based on the flags passed and the configuration given in the .ggConf.yaml
file.
$ gg clone -r <remote_url_1> -r <remote_url_2> -l <local_path>
Config file:
The config file can be specified via the -c
flag. By default it tries to find .ggConf.yaml
.
Example config file:
skipDirectories:
- ignore
cloneRepos:
- remoteURL: https://github.com/golang/net.git
localPath: here/net
- remoteURL: https://github.com/golang/net.git
localPath: there/net
ssh:
privateKey: '/home/ninan/.ssh/gg'
username: 'git'
ssh_agent: false
See .ggConf.example.yaml
for more details
Contributing:
Please refer the github projects board If you want some feature, please create an issue and if possible feel free to raise PR too.
Dependencies
~29–41MB
~765K SLoC