Check multiple git repository in one pass / Vérifiez vos dépôt git en une seule passe
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
gitcheck
requirements
.gitignore Add .gitignore to avoid to commit wrong files Feb 21, 2015
.travis.yml Remove deprecated pip option Nov 21, 2016
CHANGELOG.txt Check git repositories from an docker container May 6, 2015
LICENSE Update the setup.py package May 5, 2015
MANIFEST.in Update the setup.py package May 5, 2015
Makefile Add a Makefile May 5, 2015
README.rst Update the doc Nov 22, 2015
coverage.rc Default coverage configuration file added Oct 12, 2015
mygitcheck.py.sample Add colortheme feature #27 Nov 22, 2015
pep8.rc Mising files for PEP8 coding style May 6, 2015
setup.py Update the setup.py package May 5, 2015
tests.py Add colortheme feature #27 Nov 22, 2015

README.rst

https://travis-ci.org/badele/gitcheck.svg?branch=unittest

gitcheck

When working simultaneously on several git repositories, it is easy to loose the overview on the advancement of your work. This is why I decided to write gitcheck, a tool which reports the status of the repositories it finds in a file tree. This report can of course be displayed on the terminal but also be sent by email.

Now you can also check your host git from an docker container. See the docker section

Installation

pip install git+git://github.com/badele/gitcheck.git

Examples

Simple report

In a simple invocation, gitcheck shows for each repository found in the file tree rooted at the current working directory if they have changes to be committed or commits to be pushed.

$ gitcheck.py
Gitcheck simple report

Gitcheck simple report

Detailed report

This invocation is substantially identical to the previous one, but the generated report also enumerates modified files and pending commits.

$ gitcheck.py -v
Gitcheck detailed report

Gitcheck detailed report

Gitcheck customization

You can customize the output color, the gitcheck try to find ~/mygitcheck.py if it found, it is imported, see the mygitcheck.py.sample

Docker container

You can check your git repositories from an docker container (from your host)

From the host, you can use this command

$ docker run --rm -v `pwd`:/files:ro badele/alpine-gitcheck

or

$ docker run --rm -v `pwd`:/files:ro badele/alpine-gitcheck cd /files && gitcheck OPTIONS

You can also create a shell function into the host, exemple for ZSH

gitcheck (){
    docker run --rm -v `pwd`:/files:ro badele/alpine-gitcheck
}
#
$ gitcheck

More info about the gitcheck container https://registry.hub.docker.com/u/badele/alpine-gitcheck/

Options

-v, --verbose                        Show files & commits
--debug                              Show debug message
-r, --remote                         force remote update(slow)
-u, --untracked                      Show untracked files
-b, --bell                           bell on action needed
-w <sec>, --watch=<sec>              after displaying, wait <sec> and run again
-i <re>, --ignore-branch=<re>        ignore branches matching the regex <re>
-d <dir>, --dir=<dir>                Search <dir> for repositories
-m <maxdepth>, --maxdepth=<maxdepth> Limit the depth of repositories search
-q, --quiet                          Display info only when repository needs action
-e, --email                          Send an email with result as html, using mail.properties parameters
--init-email                         Initialize mail.properties file (has to be modified by user using JSON Format)

French version

A French version of this document is available here: http://bruno.adele.im/projets/gitcheck/