{"id":13405704,"url":"https://github.com/github-tooling/ghtopdep","last_synced_at":"2025-03-14T10:31:30.576Z","repository":{"id":35069179,"uuid":"202996651","full_name":"github-tooling/ghtopdep","owner":"github-tooling","description":":star: CLI tool for sorting dependents repo by stars","archived":false,"fork":false,"pushed_at":"2024-09-04T00:35:17.000Z","size":149,"stargazers_count":257,"open_issues_count":6,"forks_count":18,"subscribers_count":5,"default_branch":"master","last_synced_at":"2024-10-04T06:45:42.017Z","etag":null,"topics":["cli","dependencies","github"],"latest_commit_sha":null,"homepage":"","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/github-tooling.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"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":"2019-08-18T11:52:01.000Z","updated_at":"2024-10-02T08:27:01.000Z","dependencies_parsed_at":"2024-01-13T19:46:57.185Z","dependency_job_id":"cca9ca48-03a5-476d-86ee-2f690f51fef5","html_url":"https://github.com/github-tooling/ghtopdep","commit_stats":{"total_commits":28,"total_committers":2,"mean_commits":14.0,"dds":0.0714285714285714,"last_synced_commit":"6f23e0f3449e6be0d4c3000c50201ba4d610b97f"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github-tooling%2Fghtopdep","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github-tooling%2Fghtopdep/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github-tooling%2Fghtopdep/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/github-tooling%2Fghtopdep/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/github-tooling","download_url":"https://codeload.github.com/github-tooling/ghtopdep/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221458177,"owners_count":16825271,"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","dependencies","github"],"created_at":"2024-07-30T19:02:09.030Z","updated_at":"2025-03-14T10:31:30.570Z","avatar_url":"https://github.com/github-tooling.png","language":"Python","readme":"# GHTOPDEP\n\n[![image](https://img.shields.io/pypi/v/ghtopdep.svg)](https://pypi.org/project/ghtopdep/)\n[![image](https://img.shields.io/pypi/l/ghtopdep.svg)](https://pypi.org/project/ghtopdep/)\n[![image](https://img.shields.io/pypi/pyversions/ghtopdep.svg)](https://pypi.org/project/ghtopdep/)\n\nCLI tool for sorting dependents repo by stars\n\n## Requirements\n\n- Python 3.5 and up\n- Python development libraries\n\n## Installation\n\n### From PyPI\n\n```sh\n$ pip install ghtopdep\n```\n\n### From git repository\n\n```sh\n$ pip install git+https://github.com/github-tooling/ghtopdep.git#egg=ghtopdep\n```\n\n### From source\n\n```sh\n$ git clone https://github.com/github-tooling/ghtopdep\n$ cd ghtopdep\n$ python setup.py install\n```\n\n### Using docker (from source)\n\nFirst `docker build` the image once:\n\n```sh\n$ git clone https://github.com/github-tooling/ghtopdep\n$ cd ghtopdep\n$ docker build . -t ghtopdep\n```\n\nThen you can `docker run` it:\n\n```sh\n$ docker run --rm -it ghtopdep --help\n```\n\n## Python development Installation\n\n### Ubuntu/Debian\n\n```sh\nsudo apt install python3-dev\n```\n\n### CentOS/RHEL\n\n```sh\nsudo yum install python3-devel\n```\n\n## Version upgrade\n\n```sh\n➜ pip install --upgrade ghtopdep\n```\n\n## Usage\n\nIf you want retrieve packages or repositories description you need pass token.\nTo prevent rale limit being exceeded for unauthentIcated requests, ghtopdep needs an access token.\nFor public repositories, [create a token](https://github.com/settings/tokens/new?scopes=public_repo\u0026description=ghtopdep)\nwith the public_repo permission.\n\nYou can use token as environment variable `GHTOPDEP_TOKEN` at `~/.bashrc` or `~/.zshrc`\n\nexport GHTOPDEP_TOKEN=\"**\\*\\*\\*\\***\\*\\***\\*\\*\\*\\***\\*\\*\\*\\***\\*\\*\\*\\***\\*\\***\\*\\*\\*\\***\"\n\nor pass token as option --token\n\n```sh\n➜ ghtopdep --help\nUsage: ghtopdep [OPTIONS] URL\n\nOptions:\n  --repositories / --packages  Sort repositories or packages (default\n                               repositories)\n  --table / --json             View mode\n  --description                Show description of packages or repositories\n                               (performs additional request per repository)\n  --rows INTEGER               Number of showing repositories (default=10)\n  --minstar INTEGER            Minimum number of stars (default=5)\n  --search TEXT                search code at dependents\n                               (repositories/packages)\n  --token TEXT\n  --help                       Show this message and exit.\n```\n\n### Table view (by default)\n\n```sh\n➜ ghtopdep https://github.com/dropbox/dropbox-sdk-js\n| url                                               | stars   |\n|---------------------------------------------------|---------|\n| https://github.com/transloadit/uppy               | 21K     |\n| https://github.com/codesandbox/codesandbox-client | 8.6K    |\n| https://github.com/joemccann/dillinger            | 6.5K    |\n| https://github.com/keplergl/kepler.gl             | 5.8K    |\n| https://github.com/jitsi/jitsi-meet               | 4.5K    |\n| https://github.com/jsbin/jsbin                    | 4.0K    |\n| https://github.com/NorthwoodsSoftware/GoJS        | 3.8K    |\n| https://github.com/buttercup/buttercup-desktop    | 3.1K    |\n| https://github.com/openstyles/stylus              | 2.3K    |\n| https://github.com/mickael-kerjean/filestash      | 2.0K    |\nfound 1660 repositories others repositories are private\nfound 443 repositories with more than zero star\n~ via ⬢ v12.5.0 via 🐘 v7.2.19 via 🐍 3.8.0 took 2m 57s\n```\n\n### JSON view\n\n```sh\n➜ ghtopdep https://github.com/dropbox/dropbox-sdk-js --json\n[{\"url\": \"https://github.com/transloadit/uppy\", \"stars\": 21191}, {\"url\": \"https://github.com/codesandbox/codesandbox-client\", \"stars\": 8386}, {\"url\": \"https://github.com/joemccann/dillinger\", \"stars\": 6491}, {\"url\": \"https://github.com/keplergl/kepler.gl\", \"stars\": 5615}, {\"url\": \"https://github.com/jitsi/jitsi-meet\", \"stars\": 4303}, {\"url\": \"https://github.com/jsbin/jsbin\", \"stars\": 3947}, {\"url\": \"https://github.com/NorthwoodsSoftware/GoJS\", \"stars\": 3692}, {\"url\": \"https://github.com/buttercup/buttercup-desktop\", \"stars\": 3054}, {\"url\": \"https://github.com/openstyles/stylus\", \"stars\": 2219}, {\"url\": \"https://github.com/mickael-kerjean/filestash\", \"stars\": 1869}]\n```\n\nyou can sort packages and fetch their description\n\n```sh\n➜ ghtopdep https://github.com/dropbox/dropbox-sdk-js --description --packages\n| url                                            | stars   | description                                                  |\n|------------------------------------------------|---------|--------------------------------------------------------------|\n| https://github.com/jsbin/jsbin                 | 4.0K    | Collaborative JavaScript Debugging App                       |\n| https://github.com/jvilk/BrowserFS             | 1.9K    | BrowserFS is an in-browser filesystem that emulates the...   |\n| https://github.com/coderaiser/cloudcmd         | 1.1K    | ✨☁️📁✨ Cloud Commander file manager for the web with...       |\n| https://github.com/node-red/node-red-web-nodes | 153     | A collection of node-red nodes aimed at web services         |\n| https://github.com/robertknight/passcards      | 133     | A 1Password-compatible command-line and web-based...         |\n| https://github.com/enyojs/ares-project         | 125     | A browser-based code editor and UI designer for Enyo 2...    |\n| https://github.com/transloadit/uppy-server     | 114     | [DEPRECATED] 'Uppy Server' was renamed to 'Companion' and... |\n| https://github.com/bioimagesuiteweb/bisweb     | 34      | This is the repository for the BioImage Suite Web Project    |\n| https://github.com/sallar/dropbox-fs           | 30      | :package: Node FS wrapper for Dropbox                        |\n| https://github.com/filefog/filefog             | 26      | A thin cloud-service agnostic wrapper/interface to access... |\nfound 140 packages others packages are private\nfound 61 packages with more than zero star\n```\n\nalso ghtopdep support code searching at dependents (repositories/packages)\n\n```sh\n➜ ghtopdep https://github.com/rob-balfre/svelte-select --search=isMulti --minstar=0\nhttps://github.com/andriyor/linkorg-frontend/blob/7eed49c332f127c8541281b85def80e54c882920/src/App.svelte with 0 stars\nhttps://github.com/andriyor/linkorg-frontend/blob/7eed49c332f127c8541281b85def80e54c882920/src/providers/Post.svelte with 0 stars\nhttps://github.com/jdgaravito/bitagora_frontend/blob/776a23f5e848995d3eba90563d55c96429470c48/src/Events/AddEvent.svelte with 0 stars\nhttps://github.com/gopear/OlcsoSor/blob/b1fa1d877a59f7daf41a86fecb21137c91652d77/src/routes/index.svelte with 3 stars\nhttps://github.com/openstate/allmanak/blob/ff9ac0833e5e63f7c17f99c5c2355b4e46c48148/app/src/routes/index.svelte with 3 stars\nhttps://github.com/openstate/allmanak/blob/e6d7aa72a8878eefc6f63a27c983894de1cef294/app/src/components/ReportForm.svelte with 3 stars\nhttps://github.com/wolbodo/members/blob/d091f1e44b4e8cb8cc31f39ea6f6e9c36211d019/sapper/src/components/Member.html with 1 stars\n```\n\n## Development setup\n\nUsing [Poetry](https://poetry.eustace.io/docs/)\n\n```sh\n$ poetry install\n$ poetry run ghtopdep https://github.com/dropbox/dropbox-sdk-js\n$ dephell deps convert --from=pyproject.toml --to=setup.py\n$ poetry build\n$ poetry publish\n```\n\n[poetry2setup: Convert python-poetry(pyproject.toml) to setup.py.](https://github.com/abersheeran/poetry2setup)\n\nor [Pipenv](https://docs.pipenv.org/)\n\n```sh\n$ pipenv install --dev -e .\n```\n\n## License\n\n[MIT](https://choosealicense.com/licenses/mit/)\n\n## Alternatives\n\n[ghtracker](https://github.com/zer0yu/ghtracker) - not provide full result https://github.com/zer0yu/ghtracker/issues/2\n\n[github-by-stars](https://github.com/hacker-DOM/github-by-stars) - complex setup\n\n\n## References\n\n[Allow dependents to be sorted by stars · Issue #1537 · isaacs/github](https://github.com/isaacs/github/issues/1537)\n\n[Sorting the insights dependency graph lists · community · Discussion #5575](https://github.com/orgs/community/discussions/5575)\n","funding_links":[],"categories":["Python"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgithub-tooling%2Fghtopdep","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgithub-tooling%2Fghtopdep","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgithub-tooling%2Fghtopdep/lists"}