adyla2/hermes

Code Repository Manager

Hermes - Messenger of the Version Control Gods

Hermes allows you to manage your git repositories from the command line

NOTE: This project is a blatant ripoff of this project, bitcar, created by a friend and former colleague. I decided to create hermes because I wasn't a fan of the node dependency with bitcar and wanted additional features.

OTHER NOTE: Currently the project is still in the very early stages of development, so, although some features work, there's still plenty more to come and there is no guarantee of backwards compatibility until the project reaches the v1.0.0 mark.

Table of Contents

• Installation
• Setup
• Configuration
  • Example File
• Usage
  • Root/Get Command
  • Setup Command
  • Alias Command
• Contributing Guidlines

---

Installation

As the project is still in beta stages of development, it has not been distributed, and is only available to install from source. To install hermes, you must then have go setup with your GOPATH bin in your shell PATH. Once you have this you can install by running

go get -u github.com/TheHipbot/hermes
hermes -h

Setup

Once you have hermes installed, you must setup the hermes config directory and add an alias to you shell profile.

To create the config directory, run the following:

hermes setup

And you must add the hermes alias to your shell profile (e.g. $HOME/.bash_profile, .$HOME/.profile, etc):

cat >> ~/.bash_profile
if which hermes > /dev/null; then
    eval "$(hermes alias)"
fi

The above command will expect you to enter in the shell script text then end the command by hitting <CTRL+D>.

Configuration

Hermes supports yaml configuration files stored in either of these two locations on the system:

$HOME/.hermes.yml
/etc/hermes/.hermes.yml

Here is a list of the current supported config keys and values along with their use:

• repo_path (default: $HOME/hermes-repos/) - tells hermes where to clone repos to on your system. From this base path, repos will be stored similar to the go get tool. For example hermes will store itself in ${repo_path}/github.com/TheHipbot/hermes
• config_path (default: $HOME/.hermes/) - the directory where hermes will store configuration files such as its internal cache and the hermes target file. NOTE: you will want to set this in your hermes configuration file BEFORE you run hermes setup since that command will create the config folder.
• target_file (default: .hermes_target) - after running the hermes command, if there is a valid target (e.g. repo that you have cloned or want to jump to), hermes writes out the full path into the hermes target file. From there, the alias in your shell profile will read this, jump to the directory and then remove the target file. NOTE: target_file only specifies the file name, the file will be created in the config_path. if you change the target file after setting the hermes alias, you would need to open a new terminal session or re-source your profile file for the alias to realize the change
• cache_file (default: cache.json) - hermes stores a cache of repos it is aware of to allow for tab completion and prompts. this will be in json format. NOTE: cache_file only specifies the file name, the file will be created in the config_path

Example .hermes.yml File

repo_path: /Users/jeremychambers/test-repos/
config_path: /Users/jeremychambers/.hermes-config/
cache_file: cached-repos.json
target_file: .hermes_target_dir

Usage

Root / Get Command

hermes <args> or hermes get <args>

Running the hermes command without any subcommands or with the get subcommand are synonymous. The command is used to jump to a repo in the hermes cache or pull down a repo then jump to its new location.

args - the expected arguments are a full repo path in this format: [remote address]/[project or user]/[repo nam] (e.g. github.com/TheHipbot/hermes) to clone a new repo, or a string to conduct a contains search on the repos in the hermes cache

When run, the following actions happen in order:

1. The hermes cache file is read in and then all repos are searched to see if they contain the text given as args
2. Based on the results of the search, 1 of 3 things will happen
   • If the search turns up a single result from the cache, hermes will set the target to the path of that repo and exit so the alias can move you to the directory
   • If the search turns up no results, hermes assumes this is a new repo and will attempt to clone it. If the clone is successful, the repo is added to the cache and the target is set to the new repo
   • If there are multiple results, the user is prompted to select a repo from the results. Once a repo is selected, hermes will continue with that repo.
3. Assuming the command has executed successfully a target path should be written to the target file. Hermes will exit 0 and the alias (assuming it has been setup) will read the path from the file, move the current working directory to that target directory, remove the target file and exit.

Setup Command

hermes setup

Running hermes setup creates the config_path directory if specified in the .hermes.yml file or $HOME/.hermes by default. This ensures the directory is available for subsequent commands and should only be run once.

Alias Command

hermes alias

This command is meant only to provide the alias for a terminal session so it should be added to a shell profile, but not used otherwise. It writes to stdout a bash function which runs the hermes binary with the given args, then if a target file was written, it read the content as a directory to cd into. This is necessary because it is the only way which hermes can move the shell session's current working directory.