| Name | typeshed-stats JSON |
| Version |
24.10.6
JSON |
| download |
| home_page | None |
| Summary | Library and command-line tool to gather stats on typeshed packages |
| upload_time | 2024-10-06 01:27:36 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.10 |
| license | MIT |
| keywords |
stubs
typeshed
typing
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
<div align=center>
# typeshed-stats
<img src="https://raw.githubusercontent.com/AlexWaygood/typeshed-stats/main/stats_website/big_logo.png" width="500" alt="A Python in a field of wheat with a shed behind it, golden-red sunset in the background">
<br>
---
## A CLI tool and library to gather stats on [typeshed](https://github.com/python/typeshed)
<br>
[](https://alexwaygood.github.io/typeshed-stats/)[](https://github.com/AlexWaygood/typeshed-stats/actions/workflows/test.yml)
<br>
[](http://mypy-lang.org/)[](https://github.com/astral-sh/ruff)[](https://pre-commit.ci)
<br>
[](https://pypi.org/project/typeshed-stats/)[](https://opensource.org/licenses/MIT)
---
<br>
</div>
## What's this project for?
This project is for easy gathering of statistics relating to [typeshed](https://github.com/python/typeshed)'s stubs. As well as being a CLI tool and library, it also powers [a website](https://alexwaygood.github.io/typeshed-stats/) where stats about typeshed's stubs are uploaded twice a day.
This project was created by Alex Waygood. It is not necessarily endorsed by any of the other typeshed maintainers.
Some examples of things you can do from the command line:
- Create a `.csv` file with stats on all typeshed stubs: `typeshed-stats --typeshed-dir <PATH_TO_TYPESHED_CLONE> --to-file stats.csv` (the `.csv` file extension will be automatically detected by the script to identify the format required).
- Pretty-print stats on typeshed stubs for emoji and redis to the terminal, in JSON format: `typeshed-stats --typeshed-dir <PATH_TO_TYPESHED_CLONE> --to-json emoji redis`
- Generate a MarkDown file detailing stats on typeshed's stubs for protobuf and the stdlib: `typeshed-stats --typeshed-dir <PATH_TO_TYPESHED_CLONE> --to-file stats.md stdlib protobuf`
Example usage of the Python-level API:
```python
from typeshed_stats.gather import tmpdir_typeshed, gather_stats
with tmpdir_typeshed() as typeshed:
stats_on_all_packages = gather_stats_on_multiple_packages(typeshed_dir=typeshed)
```
## How can I use this?
1. Run `pip install typeshed-stats[rich]` to install the package
1. Run `typeshed-stats --help` for information about various options
## Are there any examples of things this script can produce, other than [the website](https://alexwaygood.github.io/typeshed-stats/)?
I'm glad you asked! They're in the `examples/` folder in this repo.
(These examples are generated using the `regenerate.py` script in the `scripts/` directory.)
## How do I run tests/linters?
1. Clone the repo and `cd` into it
1. Create and activate a virtual environment
1. Run `pip install -e .[dev]`
1. Either run the linters/tests individually (see the `.github/workflows` directory for details about what's run in CI) or use the `scripts/runtests.py` convenience script to run them all in succession.
Raw data
{
"_id": null,
"home_page": null,
"name": "typeshed-stats",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "stubs, typeshed, typing",
"author": null,
"author_email": "Alex Waygood <alex.waygood@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/a3/62/6db4aa365e1605357459d5a99986b2490bcb80717f7d279869e97be005c7/typeshed_stats-24.10.6.tar.gz",
"platform": null,
"description": "<div align=center>\n\n# typeshed-stats\n\n<img src=\"https://raw.githubusercontent.com/AlexWaygood/typeshed-stats/main/stats_website/big_logo.png\" width=\"500\" alt=\"A Python in a field of wheat with a shed behind it, golden-red sunset in the background\">\n\n<br>\n\n---\n\n## A CLI tool and library to gather stats on [typeshed](https://github.com/python/typeshed)\n\n<br>\n\n[](https://alexwaygood.github.io/typeshed-stats/)[](https://github.com/AlexWaygood/typeshed-stats/actions/workflows/test.yml)\n<br>\n[](http://mypy-lang.org/)[](https://github.com/astral-sh/ruff)[](https://pre-commit.ci)\n<br>\n[](https://pypi.org/project/typeshed-stats/)[](https://opensource.org/licenses/MIT)\n\n---\n\n<br>\n</div>\n\n## What's this project for?\n\nThis project is for easy gathering of statistics relating to [typeshed](https://github.com/python/typeshed)'s stubs. As well as being a CLI tool and library, it also powers [a website](https://alexwaygood.github.io/typeshed-stats/) where stats about typeshed's stubs are uploaded twice a day.\n\nThis project was created by Alex Waygood. It is not necessarily endorsed by any of the other typeshed maintainers.\n\nSome examples of things you can do from the command line:\n\n- Create a `.csv` file with stats on all typeshed stubs: `typeshed-stats --typeshed-dir <PATH_TO_TYPESHED_CLONE> --to-file stats.csv` (the `.csv` file extension will be automatically detected by the script to identify the format required).\n- Pretty-print stats on typeshed stubs for emoji and redis to the terminal, in JSON format: `typeshed-stats --typeshed-dir <PATH_TO_TYPESHED_CLONE> --to-json emoji redis`\n- Generate a MarkDown file detailing stats on typeshed's stubs for protobuf and the stdlib: `typeshed-stats --typeshed-dir <PATH_TO_TYPESHED_CLONE> --to-file stats.md stdlib protobuf`\n\nExample usage of the Python-level API:\n\n```python\nfrom typeshed_stats.gather import tmpdir_typeshed, gather_stats\n\nwith tmpdir_typeshed() as typeshed:\n stats_on_all_packages = gather_stats_on_multiple_packages(typeshed_dir=typeshed)\n```\n\n## How can I use this?\n\n1. Run `pip install typeshed-stats[rich]` to install the package\n1. Run `typeshed-stats --help` for information about various options\n\n## Are there any examples of things this script can produce, other than [the website](https://alexwaygood.github.io/typeshed-stats/)?\n\nI'm glad you asked! They're in the `examples/` folder in this repo.\n(These examples are generated using the `regenerate.py` script in the `scripts/` directory.)\n\n## How do I run tests/linters?\n\n1. Clone the repo and `cd` into it\n1. Create and activate a virtual environment\n1. Run `pip install -e .[dev]`\n1. Either run the linters/tests individually (see the `.github/workflows` directory for details about what's run in CI) or use the `scripts/runtests.py` convenience script to run them all in succession.\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Library and command-line tool to gather stats on typeshed packages",
"version": "24.10.6",
"project_urls": {
"Bug Tracker": "https://github.com/AlexWaygood/typeshed-stats/issues",
"Homepage": "https://github.com/AlexWaygood/typeshed-stats"
},
"split_keywords": [
"stubs",
" typeshed",
" typing"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c2e5dc1d5723e2cdb2371cd4f561e8322c7a752ad6fd725eefc4e0f7e308d882",
"md5": "cacbdbdd13441e84fec964a4d88350c9",
"sha256": "dd8b083da0ebbeed1edec3465e0913d96e3c93ce02ae17a5ce67604582d23c19"
},
"downloads": -1,
"filename": "typeshed_stats-24.10.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "cacbdbdd13441e84fec964a4d88350c9",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 23035,
"upload_time": "2024-10-06T01:27:34",
"upload_time_iso_8601": "2024-10-06T01:27:34.645508Z",
"url": "https://files.pythonhosted.org/packages/c2/e5/dc1d5723e2cdb2371cd4f561e8322c7a752ad6fd725eefc4e0f7e308d882/typeshed_stats-24.10.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a3626db4aa365e1605357459d5a99986b2490bcb80717f7d279869e97be005c7",
"md5": "fd83b274daa4b03c9a86e469e4323dbe",
"sha256": "1394cc27e19b3f43c5c5e2144bc49e5d85be4aae2dfe7a92f190c321f1616792"
},
"downloads": -1,
"filename": "typeshed_stats-24.10.6.tar.gz",
"has_sig": false,
"md5_digest": "fd83b274daa4b03c9a86e469e4323dbe",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 985827,
"upload_time": "2024-10-06T01:27:36",
"upload_time_iso_8601": "2024-10-06T01:27:36.428237Z",
"url": "https://files.pythonhosted.org/packages/a3/62/6db4aa365e1605357459d5a99986b2490bcb80717f7d279869e97be005c7/typeshed_stats-24.10.6.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-10-06 01:27:36",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "AlexWaygood",
"github_project": "typeshed-stats",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "typeshed-stats"
}
