pytest-dynamic-params 0.1.0__tar.gz

pytest_dynamic_params-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ProgrammerChengPei
+
+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_dynamic_params-0.1.0/PKG-INFO

@@ -0,0 +1,188 @@
+Metadata-Version: 2.4
+Name: pytest-dynamic-params
+Version: 0.1.0
+Summary: Dynamic parameters plugin for pytest
+Author-email: Your Name <your.email@example.com>
+License: MIT License
+        
+        Copyright (c) 2026 ProgrammerChengPei
+        
+        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.
+        
+Classifier: Framework :: Pytest
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pytest
+Provides-Extra: dev
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Requires-Dist: bandit; extra == "dev"
+Requires-Dist: pre-commit; extra == "dev"
+Dynamic: license-file
+
+# pytest-dynamic-params
+
+pytest-dynamic-params 是一个为 pytest 设计的动态参数化插件，通过声明式参数生成器自动处理依赖解析和参数化，支持懒加载、缓存机制和多作用域管理，与现有 pytest 机制无缝集成，简化复杂测试场景的参数管理，提高测试效率和可维护性。
+
+## 特性
+
+- **声明式参数生成**：使用装饰器定义参数生成器，专注于"生成什么"而非"如何生成"
+- **自动依赖管理**：系统自动分析生成器函数的参数签名，确定依赖关系并按正确顺序执行
+- **与现有机制兼容**：完全兼容现有的pytest机制，包括`@pytest.mark.parametrize`装饰器和fixture系统
+- **性能优化**：支持懒加载和缓存机制，提高测试执行效率
+- **灵活的作用域管理**：支持function、class、module、session四种作用域
+- **智能错误检测**：自动检测并报告参数生成器之间的循环依赖
+- **可配置性**：支持多种配置选项，满足不同场景需求
+
+## 安装
+
+```bash
+pip install -e .
+```
+
+## 快速开始
+
+安装后，您可以立即在测试中使用动态参数装饰器：
+
+```python
+from dynamic_params import param_generator, with_dynamic_params
+
+@param_generator
+def calculate_result(input_value):
+    return input_value * 2
+
+@with_dynamic_params(result=calculate_result)
+@pytest.mark.parametrize("input_value", [1, 2, 3])
+def test_basic(input_value, result):
+    assert result == input_value * 2
+```
+
+## 核心概念
+
+- **参数生成器**：使用`@param_generator`装饰器定义的函数，用于生成参数值
+- **动态参数**：在运行时生成的参数，可以依赖其他参数或fixture
+- **参数依赖**：参数之间的依赖关系，系统自动按依赖顺序生成参数
+- **懒加载**：推迟参数生成到实际需要时执行，避免不必要的计算
+- **缓存机制**：缓存参数生成结果，避免重复计算，提高性能
+- **作用域管理**：控制参数生成器实例的生命周期，影响缓存和执行时机
+
+## 使用示例
+
+完整的使用示例请参见：
+- `examples/basic_usage.py` - 基础用法示例（可直接复制使用）
+- `examples/advanced_usage.py` - 高级用法示例（包含作用域、缓存和懒加载）
+- `docs/usage-guide.md` - 详细使用指南
+
+## 配置
+
+可以在`pytest.ini`中配置插件行为：
+
+```ini
+[pytest]
+# 动态参数化系统配置
+dynamic_param_cache_enabled = true
+dynamic_param_validation = strict
+dynamic_param_log_level = INFO
+
+# 缓存大小配置
+dynamic_param_cache_size_function = 1000
+dynamic_param_cache_size_class = 500
+dynamic_param_cache_size_module = 200
+dynamic_param_cache_size_session = 100
+
+# 性能配置
+dynamic_param_lazy_loading = true
+dynamic_param_incremental_generation = true
+
+# 测试标记
+markers =
+    dynamic_param: 使用动态参数的测试
+    param_generator: 参数生成器函数
+```
+
+也可以通过环境变量配置：
+- `PYTEST_DYNAMIC_PARAM_CACHE`: 控制缓存是否启用
+- `PYTEST_DYNAMIC_PARAM_VALIDATION`: 验证级别
+- `PYTEST_DYNAMIC_PARAM_LOG_LEVEL`: 日志级别
+- `PYTEST_DYNAMIC_PARAM_LAZY_LOADING`: 懒加载设置
+- `PYTEST_DYNAMIC_PARAM_INCREMENTAL`: 增量生成设置
+- `PYTEST_DYNAMIC_PARAM_DEBUG`: 调试模式
+- `PYTEST_DYNAMIC_PARAM_PROFILE`: 性能分析
+- `PYTEST_DYNAMIC_PARAM_CACHE_DIR`: 缓存目录
+
+## 项目结构
+
+项目的主要组成部分：
+
+- `src/` - 源代码
+- `tests/` - 测试代码
+- `examples/` - 使用示例
+- `docs/` - 文档
+- `specs/` - 项目规格说明
+- `reports/` - 测试报告
+
+有关详细的源码架构说明，请参见 [docs/structure.md](./docs/structure.md)。
+
+## 运行测试
+
+```bash
+# 运行单元测试
+python -m pytest tests/unit/
+
+# 运行功能测试
+python -m pytest tests/functional/
+
+# 运行集成测试
+python -m pytest tests/integration/
+
+# 运行性能测试
+python -m pytest tests/performance/
+
+# 运行所有测试
+python -m pytest tests/
+
+# 查看覆盖率
+python -m pytest --cov=src.dynamic_params tests/unit/ --cov-report=html
+
+# 生成完整报告（Allure + 覆盖率）
+python -m pytest tests/ --alluredir=reports/allure-results -clean --cov=src.dynamic_params --cov-report=html:reports/coverage-html --cov-report=xml:reports/coverage.xml --cov-report=term
+
+# 查看Allure报告
+allure serve reports/allure-results
+```
+
+## 测试报告
+
+有关测试报告的详细说明，请参见：
+- [docs/reports-readme.md](./docs/reports-readme.md) - 报告使用说明
+- [docs/reports-summary.md](./docs/reports-summary.md) - 测试结果和覆盖率摘要
+
+生成的报告位于 `reports/` 目录：
+- Allure报告：`reports/allure-results`（可通过 `allure serve` 查看）
+- 覆盖率HTML报告：`reports/coverage-html/index.html`
+- 覆盖率XML报告：`reports/coverage.xml`
+
+## 许可证
+
+MIT

