Skip to main content

Download single files or directories from a git remote repository without cloning its entire contents.

Project description

git-remote-get

PyPI version Testsuite Python version Project Status Supported Interpreters License

Download single files or directories from a git remote repository without cloning its entire contents.

Installation

pip install git-remote-get

Usage

Usage: git-remote-get [OPTIONS] PATH [DESTINATION]

  Get a file from a remote git repository

  Arguments:     
    PATH: The path on the remote repository to get the file from
    DESTINATION: The path to save the file to. Defaults to the same as the path.

Options:
  --repo TEXT          The repo to get the file from. You can also set the
                       GGET_REPO environment variable to set this option.
  --from TEXT          Alias for --repo
  --owner TEXT         The owner of the repo to get the file from. You can
                       also set the GGET_OWNER environment variable to set
                       this option.  [required]
  --provider [github]  The remote repository provider to get the file from.
                       Defaults to github. Currently, only github is
                       supported. You can set the GGET_PROVIDER environment
                       variable to set this option.
  --ref TEXT           Branch or commit to get the file from. Defaults to
                       master. You can set the GGET_REF environment variable
                       to set this option.
  --help               Show this message and exit.

You can also use the gget alias for git-remote-get.

.env template

You can create a .env file in the root of your project to set default options for the program.

# .env
GGET_OWNER='<your-git-remote-repository-owner-name>'
GGET_REPO='<your-git-remote-repository-name>'
GGET_PROVIDER='github'
GGET_REF='<your-git-remote-repository-branch-or-commit>'

Examples

# This will download the README file from the octocat/Hello-World repository
# and save it to the current directory with same name
gget README --owner=octocat --repo=Hello-World

# This will download the README file
# and save it to docs/README.md
gget README --owner=octocat --repo=Hello-World docs/README.md

# This will download `examples/tutorial`
# of flask repository and save it to the current directory.
#
# If destination is not provided, the program
# will create a directory with the same name as the PATH.
#
# In other words, you will get `examples/tutorial` directory
# and its contents inside that directory.
gget examples/tutorial --owner=pallets --repo=flask --ref=main

# This will download the `examples/tutorial`
# of flask repository and save it to `tutorial` directory.
#
# In this case, the destination is provided.
# Contents under `examples/tutorial` will be saved to `tutorial-contents` directory.
gget examples/tutorial --owner=pallets --repo=flask --ref=main tutorial-contents

Contributing

Any contribution is welcome! Check out CONTRIBUTING.md and CODE_OF_CONDUCT.md for more information on how to get started.

License

git-remote-get is licensed under a MIT License.

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

git_remote_get-0.3.1.tar.gz (7.5 kB view details)

Uploaded Source

Built Distribution

git_remote_get-0.3.1-py3-none-any.whl (10.1 kB view details)

Uploaded Python 3

File details

Details for the file git_remote_get-0.3.1.tar.gz.

File metadata

  • Download URL: git_remote_get-0.3.1.tar.gz
  • Upload date:
  • Size: 7.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.11.9 Linux/6.5.0-1018-azure

File hashes

Hashes for git_remote_get-0.3.1.tar.gz
Algorithm Hash digest
SHA256 cfef6a21f2ef25e8475e05f48618da0d973914ce558422b841ba81bd6ac852a5
MD5 92ee5d4132a806dfea481942f2c03a60
BLAKE2b-256 84f3fb9005278481aca17cd05ac462f257805bdde28879c0d85dfc6a00757700

See more details on using hashes here.

File details

Details for the file git_remote_get-0.3.1-py3-none-any.whl.

File metadata

  • Download URL: git_remote_get-0.3.1-py3-none-any.whl
  • Upload date:
  • Size: 10.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.3 CPython/3.11.9 Linux/6.5.0-1018-azure

File hashes

Hashes for git_remote_get-0.3.1-py3-none-any.whl
Algorithm Hash digest
SHA256 69a7d7c25d554bc8c14c004c645d4df520ce545b4a300d56eb49d906ab7d6600
MD5 57f5458cb8f5e51859c89276cf8710ba
BLAKE2b-256 2f317cf66e9c9061a9d194d152738e4450c328ee2c6649447a3066654657e9e4

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