Metadata-Version: 2.1
Name: pipui
Version: 0.1.13
Summary: pipui
Author: merlon
License: BSD
Requires-Python: >=3.6, <4
Requires-Dist: flask
Requires-Dist: requests
Requires-Dist: beautifulsoup4

# Web Python 包管理工具

该项目是一个简单的 **Python 包管理工具**，可以方便地搜索、安装、卸载 Python 包，支持查看当前 Python 解释器的信息，并允许用户通过多种方式安装包（包括手动输入包名、上传 `.txt` 文件、选择镜像源等）。
![img.png](img.png)
## 项目功能

- **包搜索**：按包名搜索，查看可用版本并添加到安装列表。
- **包安装**：通过文本框手动输入包名和版本，或上传 `.txt` 文件批量安装包。
- **包卸载**：查看已安装的包并卸载不需要的包。
- **查看 Python 解释器信息**：展示当前使用的 Python 版本和路径。
- **镜像源选择**：支持多个镜像源（如清华、阿里云等）来加速包的安装。

## 技术栈

- **前端**：HTML5, CSS3, JavaScript（原生）
- **后端**：Python, Flask

## 环境要求

- **操作系统**：
    - Windows 7 及以上
    - Linux 发行版（如 Ubuntu、CentOS 等）

- **Python 版本**：
    - Python 3.6 或更高版本
    - 必须安装 `pip` 包管理工具

## 安装与运行

### 1. 安装 `pipui`

首先，确保已安装 Python 环境和 `pip` 包管理工具。然后在终端中运行以下命令安装 `pipui`：

```bash
pip install pipui
```

### 2. 启动项目

在命令行中运行以下命令来启动项目：

```bash
python -m pipui --host=0.0.0.0 --port=5000
```

- `--host=0.0.0.0`：让应用绑定到所有网络接口，可以在局域网内访问。
- `--port=5000`：默认使用 5000 端口，你可以根据需要修改。

启动后，打开浏览器，访问以下地址即可使用工具：

```
http://localhost:5000
```

如果想让其他设备也能访问该工具，可以使用你的局域网 IP 地址：

```
http://<your-ip>:5000
```

### 3. 命令行参数说明

| 参数                    | 描述                                      | 默认值        |
| ----------------------- | ----------------------------------------- | ------------- |
| `-h`, `--help`           | 显示帮助信息                              | -             |
| `--host=HOST`            | 指定主机地址（默认值：`0.0.0.0`）         | `0.0.0.0`     |
| `--port=PORT`            | 指定端口（默认值：`5000`）                | `5000`        |

#### 示例

1. **在默认端口启动应用**：
   ```bash
   python -m pipui --host=0.0.0.0 --port=5000
   ```

2. **在自定义端口启动应用**：
   ```bash
   python -m pipui --host=0.0.0.0 --port=8080
   ```

### 4. 停止项目

你可以通过在命令行窗口按 `Ctrl+C` 停止正在运行的应用。

## 文件上传说明

用户可以通过上传 `.txt` 格式的文件来批量安装 Python 包。文件内容应为每行一个包名和版本，格式如下：

```
pandas==2.0
numpy==1.24
requests==2.28.1
```

上传后，点击安装按钮即可批量安装包。

## 常见问题

### 1. 安装包失败怎么办？

- 请检查输入的包名和版本号是否正确。
- 如果使用了镜像源，尝试更换镜像源。
- 确保你的网络连接正常。

### 2. 上传文件时格式错误？

- 请确保文件是 `.txt` 格式，并且每一行的格式为 `包名==版本`。

### 3. 如何停止运行的应用？

- 你可以通过在终端按 `Ctrl+C` 停止正在运行的应用。

