mirror of
https://github.com/clockfort/GitHub-Backup.git
synced 2025-03-23 00:00:05 +01:00
74 lines
2.4 KiB
Markdown
74 lines
2.4 KiB
Markdown
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.
|
|
|
|
Dependencies
|
|
----
|
|
|
|
GitHub-Backup requires `pygithub3` a Python library for the GitHub API v3.
|
|
|
|
Installation is simple with
|
|
|
|
pip install pygithub3
|
|
|
|
Usage
|
|
-----
|
|
````
|
|
usage: github-backup.py [-h] [-c] [-m] [-f] [-g ARGS] [-o ORGANIZATION] [-p PASSWORD] [-P PREFIX] [-s SUFFIX] [-S] [-t TOKEN]
|
|
username backupdir
|
|
|
|
makes a backup of all of a github user's repositories
|
|
|
|
positional arguments:
|
|
username A Github username
|
|
backupdir The folder where you want your backups to go
|
|
|
|
optional arguments:
|
|
-h, --help Show this help message and exit
|
|
-c, --cron Use this when running from a cron job
|
|
-m, --mirror Create a bare mirror
|
|
-f, --skip-forks Skip forks
|
|
-g ARGS, --git ARGS Pass extra arguments to git
|
|
-o ORGANIZATION, --organization ORGANIZATION
|
|
Backup Organizational repositories
|
|
-p PASSWORD, --password PASSWORD
|
|
Authenticate with Github API
|
|
-P PREFIX, --prefix PREFIX
|
|
Add prefix to repository directory names
|
|
-s SUFFIX, --suffix SUFFIX
|
|
Add suffix to repository directory names
|
|
-S, --ssh Use SSH protocol
|
|
-t TOKEN, --token TOKEN
|
|
Authenticate with Github API using OAuth token
|
|
|
|
````
|
|
|
|
Then, put it in a cron job somewhere and forget about it for eternity.
|
|
|
|
Why This Software Exists
|
|
-------------------------
|
|
This software is useful in many cases:
|
|
|
|
- GitHub suddenly explodes.
|
|
|
|
- GitHub goes out of business.
|
|
|
|
- Your corporation's backup policies are more stringent than GitHub's.
|
|
|
|
- You have spotty/no internet access - perhaps you'd like to have all of your repositories available to code on while you ride the train?
|
|
|
|
- You are paranoid tinfoil-hat wearer who needs to back up everything in triplicate on a variety of outdated tape media.
|
|
|
|
|
|
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.
|