Metadata-Version: 2.4
Name: yyds-pip
Version: 0.1.0
Summary: A high-performance, user-friendly, and beautiful PyPI mirror source manager.
Author: yyds-fast Team
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0.0
Requires-Dist: rich>=12.0.0

# 🚀 yyds-pip

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

---

## ✨ 核心特性

- ⚡ **极致性能**：采用多线程并发测试（`ThreadPoolExecutor`）各大镜像源延迟，通常在 **0.5秒内** 完成所有源的测速。
- 🎮 **键盘交互选择**：支持在终端直接使用 **上下方向键 (↑/↓)** 选择镜像源，回车一键切换，极具人性化。
- 🎨 **视觉观赏度高**：使用 `rich` 库构建绚丽多彩的命令行输出、加载动画，并在测速结果中以色阶标记延迟（绿/黄/红）。
- 🔧 **便捷的命令行**：
  - `yyds-pip` / `yyds-pip select`：进入极速测速与交互选择模式。
  - `yyds-pip best`：一键自动选取最快的源应用配置。
  - `yyds-pip test`：显示精美的镜像源测速排行榜（按延迟从小到大排序）。
  - `yyds-pip list`：查看所有预设镜像源的名称及地址。
  - `yyds-pip show`：清晰明了地展示当前 pip 配置的镜像源信息。
  - `yyds-pip set <alias|url>`：手动设置指定别名（如 `tsinghua`）或自定义 URL。
  - `yyds-pip reset`：一键清除当前镜像源，恢复为 PyPI 官方源。

---

## 📦 支持的镜像源

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

---

## 🛠️ 安装方法

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

```bash
pip install -e .
```

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

---

## 📖 使用指南

### 1. 测速与交互式选择（推荐）
直接运行 `yyds-pip` 命令：
```bash
yyds-pip
```
系统将自动对所有源进行并发测速，并在终端弹出带有高亮行和动态指针的菜单，您只需使用 **↑/↓ 键** 移动，按 **Enter 键** 确认即可！

### 2. 自动切换到最快源
```bash
yyds-pip best
```

### 3. 查看当前配置
```bash
yyds-pip show
```

### 4. 列出所有镜像源
```bash
yyds-pip list
```

### 5. 测速并以表格输出
```bash
yyds-pip test
```

### 6. 手动设置镜像源
可以通过内置别名（例如 `tsinghua`）进行设置：
```bash
yyds-pip set tsinghua
```
或者输入自定义的 HTTP/HTTPS 源 URL：
```bash
yyds-pip set https://mirrors.aliyun.com/pypi/simple/
```

### 7. 恢复官方源
```bash
yyds-pip reset
```
