Metadata-Version: 2.5
Name: pytest-picker
Version: 0.1.1
Summary: 勾选 pytest 测试用例 + Allure 选项，生成可执行命令的 Flask Web 工具
License-Expression: MIT
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Flask
Classifier: Framework :: Pytest
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.8
Requires-Dist: allure-pytest>=2.16.2
Requires-Dist: flask>=3.0.3
Requires-Dist: pytest>=8.3.5
Description-Content-Type: text/markdown

# pytest-picker

勾选 pytest 测试用例 + Allure 选项，实时生成可执行命令的 Web 工具。

在目标项目的测试用例目录树上打勾，自动生成 pytest 执行命令、`pytest.main()` 代码和 Allure 报告命令，一键复制即可使用——全程零侵入，不修改目标项目的任何文件。

## 功能特性

- **零侵入收集**：通过子进程调用 pytest `--collect-only`，注入收集插件，不改动目标项目的代码与配置
- **用例目录树**：按目录/文件分组展示所有用例，勾选框支持级联与三态（半选），参数化用例 ID 完整显示
- **搜索过滤**：按用例名 / 文件路径 / 目录名实时过滤，目录命中时展示整个子树
- **Marker 与参数**：自动识别目标项目的自定义 marker、conftest 自定义参数和已安装插件的参数，可勾选加入命令
- **Allure 集成**：`--alluredir`、`--clean-alluredir`、`--lang zh` 等选项可视化配置，同步生成 `allure generate` 与 `allure open` 命令
- **命令生成**：pytest 执行命令 / `pytest.main()` 代码 / Allure 报告命令集中展示，各带复制按钮；用例以列表传参，路径含空格也能正确执行

## 快速开始

无需安装，一条命令直接运行（推荐）：

```bash
uvx pytest-picker          # 或 pipx run pytest-picker
```

或安装后使用：

```bash
pip install pytest-picker
pk run
```

启动后自动打开浏览器访问 Web 界面（端口由系统自动分配，也可 `--port` 指定）：

```bash
pk run c:\path\to\your\project   # 指定默认打开的目标项目路径
pk run --port 5000               # 固定端口
pk run --no-browser              # 不自动打开浏览器
```

## 使用流程

1. 在输入框填入目标项目路径（或测试目录），点击收集
2. 在用例树上勾选要执行的用例，按需勾选 marker、自定义参数、Allure 与 pytest 选项
3. 复制页面底部生成的命令，到目标项目目录下执行

## 工作原理

- 后端以子进程列表传参方式执行 `python -m pytest --collect-only -q -p pytest_picker.plugin`，通过 `PYTHONPATH` 注入收集插件，目标项目无需安装本工具
- 插件基于 `pytest_collection_finish` 钩子，将收集到的用例按文件分组写入 `tests.json`（输出到系统临时目录）
- 前端从 `tests.json` 构建目录树，勾选结果实时生成命令

## 环境要求

- Python >= 3.8
- 目标项目可正常运行 pytest

## License

MIT
