pipenv使用

### 配置 Pipenv 使用 Allure 的方法 要在 Pipenv 中集成和使用 Allure 来生成测试报告，可以按照以下方式操作： #### 安装依赖项 首先，在 `Pipfile` 文件中添加必要的 Python 包来支持 Allure 报告功能。以下是需要的主要包及其用途： - **pytest-allure-adaptor**: 提供 Pytest 和 Allure 之间的适配器。 - **playwright**: 支持浏览器自动化测试。 在终端执行以下命令以安装这些依赖项： ```bash pipenv install pytest allure-pytest playwright --dev ``` 这会将所需的开发工具作为开发依赖项添加到您的项目中[^1]。 #### 创建测试脚本 创建一个简单的测试文件（例如 `tests/test_example.py`），其中包含一些基本的测试用例，并通过装饰器标记它们以便于后续生成报告。 示例代码如下所示： ```python import pytest @pytest.mark.feature("User Login") def test_successful_login(): assert True, "Login should be successful" @pytest.mark.bug("Invalid credentials check") def test_failed_login(): assert False, "Failed login due to invalid credentials" ``` 以上代码片段展示了两个不同的测试场景——一个是成功的登录验证；另一个则是失败的情况用于模拟错误处理逻辑[^1]。 #### 运行测试并生成报告 为了能够顺利地运行测试并将结果导出为 HTML 格式的可视化报表，请遵循下面的操作指南： ##### 设置环境变量 确保系统路径已正确设置 ALLURE 命令行工具的位置。如果是在 Linux 上，则可能还需要额外配置 JAVA_HOME 变量以及调整权限等问题[^2]。 可以通过修改 `.bashrc` 或者直接在 shell session 当前生效的方式完成此步骤： ```bash export PATH=$PATH:/path/to/allure/bin source ~/.bashrc ``` ##### 执行测试与收集数据 利用 pipenv 虚拟环境中激活后的状态下来调用 py.test 工具加上相应的参数选项来进行实际的任务执行过程： ```bash pipenv run python -m pytest tests/ --alluredir=./results/ ``` 这里指定了输出目录存放临时产生的 json 数据文件夹位置 ./results/[^1]. ##### 构建最终HTML版本文档 最后一步就是把之前得到的数据转换成易于阅读理解的形式展示出来即 html 页面形式: ```bash allure serve ./results/ ``` 或者如果您希望保存本地副本而不是立即打开浏览窗口的话也可以采用打包模式代替serve子命令: ```bash allure generate ./results/ -o ./report/ --clean ``` 这样就完成了整个流程从编写测试案例直到查看图形化统计分析图表为止的工作流构建工作[^1]^. #### GitHub Actions 自动化部署 (可选扩展部分) 为了让 CI/CD 流程更加便捷高效还可以考虑加入 github actions 实现持续集成目的。新建 .github/workflows/ci.yml 文件内容大致结构如下: ```yaml name: Test and Report Workflow on: push: branches: - main jobs: build-and-test: runs-on: ubuntu-latest steps: - uses: actions/checkout@v2 - name: Set up Python uses: actions/setup-python@v2 with: python-version: '3.x' - name: Install dependencies via Pipenv run: | pip install pipenv pipenv install --dev - name: Run Tests & Generate Results run: pipenv run python -m pytest tests/ --alluredir=./results/ - name: Setup Allure Command-line Tool uses: franzbischoff/install-allure-action@master with: version: latest-stable - name: Build Allure Reports run: allure generate ./results/ -o ./report/ --clean && allure open ./report/ ``` 该 YAML 文件定义了一个完整的动作序列涵盖了检出源码、准备解释器环境、加载所需库直至触发 allure report 查看服务启动等一系列环节[^1]. --- ###