{"id":24881886,"url":"https://github.com/01joseph-hwang10/git-remote-get","last_synced_at":"2026-05-07T18:10:34.220Z","repository":{"id":224909603,"uuid":"764454069","full_name":"01Joseph-Hwang10/git-remote-get","owner":"01Joseph-Hwang10","description":"Download single files or directories from a git remote repository without cloning its entire contents.","archived":false,"fork":false,"pushed_at":"2024-05-09T15:36:00.000Z","size":138,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-01-01T11:02:30.589Z","etag":null,"topics":["cli","download","git","github","single-file"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/git-remote-get/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/01Joseph-Hwang10.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":".github/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-02-28T05:18:14.000Z","updated_at":"2024-05-09T15:35:50.000Z","dependencies_parsed_at":"2024-05-09T16:55:15.948Z","dependency_job_id":null,"html_url":"https://github.com/01Joseph-Hwang10/git-remote-get","commit_stats":null,"previous_names":["01joseph-hwang10/git-remote-get"],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/01Joseph-Hwang10%2Fgit-remote-get","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/01Joseph-Hwang10%2Fgit-remote-get/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/01Joseph-Hwang10%2Fgit-remote-get/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/01Joseph-Hwang10%2Fgit-remote-get/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/01Joseph-Hwang10","download_url":"https://codeload.github.com/01Joseph-Hwang10/git-remote-get/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245798353,"owners_count":20673902,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","download","git","github","single-file"],"created_at":"2025-02-01T12:14:13.869Z","updated_at":"2026-05-07T18:10:29.168Z","avatar_url":"https://github.com/01Joseph-Hwang10.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# git-remote-get\n\n[![PyPI version](https://badge.fury.io/py/git-remote-get.svg)](https://pypi.org/project/git-remote-get)\n[![Testsuite](https://github.com/01Joseph-Hwang10/git-remote-get/workflows/Test%20and%20Lint/badge.svg)](https://github.com/01Joseph-Hwang10/git-remote-get/actions?query=workflow%3A\"Test+and+Lint\")\n[![Python version](https://img.shields.io/pypi/pyversions/git-remote-get.svg)](https://pypi.org/project/git-remote-get)\n[![Project Status](https://img.shields.io/pypi/status/git-remote-get.svg)](https://pypi.org/project/git-remote-get/)\n[![Supported Interpreters](https://img.shields.io/pypi/implementation/git-remote-get.svg)](https://pypi.org/project/git-remote-get/)\n[![License](https://img.shields.io/pypi/l/git-remote-get.svg)](https://github.com/pawelzny/git-remote-get/blob/master/LICENSE)\n\nDownload single files or directories from a git remote repository without cloning its entire contents.\n\n## Installation\n\n```bash\npip install git-remote-get\n```\n\n## Usage\n\n```bash\nUsage: git-remote-get [OPTIONS] PATH [DESTINATION]\n\n  Get a file from a remote git repository\n\n  Arguments:     \n    PATH: The path on the remote repository to get the file from\n    DESTINATION: The path to save the file to. Defaults to the same as the path.\n\nOptions:\n  --repo TEXT          The repo to get the file from. You can also set the\n                       GGET_REPO environment variable to set this option.\n  --from TEXT          Alias for --repo\n  --owner TEXT         The owner of the repo to get the file from. You can\n                       also set the GGET_OWNER environment variable to set\n                       this option.  [required]\n  --provider [github]  The remote repository provider to get the file from.\n                       Defaults to github. Currently, only github is\n                       supported. You can set the GGET_PROVIDER environment\n                       variable to set this option.\n  --ref TEXT           Branch or commit to get the file from. Defaults to\n                       master. You can set the GGET_REF environment variable\n                       to set this option.\n  --help               Show this message and exit.\n```\n\nYou can also use the `gget` alias for `git-remote-get`.\n\n## `.env` template\n\nYou can create a `.env` file in the root of your project \nto set default options for the program.\n\n```bash\n# .env\nGGET_OWNER='\u003cyour-git-remote-repository-owner-name\u003e'\nGGET_REPO='\u003cyour-git-remote-repository-name\u003e'\nGGET_PROVIDER='github'\nGGET_REF='\u003cyour-git-remote-repository-branch-or-commit\u003e'\n```\n\n## Examples\n\n```bash\n# This will download the README file from the octocat/Hello-World repository\n# and save it to the current directory with same name\ngget README --owner=octocat --repo=Hello-World\n\n# This will download the README file\n# and save it to docs/README.md\ngget README --owner=octocat --repo=Hello-World docs/README.md\n\n# This will download `examples/tutorial`\n# of flask repository and save it to the current directory.\n#\n# If destination is not provided, the program\n# will create a directory with the same name as the PATH.\n#\n# In other words, you will get `examples/tutorial` directory\n# and its contents inside that directory.\ngget examples/tutorial --owner=pallets --repo=flask --ref=main\n\n# This will download the `examples/tutorial`\n# of flask repository and save it to `tutorial` directory.\n#\n# In this case, the destination is provided.\n# Contents under `examples/tutorial` will be saved to `tutorial-contents` directory.\ngget examples/tutorial --owner=pallets --repo=flask --ref=main tutorial-contents\n```\n\n## Contributing\n\nAny contribution is welcome! Check out [CONTRIBUTING.md](https://github.com/01Joseph-Hwang10/git-remote-get/blob/master/.github/CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](https://github.com/01Joseph-Hwang10/git-remote-get/blob/master/.github/CODE_OF_CONDUCT.md) for more information on how to get started.\n\n## License\n\n`git-remote-get` is licensed under a [MIT License](https://github.com/01Joseph-Hwang10/git-remote-get/blob/master/LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F01joseph-hwang10%2Fgit-remote-get","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F01joseph-hwang10%2Fgit-remote-get","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F01joseph-hwang10%2Fgit-remote-get/lists"}