pytest_dynamic_params-0.1.0/README.md

@@ -0,0 +1,145 @@
+# pytest-dynamic-params
+
+pytest-dynamic-params 是一个为 pytest 设计的动态参数化插件，通过声明式参数生成器自动处理依赖解析和参数化，支持懒加载、缓存机制和多作用域管理，与现有 pytest 机制无缝集成，简化复杂测试场景的参数管理，提高测试效率和可维护性。
+
+## 特性
+
+- **声明式参数生成**：使用装饰器定义参数生成器，专注于"生成什么"而非"如何生成"
+- **自动依赖管理**：系统自动分析生成器函数的参数签名，确定依赖关系并按正确顺序执行
+- **与现有机制兼容**：完全兼容现有的pytest机制，包括`@pytest.mark.parametrize`装饰器和fixture系统
+- **性能优化**：支持懒加载和缓存机制，提高测试执行效率
+- **灵活的作用域管理**：支持function、class、module、session四种作用域
+- **智能错误检测**：自动检测并报告参数生成器之间的循环依赖
+- **可配置性**：支持多种配置选项，满足不同场景需求
+
+## 安装
+
+```bash
+pip install -e .
+```
+
+## 快速开始
+
+安装后，您可以立即在测试中使用动态参数装饰器：
+
+```python
+from dynamic_params import param_generator, with_dynamic_params
+
+@param_generator
+def calculate_result(input_value):
+    return input_value * 2
+
+@with_dynamic_params(result=calculate_result)
+@pytest.mark.parametrize("input_value", [1, 2, 3])
+def test_basic(input_value, result):
+    assert result == input_value * 2
+```
+
+## 核心概念
+
+- **参数生成器**：使用`@param_generator`装饰器定义的函数，用于生成参数值
+- **动态参数**：在运行时生成的参数，可以依赖其他参数或fixture
+- **参数依赖**：参数之间的依赖关系，系统自动按依赖顺序生成参数
+- **懒加载**：推迟参数生成到实际需要时执行，避免不必要的计算
+- **缓存机制**：缓存参数生成结果，避免重复计算，提高性能
+- **作用域管理**：控制参数生成器实例的生命周期，影响缓存和执行时机
+
+## 使用示例
+
+完整的使用示例请参见：
+- `examples/basic_usage.py` - 基础用法示例（可直接复制使用）
+- `examples/advanced_usage.py` - 高级用法示例（包含作用域、缓存和懒加载）
+- `docs/usage-guide.md` - 详细使用指南
+
+## 配置
+
+可以在`pytest.ini`中配置插件行为：
+
+```ini
+[pytest]
+# 动态参数化系统配置
+dynamic_param_cache_enabled = true
+dynamic_param_validation = strict
+dynamic_param_log_level = INFO
+
+# 缓存大小配置
+dynamic_param_cache_size_function = 1000
+dynamic_param_cache_size_class = 500
+dynamic_param_cache_size_module = 200
+dynamic_param_cache_size_session = 100
+
+# 性能配置
+dynamic_param_lazy_loading = true
+dynamic_param_incremental_generation = true
+
+# 测试标记
+markers =
+    dynamic_param: 使用动态参数的测试
+    param_generator: 参数生成器函数
+```
+
+也可以通过环境变量配置：
+- `PYTEST_DYNAMIC_PARAM_CACHE`: 控制缓存是否启用
+- `PYTEST_DYNAMIC_PARAM_VALIDATION`: 验证级别
+- `PYTEST_DYNAMIC_PARAM_LOG_LEVEL`: 日志级别
+- `PYTEST_DYNAMIC_PARAM_LAZY_LOADING`: 懒加载设置
+- `PYTEST_DYNAMIC_PARAM_INCREMENTAL`: 增量生成设置
+- `PYTEST_DYNAMIC_PARAM_DEBUG`: 调试模式
+- `PYTEST_DYNAMIC_PARAM_PROFILE`: 性能分析
+- `PYTEST_DYNAMIC_PARAM_CACHE_DIR`: 缓存目录
+
+## 项目结构
+
+项目的主要组成部分：
+
+- `src/` - 源代码
+- `tests/` - 测试代码
+- `examples/` - 使用示例
+- `docs/` - 文档
+- `specs/` - 项目规格说明
+- `reports/` - 测试报告
+
+有关详细的源码架构说明，请参见 [docs/structure.md](./docs/structure.md)。
+
+## 运行测试
+
+```bash
+# 运行单元测试
+python -m pytest tests/unit/
+
+# 运行功能测试
+python -m pytest tests/functional/
+
+# 运行集成测试
+python -m pytest tests/integration/
+
+# 运行性能测试
+python -m pytest tests/performance/
+
+# 运行所有测试
+python -m pytest tests/
+
+# 查看覆盖率
+python -m pytest --cov=src.dynamic_params tests/unit/ --cov-report=html
+
+# 生成完整报告（Allure + 覆盖率）
+python -m pytest tests/ --alluredir=reports/allure-results -clean --cov=src.dynamic_params --cov-report=html:reports/coverage-html --cov-report=xml:reports/coverage.xml --cov-report=term
+
+# 查看Allure报告
+allure serve reports/allure-results
+```
+
+## 测试报告
+
+有关测试报告的详细说明，请参见：
+- [docs/reports-readme.md](./docs/reports-readme.md) - 报告使用说明
+- [docs/reports-summary.md](./docs/reports-summary.md) - 测试结果和覆盖率摘要
+
+生成的报告位于 `reports/` 目录：
+- Allure报告：`reports/allure-results`（可通过 `allure serve` 查看）
+- 覆盖率HTML报告：`reports/coverage-html/index.html`
+- 覆盖率XML报告：`reports/coverage.xml`
+
+## 许可证
+
+MIT

