Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sgnn7/gh_fetch
Downloader, archiver, and updater for your github repos
https://github.com/sgnn7/gh_fetch
Last synced: 7 days ago
JSON representation
Downloader, archiver, and updater for your github repos
- Host: GitHub
- URL: https://github.com/sgnn7/gh_fetch
- Owner: sgnn7
- License: mit
- Created: 2013-07-31T13:29:49.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2020-03-13T15:22:02.000Z (over 4 years ago)
- Last Synced: 2024-05-02T00:27:25.107Z (7 months ago)
- Language: Python
- Homepage:
- Size: 61.5 KB
- Stars: 3
- Watchers: 4
- Forks: 8
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
gh_fetch
========
### Downloader and updater for your github repos.
- Did you ever needed to keep a backup of a large number of GitHub repos?
- Did you ever need to start using your dev machine quickly but had to clone repos one by one?
- Did you ever need to update (fetch) a ton of repositories from GitHub but you had to do it one by one?
**gh_fetch** is designed to fix all of these problems by automating the process to the maximum extent possible. This tool will go through your (or another account's) GitHub repos both public and private including repositories from organizations you are a member of and fetch the most recent changes for it, cloning the relevant repos if they are not already downloaded. Feature set will be expanding per my current needs but you are free to fork and issue a pull request.
**Note: This code works with both Python3 (default) and Python2 (when invoked with `python2` prefix)**
```
$ ./update_repos -h
usage: update_repos [-h] [--version] [-d DIRECTORY] [-t TOKEN_FILE] [-s] [-m]
[-x] [--exclude-forks] [--exclude-orgs]
[--include-org-forks] [--include-public-org-repos]
[--full-backup] [--debug]
username [token]
Retrieve and/or update local copies of GitHub-hosted repos
positional arguments:
username GitHub username that will be used for cloning and
fetching
token GitHub auth token for that username. You can create
one at https://github.com/settings/applications
optional arguments:
-h, --help show this help message and exit
--version show program's version number and exit
-d DIRECTORY, --directory DIRECTORY
Target directory for cloning and fetching
-t TOKEN_FILE, --token-file TOKEN_FILE
File containing the github token
-s, --ssh Fetch repositories using ssh
-m, --mirror Mirror bare repositories instead of making full
checkouts
-x, --exclude-own Exclude own repositories in the updates
--exclude-forks Exclude forked repositories from the updates
--exclude-orgs Exclude repos that are in user's orgs (this does not
filter the ones you have)
--include-org-forks Include forked repos that are in user's orgs
--include-public-org-repos
Include public repos that are in user's orgs
--full-backup Include all repository content
--debug Enable debugging output
```
## Examples
- Getting all your repos:
```
./update_repos -d /opt/checkout --exclude-orgs sgnn7 1234567890abfdefghijkl
```
- Backing up all organizational repos:
```
./update_repos -x -d ~/backups --include-org-forks --include-public-org-repos backup-user 1234567890abfdefghijkl
```
## TODO
- Scrubbing of remote endpoints
- Lots of testing
## Contributors
- Srdjan Grubor ([@sgnn7](https://github.com/sgnn7))
- Dan Nicholson ([@dbnicholson](https://github.com/dbnicholson))
- Will Thompson ([@wjt](https://github.com/wjt))
- Nimrod Adar ([@adarnimrod](https://github.com/adarnimrod))