df-test-framework 4.10.2__tar.gz → 4.10.4__tar.gz

df_test_framework-4.10.4/.github/workflows/docs.yml

@@ -0,0 +1,44 @@
+name: 文档机检
+
+# 文档改动的轻量检查（死链/import 路径/版本一致性机检在 tests/test_docs_*.py，
+# 测试矩阵的 paths 过滤排除了 docs/**，此 workflow 补上这道防线；单机约 2 分钟）
+on:
+  push:
+    branches: [ main, master, develop ]
+    paths:
+    - docs/**
+    - '*.md'
+    - .github/workflows/docs.yml
+  pull_request:
+    branches: [ main, master, develop ]
+    paths:
+    - docs/**
+    - '*.md'
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+permissions:
+  contents: read
+
+jobs:
+  docs-check:
+    name: 文档死链 / import 路径 / 版本一致性
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+    - uses: actions/checkout@v5
+
+    - uses: astral-sh/setup-uv@v7
+      with:
+        version: "latest"
+        enable-cache: false
+
+    - name: 安装依赖
+      run: uv sync
+
+    - name: 文档机检
+      run: uv run pytest tests/test_docs_links.py tests/test_docs_imports.py tests/test_version_consistency.py -v

df_test_framework-4.10.4/.github/workflows/lint.yml

@@ -0,0 +1,70 @@
+name: 代码质量检查
+
+on:
+  push:
+    branches: [ main, master, develop ]
+    paths: &code_paths
+    - src/**
+    - tests/**
+    - pyproject.toml
+    - .github/workflows/lint.yml
+  pull_request:
+    branches: [ main, master, develop ]
+    paths: *code_paths
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint & Format Check
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+    - name: 检出代码
+      uses: actions/checkout@v5
+
+    - name: 设置Python 3.12
+      uses: actions/setup-python@v6
+      with:
+        python-version: '3.12'
+
+    - name: 安装uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: "latest"
+        enable-cache: false
+
+    - name: 同步依赖
+      run: |
+        uv sync
+
+    - name: Ruff代码检查
+      run: |
+        echo "::group::Ruff Linting"
+        uv run ruff check src/ --output-format=github
+        echo "::endgroup::"
+
+    - name: Ruff格式检查
+      run: |
+        echo "::group::Ruff Format Check"
+        uv run ruff format src/ --check
+        echo "::endgroup::"
+
+    - name: MyPy类型检查
+      run: |
+        echo "::group::MyPy Type Checking"
+        uv run mypy src/df_test_framework --ignore-missing-imports --no-strict-optional
+        echo "::endgroup::"
+      continue-on-error: true  # 类型检查暂时允许失败
+
+    - name: 检查结果总结
+      if: always()
+      run: |
+        echo "## 代码质量检查完成 ✅" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "- ✅ Ruff Linting" >> $GITHUB_STEP_SUMMARY
+        echo "- ✅ Ruff Format Check" >> $GITHUB_STEP_SUMMARY
+        echo "- ⚠️  MyPy Type Checking (允许失败)" >> $GITHUB_STEP_SUMMARY

df_test_framework-4.10.4/.github/workflows/release.yml

@@ -0,0 +1,245 @@
+name: 发布
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'  # 触发条件: 推送版本标签 (如 v2.0.0)
+  workflow_dispatch:  # 允许手动触发
+    inputs:
+      version:
+        description: '仅验证和构建的版本号（不发布，例如 4.10.1）'
+        required: true
+        type: string
+
+permissions:
+  contents: write  # 允许创建 Release 和上传资源
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: false
+
+jobs:
+  validate:
+    name: 校验发布版本与文档
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+
+    steps:
+    - name: 检出代码
+      uses: actions/checkout@v5
+
+    - name: 设置Python 3.12
+      uses: actions/setup-python@v6
+      with:
+        python-version: '3.12'
+
+    - name: 版本与发布材料必须匹配
+      env:
+        RELEASE_VERSION: ${{ github.event_name == 'push' && github.ref_name || inputs.version }}
+      run: python scripts/check_release.py "$RELEASE_VERSION"
+
+  test:
+    name: 发布前完整测试
+    needs: validate
+    uses: ./.github/workflows/test.yml
+    with:
+      full_matrix: true
+
+  build:
+    name: 构建分发包
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    needs: test
+
+    steps:
+    - name: 检出代码
+      uses: actions/checkout@v5
+
+    - name: 设置Python 3.12
+      uses: actions/setup-python@v6
+      with:
+        python-version: '3.12'
+
+    - name: 安装构建工具
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine
+
+    - name: 安装uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: "latest"
+        enable-cache: false
+
+    - name: 安装锁定的检查工具
+      run: uv sync --locked
+
+    - name: 代码质量检查（不自动修改发布源码）
+      run: |
+        uv run --no-sync ruff check src/ tests/ scripts/check_release.py
+        uv run --no-sync ruff format src/ tests/ scripts/check_release.py --check
+
+    - name: 构建分发包
+      run: |
+        python -m build
+
+    - name: 检查分发包
+      run: |
+        twine check dist/*
+
+    - name: 独立环境验收 wheel 与可选密码入口
+      run: |
+        WHEEL=$(realpath dist/*.whl)
+        EXPECTED=$(python -c 'import tomllib; print(tomllib.load(open("pyproject.toml", "rb"))["project"]["version"])')
+        python -m venv "$RUNNER_TEMP/release-smoke"
+        "$RUNNER_TEMP/release-smoke/bin/python" -m pip install "$WHEEL[gm,crypto]"
+        cd "$RUNNER_TEMP"
+        "$RUNNER_TEMP/release-smoke/bin/df-test" --help
+        "$RUNNER_TEMP/release-smoke/bin/python" -I - "$EXPECTED" <<'PY'
+        import secrets
+        import sys
+        from importlib.metadata import version
+        from df_test_framework import SM2PrivateKey, SM2_DEFAULT_USER_ID
+        from df_test_framework.infrastructure.helpers import (
+            SM2Cipher, SM2Signer, SM4Cipher, aes_encrypt, aes_decrypt,
+        )
+        assert version("df-test-framework") == sys.argv[1]
+        private = SM2PrivateKey.generate()
+        signer = SM2Signer(key=private, user_id=SM2_DEFAULT_USER_ID, signature_format="der")
+        signer.verify_text(signer.sign_text("验收"), "验收")
+        cipher = SM2Cipher(key=private, ciphertext_format="c1c3c2")
+        assert cipher.decrypt_text(cipher.encrypt_text("验收")) == "验收"
+        sm4 = SM4Cipher(key=secrets.token_bytes(16), mode="GCM")
+        nonce = secrets.token_bytes(12)
+        assert sm4.decrypt_text(sm4.encrypt_text("验收", nonce=nonce), nonce=nonce) == "验收"
+        key = secrets.token_bytes(16)
+        aes = aes_encrypt("验收", key=key, mode="ECB")
+        assert aes_decrypt(aes, key=key, mode="ECB") == "验收"
+        PY
+        "$RUNNER_TEMP/release-smoke/bin/python" -I "$GITHUB_WORKSPACE/scripts/smoke_config_release.py" "$EXPECTED"
+
+    - name: 上传构建产物
+      uses: actions/upload-artifact@v6
+      with:
+        name: dist-packages
+        path: dist/
+        retention-days: 7
+
+    - name: 构建总结
+      run: |
+        echo "## 构建完成 ✅" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "**构建产物**:" >> $GITHUB_STEP_SUMMARY
+        echo '```' >> $GITHUB_STEP_SUMMARY
+        ls -lh dist/
+        echo '```' >> $GITHUB_STEP_SUMMARY
+
+  publish-pypi:
+    name: 发布到PyPI
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    needs: build
+    environment: release  # 使用GitHub环境保护规则
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+
+    steps:
+    - name: 下载构建产物
+      uses: actions/download-artifact@v7
+      with:
+        name: dist-packages
+        path: dist/
+
+    - name: 发布到PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        password: ${{ secrets.PYPI_API_TOKEN }}
+
+    - name: 发布总结
+      run: |
+        echo "## 🎉 发布到PyPI成功！" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "版本: \`${GITHUB_REF#refs/tags/}\`" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "**安装命令**:" >> $GITHUB_STEP_SUMMARY
+        echo '```bash' >> $GITHUB_STEP_SUMMARY
+        echo "pip install df-test-framework" >> $GITHUB_STEP_SUMMARY
+        echo '```' >> $GITHUB_STEP_SUMMARY
+
+  create-release:
+    name: 创建GitHub Release
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    needs: [build, publish-pypi]
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+
+    steps:
+    - name: 检出代码
+      uses: actions/checkout@v5
+      with:
+        fetch-depth: 0  # 获取完整历史用于生成changelog
+
+    - name: 下载构建产物
+      uses: actions/download-artifact@v7
+      with:
+        name: dist-packages
+        path: dist/
+
+    - name: 设置Python 3.12
+      uses: actions/setup-python@v6
+      with:
+        python-version: '3.12'
+
+    - name: 生成变更日志
+      id: changelog
+      run: |
+        VERSION=${GITHUB_REF#refs/tags/v}
+        echo "version=$VERSION" >> $GITHUB_OUTPUT
+
+        python scripts/check_release.py "$VERSION" --notes release_notes.md
+
+    - name: 创建GitHub Release
+      uses: softprops/action-gh-release@v3
+      with:
+        name: v${{ steps.changelog.outputs.version }}
+        body_path: release_notes.md
+        files: |
+          dist/*
+        draft: false
+        prerelease: false
+        generate_release_notes: true
+
+    - name: Release总结
+      run: |
+        echo "## 🎉 GitHub Release创建成功！" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "**版本**: v${{ steps.changelog.outputs.version }}" >> $GITHUB_STEP_SUMMARY
+        echo "**查看**: [Release页面](https://github.com/${{ github.repository }}/releases/tag/v${{ steps.changelog.outputs.version }})" >> $GITHUB_STEP_SUMMARY
+
+  notify:
+    name: 发布通知
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    needs: [publish-pypi, create-release]
+    if: always() && github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+
+    steps:
+    - name: 发送钉钉通知
+      if: env.DINGTALK_WEBHOOK != ''
+      env:
+        DINGTALK_WEBHOOK: ${{ secrets.DINGTALK_WEBHOOK }}
+      run: |
+        VERSION=${GITHUB_REF#refs/tags/v}
+        STATUS="✅ 成功"
+        if [ "${{ needs.publish-pypi.result }}" != "success" ] || [ "${{ needs.create-release.result }}" != "success" ]; then
+          STATUS="❌ 失败"
+        fi
+
+        curl -X POST "$DINGTALK_WEBHOOK" \
+          -H 'Content-Type: application/json' \
+          -d "{
+            \"msgtype\": \"markdown\",
+            \"markdown\": {
+              \"title\": \"DF Test Framework 发布通知\",
+              \"text\": \"## DF Test Framework 发布通知\\n\\n**版本**: v${VERSION}\\n\\n**状态**: ${STATUS}\\n\\n**安装**: \\\`pip install df-test-framework\\\`\\n\\n**查看**: [GitHub Release](https://github.com/${{ github.repository }}/releases/tag/v${VERSION})\"
+            }
+          }"

df_test_framework-4.10.4/.github/workflows/scheduled.yml

@@ -0,0 +1,150 @@
+name: 定时检查
+
+# 额度策略（2026-08-24）：内容与 test.yml/lint.yml 完全重复，每日空跑
+# 无信息量（无新提交时结果恒同）——去掉定时，仅保留手动触发备用。
+on:
+  workflow_dispatch:  # 仅手动触发
+
+jobs:
+  health-check:
+    name: 健康检查
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+    - name: 检出代码
+      uses: actions/checkout@v5
+
+    - name: 设置Python 3.12
+      uses: actions/setup-python@v6
+      with:
+        python-version: '3.12'
+
+    - name: 安装uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: "latest"
+        enable-cache: false
+
+    - name: 同步依赖
+      run: |
+        uv sync
+
+    - name: 代码质量检查
+      run: |
+        echo "::group::Ruff Linting"
+        uv run ruff check src/
+        echo "::endgroup::"
+
+        echo "::group::Ruff Format"
+        uv run ruff format src/ --check
+        echo "::endgroup::"
+
+    - name: CLI命令健康检查
+      run: |
+        echo "::group::CLI Help"
+        uv run df-test --help
+        echo "::endgroup::"
+
+        echo "::group::Init命令"
+        # CI环境自动检测：框架会使用本地路径依赖（CI=true）
+        uv run df-test init health-check-api --type api
+        # pytest 配置已整合到 pyproject.toml
+        test -f health-check-api/pyproject.toml || exit 1
+        echo "::endgroup::"
+
+        echo "::group::验证依赖配置"
+        # 验证生成的项目使用了本地路径依赖
+        grep 'df-test-framework @ file://..' health-check-api/pyproject.toml || exit 1
+        echo "✅ 已正确使用本地路径依赖"
+        echo "::endgroup::"
+
+        echo "::group::Gen命令"
+        # 在父目录执行 gen 命令，指定输出目录
+        uv run df-test gen test health_check --output-dir health-check-api/tests/api/
+        test -f health-check-api/tests/api/test_health_check.py || exit 1
+        echo "::endgroup::"
+
+    - name: 检查文档链接
+      run: |
+        echo "::group::检查文档文件"
+        test -f README.md
+        test -f CHANGELOG.md
+        test -f docs/README.md
+        echo "::endgroup::"
+
+    - name: 检查示例代码
+      run: |
+        echo "::group::检查示例目录"
+        test -d examples/
+        find examples/ -name "*.py" -type f | head -5
+        echo "::endgroup::"
+
+    - name: 健康检查总结
+      if: always()
+      run: |
+        echo "## 🏥 每日健康检查" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "**日期**: $(date +'%Y-%m-%d %H:%M:%S')" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "### 检查项" >> $GITHUB_STEP_SUMMARY
+        echo "- ✅ 代码质量（Ruff）" >> $GITHUB_STEP_SUMMARY
+        echo "- ✅ CLI工具可用性" >> $GITHUB_STEP_SUMMARY
+        echo "- ✅ 项目初始化功能" >> $GITHUB_STEP_SUMMARY
+        echo "- ✅ 代码生成功能" >> $GITHUB_STEP_SUMMARY
+        echo "- ✅ 文档完整性" >> $GITHUB_STEP_SUMMARY
+        echo "- ✅ 示例代码存在性" >> $GITHUB_STEP_SUMMARY
+
+  dependency-check:
+    name: 依赖安全检查
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+
+    steps:
+    - name: 检出代码
+      uses: actions/checkout@v5
+
+    - name: 设置Python 3.12
+      uses: actions/setup-python@v6
+      with:
+        python-version: '3.12'
+
+    - name: 安装pip-audit
+      run: |
+        pip install pip-audit
+
+    - name: 检查依赖安全漏洞
+      run: |
+        pip install -e .
+        pip-audit --desc
+      continue-on-error: true  # 允许有漏洞，但会记录
+
+    - name: 依赖检查总结
+      if: always()
+      run: |
+        echo "## 🔒 依赖安全检查" >> $GITHUB_STEP_SUMMARY
+        echo "" >> $GITHUB_STEP_SUMMARY
+        echo "已扫描所有依赖包的已知安全漏洞" >> $GITHUB_STEP_SUMMARY
+
+  notify-failure:
+    name: 失败通知
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    needs: [health-check, dependency-check]
+    if: failure() && github.event_name == 'schedule'
+
+    steps:
+    - name: 发送钉钉通知
+      if: env.DINGTALK_WEBHOOK != ''
+      env:
+        DINGTALK_WEBHOOK: ${{ secrets.DINGTALK_WEBHOOK }}
+      run: |
+        curl -X POST "$DINGTALK_WEBHOOK" \
+          -H 'Content-Type: application/json' \
+          -d "{
+            \"msgtype\": \"markdown\",
+            \"markdown\": {
+              \"title\": \"⚠️ DF Test Framework 定时检查失败\",
+              \"text\": \"## ⚠️ 定时健康检查失败\\n\\n**时间**: $(date +'%Y-%m-%d %H:%M:%S')\\n\\n**查看**: [GitHub Actions](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }})\\n\\n请及时处理！\"
+            }
+          }"