pytest_dynamic_params-0.1.0/pyproject.toml

@@ -0,0 +1,75 @@
+[project]
+name = "pytest-dynamic-params"
+version = "0.1.0"
+description = "Dynamic parameters plugin for pytest"
+readme = "README.md"
+authors = [
+    { name = "Your Name", email = "your.email@example.com" }
+]
+license = { file = "LICENSE" }
+classifiers = [
+    "Framework :: Pytest",
+    "Programming Language :: Python :: 3",
+    "Operating System :: OS Independent"
+]
+requires-python = ">=3.8"
+dependencies = [
+    "pytest"
+]
+
+[project.optional-dependencies]
+dev = [
+    "black",
+    "flake8",
+    "isort",
+    "mypy",
+    "bandit",
+    "pre-commit"
+]
+
+[project.entry-points.pytest11]
+dynamic-params = "dynamic_params.plugin"
+
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.basedpyright]
+pythonVersion = "3.8"
+strict = true
+reportMissingImports = true
+reportMissingTypeStubs = true
+reportUnusedVariable = true
+reportUnusedImport = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.black]
+line-length = 88
+target-version = ['py38']
+
+[tool.isort]
+profile = "black"
+
+[tool.flake8]
+max-line-length = 88
+extend-ignore = [
+    "E203",  # 与 black 冲突的空格规则
+    "ANN101", "ANN102", "ANN103", "ANN104",  # 忽略 self/cls 的类型注解检查
+    "ANN201", "ANN202", "ANN203", "ANN204", "ANN205", "ANN206",  # 忽略返回值类型注解检查
+    "ANN001", "ANN002", "ANN003"  # 忽略参数类型注解检查
+]
+
+[tool.flake8.plugins]
+flake8-annotations = false
+
+[tool.mypy]
+python_version = "3.10"
+ignore_missing_imports = true
+exclude = "^tests/|^venv/|^\\.venv/"
+mypy_path = "src"
+follow_imports = "silent"
+warn_unused_configs = true
+namespace_packages = true

