Fix CI and add Python 3.9-3.14 compatibility matrix

Author: cloudQuant

.github/workflows/optimized-tests.yml

@@ -1,15 +1,3 @@
-# GitHub Actions CI/CD Quality Pipeline
-# Generated by BMad TEA Agent - Test Architect Module
-# Optimized for: Quality Gates, Coverage Thresholds, Parallel Execution
-# Stack: backend (Python) | Framework: pytest
-#
-# Quality Gates:
-#   - Lint: ruff check (zero errors)
-#   - Format: ruff format --check
-#   - Type: mypy (strict mode)
-#   - Coverage: fail_under=40 (verified full-suite baseline threshold)
-#   - Security: bandit, pip-audit
-
 name: Tests
 
 on:
@@ -19,32 +7,30 @@ on:
     branches: [main, master, develop]
   workflow_dispatch:
     inputs:
-      test-markers:
-        description: 'Pytest markers to filter tests (e.g., "unit", "not slow")'
-        required: false
-        default: ''
       coverage-threshold:
-        description: 'Minimum coverage percentage'
+        description: "Minimum coverage percentage for the Ubuntu baseline suite"
         required: false
-        default: '40'
+        default: "40"
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
 
 env:
-  PYTHON_VERSION_DEFAULT: '3.11'
-  COVERAGE_THRESHOLD: 40
+  PYTHON_VERSION_DEFAULT: "3.11"
+  COVERAGE_THRESHOLD: "40"
+  SMOKE_TEST_PATHS: >-
+    tests/test_bt_api_quality.py
+    tests/test_event_bus.py
+    tests/core/test_async_context.py
+    tests/gateway/test_config.py
+  FULL_SUITE_MARKERS: "not network and not integration and not performance and not e2e"
 
 jobs:
-  # ============================================================================
-  # STAGE 1: FAST FEEDBACK (< 5 minutes)
-  # Code quality checks - lint, format, type, security
-  # ============================================================================
   quality:
     name: Quality Gates
     runs-on: ubuntu-latest
-    timeout-minutes: 10
+    timeout-minutes: 15
 
     steps:
       - uses: actions/checkout@v4
@@ -53,6 +39,7 @@ jobs:
         with:
           python-version: ${{ env.PYTHON_VERSION_DEFAULT }}
           cache: pip
+          cache-dependency-path: pyproject.toml
 
       - name: Install package + quality tools
         run: |
@@ -76,21 +63,21 @@ jobs:
         run: pip-audit || true
         continue-on-error: true
 
-  # ============================================================================
-  # STAGE 2: COMPREHENSIVE TESTING (10-20 minutes)
-  # Full test suite with coverage reporting
-  # ============================================================================
-  test:
-    name: Test (Python ${{ matrix.python-version }}, ${{ matrix.os }})
+  compatibility:
+    name: Compatibility (Python ${{ matrix.python-version }}, ${{ matrix.os }})
     runs-on: ${{ matrix.os }}
     timeout-minutes: 30
     needs: quality
 
     strategy:
       fail-fast: false
       matrix:
-        os: [ubuntu-latest]
-        python-version: ['3.11']
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.9", "3.10", "3.11", "3.12", "3.13", "3.14"]
+
+    defaults:
+      run:
+        shell: bash
 
     steps:
       - uses: actions/checkout@v4
@@ -99,163 +86,110 @@ jobs:
         with:
           python-version: ${{ matrix.python-version }}
           cache: pip
+          cache-dependency-path: pyproject.toml
 
       - name: Install build tools (Linux)
         if: runner.os == 'Linux'
         run: sudo apt-get update && sudo apt-get install -y build-essential
 
+      # GitHub-hosted runners do not expose a generic Windows 11 x64 label.
+      # `windows-latest` is the supported hosted Windows image for this matrix.
       - name: Install package + dev deps
         run: |
           python -m pip install --upgrade pip
           pip install -e ".[dev]"
 
-      - name: Run unit tests
+      - name: Run cross-platform compatibility smoke suite
         env:
-          # Security: inputs passed through env: to prevent script injection
-          TEST_MARKERS: ${{ github.event.inputs.test-markers }}
+          SKIP_LIVE_TESTS: "true"
+        run: pytest $SMOKE_TEST_PATHS -q
+
+  full-suite:
+    name: Full Suite (Python ${{ env.PYTHON_VERSION_DEFAULT }}, Ubuntu)
+    runs-on: ubuntu-latest
+    timeout-minutes: 45
+    needs: quality
+
+    defaults:
+      run:
+        shell: bash
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ env.PYTHON_VERSION_DEFAULT }}
+          cache: pip
+          cache-dependency-path: pyproject.toml
+
+      - name: Install build tools
+        run: sudo apt-get update && sudo apt-get install -y build-essential
+
+      - name: Install package + dev deps
         run: |
