RRH

RRH is a simple git repository manager.

Description

There are too many repositories. We love programming; however, to manage many repositories is quite hard and bothersome tasks. Therefore, we built a headquarter for managing the git repositories, named RRH. RRH manages repositories by categorizing in groups and execute git command to the groups.

I know the tool ghq, manages the git repositories. However, I cannot use it for the following reasons.

there are quite many repositories in my home directory.
- To start using ghq, we clone the repositories. However, I did not accept to clone all of the repositories.
The location of repositories is fixed in the config file and is accepted only one location.
- I decide the directory layout in my home directory.

Additionally, I edit several repositories in a day, when I work hard. Consequently, the progress of each repository is obscured; I cannot remember a lot of things. Therefore, it is glad to see the last modified date of branches.

RRH is now growing. Please hack RRH itself.

Installation

Homebrew

Install rrh via Homebrew, simply run:

$ brew tap tamada/brew
$ brew install rrh

Golang

To install by cli, simply run:

$ go get git@github.com/tamada/rrh.git

Requirements

Runtime
- Bash 4.x or after, for completion.
  - zsh?, and fish?, I do not use them, so I do not know.
  - For macOS user, the default shell of the macOS is bash 3.x, therefore, the completion is not work enough.
    - rrh is maybe work on Windows, and Linux. I do not use them.
Development
- Go 1.12
- See go.mod

For 1.x.x Users

rrh updates the default config and database paths from "${HOME}/.rrh" to "${HOME}/.config/rrh". Therefore, please move the previous database and config to the new location by executing rrh migrate 1.x.x.

Usage

Getting started

RRH has various subcommands, however, list and add subcommand make you happy.

rrh list shows managed repositories.
rrh add <REPO> adds the given repository under the RRH management.
type cdrrh on Terminal, then type TAB, TAB, TAB!

Command references

rrh [GLOBAL OPTIONS] <SUB COMMANDS> [ARGUMENTS]
GLOBAL OPTIONS
    -h, --help                        print this message.
    -v, --version                     print version.
    -c, --config-file <CONFIG_FILE>   specifies the config file path.
AVAILABLE SUB COMMANDS:
    add          add repositories on the local path to RRH.
    clone        run "git clone" and register it to a group.
    config       set/unset and list configuration of RRH.
    export       export RRH database to stdout.
    fetch        run "git fetch" on the given groups.
    fetch-all    run "git fetch" in the all repositories.
    group        add/list/update/remove groups and show groups of the repository.
    help         print this message.
    import       import the given database.
    list         print managed repositories and their groups.
    mv           move the repositories from groups to another group.
    open         open folder or web page of the given repositories.
    prune        prune unnecessary repositories and groups.
    repository   manages repositories.
    rm           remove given repository from database.
    status       show git status of repositories.
    version      show version.

If the user specified an unknown subcommand (e.g., rrh helloworld), rrh treats it as an external command. In that case, rrh searches an executable file named rrh-helloworld from the PATH environment variable. If rrh found it, rrh executes it, if not found, rrh prints help and exit.

Subcommands

`rrh add`

Registers the repositories which specified the given paths to the RRH database and categorize to the group (Default no-group, see RRH_DEFAULT_GROUP_NAME).

rrh add [OPTIONS] <REPOSITORY_PATHS...>
OPTIONS
    -g, --group <GROUP>        add repository to RRH database.
    -r, --repository-id <ID>   specified repository id of the given repository path.
                               Specifying this option fails with multiple arguments.
ARGUMENTS
    REPOSITORY_PATHS           the local path list of the git repositories.

`rrh clone`

Runs git clone command and registers the cloned repository to RRH database. The following steps identify the id of the repository.

If the length of REMOTE_REPOS is 1, and DEST exists, then the last entry of REMOTE_REPOS is repository id by eliminating the suffix .git.
If the length of REMOTE_REPOS is 1, and DEST does not exist, then the last entry of DEST is repository id.
If the length of REMOTE_REPOS is greater than 1, then the last entry of each REMOTE_REPOS is repository ids by eliminating the suffix .git.

rrh clone [OPTIONS] <REMOTE_REPOS...>
OPTIONS
    -g, --group <GROUP>   print managed repositories categoried in the group.
    -d, --dest <DEST>     specify the destination. Default is the current directory.
