🚀 yyds-pip

yyds-pip 是一个极速、便捷、终端视觉体验极佳的 PyPI 镜像源命令行管理工具。它专门为解决中国大陆地区下载 Python 依赖包缓慢的问题而设计，提供比传统镜像配置工具更强大、更优雅的使用体验。

---

✨ 核心特性

• ⚡ 并发测速：采用 ThreadPoolExecutor 并发测试各大镜像源延迟，整体耗时受网络状况和 --timeout 设置控制。
• 🔒 安全默认值：HTTPS 请求默认验证服务器证书，不会自动把 HTTPS 镜像加入 trusted-host。
• 🎮 键盘交互选择：支持在终端直接使用 上下方向键 (↑/↓) 选择镜像源，回车一键切换，极具人性化。
• ❌ 全新取消选项：在选择菜单中添加了 ❌ 取消选择 (Cancel) 行，操作上更加方便直接，支持按 Enter 或 Esc/q 放弃配置变更退出。
• 🎨 视觉观赏度高：使用 rich 库构建绚丽多彩的当前状态看板、加载动画，并在测速结果中以色阶标记延迟（绿/黄/红）。
• 🔧 便捷的命令行：
  • 支持 yyds-pip 与 yyds_pip 两种拼写命令，完美兼容短横线与下划线拼写习惯。
  • 直接运行 yyds-pip 会先即时展示当前状态面板，同时在后台进行并发测速，测速完毕后无缝加载交互式菜单，操作极致流畅。
  • 支持 best 自动选择、test 列表测速、show 查看配置、reset 一键恢复官方源。

---

📦 支持的镜像源

别名 (Alias)	镜像源名称
aliyun	阿里云
tsinghua	清华大学
tencent	腾讯云
douban	豆瓣
huawei	华为云
ustc	中国科学技术大学
sjtu	上海交通大学
pypi	PyPI 官方

---

🛠️ 安装方法

方式一：直接从 PyPI 安装（推荐）

pip install -U yyds-pip

方式二：本地源码安装

进入项目根目录，在终端中以可编辑（-e）模式安装：

pip install -e .

注：该工具要求 Python >= 3.7，依赖 click 与 rich 库。

---

📖 使用指南

注：以下指南中 yyds-pip 与 yyds_pip 均等价生效。

1. 测速与交互式选择（推荐）

直接运行 yyds-pip：

yyds-pip

系统将立即向您展示当前配置状态卡片，同时进行并发延迟测试，并随之载入交互式菜单。您只需使用 ↑/↓ 键 移动高亮选择项，按 Enter 键 确认切换，或者选择底部的 ❌ 取消选择 (Cancel) 行退出即可！

2. 自动切换到最快源

yyds-pip best

3. 查看当前配置

yyds-pip show

4. 列出所有镜像源

yyds-pip list

5. 测速并以表格输出

yyds-pip test

6. 手动设置镜像源

可以通过内置别名（例如 tsinghua）进行设置：

yyds-pip set tsinghua

或者输入自定义的 HTTPS 源 URL：

yyds-pip set https://mirrors.aliyun.com/pypi/simple/

HTTP 源会降低连接安全性，必须显式确认：

yyds-pip set --allow-insecure http://localhost:8080/simple/

修改配置的命令支持 --scope user|site|global，默认写入用户级配置。例如：

yyds-pip set --scope site tsinghua

7. 恢复官方源

yyds-pip reset

如果存在 PIP_INDEX_URL 环境变量，它仍会覆盖配置文件；工具会在修改后给出提示。