Metadata-Version: 2.4
Name: yyds-pip
Version: 0.4.4
Summary: A high-performance, user-friendly, and beautiful PyPI mirror source manager.
Home-page: https://github.com/yyds-fast/yyds-pip
Author: yyds-fast
Author-email: yyds.fast@gmail.com
License: MIT
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: License :: OSI Approved :: MIT License
Requires-Python: >=3.7
Description-Content-Type: text/markdown
Requires-Dist: click>=8.0.0
Requires-Dist: rich>=12.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: license
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# 🚀 yyds-pip

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

---

## ✨ 核心特性

- ⚡ **极致性能**：采用多线程并发测试（`ThreadPoolExecutor`）各大镜像源延迟，通常在 **0.5秒内** 完成所有源的测速。
- 🎮 **键盘交互选择**：支持在终端直接使用 **上下方向键 (↑/↓)** 选择镜像源，回车一键切换，极具人性化。
- ❌ **全新取消选项**：在选择菜单中添加了 `❌ 取消选择 (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 安装（推荐）
```bash
pip install -U yyds-pip
```

### 方式二：本地源码安装
进入项目根目录，在终端中以可编辑（`-e`）模式安装：
```bash
pip install -e .
```

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

---

## 📖 使用指南

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

### 1. 测速与交互式选择（推荐）
直接运行 `yyds-pip`：
```bash
yyds-pip
```
系统将立即向您展示当前配置状态卡片，同时进行并发延迟测试，并随之载入交互式菜单。您只需使用 **↑/↓ 键** 移动高亮选择项，按 **Enter 键** 确认切换，或者选择底部的 `❌ 取消选择 (Cancel)` 行退出即可！

### 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
```
