github-dl is a lightweight command line tool for downloading repositories from github.com and gists from gist.github.com. github-dl has been tested on python 2.7.12 and python 3.5.2.
The project was recently added to PYPI. Feel free to submit an issue if there are any issues with downloading via the command below...
pip install github-dlInstall the project by downloading the project as a zip file or cloning the repository. After downloading the source, run the following command to install in the root directory of the project...
pip install -e .github-dl's functionality is currently fairly limited, but the following functionality is supported
| command line argument/option | functionality |
|---|---|
--help |
list arguments/options for tool |
--username |
github username for credentials |
--password |
github password for credentials |
--token |
github token for credentials |
--config |
filename for configuration file |
The config file is an optional file that stores github credentials in the following required format.
{
"username" : "username",
"password" : "secret_password",
"token" : "secret_token"
}**NOTE: ** None of the credentials are required in the configuration file and token has the highest priority.
| command line argument/option | functionality |
|---|---|
queries |
query for filtering github repositories |
destination |
directory to download repositories to |
Download all machine learning related notebooks matching a criteria:
$ github-dl 'machine learning language:jupyter-notebook size:<1000' github-notebooks --config=config.json
| command line argument/option | functionality |
|---|---|
sources |
list of github users accounts to download gists |
destination |
directory to download gists to |
--extension |
file extension to download ex: ipynb |
Download all public jupyter notebooks:
$ gist-dl gist-notebooks --config=config.json --extension=ipynb
Download a specific user's public jupyter notebooks:
$ gist-dl cameres gist-notebooks --config=config.json --extension=ipynb