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.1.tar.gz (12.9 kB view details)

Uploaded Source

Built Distribution

github_backup-0.12.1-py2-none-any.whl (12.9 kB view details)

Uploaded Python 2

File details

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

File metadata

File hashes

Hashes for github-backup-0.12.1.tar.gz
Algorithm Hash digest
SHA256 843b9b83c19b966dc1d0bcac4f069a89b51af51aa32a80e93cfe022eb3be36fa
MD5 6c7a8196e5f68618037ff16f54682525
BLAKE2b-256 b7bbd699a67b0c74aa6b8193735f95caae6f053300a9c05b3c325d95ae068ae4

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for github_backup-0.12.1-py2-none-any.whl
Algorithm Hash digest
SHA256 e052a84c0a14a5dee05eb7f55a76dc3ff4259dc4eb2860aeddf36646da3b89d3
MD5 71aaee2a638408c8b4d62c812ba1b73d
BLAKE2b-256 69e8c2cdb8a7ca9e4f35b5990ab1a399f9fe32add8d6a8d826de8378053f04aa

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