Python 接口到 PyPI Stats API https://pypistats.org/api
项目描述
pypistats
与PyPI Stats API的Python 接口，用于在 Python 包索引上获取 Python 包的聚合下载统计信息，而无需直接针对 Google BigQuery 执行查询。
最近 180 天的数据可用。（对于更长的时间段，pypinfo可以提供帮助，您需要一个 API 密钥并获得免费配额。）
安装
来自 PyPI
python3 -m pip install --upgrade pypistats
从源头
git clone https://github.com/hugovk/pypistats
cd pypistats
python3 -m pip install .
命令行使用示例
pypistats使用子命令（对应于
PyPI Stats endpoints ）运行，然后使用该子命令的选项。
顶级帮助：
$ pypistats --help
usage: pypistats [-h] [-V]
{recent,overall,python_major,python_minor,system} ...
positional arguments:
{recent,overall,python_major,python_minor,system}
options:
-h, --help show this help message and exit
-V, --version show program's version number and exit
子命令的帮助：
$ pypistats recent --help
usage: pypistats recent [-h] [-p {day,week,month}]
[-f {html,json,markdown,rst,tsv}] [-j] [-v]
package
Retrieve the aggregate download quantities for the last day/week/month
positional arguments:
package
options:
-h, --help show this help message and exit
-p {day,week,month}, --period {day,week,month}
-f {html,json,markdown,rst,tsv}, --format {html,json,markdown,rst,tsv}
The format of output (default: markdown)
-j, --json Shortcut for "-f json" (default: False)
-v, --verbose Print debug messages to stderr (default: False)
获取最近的下载：
$ pypistats recent pillow
| last_day | last_month | last_week |
|----------:|-----------:|----------:|
| 1,311,102 | 30,846,063 | 7,783,107 |
另一个子命令的帮助：
$ pypistats python_minor --help
usage: pypistats python_minor [-h] [-V VERSION]
[-f {html,json,markdown,rst,tsv}] [-j]
[-sd yyyy-mm[-dd]|name] [-ed yyyy-mm[-dd]|name]
[-m yyyy-mm|name] [-l] [-t] [-d] [--monthly]
[-c {yes,no,auto}] [-v]
package
Retrieve the aggregate daily download time series by Python minor version
number
positional arguments:
package
options:
-h, --help show this help message and exit
-V VERSION, --version VERSION
eg. 2.7 or 3.6 (default: None)
-f {html,json,markdown,rst,tsv}, --format {html,json,markdown,rst,tsv}
The format of output (default: markdown)
-j, --json Shortcut for "-f json" (default: False)
-sd yyyy-mm[-dd]|name, --start-date yyyy-mm[-dd]|name
Start date (default: None)
-ed yyyy-mm[-dd]|name, --end-date yyyy-mm[-dd]|name
End date (default: None)
-m yyyy-mm|name, --month yyyy-mm|name
Shortcut for -sd & -ed for a single month (default:
None)
-l, --last-month Shortcut for -sd & -ed for last month (default: False)
-t, --this-month Shortcut for -sd for this month (default: False)
-d, --daily Show daily downloads (default: False)
--monthly Show monthly downloads (default: False)
-c {yes,no,auto}, --color {yes,no,auto}
Color terminal output (default: auto)
-v, --verbose Print debug messages to stderr (default: False)
获取版本下载：
$ pypistats python_minor pillow --last-month
| category | percent | downloads |
|:---------|--------:|-----------:|
| 3.7 | 35.51% | 11,619,678 |
| 3.8 | 22.03% | 7,207,712 |
| 3.6 | 16.30% | 5,332,566 |
| 3.9 | 11.60% | 3,794,862 |
| null | 5.57% | 1,822,007 |
| 3.5 | 5.43% | 1,776,077 |
| 2.7 | 1.96% | 641,598 |
| 3.10 | 1.59% | 520,363 |
| 3.4 | 0.01% | 4,171 |
| 3.11 | 0.00% | 976 |
| 3.3 | 0.00% | 54 |
| 3.2 | 0.00% | 5 |
| 2.6 | 0.00% | 2 |
| Total | | 32,720,071 |
Date range: 2021-12-01 - 2021-12-31
该表是 Markdown，可以粘贴到 GitHub 问题和 PR 中：
| 类别 | 百分 | 下载 |
|---|---|---|
| 3.7 | 35.51% | 11,619,678 |
| 3.8 | 22.03% | 7,207,712 |
| 3.6 | 16.30% | 5,332,566 |
| 3.9 | 11.60% | 3,794,862 |
| 无效的 | 5.57% | 1,822,007 |
| 3.5 | 5.43% | 1,776,077 |
| 2.7 | 1.96% | 641,598 |
| 3.10 | 1.59% | 520,363 |
| 3.4 | 0.01% | 4,171 |
| 3.11 | 0.00% | 976 |
| 3.3 | 0.00% | 54 |
| 3.2 | 0.00% | 5 |
| 2.6 | 0.00% | 2 |
| 全部的 | 32,720,071 |
日期范围：2021-12-01 - 2021-12-31
这些是等效的（2019 年 5 月）：
pypistats python_major pip --last-month
pypistats python_major pip --month april
pypistats python_major pip --month apr
pypistats python_major pip --month 2019-04
和：
pypistats python_major pip --start-date december --end-date january
pypistats python_major pip --start-date dec --end-date jan
pypistats python_major pip --start-date 2018-12 --end-date 2019-01
示例程序化使用
返回值来自 API 中记录的 JSON 响应： https ://pypistats.org/api/
import pypistats
from pprint import pprint
# Call the API
print(pypistats.recent("pillow"))
print(pypistats.recent("pillow", "day", format="markdown"))
print(pypistats.recent("pillow", "week", format="rst"))
print(pypistats.recent("pillow", "month", format="html"))
pprint(pypistats.recent("pillow", "week", format="json"))
print(pypistats.recent("pillow", "day"))
print(pypistats.overall("pillow"))
print(pypistats.overall("pillow", mirrors=True, format="markdown"))
print(pypistats.overall("pillow", mirrors=False, format="rst"))
print(pypistats.overall("pillow", mirrors=True, format="html"))
pprint(pypistats.overall("pillow", mirrors=False, format="json"))
print(pypistats.python_major("pillow"))
print(pypistats.python_major("pillow", version=2, format="markdown"))
print(pypistats.python_major("pillow", version=3, format="rst"))
print(pypistats.python_major("pillow", version="2", format="html"))
pprint(pypistats.python_major("pillow", version="3", format="json"))
print(pypistats.python_minor("pillow"))
print(pypistats.python_minor("pillow", version=2.7, format="markdown"))
print(pypistats.python_minor("pillow", version="2.7", format="rst"))
print(pypistats.python_minor("pillow", version=3.7, format="html"))
pprint(pypistats.python_minor("pillow", version="3.7", format="json"))
print(pypistats.system("pillow"))
print(pypistats.system("pillow", os="darwin", format="markdown"))
print(pypistats.system("pillow", os="linux", format="rst"))
print(pypistats.system("pillow", os="darwin", format="html"))
pprint(pypistats.system("pillow", os="linux", format="json"))
NumPy 和熊猫
要与 NumPy 或 pandas 一起使用，请确保首先安装它们，或者：
pip install --upgrade "pypistats[numpy]"
pip install --upgrade "pypistats[pandas]"
pip install --upgrade "pypistats[numpy,pandas]"
返回 NumPy 数组中的数据以供进一步处理：
import pypistats
numpy_array = pypistats.overall("pyvista", total=True, format="numpy")
print(type(numpy_array))
# <class 'numpy.ndarray'>
print(numpy_array)
# [['with_mirrors' '2019-09-20' '2.23%' 1204]
# ['without_mirrors' '2019-09-20' '2.08%' 1122]
# ['with_mirrors' '2019-09-19' '0.92%' 496]
# ...
# ['with_mirrors' '2019-10-26' '0.02%' 13]
# ['without_mirrors' '2019-10-26' '0.02%' 12]
# ['Total' None None 54041]]
或者在熊猫数据框中：
import pypistats
pandas_dataframe = pypistats.overall("pyvista", total=True, format="pandas")
print(type(pandas_dataframe))
# <class 'pandas.core.frame.DataFrame'>
print(pandas_dataframe)
# category date percent downloads
# 0 with_mirrors 2019-09-20 2.23% 1204
# 1 without_mirrors 2019-09-20 2.08% 1122
# 2 with_mirrors 2019-09-19 0.92% 496
# 3 with_mirrors 2019-08-22 0.90% 489
# 4 without_mirrors 2019-09-19 0.86% 466
# .. ... ... ... ...
# 354 without_mirrors 2019-11-03 0.03% 15
# 355 without_mirrors 2019-11-16 0.03% 15
# 356 with_mirrors 2019-10-26 0.02% 13
# 357 without_mirrors 2019-10-26 0.02% 12
# 358 Total None None 54041
#
# [359 rows x 4 columns]
例如，使用 pandas 创建图表：
# Show overall downloads over time, excluding mirrors
import pypistats
data = pypistats.overall("pillow", total=True, format="pandas")
data = data.groupby("category").get_group("without_mirrors").sort_values("date")
chart = data.plot(x="date", y="downloads", figsize=(10, 2))
chart.figure.show()
chart.figure.savefig("overall.png") # alternatively
# Show Python 3 downloads over time
import pypistats
data = pypistats.python_major("pillow", total=True, format="pandas")
data = data.groupby("category").get_group(3).sort_values("date")
chart = data.plot(x="date", y="downloads", figsize=(10, 2))
chart.figure.show()
chart.figure.savefig("python3.png") # alternatively
也可以看看
相关项目