pytest_dynamic_params-0.1.0/setup.cfg

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

pytest_dynamic_params-0.1.0/setup.py

@@ -0,0 +1,15 @@
+from setuptools import find_packages, setup
+
+setup(
+    name="pytest-dynamic-params",
+    version="0.1.0",
+    packages=find_packages(where="src"),  # 只查找src目录下的包
+    package_dir={"": "src"},
+    install_requires=["pytest"],
+    entry_points={"pytest11": ["dynamic-params = dynamic_params.plugin"]},
+    classifiers=[
+        "Framework :: Pytest",
+        "Programming Language :: Python :: 3",
+        "Operating System :: OS Independent",
+    ],
+)

pytest_dynamic_params-0.1.0/src/dynamic_params/__init__.py

@@ -0,0 +1,21 @@
+from .config import DynamicParamConfig
+from .core.generator import ParamGenerator
+from .core.registry import GeneratorRegistry
+from .decorators import param_generator, with_dynamic_params
+from .errors import DynamicParamError, InvalidGeneratorError, MissingParameterError
+from .lazy import LazyResult
+from .plugin import pytest_configure, pytest_generate_tests
+
+__all__ = [
+    "ParamGenerator",
+    "LazyResult",
+    "GeneratorRegistry",
+    "DynamicParamError",
+    "MissingParameterError",
+    "InvalidGeneratorError",
+    "param_generator",
+    "with_dynamic_params",
+    "pytest_configure",
+    "pytest_generate_tests",
+    "DynamicParamConfig",
+]

pytest_dynamic_params-0.1.0/src/dynamic_params/config.py

