PyPI 浏览器

PyPI 浏览器 是一个用于浏览 Python 包索引（PyPI）上包内容的 Web 应用。

您可以看到一个实时版本，它提供了来自 pypi.org 的包信息

• 搜索页面
• django 包的包页面
• Django-4.1.1-py3-none-any.whl 文件的存档浏览页面
• 来自同一存档的随机文件的文件查看页面

它也可以与私有 PyPI 注册表配合使用，作为其目标以用于公司的内部注册表。

功能

浏览上传的包存档

您可以看到给定包的所有上传包存档。

检查包存档元数据和内容

您可以检查包存档的元数据和其内容。

轻松查看包存档中的文件

您可以直接在浏览器中显示文本文件，并提供语法高亮和其他功能，如行选择，这些功能由 fluffy-code 提供。

二进制文件也可以下载。

部署 PyPI 浏览器

要运行自己的副本，请使用 pip 安装 pypi-browser-webapp，然后使用任何 ASGI Web 服务器（例如 uvicorn）运行 pypi_browser.app:app ASGI 应用。

您可以通过设置以下环境变量来配置服务器

• PYPI_BROWSER_PYPI_URL: 要使用的 PyPI 服务器的 URL（默认为 https://pypi.ac.cn）

  为了获得最佳结果（即大多数可用的元数据），请从以下列表中选择您的 PyPI 注册表支持的第一项

  • 如果您的注册表支持 PEP691 JSON "简单" 索引，请使用 /simple 添加到基本注册表 URL 中（例如 https://my-registry/simple）。

  • 如果您的注册表支持与pypi.org兼容的旧版JSON API（例如 {registry}/pypi/{package}/json），请指定不带后缀的基本注册表URL（例如 https://my-registry）。

  • 否则，如果您的注册表只支持传统的HTML "简单"索引，请指定带有 /simple 结尾的注册表URL（例如 https://my-registry/simple）。

• PYPI_BROWSER_PACKAGE_CACHE_PATH：用于缓存下载文件的文件系统路径。这将无限增长（应用程序不会清理它），因此您可能想使用 tmpreaper 或类似工具来管理其大小。

pypi-browser是一个ASGI应用程序，尽管它在很多I/O操作（按需下载和提取包）上执行，但已尽力将所有阻塞操作从主线程中移除。它应该具有相当好的性能。

贡献

要本地构建此项目，您需要安装Poetry并运行poetry install。

安装后，您可以运行

$ make start-dev

以启用热重载本地运行应用程序的一个副本。