ARGUMENTS
    REMOTE_REPOS          repository urls

The destination of cloned repository is located based on RRH_CLONE_DESTINATION

`rrh config`

Handles the operations of configuration/environment variables. This subcommand requires sub-sub-command. If sub-sub-command was not specified, it runs list sub-sub-command.

rrh config <COMMAND> [ARGUMENTS]
COMMAND
    set <ENV_NAME> <VALUE>  set ENV_NAME to VALUE
    unset <ENV_NAME>        reset ENV_NAME
    list                    list all of ENVs (default)

`rrh export`

Exports the data of RRH database by JSON format.

rrh export [OPTIONS]
OPTiONS
    --no-indent      print result as no indented json
    --no-hide-home   not replace home directory to '${HOME}' keyword

`rrh fetch`

Runs git fetch command in the repositories of the specified group.

rrh fetch [OPTIONS] [GROUPS...]
OPTIONS
    -r, --remote <REMOTE>   specify the remote name. Default is "origin."
ARGUMENTS
    GROUPS                  run "git fetch" command on each repository on the group.
                            if no value is specified, run on the default group.

`rrh fetch-all`

Runs git fetch command in all repositories of managing in RRH. This command may make heavy network traffic; therefore, we do not recommend to run.

rrh fetch-all [OPTIONS]
OPTIONS
    -r, --remote <REMOTE>   specify the remote name. Default is "origin."

`rrh group`

Handles the operations of groups of RRH. This subcommand requires sub-sub-command. If sub-sub-command was not specified, it runs list sub-sub-command.

rrh group <SUBCOMMAND>
SUBCOMMAND
    add       add new group.
    info      show information of specified groups.
    list      list groups (default).
    of        shows groups of the specified repository.
    rm        remove group.
    update    update group.

`rrh group add`

Adds new group to the RRH database.

rrh group add [OPTIONS] <GROUPS...>
OPTIONS
    -d, --desc <DESC>        gives the description of the group.
    -o, --omit-list <FLAG>   gives the omit list flag of the group.
ARGUMENTS
    GROUPS                   gives group names.

`rrh group info`

Show information of specified groups.

rrh group info <GROUPS...>
ARGUMENTS
    GROUPS           group names to show the information.

`rrh group list`

Displays group list.

rrh group list [OPTIONS]
OPTIONS
    -d, --desc             show description.
    -r, --repository       show repositories in the group.
    -o, --only-groupname   show only group name. This option is prioritized.

`rrh group of`

Displays group of the specified repositories.

rrh group of <REPOSITORY_ID>
ARGUMENTS
    REPOSITORY_ID     show the groups of the repository.

`rrh group rm`

Removes groups.

rrh group rm [OPTIONS] <GROUPS...>
OPTIONS
    -f, --force      force remove.
    -i, --inquery    inquiry mode.
    -v, --verbose    verbose mode.
ARGUMENTS
    GROUPS           target group names.

`rrh group update`

Update the information of specified group.

rrh group update [OPTIONS] <GROUP>
OPTIONS
    -n, --name <NAME>        change group name to NAME.
    -d, --desc <DESC>        change description to DESC.
    -o, --omit-list <FLAG>   change omit-list of the group. FLAG must be "true" or "false".
ARGUMENTS
    GROUP                    update target group names.

`rrh help`

Prints the help message.

rrh help [ARGUMENTS...]
ARGUMENTS
    print help message of target command.

`rrh import`

Import the database to the local environment.

rrh import [OPTIONS] <DATABASE_JSON>
OPTIONS
    --auto-clone    clone the repository, if paths do not exist.
    --overwrite     replace the local RRH database to the given database.
    -v, --verbose   verbose mode.
ARGUMENTS
    DATABASE_JSON   the exported RRH database.

`rrh list`

Prints the repositories of managing in RRH.

rrh list [OPTIONS] [GROUPS...]
OPTIONS
    -d, --desc          print description of group.
    -p, --path          print local paths (default).
    -r, --remote        print remote urls.
    -A, --all-entries   print all entries of each repository.

    -a, --all           print all repositories, no omit repositories.
    -c, --csv           print result as csv format.
ARGUMENTS
    GROUPS    print managed repositories categorized in the groups.
              if no groups are specified, all groups are printed.