@@ -0,0 +1,163 @@
+import configparser
+import os
+from typing import Any, Dict, Optional
+
+from .errors import ConfigurationError
+
+
+class DynamicParamConfig:
+    """动态参数化系统配置类"""
+
+    DEFAULT_CONFIG = {
+        "cache": {
+            "enabled": "true",
+            "size_function": "1000",
+            "size_class": "500",
+            "size_module": "200",
+            "size_session": "100",
+            "cleanup_interval": "100",
+            "dir": ".pytest_cache/dynamic_params",
+        },
+        "validation": {"level": "strict", "log_level": "INFO"},
+        "performance": {"lazy_loading": "true", "incremental_generation": "true"},
+        "debug": {"enabled": "false", "profile": "false"},
+    }
+
+    _instance: Optional["DynamicParamConfig"] = None
+    _config: Dict[str, Any]
+
+    def __new__(cls):
+        if cls._instance is None:
+            cls._instance = super().__new__(cls)
+            cls._instance._config = cls._instance._load_config()
+        return cls._instance
+
+    @classmethod
+    def get_instance(cls):
+        """获取单例实例"""
+        if cls._instance is None:
+            cls._instance = cls()
+        return cls._instance
+
+    def _load_config(self) -> Dict[str, Any]:
+        """加载配置"""
+        config = configparser.ConfigParser()
+        config.read_dict(self.DEFAULT_CONFIG)
+
+        # 从配置文件加载（优先级：pytest.ini > pyproject.toml > dynamic_params.json/yaml）
+        config_files = [
+            "pytest.ini",
+            "pyproject.toml",
+            "dynamic_params.json",
+            "dynamic_params.yaml",
+        ]
+
+        for config_file in config_files:
+            if os.path.exists(config_file):
+                try:
+                    config.read(config_file)
+                except Exception as e:
+                    print(f"Warning: Failed to read {config_file}: {e}")
+
+        # 从环境变量加载（优先级最高）
+        self._update_from_env(config)
+
+        return self._normalize_config(config)
+
+    def _update_from_env(self, config: configparser.ConfigParser):
+        """从环境变量更新配置"""
+        env_mapping = {
+            "PYTEST_DYNAMIC_PARAM_CACHE": "cache.enabled",
+            "PYTEST_DYNAMIC_PARAM_VALIDATION": "validation.level",
+            "PYTEST_DYNAMIC_PARAM_LOG_LEVEL": "validation.log_level",
+            "PYTEST_DYNAMIC_PARAM_LAZY_LOADING": "performance.lazy_loading",
+            "PYTEST_DYNAMIC_PARAM_INCREMENTAL": "performance.incremental_generation",
+            "PYTEST_DYNAMIC_PARAM_DEBUG": "debug.enabled",
+            "PYTEST_DYNAMIC_PARAM_PROFILE": "debug.profile",
+            "PYTEST_DYNAMIC_PARAM_CACHE_DIR": "cache.dir",
+        }
+
+        for env_var, config_key in env_mapping.items():
+            if env_var in os.environ:
+                try:
+                    section, option = config_key.split(".")
+                    if section not in config:
+                        config[section] = {}
+                    config[section][option] = os.environ[env_var]
+                except Exception as e:
+                    print(f"Warning: Failed to update config from {env_var}: {e}")
+
+    def _normalize_config(self, config: configparser.ConfigParser) -> Dict[str, Any]:
+        """标准化配置值"""
+        normalized: Dict[str, Any] = {}
+
+        for section in config.sections():
+            normalized[section] = {}
+            for key, value in config[section].items():
+                try:
+                    # 转换布尔值
+                    if value.lower() in ("true", "false"):
+                        normalized[section][key] = config[section].getboolean(key)
+                    # 转换整数
+                    elif value.isdigit():
+                        normalized[section][key] = config[section].getint(key)
+                    else:
+                        normalized[section][key] = value
+                except Exception as e:
+                    raise ConfigurationError(
+                        config_key=f"{section}.{key}",
+                        config_value=value,
+                        expected_type=str,
+                    ) from e
+
+        return normalized
+
+    def get(self, section: str, option: str, default: Optional[Any] = ...) -> Any:
+        """获取配置值"""
+        try:
+            if section not in self._config:
+                if default is not ...:
+                    return default
+                raise KeyError(section)
+            if option not in self._config[section]:
+                if default is not ...:
+                    return default
+                raise KeyError(option)
+            return self._config[section][option]
+        except KeyError:
+            if default is not ...:
+                return default
+            raise
+
+    def get_section(self, section: str) -> Dict[str, Any]:
+        """获取整个配置节"""
+        return self._config.get(section, {})
+
+    def validate(self) -> bool:
+        """验证配置有效性"""
+        try:
+            # 验证缓存配置
+            if not isinstance(self.get("cache", "enabled"), bool):
+                raise ConfigurationError(
+                    "cache.enabled", self.get("cache", "enabled"), bool
+                )
+
+            # 验证验证级别
+            valid_levels = ["strict", "warn", "off"]
+            if self.get("validation", "level") not in valid_levels:
+                raise ConfigurationError(
+                    "validation.level", self.get("validation", "level"), str
+                )
+
+            # 验证日志级别
+            valid_log_levels = ["DEBUG", "INFO", "WARNING", "ERROR"]
+            if self.get("validation", "log_level") not in valid_log_levels:
+                raise ConfigurationError(
+                    "validation.log_level", self.get("validation", "log_level"), str
+                )
+
+            return True
+        except ConfigurationError:
+            raise
+        except Exception as e:
+            raise ConfigurationError("config.validation", str(e), str) from e