| Name | ghtopdep JSON |
| Version |
0.4.3
JSON |
| download |
| home_page | None |
| Summary | CLI tool for sorting dependents repositories and packages by stars |
| upload_time | 2024-08-02 20:54:17 |
| maintainer | None |
| docs_url | None |
| author | Andriy Orehov |
| requires_python | <4.0,>=3.7 |
| license | MIT |
| keywords |
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# GHTOPDEP
[](https://pypi.org/project/ghtopdep/)
[](https://pypi.org/project/ghtopdep/)
[](https://pypi.org/project/ghtopdep/)
CLI tool for sorting dependents repo by stars
## Requirements
- Python 3.5 and up
- Python development libraries
## Installation
from PyPI
```
$ pip install ghtopdep
```
from git repository
```
$ pip install git+https://github.com/github-tooling/ghtopdep.git#egg=ghtopdep
```
from source
```
$ git clone https://github.com/github-tooling/ghtopdep
$ cd ghtopdep
$ python setup.py install
```
## Python development Installation
Ubuntu/Debian
```
sudo apt install python3-dev
```
CentOS/RHEL
```
sudo yum install python3-devel
```
## Version upgrade
```
➜ pip install --upgrade ghtopdep
```
## Usage
If you want retrieve packages or repositories description you need pass token.
To prevent rale limit being exceeded for unauthentIcated requests, ghtopdep needs an access token.
For public repositories, [create a token](https://github.com/settings/tokens/new?scopes=public_repo&description=ghtopdep)
with the public_repo permission.
You can use token as environment variable `GHTOPDEP_TOKEN` at `~/.bashrc` or `~/.zshrc`
export GHTOPDEP_TOKEN="**\*\*\*\***\*\***\*\*\*\***\*\*\*\***\*\*\*\***\*\***\*\*\*\***"
or pass token as option --token
```
➜ ghtopdep --help
Usage: ghtopdep [OPTIONS] URL
Options:
--repositories / --packages Sort repositories or packages (default
repositories)
--table / --json View mode
--description Show description of packages or repositories
(performs additional request per repository)
--rows INTEGER Number of showing repositories (default=10)
--minstar INTEGER Minimum number of stars (default=5)
--search TEXT search code at dependents
(repositories/packages)
--token TEXT
--help Show this message and exit.
```
Table view (by default)
```
➜ ghtopdep https://github.com/dropbox/dropbox-sdk-js
| url | stars |
|---------------------------------------------------|---------|
| https://github.com/transloadit/uppy | 21K |
| https://github.com/codesandbox/codesandbox-client | 8.6K |
| https://github.com/joemccann/dillinger | 6.5K |
| https://github.com/keplergl/kepler.gl | 5.8K |
| https://github.com/jitsi/jitsi-meet | 4.5K |
| https://github.com/jsbin/jsbin | 4.0K |
| https://github.com/NorthwoodsSoftware/GoJS | 3.8K |
| https://github.com/buttercup/buttercup-desktop | 3.1K |
| https://github.com/openstyles/stylus | 2.3K |
| https://github.com/mickael-kerjean/filestash | 2.0K |
found 1660 repositories others repositories are private
found 443 repositories with more than zero star
~ via ⬢ v12.5.0 via 🐘 v7.2.19 via 🐍 3.8.0 took 2m 57s
```
JSON view
```
➜ ghtopdep https://github.com/dropbox/dropbox-sdk-js --json
[{"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}]
```
you can sort packages and fetch their description
```
➜ ghtopdep https://github.com/dropbox/dropbox-sdk-js --description --packages
| url | stars | description |
|------------------------------------------------|---------|--------------------------------------------------------------|
| https://github.com/jsbin/jsbin | 4.0K | Collaborative JavaScript Debugging App |
| https://github.com/jvilk/BrowserFS | 1.9K | BrowserFS is an in-browser filesystem that emulates the... |
| https://github.com/coderaiser/cloudcmd | 1.1K | ✨☁️📁✨ Cloud Commander file manager for the web with... |
| https://github.com/node-red/node-red-web-nodes | 153 | A collection of node-red nodes aimed at web services |
| https://github.com/robertknight/passcards | 133 | A 1Password-compatible command-line and web-based... |
| https://github.com/enyojs/ares-project | 125 | A browser-based code editor and UI designer for Enyo 2... |
| https://github.com/transloadit/uppy-server | 114 | [DEPRECATED] 'Uppy Server' was renamed to 'Companion' and... |
| https://github.com/bioimagesuiteweb/bisweb | 34 | This is the repository for the BioImage Suite Web Project |
| https://github.com/sallar/dropbox-fs | 30 | :package: Node FS wrapper for Dropbox |
| https://github.com/filefog/filefog | 26 | A thin cloud-service agnostic wrapper/interface to access... |
found 140 packages others packages are private
found 61 packages with more than zero star
```
also ghtopdep support code searching at dependents (repositories/packages)
```
➜ ghtopdep https://github.com/rob-balfre/svelte-select --search=isMulti --minstar=0
https://github.com/andriyor/linkorg-frontend/blob/7eed49c332f127c8541281b85def80e54c882920/src/App.svelte with 0 stars
https://github.com/andriyor/linkorg-frontend/blob/7eed49c332f127c8541281b85def80e54c882920/src/providers/Post.svelte with 0 stars
https://github.com/jdgaravito/bitagora_frontend/blob/776a23f5e848995d3eba90563d55c96429470c48/src/Events/AddEvent.svelte with 0 stars
https://github.com/gopear/OlcsoSor/blob/b1fa1d877a59f7daf41a86fecb21137c91652d77/src/routes/index.svelte with 3 stars
https://github.com/openstate/allmanak/blob/ff9ac0833e5e63f7c17f99c5c2355b4e46c48148/app/src/routes/index.svelte with 3 stars
https://github.com/openstate/allmanak/blob/e6d7aa72a8878eefc6f63a27c983894de1cef294/app/src/components/ReportForm.svelte with 3 stars
https://github.com/wolbodo/members/blob/d091f1e44b4e8cb8cc31f39ea6f6e9c36211d019/sapper/src/components/Member.html with 1 stars
```
## Development setup
Using [Poetry](https://poetry.eustace.io/docs/)
```
$ poetry install
$ poetry run ghtopdep https://github.com/dropbox/dropbox-sdk-js
$ dephell deps convert --from=pyproject.toml --to=setup.py
$ poetry build
$ poetry publish
```
[poetry2setup: Convert python-poetry(pyproject.toml) to setup.py.](https://github.com/abersheeran/poetry2setup)
or [Pipenv](https://docs.pipenv.org/)
```
$ pipenv install --dev -e .
```
## License
[MIT](https://choosealicense.com/licenses/mit/)
## Alternatives
[ghtracker](https://github.com/zer0yu/ghtracker) - not provide full result https://github.com/zer0yu/ghtracker/issues/2
[github-by-stars](https://github.com/hacker-DOM/github-by-stars) - complex setup
## References
[Allow dependents to be sorted by stars · Issue #1537 · isaacs/github](https://github.com/isaacs/github/issues/1537)
[Sorting the insights dependency graph lists · community · Discussion #5575](https://github.com/orgs/community/discussions/5575)
Raw data
{
"_id": null,
"home_page": null,
"name": "ghtopdep",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0,>=3.7",
"maintainer_email": null,
"keywords": null,
"author": "Andriy Orehov",
"author_email": "andriyorehov@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/fd/4e/77f4964a360710e5a433bdc99795c25313c19c530ff03b5b75999781121d/ghtopdep-0.4.3.tar.gz",
"platform": null,
"description": "# GHTOPDEP\n\n[](https://pypi.org/project/ghtopdep/)\n[](https://pypi.org/project/ghtopdep/)\n[](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\nfrom PyPI\n\n```\n$ pip install ghtopdep\n```\n\nfrom git repository\n\n```\n$ pip install git+https://github.com/github-tooling/ghtopdep.git#egg=ghtopdep\n```\n\nfrom source\n\n```\n$ git clone https://github.com/github-tooling/ghtopdep\n$ cd ghtopdep\n$ python setup.py install\n```\n\n## Python development Installation\n\nUbuntu/Debian\n\n```\nsudo apt install python3-dev\n```\n\nCentOS/RHEL\n\n```\nsudo yum install python3-devel\n```\n\n## Version upgrade\n\n```\n\u279c 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&description=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```\n\u279c 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\nTable view (by default)\n\n```\n\u279c 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 \u2b22 v12.5.0 via \ud83d\udc18 v7.2.19 via \ud83d\udc0d 3.8.0 took 2m 57s\n```\n\nJSON view\n\n```\n\u279c 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```\n\u279c 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 | \u2728\u2601\ufe0f\ud83d\udcc1\u2728 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```\n\u279c 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```\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```\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 \u00b7 Issue #1537 \u00b7 isaacs/github](https://github.com/isaacs/github/issues/1537)\n\n[Sorting the insights dependency graph lists \u00b7 community \u00b7 Discussion #5575](https://github.com/orgs/community/discussions/5575)\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "CLI tool for sorting dependents repositories and packages by stars",
"version": "0.4.3",
"project_urls": {
"Bug Tracker": "https://github.com/github-tooling/ghtopdep/issues",
"Source": "https://github.com/github-tooling/ghtopdep"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f73b3196679dc9ccb5ad0acad28f327294f2c20d1c23891bb5375dd8fef9898b",
"md5": "468fb66a917f2cf736e20e47f15690be",
"sha256": "bc4b2b748bd26937b31e9d16638c9581dabb8f129992f5aecc901beffd2139dd"
},
"downloads": -1,
"filename": "ghtopdep-0.4.3-py3-none-any.whl",
"has_sig": false,
"md5_digest": "468fb66a917f2cf736e20e47f15690be",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0,>=3.7",
"size": 8080,
"upload_time": "2024-08-02T20:54:15",
"upload_time_iso_8601": "2024-08-02T20:54:15.914740Z",
"url": "https://files.pythonhosted.org/packages/f7/3b/3196679dc9ccb5ad0acad28f327294f2c20d1c23891bb5375dd8fef9898b/ghtopdep-0.4.3-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "fd4e77f4964a360710e5a433bdc99795c25313c19c530ff03b5b75999781121d",
"md5": "c950f1011eaffcc622a14b49322fe3b8",
"sha256": "92dee4ad028c0684b75b470028954f4557f1f01282c768aa030828502c932b37"
},
"downloads": -1,
"filename": "ghtopdep-0.4.3.tar.gz",
"has_sig": false,
"md5_digest": "c950f1011eaffcc622a14b49322fe3b8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0,>=3.7",
"size": 7359,
"upload_time": "2024-08-02T20:54:17",
"upload_time_iso_8601": "2024-08-02T20:54:17.770540Z",
"url": "https://files.pythonhosted.org/packages/fd/4e/77f4964a360710e5a433bdc99795c25313c19c530ff03b5b75999781121d/ghtopdep-0.4.3.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-02 20:54:17",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "github-tooling",
"github_project": "ghtopdep",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "ghtopdep"
}
