mirror of
https://github.com/josegonzalez/python-github-backup.git
synced 2026-01-21 04:43:07 +01:00
Fill out readme more
This commit is contained in:
60
README.rst
60
README.rst
@@ -3,3 +3,63 @@ github-backup
|
|||||||
=============
|
=============
|
||||||
|
|
||||||
backup a github user or organization
|
backup a github user or organization
|
||||||
|
|
||||||
|
Installation
|
||||||
|
============
|
||||||
|
|
||||||
|
Using PIP via PyPI::
|
||||||
|
|
||||||
|
pip install github-backup
|
||||||
|
|
||||||
|
Using PIP via Github::
|
||||||
|
|
||||||
|
pip install git+git://github.com/josegonzalez/python-github-backup.git#egg=github-backup
|
||||||
|
|
||||||
|
Usage
|
||||||
|
=====
|
||||||
|
|
||||||
|
CLI Usage is as follows::
|
||||||
|
|
||||||
|
Github Backup [-h] [-u USERNAME] [-p PASSWORD] [-t TOKEN]
|
||||||
|
[-o OUTPUT_DIRECTORY] [--starred] [--watched] [--all]
|
||||||
|
[--issues] [--issue-comments] [--issue-events]
|
||||||
|
[--repositories] [--wikis] [--skip-existing]
|
||||||
|
[-L [LANGUAGES [LANGUAGES ...]]] [-N NAME_REGEX]
|
||||||
|
[-R REPOSITORY] [-P] [-F] [-v]
|
||||||
|
USER
|
||||||
|
|
||||||
|
Backup a github users account
|
||||||
|
|
||||||
|
positional arguments:
|
||||||
|
USER github username
|
||||||
|
|
||||||
|
optional arguments:
|
||||||
|
-h, --help show this help message and exit
|
||||||
|
-u USERNAME, --username USERNAME
|
||||||
|
username for basic auth
|
||||||
|
-p PASSWORD, --password PASSWORD
|
||||||
|
password for basic auth
|
||||||
|
-t TOKEN, --token TOKEN
|
||||||
|
personal access or OAuth token
|
||||||
|
-o OUTPUT_DIRECTORY, --output-directory OUTPUT_DIRECTORY
|
||||||
|
directory at which to backup the repositories
|
||||||
|
--starred include starred repositories in backup
|
||||||
|
--watched include watched repositories in backup
|
||||||
|
--all include everything in backup
|
||||||
|
--issues include issues in backup
|
||||||
|
--issue-comments include issue comments in backup
|
||||||
|
--issue-events include issue events in backup
|
||||||
|
--repositories include repository clone in backup
|
||||||
|
--wikis include wiki clone in backup
|
||||||
|
--skip-existing skip project if a backup directory exists
|
||||||
|
-L [LANGUAGES [LANGUAGES ...]], --languages [LANGUAGES [LANGUAGES ...]]
|
||||||
|
only allow these languages
|
||||||
|
-N NAME_REGEX, --name-regex NAME_REGEX
|
||||||
|
python regex to match names against
|
||||||
|
-R REPOSITORY, --repository REPOSITORY
|
||||||
|
name of repository to limit backup to
|
||||||
|
-P, --private include private repositories
|
||||||
|
-F, --fork include forked repositories
|
||||||
|
-v, --version show program's version number and exit
|
||||||
|
|
||||||
|
The package can be used to backup an *entire* organization or repository, including issues and wikis in the most appropriate format (clones for wikis, json files for issues).
|
||||||
|
|||||||
Reference in New Issue
Block a user