garbas / github-collective Goto Github PK

Github organization are great way for organization to manage their git repositories. This tool will let you automate tedious tasks of creating teams, granting permission and creating repositories.

Approach that github-collective tool takes is that you edit central configuration (for now only ini-like file) from where configuration is read and updated respectivly.

Initially purposo of this scrip is to manage Plone's collective organisation on github: https://collective.github.com

% pip install github-collective
(or)
% easy_install github-collective

When github-collective is installed it should create executable with same name.

% bin/github-collective --help
usage: github-collective [-h] -c CONFIG [-M MAILER] [-C CACHE] -o GITHUB_ORG
                         -u GITHUB_USERNAME -P GITHUB_PASSWORD [-v] [-p]

This tool will let you automate tedious tasks of creating teams granting
permission and creating repositories.

optional arguments:
  -h, --help            show this help message and exit
  -c CONFIG, --config CONFIG
                        path to configuration file (could also be remote
                        location). eg.
                        http://collective.github.com/permissions.cfg (default:
                        None)
  -M MAILER, --mailer MAILER
                        TODO (default: None)
  -C CACHE, --cache CACHE
                        path to file where to cache results from github.
                        (default: None)
  -o GITHUB_ORG, --github-org GITHUB_ORG
                        github organisation. (default: None)
  -u GITHUB_USERNAME, --github-username GITHUB_USERNAME
                        github account username. (default: None)
  -P GITHUB_PASSWORD, --github-password GITHUB_PASSWORD
                        github account password. (default: None)
  -v, --verbose
  -p, --pretend

% bin/github-collective \
    -c example.cfg \ # path to configuration file
    -o vim-addons \  # organization that we are
    -u garbas \      # account that has management right for organization
    -P PASSWORD      # account password

% bin/github-collective \
    -c https://raw.github.com/garbas/github-collective/master/example.cfg \
                     # url to configuration file
    -o collective \  # organization that we are
    -u garbas \      # account that has management right for organization
    -P PASSWORD      # account password

% bin/github-collective \
    -c https://raw.github.com/garbas/github-collective/master/example.cfg \
                     # url to configuration file
    -C .cache        # file where store and read cached results from github
    -o collective \  # organization that we are
    -u garbas \      # account that has management right for organization
    -P PASSWORD      # account password

• Send emails to owners about removing repos
• better logging mechanism (eg. logbook)

• fix caching file bug, cache now working [garbas]

• remane team to old_team to keep convention in sync.run method, using add instead of update on sets [e48de49, garbas]
• pretend should work for all except get reuqest type [e098f9d, garbas]
• nicer dump of json in cache file, unindent section which searches for repos defined in teams [b8cb123, garbas]
• we should write to cache file when there is no cache file avaliable [fd7f9ee, garbas]

• and we have first bugfix relese, after refractoring and merging enable-cache branch. [a09d174, garbas]

• initial release [garbas]