-          # Security: inputs passed through env: to prevent script injection
-          if [ -n "$TEST_MARKERS" ]; then
-            pytest tests -v -m "$TEST_MARKERS" \
-              -n 8 \
-              --dist=loadgroup
-          else
-            pytest tests -v -m "unit" \
-              -n 8 \
-              --dist=loadgroup
-          fi
+          python -m pip install --upgrade pip
+          pip install -e ".[dev]"
 
-      - name: Run full test suite with coverage gate
+      - name: Run baseline suite with coverage gate
         env:
           SKIP_LIVE_TESTS: "true"
         run: |
           pytest tests -v \
+            -m "$FULL_SUITE_MARKERS" \
             --cov=bt_api_py \
             --cov-report=xml:coverage-full.xml \
             --cov-report=html \
             --cov-report=term-missing \
-            --cov-fail-under=${{ github.event.inputs.coverage-threshold || env.COVERAGE_THRESHOLD }} \
-            -n 8 \
-            --dist=loadgroup
+            --cov-fail-under=${{ github.event.inputs.coverage-threshold || env.COVERAGE_THRESHOLD }}
 
       - name: Upload coverage to Codecov
         if: always()
         uses: codecov/codecov-action@v5
         with:
           files: ./coverage-full.xml
-          flags: ${{ matrix.os }}-py${{ matrix.python-version }}
+          flags: ubuntu-py${{ env.PYTHON_VERSION_DEFAULT }}
           fail_ci_if_error: false
           verbose: true
 
       - name: Archive coverage report
         if: always()
         uses: actions/upload-artifact@v4
         with:
-          name: coverage-report-${{ matrix.os }}-py${{ matrix.python-version }}
+          name: coverage-report-ubuntu-py${{ env.PYTHON_VERSION_DEFAULT }}
           path: htmlcov/
           retention-days: 30
 
-      - name: Archive test results
-        if: failure()
-        uses: actions/upload-artifact@v4
-        with:
-          name: test-results-${{ matrix.os }}-py${{ matrix.python-version }}
-          path: |
-            .pytest_cache/
-            test-results/
-          retention-days: 30
-
-  # ============================================================================
-  # STAGE 3: QUALITY GATE ENFORCEMENT
-  # Ensure coverage threshold is met across all matrix combinations
-  # ============================================================================
   quality-gate:
     name: Quality Gate
     runs-on: ubuntu-latest
-    needs: [quality, test]
+    needs: [quality, compatibility, full-suite]
     if: always()
 
     steps:
-      - name: Check test results
+      - name: Check job results
         run: |
-          if [ "${{ needs.test.result }}" == "failure" ]; then
-            echo "::error::Tests failed - Quality gate not passed"
+          if [ "${{ needs.quality.result }}" != "success" ]; then
+            echo "::error::Quality checks failed"
+            exit 1
+          fi
+          if [ "${{ needs.compatibility.result }}" != "success" ]; then
+            echo "::error::Compatibility matrix failed"
+            exit 1
+          fi
+          if [ "${{ needs.full-suite.result }}" != "success" ]; then
+            echo "::error::Full baseline suite failed"
             exit 1
           fi
-          echo "✅ All quality gates passed"
 
       - name: Generate summary
         run: |