`rrh mv`

Move repositories to another group.

rrh mv [OPTIONS] <FROMS...> <TO>
OPTIONS
    -v, --verbose   verbose mode

ARGUMENTS
    FROMS...        specifies move from, formatted in <GROUP_NAME/REPO_ID>, or <GROUP_NAME>
    TO              specifies move to, formatted in <GROUP_NAME>

`rrh open`

Opens folder or web page of the given repositories.

rrh open [OPTIONS] <REPOSITORIES...>
OPTIONS
    -f, --folder     open the folder of the specified repository (Default).
    -w, --webpage    open the webpage of the specified repository.
    -h, --help       print this message.
ARGUMENTS
    REPOSITORIES     specifies repository names.

`rrh prune`

Deletes unnecessary groups and repositories. The unnecessary groups are no repositories in them. The unnecessary repositories are to have an invalid path.

rrh prune

`rrh repository`

Prints/Updates the repository.

rrh repository <SUBCOMMAND>
SUBCOMMAND
    info [OPTIONS] <REPO...>     shows repository information.
    update [OPTIONS] <REPO...>   updates repository information.
    update-remotes [OPTIONS]     update all remote entries.

`rrh repository info`

prints the repository information.

rrh repository info [OPTIONS] [REPOSITORIES...]
    -G, --color     prints the results with color.
    -c, --csv       prints the results in the csv format.
ARGUMENTS
    REPOSITORIES    target repositories.  If no repositories are specified,
                    this sub command failed.

`rrh repository update`

update the information of the repository.

rrh repository update [OPTIONS] <REPOSITORY>
OPTIONS
    -i, --id <NEWID>     specifies new repository id.
    -d, --desc <DESC>    specifies new description.
    -p, --path <PATH>    specifies new path.
ARGUMENTS
    REPOSITORY           specifies the repository id.

`rrh repository update-remotes`

update remote entries in the all repositories.

rrh repository update-remotes [OPTIONS]
OPTIONS
    -d, --dry-run    dry-run mode.
    -v, --verbose    verbose mode.

`rrh rm`

Removes the specified groups, repositories, and relations. If the group has entries is removed by specifying the option --recursive.

rrh rm [OPTIONS] <REPO_ID|GROUP_ID|GROUP_ID/REPO_ID...>
OPTIONS
    -i, --inquiry       inquiry mode.
    -r, --recursive     recursive mode.
    -v, --verbose       verbose mode.

ARGUMENTS
    REPOY_ID            repository name for removing.
    GROUP_ID            group name. if the group contains repositories,
                        removing will fail without '-r' option.
    GROUP_ID/REPO_ID    remove the relation between the given REPO_ID and GROUP_ID.

`rrh status`

Prints the last modified times of each branch in the repositories of the specified group.

rrh status [OPTIONS] [GROUPS|REPOS...]
OPTIONS
    -b, --branches  show the status of the local branches.
    -r, --remote    show the status of the remote branches.
    -c, --csv       print result in csv format.
ARGUMENTS
    GROUPS          target groups.
    REPOS           target repositories.
                    If no arguments were specified, this command
                    shows the result of default group.

`rrh version`

Prints rrh version.

rrh version

Environment variables

We can see those variables by running rrh config sub-command.

`RRH_HOME`

specifies the location of the RRH database and config file.
Default: /Users/tamada/.rrh

`RRH_CONFIG_PATH`

specifies the location of the location path.
- RRH ignores to specify RRH_CONFIG_PATH in the config file. This variable availables only environment variable.
Default: ${RRH_HOME}/config.json

`RRH_DATABASE_PATH`

specifies the location of the database path.
Default: ${RRH_HOME}/database.json

`RRH_DEFAULT_GROUP_NAME`

specifies the default group name.
Default: no-group

`RRH_CLONE_DESTINATION`

specifies the destination by cloning the repository.
Default: .

`RRH_ON_ERROR`

specifies the behaviors of RRH on error.
Default: WARN
Available values: FAIL_IMMEDIATELY, FAIL, WARN, and IGNORE
- FAIL_IMMEDIATELY
  - reports error immediately and quits RRH with a non-zero status.
- FAIL
  - runs through all targets and reports errors if needed, then quits RRH with a non-zero status.
