spajus / gitmon Goto Github PK

View Code? Open in Web Editor NEW

37.0 5.0 4.0 606 KB

Git Repository Monitor

License: GNU General Public License v3.0

Python 100.00%

gitmon's Introduction

GitMon - The Git Repository Monitor

Installation

Requirements:

Python 2.6+
Git
growlnotify (http://growl.info/), python-notify (for libnotify on linux) or a command line tool for notifications

To install without downloading source:

sudo easy_install gitmon

or from source folder:

sudo python setup.py install

When building from source, you may need to install gitpython (sudo easy_install gitpython).

Usage

usage: gitmon [-v] [--version] [-c <path>] [-h|--help]

Parameters:
  -v          Verbose output
  --version   Prints GitMon version
  -c <path>   Runs GitMon using configuration file provided in <path>
  -h, --help  Prints help

Commands:
              When no command is given, GitMon scans repositories for updates
  test        Checks configuration and displays test notification
  configure   Opens GitMon configuration file for editing

You have three options for placing your configuration file:

Recommended approach: Run 'gitmon' after a fresh install and it will create you ~/.gitmon.conf, then run 'gitmon configure' to edit it
Put gitmon.conf anywhere you want and define GITMON_CONF env variable ('gitmon configure' will not work though)
Run gitmon with -c /path/to/config.file (useful during development)

Known Issues

When there is a large number of changes, growl notification may exceed desktop height therefore it gets not fully visible.

Roadmap

GUI version (at least for Mac OS X)

Contact

Suggestions, improvements? [email protected]

gitmon's People

Contributors

Stargazers

Watchers

Forkers

huitseeker williamren security-prince jyotirmaya

gitmon's Issues

Feature request: use the notify-python bindings for libnotify in a notifier

It would be cool to see an implementation accessing libnotify using the notify-python bindings, rather than the notify-send executable:

http://www.galago-project.org/downloads.php

http://www.galago-project.org/news/index.php

'Repo' object has no attribute 'remote'

Hi I have an error trying to run Gitmon on Ubuntu 11.10:
Failed checking updates for %repo_name%: 'Repo' object has no attribute 'remote'
python-git version is 0.1.6-1

On first run copy gitmon.conf.example to ~/.gitmon.conf and offer to edit it

This will be handy for new users

Does not start under Ubuntu 10.10.

Installed as sudo easy_install gitmon.

Trying to run : http://pastie.org/1538566

Current sched integration breaks functionality

Must be reworked.

Quickstart video link doesn't work anymore

Quickstart video link listed in the README doesn't work anymore.

Package dependency libraries inside GitMon

Currently user has to install all dependencies manually. This should not be the case.

Setuptools installation bundle

Make gitmon installable with setuptools

Installation package for Mac OS X

Depends on sched.

Problem with libnotify under Fedora (Rawhide)

Running gitmon under Fedora with configured libnotify ends with:

GitMon Self Test. You should see a notification right now. Install Growl from http://growl.info if you don't.

(gitmon:20261): libnotify-WARNING *: you must call notify_init() before showing
*
libnotify:ERROR:notification.c:568:notify_notification_show: code should not be reached
Przerwane (core dumped)

After adding line:
pynotify.init("GitMon") after from notifiers import * notifications works without problems.

Use python-based scheduler instead of deferring scheduling to cron

This is a good candidate: http://docs.python.org/release/2.6.6/library/sched.html

Removing remote branch locally fails

Traceback (most recent call last):
File "/usr/local/bin/gitmon", line 5, in
pkg_resources.run_script('GitMon==0.3.1', 'gitmon')
File "/Library/Python/2.6/site-packages/setuptools-0.6c12dev_r88124-py2.6.egg/pkg_resources.py", line 489, in run_script

File "/Library/Python/2.6/site-packages/setuptools-0.6c12dev_r88124-py2.6.egg/pkg_resources.py", line 1207, in run_script
# we assume here that our metadata may be nested inside a "basket"
File "/Library/Python/2.6/site-packages/GitMon-0.3.1-py2.6.egg/EGG-INFO/scripts/gitmon", line 129, in
main()
File "/Library/Python/2.6/site-packages/GitMon-0.3.1-py2.6.egg/EGG-INFO/scripts/gitmon", line 88, in main
scheduler = do_check(conf_file = conf_file)
File "/Library/Python/2.6/site-packages/GitMon-0.3.1-py2.6.egg/EGG-INFO/scripts/gitmon", line 114, in do_check
app.check()
File "/Library/Python/2.6/site-packages/GitMon-0.3.1-py2.6.egg/gitmon/gitmon.py", line 418, in check
for repo, st in self.get_repo_updates():
File "/Library/Python/2.6/site-packages/GitMon-0.3.1-py2.6.egg/gitmon/gitmon.py", line 425, in get_repo_updates
yield (repo, repo.check_status())
File "/Library/Python/2.6/site-packages/GitMon-0.3.1-py2.6.egg/gitmon/gitmon.py", line 89, in check_status
local_commits[rem.remote_head] = rem.commit
File "/Library/Python/2.6/site-packages/GitPython-0.3.1-py2.6.egg/git/refs/symbolic.py", line 165, in _get_commit
obj = self._get_object()
File "/Library/Python/2.6/site-packages/GitPython-0.3.1-py2.6.egg/git/refs/symbolic.py", line 158, in _get_object
return Object.new_from_sha(self.repo, hex_to_bin(self.dereference_recursive(self.repo, self.path)))
File "/Library/Python/2.6/site-packages/GitPython-0.3.1-py2.6.egg/git/refs/symbolic.py", line 112, in dereference_recursive
hexsha, ref_path = cls._get_ref_info(repo, ref_path)
File "/Library/Python/2.6/site-packages/GitPython-0.3.1-py2.6.egg/git/refs/symbolic.py", line 139, in _get_ref_info
raise ValueError("Reference at %r does not exist" % ref_path)
ValueError: Reference at 'refs/remotes/origin/master' does not exist