pytest-platform-adapter 1.0.0__tar.gz

pytest_platform_adapter-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 blackyau
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pytest_platform_adapter-1.0.0/PKG-INFO

@@ -0,0 +1,243 @@
+Metadata-Version: 2.2
+Name: pytest_platform_adapter
+Version: 1.0.0
+Summary: Pytest集成自动化平台插件
+Author-email: BlackYau <blackyau426@gmail.com>
+Maintainer-email: BlackYau <blackyau426@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/blackyau/pytest-platform-adapter
+Project-URL: Repository, https://github.com/blackyau/pytest-platform-adapter.git
+Project-URL: Issues, https://github.com/blackyau/pytest-platform-adapter/issues
+Keywords: pytest,platform,adapter,自动化平台,插件
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Plugins
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+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: Topic :: Software Development
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Testing :: Acceptance
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pytest>=6.2.5
+Requires-Dist: allure-pytest>=2.9.45
+
+# pytest-platform-adapter
+
+[![Release
+Status](https://img.shields.io/pypi/v/pytest-platform-adapter)](https://pypi.python.org/pypi/pytest-platform-adapter)
+[![Downloads](https://img.shields.io/pypi/dm/pytest-platform-adapter)](https://pypi.python.org/pypi/pytest-platform-adapter)
+[![Build](https://github.com/blackyau/pytest-platform-adapter/actions/workflows/deploy.yml/badge.svg)](https://github.com/allure-framework/allure-python/actions/workflows/build.yaml)
+
+Pytest集成自动化平台插件
+
+## 功能
+
+- 根据用例 `allure.title` 中的 ID 筛选执行的用例
+- 跳过所有用例的执行，快速生成 Allure 报告
+- 周期性的通过 RESTApi 上报执行用例的整体进度
+
+## 环境依赖
+
+- Python >= 3.6
+- pytest >= 7.1.2
+- allure-pytest >= 2.9.45
+
+## 安装
+
+执行以下命令即可完成安装
+
+```shell
+pip install pytest-platform-adapter
+```
+
+## 使用方法
+
+### 根据 Allure title 中的 ID 筛选用例
+
+假设有以下测试用例
+
+```python
+import allure
+
+@allure.title('19936-测试用例1')
+def test_case1():
+    assert True
+
+@allure.title('19930-测试用例2')
+def test_case2():
+    assert True
+
+@allure.title('19939-测试用例3')
+def test_case3():
+    assert True
+```
+
+该插件提供两种方式来筛选测试用例：
+
+1. 通过命令行参数指定测试ID：
+```bash
+pytest tests/ -v --case-ids="19936,19930"
+```
+
+2. 通过文件指定测试ID：
+```bash
+pytest tests/ -v --case-ids-file="test_ids.txt"
+```
+
+其中 test_ids.txt 的内容格式如下：
+```
+19936
+19930
+```
+
+### 跳过所有用例
+
+使用 `--scan` 参数，启用扫描模式。在扫描模式下，所有用例都会被 skip 不会执行，可以用于快速生成 Allure 报告。使用方法如下：
+
+```shell
+pytest --scan --alluredir allure-results
+```
+
+### 将执行进展通过RESTApi回报
+
+在 pytest.ini 中配置以下内容
+
+```ini
+[pytest]
+platform_ip = 127.0.0.1
+platform_port = 8080
+platform_path = /api/autoplatform/task/refresh_data_count
+platform_use_https = False
+```
+
+执行用例的过程中（前 10 个用例的时候执行完就立刻回报，之后就是每隔 10 个用例才回报一次） 会将测试用例的整体进展以 `POST` 的方式回报给 `http://127.0.0.1:8080/api/autoplatform/task/refresh_data_count` 请求体如下：
+
+```json
+{
+  "pipeline": "JOB_NAME",
+  "build_number": "BUILD_NUMBER",
+  "passed_case_count": 29,
+  "skipped_case_count": 1,
+  "failed_case_count": 0,
+  "selected_case": 100
+}
+```
+
+其中 `JOB_NAME` 和 `BUILD_NUMBER` 是通过环境变量获取的。
+
+
+## 调试方法
+
+### 部署虚拟环境
+
+新建一个虚拟环境，建议使用 Python 3.11.9 。
+
+安装依赖
+
+```shell
+pip install -r requirements.txt
+```
+
+在项目根目录（与pyproject.toml同一路径）执行以下命令安装本插件
+
+```shell
+pip install -e .
+```
+
+执行 `pytest --help` 检查返回的内容是否包含以下文本，如果有的话就说明安装成功了
+
+```
+usage: pytest [options] [file_or_dir] [file_or_dir] [...]
+
+positional arguments:
+  file_or_dir
+
+general:
+
+..... 省略中间
+
+自动化平台插件:
+  --case_ids=CASE_IDS   要执行的测试用例ID列表，使用逗号分隔，例如：19936,19930
+  --case_ids_file=CASE_IDS_FILE
+                        包含测试用例ID的文件路径，文件中每行一个ID
+  --scan                扫描模式：快速生成 Allure 报告而不实际执行测试
+
+[pytest] ini-options in the first pytest.ini|tox.ini|setup.cfg|pyproject.toml file found:
+
+..... 省略中间
+
+  platform_ip (string): 自动化平台IP
+  platform_port (string):
+                        自动化平台端口
+
+```
+
+### 创建测试用例
+
+在项目根目录新建 tests 目录，然后在 tests 目录中新建以 test_ 开头的 py 文件，作为测试用例。
+
+例如新建 `test_aaa.py`，在文件中写入以下内容
+
+```python
+import allure
+
+
+class TestAbc:
+    @allure.title('19936-用例1')
+    def test_abc(self):
+        print('test_abc 用例执行中')
+
+# @pytest.mark.xfail(reason='跳过')
+class TestAbd:
+    @allure.title('19930-用例2')
+    def test_abd(self):
+        with allure.step('步骤1'):
+            pass
+
+# @pytest.mark.xfail(reason='跳过')
+class TestAbe:
+    @allure.title('19932-用例3')
+    def test_abe(self):
+        pass
+        # raise AssertionError()
+        # pytest.fail('用例失败')
+```
+
+### 配置执行入口
+
+然后再项目根目录新建 main.py 作为执行的入口，写入以下内容。
+
+```python
+import pytest
+import os
+import shutil
+
+if __name__ == '__main__':
+    pytest_options = [
+        'tests/',
+        # '--case_ids', '456456',
+        # '--scan',
+        '-v',
+        '--alluredir', 'allure-results']
+    # shutil.rmtree('allure-results')  # 如果需要清空 allure-results 目录就解除本行注释
+    pytest.main(pytest_options)
+    os.system('allure generate allure-results -o ./report --clean')
+```
+
+通过为 main.py 中的 pytest_options 列表，添加 `--case_ids` 参数可以排除指定的用例，添加或删除 `--scan` 参数可以启用或禁用扫描模式。
+
+> 注意：如果发现 pytest_runtest_logreport 中的逻辑没有被执行。那可能是没有用例被选中（也就是本次没有执行任何用例）
+
+修改 `plugin.py` 的话不用重新 `pip install` 安装本插件，它是实时生效的。因为 `pip install -e` 的本质是在 Python 解释器的 `site-packages` 里面做了一个软链接到了本项目。

pytest_platform_adapter-1.0.0/README.md

@@ -0,0 +1,208 @@
+# pytest-platform-adapter
+
+[![Release
+Status](https://img.shields.io/pypi/v/pytest-platform-adapter)](https://pypi.python.org/pypi/pytest-platform-adapter)
+[![Downloads](https://img.shields.io/pypi/dm/pytest-platform-adapter)](https://pypi.python.org/pypi/pytest-platform-adapter)
+[![Build](https://github.com/blackyau/pytest-platform-adapter/actions/workflows/deploy.yml/badge.svg)](https://github.com/allure-framework/allure-python/actions/workflows/build.yaml)
+
+Pytest集成自动化平台插件
+
+## 功能
+
+- 根据用例 `allure.title` 中的 ID 筛选执行的用例
+- 跳过所有用例的执行，快速生成 Allure 报告
+- 周期性的通过 RESTApi 上报执行用例的整体进度
+
+## 环境依赖
+
+- Python >= 3.6
+- pytest >= 7.1.2
+- allure-pytest >= 2.9.45
+
+## 安装
+
+执行以下命令即可完成安装
+
+```shell
+pip install pytest-platform-adapter
+```
+
+## 使用方法
+
+### 根据 Allure title 中的 ID 筛选用例
+
+假设有以下测试用例
+
+```python
+import allure
+
+@allure.title('19936-测试用例1')
+def test_case1():
+    assert True
+
+@allure.title('19930-测试用例2')
+def test_case2():
+    assert True
+
+@allure.title('19939-测试用例3')
+def test_case3():
+    assert True
+```
+
+该插件提供两种方式来筛选测试用例：
+
+1. 通过命令行参数指定测试ID：
+```bash
+pytest tests/ -v --case-ids="19936,19930"
+```
+
+2. 通过文件指定测试ID：
+```bash
+pytest tests/ -v --case-ids-file="test_ids.txt"
+```
+
+其中 test_ids.txt 的内容格式如下：
+```
+19936
+19930
+```
+
+### 跳过所有用例
+
+使用 `--scan` 参数，启用扫描模式。在扫描模式下，所有用例都会被 skip 不会执行，可以用于快速生成 Allure 报告。使用方法如下：
+
+```shell
+pytest --scan --alluredir allure-results
+```
+
+### 将执行进展通过RESTApi回报
+
+在 pytest.ini 中配置以下内容
+
+```ini
+[pytest]
+platform_ip = 127.0.0.1
+platform_port = 8080
+platform_path = /api/autoplatform/task/refresh_data_count
+platform_use_https = False
+```
+
+执行用例的过程中（前 10 个用例的时候执行完就立刻回报，之后就是每隔 10 个用例才回报一次） 会将测试用例的整体进展以 `POST` 的方式回报给 `http://127.0.0.1:8080/api/autoplatform/task/refresh_data_count` 请求体如下：
+
+```json
+{
+  "pipeline": "JOB_NAME",
+  "build_number": "BUILD_NUMBER",
+  "passed_case_count": 29,
+  "skipped_case_count": 1,
+  "failed_case_count": 0,
+  "selected_case": 100
+}
+```
+
+其中 `JOB_NAME` 和 `BUILD_NUMBER` 是通过环境变量获取的。
+
+
+## 调试方法
+
+### 部署虚拟环境
+
+新建一个虚拟环境，建议使用 Python 3.11.9 。
+
+安装依赖
+
+```shell
+pip install -r requirements.txt
+```
+
+在项目根目录（与pyproject.toml同一路径）执行以下命令安装本插件
+
+```shell
+pip install -e .
+```
+
+执行 `pytest --help` 检查返回的内容是否包含以下文本，如果有的话就说明安装成功了
+
+```
+usage: pytest [options] [file_or_dir] [file_or_dir] [...]
+
+positional arguments:
+  file_or_dir
+
+general:
+
+..... 省略中间
+
+自动化平台插件:
+  --case_ids=CASE_IDS   要执行的测试用例ID列表，使用逗号分隔，例如：19936,19930
+  --case_ids_file=CASE_IDS_FILE
+                        包含测试用例ID的文件路径，文件中每行一个ID
+  --scan                扫描模式：快速生成 Allure 报告而不实际执行测试
+
+[pytest] ini-options in the first pytest.ini|tox.ini|setup.cfg|pyproject.toml file found:
+
+..... 省略中间
+
+  platform_ip (string): 自动化平台IP
+  platform_port (string):
+                        自动化平台端口
+
+```
+
+### 创建测试用例
+
+在项目根目录新建 tests 目录，然后在 tests 目录中新建以 test_ 开头的 py 文件，作为测试用例。
+
+例如新建 `test_aaa.py`，在文件中写入以下内容
+
+```python
+import allure
+
+
+class TestAbc:
+    @allure.title('19936-用例1')
+    def test_abc(self):
+        print('test_abc 用例执行中')
+
+# @pytest.mark.xfail(reason='跳过')
+class TestAbd:
+    @allure.title('19930-用例2')
+    def test_abd(self):
+        with allure.step('步骤1'):
+            pass
+
+# @pytest.mark.xfail(reason='跳过')
+class TestAbe:
+    @allure.title('19932-用例3')
+    def test_abe(self):
+        pass
+        # raise AssertionError()
+        # pytest.fail('用例失败')
+```
+
+### 配置执行入口
+
+然后再项目根目录新建 main.py 作为执行的入口，写入以下内容。
+
+```python
+import pytest
+import os
+import shutil
+
+if __name__ == '__main__':
+    pytest_options = [
+        'tests/',
+        # '--case_ids', '456456',
+        # '--scan',
+        '-v',
+        '--alluredir', 'allure-results']
+    # shutil.rmtree('allure-results')  # 如果需要清空 allure-results 目录就解除本行注释
+    pytest.main(pytest_options)
+    os.system('allure generate allure-results -o ./report --clean')
+```
+
+通过为 main.py 中的 pytest_options 列表，添加 `--case_ids` 参数可以排除指定的用例，添加或删除 `--scan` 参数可以启用或禁用扫描模式。
+
+> 注意：如果发现 pytest_runtest_logreport 中的逻辑没有被执行。那可能是没有用例被选中（也就是本次没有执行任何用例）
+
+修改 `plugin.py` 的话不用重新 `pip install` 安装本插件，它是实时生效的。因为 `pip install -e` 的本质是在 Python 解释器的 `site-packages` 里面做了一个软链接到了本项目。

pytest_platform_adapter-1.0.0/pyproject.toml

@@ -0,0 +1,50 @@
+[build-system]
+requires = ["setuptools"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pytest_platform_adapter"
+version = "1.0.0"
+dependencies = [
+  "pytest>=6.2.5",
+  "allure-pytest>=2.9.45"
+]
+requires-python = ">=3.6"
+authors = [
+  { name = "BlackYau", email = "blackyau426@gmail.com" }
+]
+maintainers = [
+  { name = "BlackYau", email = "blackyau426@gmail.com" }
+]
+description = "Pytest集成自动化平台插件"
+readme = "README.md"
+license = { text = "MIT" }
+keywords = ["pytest", "platform", "adapter", "自动化平台", "插件"]
+classifiers = [
+    'Development Status :: 5 - Production/Stable',
+    'Environment :: Plugins',
+    'Framework :: Pytest',
+    'Intended Audience :: Developers',
+    'License :: OSI Approved :: MIT License',
+    'Natural Language :: Chinese (Simplified)',
+    'Programming Language :: Python :: 3',
+    'Programming Language :: Python :: 3.6',
+    'Programming Language :: Python :: 3.7',
+    'Programming Language :: Python :: 3.8',
+    'Programming Language :: Python :: 3.9',
+    'Programming Language :: Python :: 3.10',
+    'Programming Language :: Python :: 3.11',
+    'Topic :: Software Development',
+    'Topic :: Software Development :: Testing',
+    'Topic :: Software Development :: Testing :: Acceptance',
+    'Topic :: Software Development :: Libraries',
+    'Topic :: Software Development :: Libraries :: Python Modules'
+]
+
+[project.urls]
+Homepage = "https://github.com/blackyau/pytest-platform-adapter"
+Repository = "https://github.com/blackyau/pytest-platform-adapter.git"
+Issues = "https://github.com/blackyau/pytest-platform-adapter/issues"
+
+[project.entry-points.pytest11]
+platform-adapter = "pytest_platform_adapter.plugin"

pytest_platform_adapter-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pytest_platform_adapter-1.0.0/src/pytest_platform_adapter/plugin.py

@@ -0,0 +1,265 @@
+import asyncio
+import json
+import os
+from typing import List, Optional
+
+import requests
+from allure_pytest.utils import allure_title
+import logging
+import pytest
+
+logger = logging.getLogger('pytest-platform-adapter')
+logger.setLevel(logging.INFO)
+
+# 全局变量用于统计测试用例状态
+test_stats = {
+    'total': 0,
+    'passed': 0,
+    'failed': 0,
+    'skipped': 0,
+    'current': 0  # 当前已执行的用例数
+}
+milestone_counter = 10  # 里程碑计数器
+failed_cases = set()  # 记录已标记为失败的用例
+skipped_cases = set()  # 记录已标记为跳过的用例
+cases_ids = set()  # 存放所有用例ID，用来检查是否有重复的
+scan_enable = False  # 记录是否扫描模式，默认为False非扫描模式，True为扫描模式
+platform_ip = None
+platform_port = None
+platform_path = None
+pipeline_name = None
+build_number = None
+platform_use_https = False
+
+
+def pytest_addoption(parser):
+    group = parser.getgroup('platform-adapter', '自动化平台插件')
+    group.addoption(
+        '--case_ids',
+        action='store',
+        default=None,
+        help='要执行的测试用例ID列表，使用逗号分隔，例如：19936,19930'
+    )
+    group.addoption(
+        '--case_ids_file',
+        action='store',
+        default=None,
+        help='包含测试用例ID的文件路径，文件中每行一个ID'
+    )
+    group.addoption(
+        '--scan',
+        action='store_true',
+        default=False,
+        help='扫描模式：快速生成 Allure 报告而不实际执行测试'
+    )
+    parser.addini(
+        'platform_ip',
+        help='自动化平台API IP',
+        default=None
+    )
+    parser.addini(
+        'platform_port',
+        help='自动化平台API端口',
+        default=None
+    )
+    parser.addini(
+        'platform_path',
+        help='自动化平台API Path',
+        default='/api/autoplatform/task/refresh_data_count'
+    )
+    parser.addini(
+        'platform_use_https',
+        help='上报自动化平台时启用HTTPS，默认不启用',
+        default=False
+    )
+
+
+def pytest_collection_modifyitems(config, items):
+    """
+    hook收集用例的过程，给--case_ids和--case_ids_file提供支持
+    修改测试用例集合，根据提供的测试用例ID过滤测试用例
+    """
+    target_ids = get_target_test_ids(config)
+    if not target_ids:
+        test_stats['total'] = len(items)  # 更新总用例数
+        return
+    selected = []
+    deselected = []
+    for item in items:
+        title = allure_title(item)
+        test_id = get_test_id_from_title(title)
+        if test_id in target_ids:
+            selected.append(item)
+        else:
+            deselected.append(item)
+        # 检测 ID 是否有重复，只是单纯的检查一下，不影响执行
+        if test_id in cases_ids:
+            # 为 None 在这里就不用打印log了，因为在 get_test_id_from_title 里面就会报错一次
+            if test_id is None:
+                continue
+            logger.warning(f"测试用例ID {test_id} 重复")
+        else:
+            cases_ids.add(test_id)
+    if deselected:
+        config.hook.pytest_deselected(items=deselected)
+        items[:] = selected
+    selected_ids = [get_test_id_from_title(allure_title(item)) for item in selected]
+    test_stats['total'] = len(selected)  # 更新总用例数
+    logger.info("目标测试用例ID (%d个): %s", len(target_ids), target_ids)
+    logger.info("实际执行用例ID (%d个): %s", len(selected_ids), selected_ids)
+
+
+@pytest.hookimpl(hookwrapper=True)
+def pytest_runtest_call(item):
+    if item.config.getoption('--scan'):
+        # logger.info(f"扫描模式：跳过执行测试用例 {allure_title(item)}")
+        pytest.skip("扫描模式已启动，跳过执行测试用例")
+    yield
+
+
+@pytest.hookimpl(hookwrapper=True)
+def pytest_runtest_setup(item):
+    if item.config.getoption('--scan'):
+        # logger.info(f"扫描模式：跳过测试用例 {allure_title(item)}前置")
+        pytest.skip("扫描模式已启动，跳过测试用例前置")
+    yield
+
+
+@pytest.hookimpl(hookwrapper=True)
+def pytest_runtest_teardown(item):
+    if item.config.getoption('--scan'):
+        # logger.info(f"扫描模式：跳过测试用例 {allure_title(item)}后置")
+        pytest.skip("扫描模式已启动，跳过测试用例后置")
+    yield
+
+
+@pytest.hookimpl
+def pytest_runtest_logreport(report):
+    """
+    hook测试用例执行结果的输出过程
+    """
+    global milestone_counter, scan_enable, platform_ip, platform_port, platform_path, platform_use_https
+    global pipeline_name, build_number
+    # config = pytest.Config
+    # my_option = config.getini("my_option")
+    # 使用 report.nodeid 作为唯一标识
+    nodeid = report.nodeid
+
+    if report.when in ['setup', 'call', 'teardown']:
+        # 记录失败状态，如果该用例任意阶段失败，则添加到 failed_cases
+        if report.failed:
+            failed_cases.add(nodeid)
+
+        # 记录跳过状态，仅在 setup 阶段处理
+        if report.skipped and report.when == 'setup':
+            skipped_cases.add(nodeid)
+            test_stats['skipped'] += 1
+
+        # 仅在 teardown 阶段完成统计更新
+        if report.when == 'teardown':
+            test_stats['current'] += 1
+            # 检查用例是否为失败、跳过或通过
+            if nodeid in failed_cases:
+                # TODO Xfail 应该计算为失败，但是不太对
+                test_stats['failed'] += 1
+            elif nodeid in skipped_cases:
+                # 如果用例已跳过，不计为通过
+                pass
+            else:
+                test_stats['passed'] += 1
+
+            # 打印进度和统计信息
+            progress = (test_stats['current'] / test_stats['total']) * 100 if test_stats['total'] != 0 else 0
+            pass_rate = (test_stats['passed'] / (test_stats['total'] - test_stats['skipped'])) * 100 if (
+                    (test_stats['total'] - test_stats['skipped']) != 0) else 0
+            logger.info(
+                f"pipeline_name:{pipeline_name}, build_number: {build_number}"
+                f"用例进度: 总数 {test_stats['total']}, 跳过 {test_stats['skipped']}, 已执行 {test_stats['current']}, "
+                f"失败 {test_stats['failed']}, 通过 {test_stats['passed']}, 进度 {progress:.2f}%, 通过率 {pass_rate:.2f}%"
+            )
+
+            # 当没有启用扫描模式、同时配置了平台的IP和端口的时候才回报给自动化平台
+            if not scan_enable and platform_ip and platform_port:
+                # 在执行前10个用例的时候，进度立即回报给平台进度。之后就是每隔10个用例再回报一次
+                if test_stats['current'] <= 10 or test_stats['current'] % 10 == 0:
+                    json_data = None
+                    url = f"http://{platform_ip}:{platform_port}{platform_path}" if not platform_use_https \
+                        else f"https://{platform_ip}:{platform_port}{platform_path}"
+                    try:
+                        json_data = {
+                            'pipeline': pipeline_name,
+                            'build_number': build_number,
+                            'passed_case_count': test_stats['passed'],
+                            'skipped_case_count': test_stats['skipped'],
+                            'failed_case_count': test_stats['failed'],
+                            'selected_case': test_stats['total'] }
+                        headers = {'Content-Type': 'application/json'}
+                        response = requests.post(url, data=json.dumps(json_data), headers=headers, timeout=3)
+                        logger.info(f"已将数据回报给 {url}，"
+                                    f"平台返回状态码：{response.status_code}，"
+                                    f"响应体：{response.text}，请求体：{json_data}")
+                    except Exception as e:
+                        logger.info(f"将请求发送到 {url}"
+                                    f"，请求体：{json_data} 错误信息：{e}")
+
+
+def pytest_configure(config):
+    global scan_enable, platform_ip, platform_port, platform_path
+    global pipeline_name, build_number
+    scan_enable, platform_ip, platform_port, platform_path, platform_use_https = config.getoption(
+        '--scan'), config.getini('platform_ip'), config.getini('platform_port'), config.getini(
+        'platform_path'), config.getini('platform_use_https')
+    pipeline_name = os.environ.get("JOB_NAME")
+    build_number = os.environ.get("BUILD_NUMBER")
+    handler = logging.StreamHandler()
+    handler.setLevel(logging.INFO)
+    formatter = logging.Formatter('自动化平台插件 - %(message)s')
+    handler.setFormatter(formatter)
+    logger.addHandler(handler)
+    config.addinivalue_line(
+        "markers",
+        "allure_title: 使用allure标题标记测试用例"
+    )
+
+
+def get_test_ids_from_file(file_path: str) -> List[str]:
+    with open(file_path, 'r') as f:
+        return [line.strip() for line in f if line.strip()]
+
+
+def get_test_ids_from_option(ids_string: str) -> List[str]:
+    case_id = []
+    for id_ in ids_string.strip(',').split(','):
+        id_strip = id_.strip()
+        if not id_strip.isdigit():
+            logger.error(f'存在无效的测试用例ID：{id_}')
+            continue
+        else:
+            case_id.append(id_strip)
+    return case_id
+
+
+def get_target_test_ids(config) -> Optional[List[str]]:
+    case_ids = config.getoption('--case_ids')
+    case_ids_file = config.getoption('--case_ids_file')
+    if case_ids:
+        logger.info(f"接收到case_ids入参为：'{case_ids}'")
+        return get_test_ids_from_option(case_ids)
+    elif case_ids_file:
+        logger.info(f"接收到case_ids_file入参为：'{case_ids_file}'")
+        return get_test_ids_from_file(case_ids_file)
+    return None
+
+
+def get_test_id_from_title(title: Optional[str]) -> Optional[str]:
+    if not title:
+        return None
+    match = title.split('-', 1)
+    if len(match) != 2:
+        logger.error(f'存在无法解析用例ID的用例，用例标题为：{title}')
+        return None
+    if match[0].isdigit():
+        return match[0]
+    else:
+        logger.error(f'存在无法解析用例ID的用例，用例标题为：{title}')
+        return None

pytest_platform_adapter-1.0.0/src/pytest_platform_adapter.egg-info/PKG-INFO

@@ -0,0 +1,243 @@
+Metadata-Version: 2.2
+Name: pytest_platform_adapter
+Version: 1.0.0
+Summary: Pytest集成自动化平台插件
+Author-email: BlackYau <blackyau426@gmail.com>
+Maintainer-email: BlackYau <blackyau426@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/blackyau/pytest-platform-adapter
+Project-URL: Repository, https://github.com/blackyau/pytest-platform-adapter.git
+Project-URL: Issues, https://github.com/blackyau/pytest-platform-adapter/issues
+Keywords: pytest,platform,adapter,自动化平台,插件
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Plugins
+Classifier: Framework :: Pytest
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Natural Language :: Chinese (Simplified)
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.6
+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: Topic :: Software Development
+Classifier: Topic :: Software Development :: Testing
+Classifier: Topic :: Software Development :: Testing :: Acceptance
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.6
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pytest>=6.2.5
+Requires-Dist: allure-pytest>=2.9.45
+
+# pytest-platform-adapter
+
+[![Release
+Status](https://img.shields.io/pypi/v/pytest-platform-adapter)](https://pypi.python.org/pypi/pytest-platform-adapter)
+[![Downloads](https://img.shields.io/pypi/dm/pytest-platform-adapter)](https://pypi.python.org/pypi/pytest-platform-adapter)
+[![Build](https://github.com/blackyau/pytest-platform-adapter/actions/workflows/deploy.yml/badge.svg)](https://github.com/allure-framework/allure-python/actions/workflows/build.yaml)
+
+Pytest集成自动化平台插件
+
+## 功能
+
+- 根据用例 `allure.title` 中的 ID 筛选执行的用例
+- 跳过所有用例的执行，快速生成 Allure 报告
+- 周期性的通过 RESTApi 上报执行用例的整体进度
+
+## 环境依赖
+
+- Python >= 3.6
+- pytest >= 7.1.2
+- allure-pytest >= 2.9.45
+
+## 安装
+
+执行以下命令即可完成安装
+
+```shell
+pip install pytest-platform-adapter
+```
+
+## 使用方法
+
+### 根据 Allure title 中的 ID 筛选用例
+
+假设有以下测试用例
+
+```python
+import allure
+
+@allure.title('19936-测试用例1')
+def test_case1():
+    assert True
+
+@allure.title('19930-测试用例2')
+def test_case2():
+    assert True
+
+@allure.title('19939-测试用例3')
+def test_case3():
+    assert True
+```
+
+该插件提供两种方式来筛选测试用例：
+
+1. 通过命令行参数指定测试ID：
+```bash
+pytest tests/ -v --case-ids="19936,19930"
+```
+
+2. 通过文件指定测试ID：
+```bash
+pytest tests/ -v --case-ids-file="test_ids.txt"
+```
+
+其中 test_ids.txt 的内容格式如下：
+```
+19936
+19930
+```
+
+### 跳过所有用例
+
+使用 `--scan` 参数，启用扫描模式。在扫描模式下，所有用例都会被 skip 不会执行，可以用于快速生成 Allure 报告。使用方法如下：
+
+```shell
+pytest --scan --alluredir allure-results
+```
+
+### 将执行进展通过RESTApi回报
+
+在 pytest.ini 中配置以下内容
+
+```ini
+[pytest]
+platform_ip = 127.0.0.1
+platform_port = 8080
+platform_path = /api/autoplatform/task/refresh_data_count
+platform_use_https = False
+```
+
+执行用例的过程中（前 10 个用例的时候执行完就立刻回报，之后就是每隔 10 个用例才回报一次） 会将测试用例的整体进展以 `POST` 的方式回报给 `http://127.0.0.1:8080/api/autoplatform/task/refresh_data_count` 请求体如下：
+
+```json
+{
+  "pipeline": "JOB_NAME",
+  "build_number": "BUILD_NUMBER",
+  "passed_case_count": 29,
+  "skipped_case_count": 1,
+  "failed_case_count": 0,
+  "selected_case": 100
+}
+```
+
+其中 `JOB_NAME` 和 `BUILD_NUMBER` 是通过环境变量获取的。
+
+
+## 调试方法
+
+### 部署虚拟环境
+
+新建一个虚拟环境，建议使用 Python 3.11.9 。
+
+安装依赖
+
+```shell
+pip install -r requirements.txt
+```
+
+在项目根目录（与pyproject.toml同一路径）执行以下命令安装本插件
+
+```shell
+pip install -e .
+```
+
+执行 `pytest --help` 检查返回的内容是否包含以下文本，如果有的话就说明安装成功了
+
+```
+usage: pytest [options] [file_or_dir] [file_or_dir] [...]
+
+positional arguments:
+  file_or_dir
+
+general:
+
+..... 省略中间
+
+自动化平台插件:
+  --case_ids=CASE_IDS   要执行的测试用例ID列表，使用逗号分隔，例如：19936,19930
+  --case_ids_file=CASE_IDS_FILE
+                        包含测试用例ID的文件路径，文件中每行一个ID
+  --scan                扫描模式：快速生成 Allure 报告而不实际执行测试
+
+[pytest] ini-options in the first pytest.ini|tox.ini|setup.cfg|pyproject.toml file found:
+
+..... 省略中间
+
+  platform_ip (string): 自动化平台IP
+  platform_port (string):
+                        自动化平台端口
+
+```
+
+### 创建测试用例
+
+在项目根目录新建 tests 目录，然后在 tests 目录中新建以 test_ 开头的 py 文件，作为测试用例。
+
+例如新建 `test_aaa.py`，在文件中写入以下内容
+
+```python
+import allure
+
+
+class TestAbc:
+    @allure.title('19936-用例1')
+    def test_abc(self):
+        print('test_abc 用例执行中')
+
+# @pytest.mark.xfail(reason='跳过')
+class TestAbd:
+    @allure.title('19930-用例2')
+    def test_abd(self):
+        with allure.step('步骤1'):
+            pass
+
+# @pytest.mark.xfail(reason='跳过')
+class TestAbe:
+    @allure.title('19932-用例3')
+    def test_abe(self):
+        pass
+        # raise AssertionError()
+        # pytest.fail('用例失败')
+```
+
+### 配置执行入口
+
+然后再项目根目录新建 main.py 作为执行的入口，写入以下内容。
+
+```python
+import pytest
+import os
+import shutil
+
+if __name__ == '__main__':
+    pytest_options = [
+        'tests/',
+        # '--case_ids', '456456',
+        # '--scan',
+        '-v',
+        '--alluredir', 'allure-results']
+    # shutil.rmtree('allure-results')  # 如果需要清空 allure-results 目录就解除本行注释
+    pytest.main(pytest_options)
+    os.system('allure generate allure-results -o ./report --clean')
+```
+
+通过为 main.py 中的 pytest_options 列表，添加 `--case_ids` 参数可以排除指定的用例，添加或删除 `--scan` 参数可以启用或禁用扫描模式。
+
+> 注意：如果发现 pytest_runtest_logreport 中的逻辑没有被执行。那可能是没有用例被选中（也就是本次没有执行任何用例）
+
+修改 `plugin.py` 的话不用重新 `pip install` 安装本插件，它是实时生效的。因为 `pip install -e` 的本质是在 Python 解释器的 `site-packages` 里面做了一个软链接到了本项目。

pytest_platform_adapter-1.0.0/src/pytest_platform_adapter.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/pytest_platform_adapter/__init__.py
+src/pytest_platform_adapter/plugin.py
+src/pytest_platform_adapter.egg-info/PKG-INFO
+src/pytest_platform_adapter.egg-info/SOURCES.txt
+src/pytest_platform_adapter.egg-info/dependency_links.txt
+src/pytest_platform_adapter.egg-info/entry_points.txt
+src/pytest_platform_adapter.egg-info/requires.txt
+src/pytest_platform_adapter.egg-info/top_level.txt

pytest_platform_adapter-1.0.0/src/pytest_platform_adapter.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pytest_platform_adapter-1.0.0/src/pytest_platform_adapter.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[pytest11]
+platform-adapter = pytest_platform_adapter.plugin

pytest_platform_adapter-1.0.0/src/pytest_platform_adapter.egg-info/requires.txt

@@ -0,0 +1,2 @@
+pytest>=6.2.5
+allure-pytest>=2.9.45

pytest_platform_adapter-1.0.0/src/pytest_platform_adapter.egg-info/top_level.txt

@@ -0,0 +1 @@
+pytest_platform_adapter