-          echo "## 🎯 Quality Gate Summary" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          echo "| Gate | Status |" >> $GITHUB_STEP_SUMMARY
-          echo "|------|--------|" >> $GITHUB_STEP_SUMMARY
-          echo "| Lint | ${{ needs.quality.result == 'success' && '✅ Passed' || '❌ Failed' }} |" >> $GITHUB_STEP_SUMMARY
-          echo "| Tests | ${{ needs.test.result == 'success' && '✅ Passed' || '❌ Failed' }} |" >> $GITHUB_STEP_SUMMARY
-          echo "| Coverage | ✅ ≥${{ github.event.inputs.coverage-threshold || env.COVERAGE_THRESHOLD }}% |" >> $GITHUB_STEP_SUMMARY
-          echo "" >> $GITHUB_STEP_SUMMARY
-          echo "**Required CI platform**: ubuntu-latest" >> $GITHUB_STEP_SUMMARY
-          echo "**Required CI Python version**: 3.11" >> $GITHUB_STEP_SUMMARY
-
-  # ============================================================================
-  # BURN-IN: FLAKY TEST DETECTION (scheduled only)
-  # Runs 5 iterations to detect flaky tests
-  # ============================================================================
-  burn-in:
-    name: Burn-In (Flaky Detection)
-    runs-on: ubuntu-latest
-    timeout-minutes: 60
-    needs: quality
-    if: github.event_name == 'schedule' || github.event_name == 'workflow_dispatch'
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: actions/setup-python@v5
-        with:
-          python-version: ${{ env.PYTHON_VERSION_DEFAULT }}
-          cache: pip
-
-      - name: Install build tools
-        run: sudo apt-get update && sudo apt-get install -y build-essential
-
-      - name: Install package + dev deps
-        run: |
-          python -m pip install --upgrade pip
-          pip install -e ".[dev]"
-
-      - name: Run burn-in loop (5 iterations)
-        env:
-          SKIP_LIVE_TESTS: "true"
-        run: |
-          echo "🔥 Starting burn-in loop - detecting flaky tests"
-          for i in {1..5}; do
-            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-            echo "🔥 Burn-in iteration $i/5"
-            echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
-            pytest tests -v -m "unit" -n 8 --dist=loadgroup || exit 1
-          done
-          echo "✅ Burn-in complete - no flaky tests detected"
-
-      - name: Upload burn-in failure artifacts
-        if: failure()
-        uses: actions/upload-artifact@v4
-        with:
-          name: burn-in-failures
-          path: |
-            .pytest_cache/
-            htmlcov/
-          retention-days: 30
-
-# ============================================================================
-# EXTENSION PATTERNS — Script Injection Prevention
-# ============================================================================
-# When extending this template into reusable workflows, manual dispatch
-# workflows, or composite actions, NEVER use ${{ inputs.* }} directly in
-# run: blocks. Always pass through env: intermediaries.
-#
-# KEY PRINCIPLE: Inputs must be DATA, not COMMANDS.
-# Pass inputs through env: and interpolate as quoted arguments into fixed
-# commands. NEVER accept command-shaped inputs (e.g., install-command,
-# test-command) that get executed as shell code — even through env:.
-# ============================================================================
+          echo "## CI Summary" >> "$GITHUB_STEP_SUMMARY"
+          echo "" >> "$GITHUB_STEP_SUMMARY"
+          echo "| Job | Status |" >> "$GITHUB_STEP_SUMMARY"
+          echo "|-----|--------|" >> "$GITHUB_STEP_SUMMARY"
+          echo "| Quality | ${{ needs.quality.result == 'success' && 'Passed' || 'Failed' }} |" >> "$GITHUB_STEP_SUMMARY"
+          echo "| Compatibility matrix | ${{ needs.compatibility.result == 'success' && 'Passed' || 'Failed' }} |" >> "$GITHUB_STEP_SUMMARY"
+          echo "| Ubuntu baseline suite | ${{ needs.full-suite.result == 'success' && 'Passed' || 'Failed' }} |" >> "$GITHUB_STEP_SUMMARY"
+          echo "" >> "$GITHUB_STEP_SUMMARY"
+          echo "Compatibility matrix: macOS, Linux, Windows x Python 3.9-3.14." >> "$GITHUB_STEP_SUMMARY"

.github/workflows/tests.yml

@@ -4,6 +4,8 @@
  and traditional financial markets (CTP, Interactive Brokers).
 """
 
+from __future__ import annotations
+
 from bt_api_py._version import __version__
 from bt_api_py.auth_config import (
     AuthConfig,

bt_api_py/__init__.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+from datetime import timezone
+from enum import Enum
+
+try:
+    from typing import Never as _Never
+    from typing import ParamSpec as _ParamSpec
+    from typing import Self as _Self
+except ImportError:
+    from typing_extensions import Never as _Never
+    from typing_extensions import ParamSpec as _ParamSpec
+    from typing_extensions import Self as _Self
+
+try:
+    from enum import StrEnum as _StrEnum
+except ImportError:
+
+    class _StrEnum(str, Enum):
+        """Backport for Python < 3.11."""
+
+
+Never = _Never
+ParamSpec = _ParamSpec
+Self = _Self
+StrEnum = _StrEnum
+UTC = timezone.utc
+
+__all__ = ["Never", "ParamSpec", "Self", "StrEnum", "UTC"]

bt_api_py/_compat.py

@@ -1,3 +1,5 @@
 """Package version metadata."""
 
+from __future__ import annotations
+
 __version__ = "0.15"

bt_api_py/_version.py

@@ -3,6 +3,8 @@
 加密货币交易所使用 API Key，CTP 使用 Broker/User/Password，IB 使用 TWS 连接参数.
 """
 
+from __future__ import annotations
+
 from typing import Any
 from urllib.parse import urlparse