- WARN
  - runs through all targets and reports errors if needed, then quits RRH successfully.
- IGNORE
  - runs all targets and no reports errors.

`RRH_TIME_FORMAT`

specifies the time format for status command.
Default: relative
Available value: relative and the time format for Go lang.
- relative
  - shows times by humanized format (e.g., 2 weeks ago)
- Other strings
  - regard as formatting layout and give to Format method of the time.
    - see Time.Format, for more detail.

`RRH_AUTO_CREATE_GROUP`

specifies to create the group when the not existing group was specified, and it needs to create.
Default: false

`RRH_AUTO_DELETE_GROUP`

specifies to delete the group when some group was no more needed.
Default: false

`RRH_SORT_ON_UPDATING`

specifies to sort database entries on updating database.
Default: false

`RRH_COLOR`

specifies the colors of the output.
Default: "repository:fg=red+group:fg=magenta+label:op=bold+configValue:fg=green"
Format: "repository:fg=<COLOR>;bg=<COLOR>;op=<STYLE>+group:fg=<COLOR>;bg=<COLOR>;op=<STYLE>+label:fg=<COLOR>;bg=<COLOR>;op=<STYLE>+configValue:fg=<COLOR>;bg=<COLOR>;op=<STYLE>"
- Available COLORs
  - red, cyan, blue, black, green, white, yellow, magenta.
- Available STYLEs
  - bold, underscore.
- Delimiter of repository, group and label is +, delimiter of type and value is :, delimiter of each label is ;, and delimiter of each value is ,.
Examples:
- RRH_COLOR: repository:fg=red+group:fg=cyan;op=bold,underscore
  - Repository: red, Group: cyan in bold with underscore.

`RRH_ENABLE_COLORIZED`

specifies to colorize the output. The colors of output were specified on RRH_COLOR
Default: false

Development

Database

The database for managed repositories is formatted in JSON. The JSON format is as follows. The JSON file is placed on $RRH_HOME/database.json. If $RRH_HOME was not set, $HOME/.rrh is used as $RRH_HOME. Also, the configuration file is on $RRH_HOME/config.json

{
    last-modified: '2019-01-01T',
    repositories: [
        {
            repository_id: 'rrh', // unique key of repository.
            repository_path: 'absolute/path/of/repository',
            repository_desc: 'description of the repository.',
            remotes: [
                {
                    Name: "origin",
                    URL: "git@github.com:tamada/rrh.git"
                }
            ]
        },
        ....
    ]
    groups: [
        {
            group_name: 'no-group',
            group_desc: 'The description of the group.',
            omit_list: false
        },
        ....
    ],
    relations: [
        {
            repository_id: 'rrh',
            group_name: 'no-group'
        }
    ]
}

Utilities

Write the following script to $HOME/.bash_profile, then restart shell, then we can use cdrrh and rrhpeco command in the terminal.

`cdrrh`

changes directory to the specified repository.

cdrrh(){
    path=$(rrh repository list --path $1)
    if [ $? -eq 0 ]; then
        cd $path
        pwd
    else
        echo "$1: repository not found"
    fi
}

`rrhpeco`

list repositories, and filtering them by peco, then change directory to the filtering result.

rrhpeco(){
  csv=$(rrh list --path --csv | peco)
  cd $(echo $csv | awk -F , '{ print $3 }')
  pwd
}

About the Project

Contribution

