Skip to main content

backup a github user or organization

Project description

backup a github user or organization

Requirements

  • GIT 1.9+

Installation

Using PIP via PyPI:

pip install github-backup

Using PIP via Github:

pip install git+https://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] [-i] [--starred] [--watched]
              [--all] [--issues] [--issue-comments] [--issue-events]
              [--pulls] [--pull-comments] [--pull-commits] [--labels]
              [--hooks] [--milestones] [--repositories] [--bare]
              [--wikis] [--skip-existing]
              [-L [LANGUAGES [LANGUAGES ...]]] [-N NAME_REGEX]
              [-H GITHUB_HOST] [-O] [-R REPOSITORY] [-P] [-F]
              [--prefer-ssh] [-v]
              USER

Backup a github 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. If a username is given but
                        not a password, the password will be prompted for.
  -t TOKEN, --token TOKEN
                        personal access or OAuth token
  -o OUTPUT_DIRECTORY, --output-directory OUTPUT_DIRECTORY
                        directory at which to backup the repositories
  -i, --incremental     incremental backup
  --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
  --pulls               include pull requests in backup
  --pull-comments       include pull request review comments in backup
  --pull-commits        include pull request commits in backup
  --labels              include labels in backup
  --hooks               include hooks in backup (works only when
                        authenticated)
  --milestones          include milestones in backup
  --repositories        include repository clone in backup
  --bare                clone bare repositories
  --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
  -H GITHUB_HOST, --github-host GITHUB_HOST
                        GitHub Enterprise hostname
  -O, --organization    whether or not this is an organization user
  -R REPOSITORY, --repository REPOSITORY
                        name of repository to limit backup to
  -P, --private         include private repositories
  -F, --fork            include forked repositories
  --prefer-ssh          Clone repositories using SSH instead of HTTPS
  -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).

Authentication

Note: Password-based authentication will fail if you have two-factor authentication enabled.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

github-backup-0.12.0.tar.gz (12.6 kB view details)

Uploaded Source

Built Distribution

github_backup-0.12.0-py2-none-any.whl (12.8 kB view details)

Uploaded Python 2

File details

Details for the file github-backup-0.12.0.tar.gz.

File metadata

File hashes

Hashes for github-backup-0.12.0.tar.gz
Algorithm Hash digest
SHA256 067830970013741733361f7dc72c91401e4a33c8bf61d97051309ca0c473d989
MD5 382d0d906fd7a677fa389dde087c464f
BLAKE2b-256 709c3637b95c59a83fb08537f1375344e3f05afcd7c0a50c40da57ad21046160

See more details on using hashes here.

File details

Details for the file github_backup-0.12.0-py2-none-any.whl.

File metadata

File hashes

Hashes for github_backup-0.12.0-py2-none-any.whl
Algorithm Hash digest
SHA256 d74f1d1311d907c32ad31d08e527bca0aa67300a2fd81ad39c3ca30a4dc2e8d9
MD5 71ab653118ca5b683343f999fbdc8aab
BLAKE2b-256 e0ebc5f87a5cdf1ba6279068883f4cdb91210adc8743c480b03a41d14129bf0b

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page