tpip 0.2.0

优选 pip 镜像源，提升下载速度的命令行工具。

tpip

tpip 是一个帮助你快速选择最优 pip 镜像源的命令行工具，基于cnpip 构建，提升 Python 包的下载速度。
它可以测试各镜像源的实际下载速度，并自动选择下载速度最快的镜像源。

快速使用

运行以下命令，快速切换为最快的镜像源：

pip install tpip
tpip set

功能

• 列出并测试镜像源速度，按连接速度排序
• 快速切换 pip 镜像源，支持手动选择或自动选择最快镜像
• 美化表格输出，使用 prettytable 库显示更清晰的结果
• 显示包下载链接，方便查看各镜像源中包的实际下载地址
• 支持异步测试，提高测试效率

安装

pip install tpip

开发者安装（可编辑模式）

pip install -e .

支持的镜像源

• 清华大学 TUNA
• 中国科学技术大学 USTC
• 阿里云 Aliyun
• 腾讯 Tencent
• 华为 Huawei
• 西湖大学 Westlake University
• 默认源 PyPi

使用方法

1. 列出所有可用的镜像源

tpip list

示例输出：

+----------+-----------+----------------------------------------+
| 镜像名称 | 耗时(ms)  | 地址                                   |
+----------+-----------+----------------------------------------+
| ustc     | 135.71    | https://pypi.mirrors.ustc.edu.cn/simple|
| aliyun   | 300.77    | https://mirrors.aliyun.com/pypi/simple |
| tuna     | 499.51    | https://pypi.tuna.tsinghua.edu.cn/simple|
| default  | 1252.75   | https://pypi.org/simple                |
| tencent  | 1253.07   | https://mirrors.cloud.tencent.com/pypi/simple|
+----------+-----------+----------------------------------------+

2. 测试特定包的下载速度

tpip list --package numpy

这将测试各镜像源下载 numpy 包的速度，并显示包的下载链接。

示例输出：

正在对延迟最低的3个镜像源进行下载速度测试，这可能需要几分钟时间...

ustc 的包链接: @https://pypi.mirrors.ustc.edu.cn/packages/65/6e/09db2a15a75e9cca1c8a5b89b5d5a6d945b3bc551898b4b8d2c4a08e09b9/numpy-1.26.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
tuna 的包链接: @https://pypi.tuna.tsinghua.edu.cn/packages/65/6e/09db2a15a75e9cca1c8a5b89b5d5a6d945b3bc551898b4b8d2c4a08e09b9/numpy-1.26.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
aliyun 的包链接: @https://mirrors.aliyun.com/pypi/packages/65/6e/09db2a15a75e9cca1c8a5b89b5d5a6d945b3bc551898b4b8d2c4a08e09b9/numpy-1.26.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

开始进行下载速度测试...

3. 自动选择最快的镜像源

tpip set

示例输出：

未指定镜像源，自动选择最快的镜像源: ustc
成功设置 pip 镜像源为 'https://pypi.mirrors.ustc.edu.cn/simple'

4. 选择指定的镜像源

tpip set <镜像名称>

示例：

tpip set tuna

输出：

成功设置 pip 镜像源为 'https://pypi.tuna.tsinghua.edu.cn/simple'

5. 取消自定义镜像源设置

tpip unset

输出：

成功取消 pip 镜像源设置，已恢复为默认源。

6. 高级选项

顺序测试模式

默认情况下，tpip 使用并行测试模式。如果需要更详细的输出，可以使用顺序测试模式：

tpip list --sequential

指定测试时间

可以指定下载测试的时间限制：

tpip list --test-time 10

指定测试的镜像源数量

可以指定要测试下载速度的镜像源数量：

tpip list --top-count 5

配置文件

tpip 会修改或创建 pip 的配置文件来设置镜像源：

• Linux/macOS: ~/.pip/pip.conf
• Windows: %APPDATA%\pip\pip.ini

在设置镜像源时，tpip 只会修改或添加 index-url 配置，不会覆盖其他配置项。

常见问题

1. 为什么我无法连接到某些镜像源？

某些镜像源（如豆瓣）可能由于网络问题或镜像源本身的原因无法连接。在这种情况下，tpip 会显示"无法连接"，并将其排在速度测试结果的最后。

2. 如何恢复为默认的 pip 镜像源？

使用 unset 命令恢复为默认的 pip 镜像源：

tpip unset

3. tpip 会覆盖我的 pip.conf 文件吗？

不会。tpip 只会修改或添加 index-url 配置项，其他配置项会被保留。

致谢

