### 使用 Python、Requests、Pytest 和 Allure 进行接口自动化测试 #### 创建项目结构 为了更好地管理和维护代码，建议按照以下目录结构组织项目[^3]: ```plaintext project_root/ ├── base/ # 存放底层方法封装，如HTTP请求处理 ├── common/ # 存储公共函数或工具类 ├── config/ # 配置文件夹，存储API端点等信息 ├── data/ # 测试数据存放位置 ├── log/ # 日志保存路径 ├── report/ # 报告输出目录 ├── tests/ # 测试用例所在的位置 └── utils/ # 辅助功能模块 ``` #### 安装必要的库 确保环境中已安装所需的Python包。可以在`requirements.txt`中指定依赖项并使用pip进行管理: ```bash pip install -r requirements.txt ``` 其中可能包含但不限于以下内容: - `requests`: 发送HTTP请求的核心库 - `pytest`: 单元测试框架 - `openpyxl`: 处理Excel表格读取与写入操作 - `allure-pytest`: 生成美观详细的HTML格式测试报告插件 #### 编写登录认证逻辑 通过自定义fixture获取每次会话期间有效的访问令牌，在`conftest.py`内添加如下代码片段以供全局调用[^2]: ```python import pytest from api import PortalLoginApi, BasePortalApi @pytest.fixture(scope='session', autouse=True) def get_portal_token(): """ 获取门户系统的token """ portal_login_api = PortalLoginApi() response = portal_login_api.send_request() token_value = response.json().get('data').get('token') if not token_value: raise ValueError("Failed to obtain valid token from login API.") BasePortalApi.portal_token = token_value ``` #### 构建具体业务场景下的测试案例 在对应的测试文件里（比如`test_user_operations.py`)实现具体的接口验证: ```python import allure import requests from conftest import get_portal_token @allure.feature('User Management') class TestUserOperations(object): @allure.story('Create New User Account') def test_create_new_user(self): url = "http://example.com/api/v1/users" headers = {"Authorization": f"Bearer {BasePortalApi.portal_token}"} payload = { 'username': 'new_tester', 'password': 'secure_password' } with allure.step(f'POST request sent to create user'): res = requests.post(url=url, json=payload, headers=headers) assert res.status_code == 201, \ f"Expected status code 201 but got {res.status_code}" created_data = res.json() expected_keys = ['id', 'username'] missing_fields = set(expected_keys).difference(created_data.keys()) assert len(missing_fields) == 0, \ f"The following fields are missing: {missing_fields}" @allure.story('Delete Existing User Record') def test_delete_existing_user(self): target_id = 123456789 delete_url = f"http://example.com/api/v1/users/{target_id}" del_headers = {'Authorization':f'Bearer {BasePortalApi.portal_token}'} with allure.step(f'DELETE request issued against ID={target_id}'): result = requests.delete(delete_url, headers=del_headers) assert result.status_code == 204 or result.status_code==404,\ f"Unexpected HTTP Status Code Received:{result.status_code}" ``` 上述例子展示了两个典型的RESTful风格的操作——创建新用户以及删除已有用户的单元测试。 #### 整合Excel作为外部输入源 如果需要从Excel导入参数化测试的数据集，则可以利用`openpyxl`解析xlsx文件中的表单，并将其转换成适合传递给测试函数的形式： ```python import openpyxl def load_excel_data(file_path="path/to/test_cases.xlsx", sheet_name=None): wb = openpyxl.load_workbook(filename=file_path) ws = wb[sheet_name] rows = list(ws.rows)[1:] # 跳过首行列名 cases = [] for row in rows: case_dict = {} for cell in row: key = str(cell.column_letter).lower() value = cell.value case_dict[key] = value cases.append(case_dict) return cases ``` 之后就可以很方便地把加载得到的字典列表传入到相应的测试方法当中去执行批量校验工作了。