From 202b9e44a8abb1dc3bde198705e97a60ff406909 Mon Sep 17 00:00:00 2001 From: Steffen Vogel Date: Thu, 26 Jun 2014 00:28:35 +0200 Subject: [PATCH] updated README --- README.markdown | 40 ++++++++++++++++++++++++++++++---------- 1 file changed, 30 insertions(+), 10 deletions(-) diff --git a/README.markdown b/README.markdown index daff30a..2245017 100644 --- a/README.markdown +++ b/README.markdown @@ -1,17 +1,13 @@ GitHub-Backup -============= - -Idea/original implementation by Chris Lockfort (clockfort@csh.rit.edu) (Github username: Clockfort) - -Python version by Anthony Gargiulo (anthony@agargiulo.com) (Github username: agargiulo) +============================ Description ----- +---------------------------- -GitHub-Backup makes a local backup copy of all of a github user's (or github organization's) repositories. +GitHub-Backup makes a local backup copy of all of a github user's (or github organization's) repositories. Dependencies ----- +---------------------------- GitHub-Backup requires `pygithub3` a Python library for the GitHub API v3. @@ -20,9 +16,10 @@ Installation is simple with pip install pygithub3 Usage ------ +---------------------------- ```` -usage: github-backup.py [-h] [-c] [-m] [-g ARGS] [-s SUFFIX] +usage: github-backup.py [-h] [-c] [-m] [-S] [-g ARGS] [-s SUFFIX] [-P PREFIX] + [-p PASSWORD] [-t TOKEN] [-o ORG] username backupdir makes a backup of all of a github user's repositories @@ -36,9 +33,18 @@ optional arguments: -c, --cron Use this when running from a cron job -m, --mirror Create a bare mirror -f, --skip-forks Skip forks + -S, --ssh Use SSH protocol -g ARGS, --git ARGS Pass extra arguments to git -s SUFFIX, --suffix SUFFIX Add suffix to repository directory names + -P PREFIX, --prefix PREFIX + Add prefix to repository directory names + -p PASSWORD, --password PASSWORD + Authenticate with Github API + -t TOKEN, --token TOKEN + OAuth token for authentification + -o ORG, --organization ORG + Backup Organizational repositories ```` Then, put it in a cron job somewhere and forget about it for eternity. @@ -62,3 +68,17 @@ Questions, Improvements, Etc ----------------------------- If you have any improvements, I'm happy, (grateful, in fact) to entertain pull requests/patches, just drop me a line or message me on GitHub. + +Contributors +---------------------------- + +Idea/original implementation by + +- Chris Lockfort (clockfort@csh.rit.edu) (Github: Clockfort) + (Original idea) + +- Anthony Gargiulo (anthony@agargiulo.com) (Github: agargiulo) + (Python version) + +- Steffen Vogel (post@steffenvogel.de) (Github: stv0g) + (A lot of patches and improvements)