gitman - Git Repository Manager

Have you been cloning git repositories left and right? Do you wish to keep them automatically up-to date?

gitman is a cross-platform manager for git repositories, that are located inside a single directory.

Usage

Arguments

• clone [url: string]: Clones one or more git repositories to the git repository directory. (urls separated by spaces)

  Example: gitman clone https://github.com/nirokay/gitman https://github.com/nirokay/nirokay

• pull: Pulls every repository's changes, or only the ones which names are provided synchronously.

  Examples: gitman pull (pulls all repos), gitman pull gitman nirokay (only pulls gitman and nirokay repo)

• async-pull: Pulls every repository's changes, or only the ones which names are provided asynchronously.

  Examples: gitman async-pull (pulls all repos), gitman async-pull gitman nirokay (only pulls gitman and nirokay repo)

• help: Displays a help message.

• remove [dir: string]: Removes the specified directory inside the git-repo directory. Can accept multiple directories to remove.

  Example: gitman remove nirokay gitman

• list: Lists all git repositories.

• install: Executes installation commands specified in the installation json file (default: $GITMAN_REPOS_LOCATION/.gitman-install.json).

  Example: gitman install (executes install instructions on every repository)

• edit-install: Edits the installation json-file. Uses the EDITOR environment variable for the editor.

  Example: gitman edit-install (opens the file in your editor)

Some commands may also have aliases, see help for more information.

Automatic installation

gitman supports automatic installations with gitman install for specified repositories (installations instructions by default in $GITMAN_REPOS_LOCATION/.gitman-install.json).

This is the JSON format:

{
    "gitman": "nimble build -d:release && nimble install"
}

This will automatically cd into every directory and execute the command, the instructions above would install gitman, when the gitman repository is cloned to $GITMAN_REPOS_LOCATION/gitman/.

Installation

You will need to have Nim installed, as well as its package-manager nimble.

Note:

If you are using nimble install, make sure the nimble/bin directory is in your path (default: ~/.nimble/bin/)!

nimble

nimble install gitman

Compiling manually from source

Clone the repository and run nimble build -d:release to compile or nimble install to compile and install it to the nimble/bin directory.

You can also set some compile-time flags to customise your the program to your liking.

List of compile-time flags:

• environment_variable (default: GITMAN_REPOS_LOCATION)

  This sets the environment variable the program uses.

• gitman_install_file (default: .gitman-install.json)

  Changes the installation json-file name.

Usage:

When compiling add the -d: flag. For example:

• nimble build -d:environment_variable:NEW_ENV_VARIABLE
• nimble build -d:gitman_install_file:new_file_name.json
• nimble build -d:environment_variable:NEW_ENV_VARIABLE -d:gitman_install_file:new_file_name.json

Configuration

There are no configuration files for this program (anymore). You can set a custom git directory by changing the GITMAN_REPOS_LOCATION environment variable.

Example (Linux):

export GITMAN_REPOS_LOCATION="$HOME/Git"

Note:

This will only be available for the current session. Consider putting the string above into your profile/shell rc file.

Changes

See Changes document.

Supported Operating Systems

Any operating system that is supported by the nim programming language should be supported.

This program was tested on GNU/Linux (Manjaro) and Windows 10 (64 bit).

Dependencies

• git

• Nim (not required to run the binary, only for compiling and installing through nimble)