Fork the project. (https://github.com/tamada/rrh/fork)
Create a feature branch. (git checkout -b FEATURE_BRANCH_NAME)
Edit the source files and Commit your changes.
Create tests and commit them.
Rebase your local changes against the master branch.
Run the test suite with the make test and confirm that passes.
Create a new pull request.
Confirm all checks pass.

Code of Conduct

License

Apache Version 2.0

Discussion

Join our Gitter channel if you have any problem or suggestions to rrh.

For Japanese user, misc_ja channel has discussions in Japanese. The public language of other channels and GitHub pages are English.

Author

Haruaki Tamada

Why the project name RRH

At first, the name of this project was GRIM (Git Repository Integrated Manager). However, the means of grim is not good, and there are many commands which start with gr. Therefore, we changed the project name to RRH. RRH means "Repositories, Ready to Hack" or "Remote Repositories Head," are not the abbreviation of the Red Riding Hood.

Attributions

Icon of RRH

by iconpon.com

Version histories

v1.1.0 (18 Dec, 2018)
- #79 (add rrh group info sub command)
- #77 (introduce rrh repository update-remotes sub command)
- #81 (introduce options for rrh prune command)
v1.0.4 (13 Jul, 2018)
- #74 (permission of created README.md by rrh-new was invalid (204))
- #75 (Introduce --dry-run option to rrh new command)
v1.0.3 (29 Jun, 2018)
- #72 (Print belonging groups on rrh repository info)
v1.0.2 (29 Jun, 2018)
- #67 (implements rrh new sub command)
v1.0.1 (26 Jun, 2018)
- #68 (rrh group prints rrh config list)
v1.0.0 (18 Jun, 2018)
- The first public release.

Name		Name	Last commit message	Last commit date
Latest commit History 359 Commits
.bin		.bin
.github		.github
cmd		cmd
common		common
completions/bash		completions/bash
decorator		decorator
docs		docs
testdata		testdata
.gitignore		.gitignore
.gitmodules		.gitmodules
CODE_OF_CONDUCT.md		CODE_OF_CONDUCT.md
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
Makefile		Makefile
README.md		README.md
colorable_output.go		colorable_output.go
colorable_output_test.go		colorable_output_test.go
config.go		config.go
config_test.go		config_test.go
database.go		database.go
database_test.go		database_test.go
git.go		git.go
git_test.go		git_test.go
go.mod		go.mod
go.sum		go.sum
math.go		math.go
message_test.go		message_test.go
messages.go		messages.go
rrhtime.go		rrhtime.go
testutils.go		testutils.go
util.go		util.go
util_test.go		util_test.go

License

tamada/rrh

Folders and files

Latest commit

History

Repository files navigation

RRH

Table of contents

Description

Installation

Homebrew

Golang

Requirements

For 1.x.x Users

Usage

Getting started

Command references

Subcommands

rrh add

rrh clone

rrh config

rrh export

rrh fetch

rrh fetch-all

rrh group

rrh group add

rrh group info

rrh group list

rrh group of

rrh group rm

rrh group update

rrh help

rrh import

rrh list

rrh mv

rrh open

rrh prune

rrh repository

rrh repository info

rrh repository update

rrh repository update-remotes

rrh rm

rrh status

rrh version

Environment variables

RRH_HOME

RRH_CONFIG_PATH

RRH_DATABASE_PATH

RRH_DEFAULT_GROUP_NAME

RRH_CLONE_DESTINATION

RRH_ON_ERROR

RRH_TIME_FORMAT

RRH_AUTO_CREATE_GROUP

RRH_AUTO_DELETE_GROUP

RRH_SORT_ON_UPDATING

RRH_COLOR

RRH_ENABLE_COLORIZED

Development

Database

Utilities

cdrrh

rrhpeco

About the Project

Contribution

Code of Conduct

License

Discussion

Author

Why the project name RRH

Attributions

Icon of RRH

Version histories

Table of Contents

About

Topics

Resources

License

Code of conduct

Stars

Watchers

`rrh add`

`rrh clone`

`rrh config`

`rrh export`

`rrh fetch`

`rrh fetch-all`

`rrh group`

`rrh group add`

`rrh group info`

`rrh group list`

`rrh group of`

`rrh group rm`

`rrh group update`

`rrh help`

`rrh import`

`rrh list`

`rrh mv`

`rrh open`

`rrh prune`

`rrh repository`

`rrh repository info`

`rrh repository update`

`rrh repository update-remotes`

`rrh rm`

`rrh status`

`rrh version`

`RRH_HOME`

`RRH_CONFIG_PATH`

`RRH_DATABASE_PATH`

`RRH_DEFAULT_GROUP_NAME`

`RRH_CLONE_DESTINATION`

`RRH_ON_ERROR`

`RRH_TIME_FORMAT`

`RRH_AUTO_CREATE_GROUP`

`RRH_AUTO_DELETE_GROUP`

`RRH_SORT_ON_UPDATING`

`RRH_COLOR`

`RRH_ENABLE_COLORIZED`

`cdrrh`

`rrhpeco`

Packages