README.rst

git-m - multiple git replication and management tool

There are great tools for multiple gits (git repositories) management: repo and git submodules. But sometimes you can have dozens or hundreds of standalone gits which you would like to manage without overhead of manual initialization of repo or git submodules.

The mission of git-m is to simplify work with multiple gits.

• Features
  • Can be installed as custom git command 'm'
  • Discovers and replicates tree of standalone gits
  • Expands and works around limitations of original git commands
    • Performs a git command from an outer directory
    • Performs a git command on all repositories in directory tree
  • Compares status of current tree of gits against saved
  • Discovers status of tree of gits in various handy formats.
  • More features
• Install
• To do

Features

Can be installed as custom git command 'm'

To use git-m as custom git command copy it to PATH, for example to /usr/local/bin.

git m -h

Discovers and replicates tree of standalone gits

Standalone git [repository] is r. which is not included in repo or submodules.

git m --export

Then copy status.yaml to another host or location and run

git m --import

One-liner to replicate gits to another host:

git m --export - | ssh $HOST "mkdir -p $DIR; cd $DIR; git m --import -; ls"

Expands and works around limitations of original git commands

To use git-m with original git command just use arguments of git as arguments of git-m. If git-m is installed as custom command just add "m" between "git" and original command.

Performs a git command from an outer directory

Git refuses to work from outer directory:

$ git log some_project/some_file
fatal: not a git repository (or any parent up to mount point /)

You can use option -C

More easy just to use git-m. It changes directory to destination directory and performs requested command:

$ git m log some_project/some_file

This feature saves you from splitting patches and changing current directories between many repositories.

Performs a git command on all repositories in directory tree

$ git m describe --always --all
project .
heads/master
project A
heads/master
project B
heads/master

Compares status of current tree of gits against saved

Please see the built-in help for details.

Discovers status of tree of gits in various handy formats.

• pretty text table with shortened strings
• csv
• sha
• JSON
• YAML

Please see the built-in help for details.

More features

git-m --help

Install

sudo pip3 install ago prettytable repository munch pandas

sudo apt-get -f install python3-git

To do

• Accept list of files as input. For example pipe from: find . -name '.git' -printf "%hn"
• You are welcome to request new features