本项目基于 cnpip 项目开发，感谢 cnpip 项目的开发者提供的优秀工具和灵感。tpip 在 cnpip 的基础上进行了功能扩展和优化，为中国用户提供更好的 pip 镜像源管理体验。

---

tpip (English)

tpip is a command-line tool designed specifically for users in mainland China to help quickly switch pip mirrors and improve Python package download speeds. Based on cnpip, it tests the connection speed of various mirrors and automatically selects the fastest one.

Quick Start

Run the following commands to quickly switch to the fastest mirror:

pip install tpip
tpip set

Features

• List and test mirror speeds, sorted by connection time
• Quickly switch pip mirrors, supporting manual selection or automatic selection of the fastest mirror
• Beautiful table output using the prettytable library
• Display package download links for each mirror
• Support for asynchronous testing to improve efficiency

Installation

pip install tpip

Developer Installation (Editable Mode)

pip install -e .

Supported Mirrors

• Tsinghua University TUNA
• University of Science and Technology of China USTC
• Aliyun
• Tencent
• Huawei
• Westlake University
• PyPi (Default)

Usage

1. List All Available Mirrors

tpip list

Example output:

+-------------+-----------+----------------------------------------+
| Mirror Name | Time(ms)  | URL                                    |
+-------------+-----------+----------------------------------------+
| ustc        | 135.71    | https://pypi.mirrors.ustc.edu.cn/simple|
| aliyun      | 300.77    | https://mirrors.aliyun.com/pypi/simple |
| tuna        | 499.51    | https://pypi.tuna.tsinghua.edu.cn/simple|
| default     | 1252.75   | https://pypi.org/simple                |
| tencent     | 1253.07   | https://mirrors.cloud.tencent.com/pypi/simple|
+-------------+-----------+----------------------------------------+

2. Test Download Speed for a Specific Package

tpip list --package numpy

This will test the download speed of the numpy package from different mirrors and display the download links.

Example output:

Testing download speed for the 3 mirrors with lowest latency, this may take a few minutes...

Package link for ustc: @https://pypi.mirrors.ustc.edu.cn/packages/65/6e/09db2a15a75e9cca1c8a5b89b5d5a6d945b3bc551898b4b8d2c4a08e09b9/numpy-1.26.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Package link for tuna: @https://pypi.tuna.tsinghua.edu.cn/packages/65/6e/09db2a15a75e9cca1c8a5b89b5d5a6d945b3bc551898b4b8d2c4a08e09b9/numpy-1.26.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Package link for aliyun: @https://mirrors.aliyun.com/pypi/packages/65/6e/09db2a15a75e9cca1c8a5b89b5d5a6d945b3bc551898b4b8d2c4a08e09b9/numpy-1.26.4-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl

Starting download speed test...

3. Automatically Select the Fastest Mirror

tpip set

Example output:

No mirror specified, automatically selecting the fastest mirror: ustc
Successfully set pip mirror to 'https://pypi.mirrors.ustc.edu.cn/simple'

4. Select a Specific Mirror

tpip set <mirror-name>

Example:

tpip set tuna

Output:

Successfully set pip mirror to 'https://pypi.tuna.tsinghua.edu.cn/simple'

5. Reset to Default Mirror

tpip unset

Output:

Successfully reset pip mirror settings to default.

6. Advanced Options

Sequential Testing Mode

By default, tpip uses parallel testing mode. For more detailed output, you can use sequential testing mode:

tpip list --sequential

Specify Test Duration

You can specify the time limit for download testing:

tpip list --test-time 10

Specify Number of Mirrors to Test

You can specify the number of mirrors to test for download speed:

tpip list --top-count 5

Configuration File

tpip modifies or creates the pip configuration file to set the mirror:

• Linux/macOS: ~/.pip/pip.conf
• Windows: %APPDATA%\pip\pip.ini

When setting a mirror, tpip only modifies or adds the index-url configuration without overwriting other settings.

FAQ

1. Why Can't I Connect to Some Mirrors?

Some mirrors (like Douban) might be inaccessible due to network issues or problems with the mirror itself. In such cases, tpip will show "Unable to connect" and rank them last in the speed test results.

2. How to Reset to the Default pip Mirror?

Use the unset command to restore the default pip mirror:

tpip unset

3. Will tpip Overwrite My pip.conf File?

No. tpip only modifies or adds the index-url configuration while preserving other settings.

Acknowledgments

This project is based on the cnpip project. We thank the developers of cnpip for providing an excellent tool and inspiration. tpip extends and optimizes the functionality of cnpip to provide a better pip mirror management experience for users in China.