fyre-toolkit 0.1.13__tar.gz

fyre_toolkit-0.1.13/.editorconfig

@@ -0,0 +1,17 @@
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+
+[*.py]
+charset = utf-8
+indent_style = space
+indent_size = 4
+continuation_indent_size = 4
+spaces_around_operators = 1
+max_line_length = 80
+
+[Makefile]
+indent_style = tab
+tab_width = 2

fyre_toolkit-0.1.13/.gitee/ISSUE_TEMPLATE.zh-CN.md

@@ -0,0 +1,13 @@
+#### 该问题是怎么引起的？
+
+
+
+#### 重现步骤
+
+
+
+#### 报错信息
+
+
+
+

fyre_toolkit-0.1.13/.gitee/PULL_REQUEST_TEMPLATE.zh-CN.md

@@ -0,0 +1,12 @@
+#### 相关的Issue
+
+
+#### 原因（目的、解决的问题等）
+
+
+#### 描述（做了什么，变更了什么）
+
+
+#### 测试用例（新增、改动、可能影响的功能）
+
+

fyre_toolkit-0.1.13/.github/ISSUE_TEMPLATE/config.yaml

@@ -0,0 +1 @@
+blank_issues_enabled: true

fyre_toolkit-0.1.13/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,43 @@
+name: 功能建议
+description: 对本项目提出一个功能建议
+title: "[Feature]: "
+labels: ["feature"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢提出功能建议，我们将仔细考虑！
+  - type: textarea
+    id: related-problem
+    attributes:
+      label: 你的功能建议是否和某个问题相关？
+      description: 清晰并简洁地描述问题是什么，例如，当我...时，我总是感到困扰。
+    validations:
+      required: false
+  - type: textarea
+    id: desired-solution
+    attributes:
+      label: 你希望看到什么解决方案？
+      description: 清晰并简洁地描述你希望发生的事情。
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: 你考虑过哪些替代方案？
+      description: 清晰并简洁地描述你考虑过的任何替代解决方案或功能。
+    validations:
+      required: false
+  - type: textarea
+    id: additional-context
+    attributes:
+      label: 你有其他上下文或截图吗？
+      description: 在此处添加有关功能请求的任何其他上下文或截图。
+    validations:
+      required: false
+  - type: checkboxes
+    attributes:
+      label: 意向参与贡献
+      options:
+        - label: 我有意向参与具体功能的开发实现并将代码贡献回到本项目
+          required: false

fyre_toolkit-0.1.13/.github/ISSUE_TEMPLATE/issue_report.yml

@@ -0,0 +1,54 @@
+name: 问题反馈
+description: 当你在代码中发现了一个问题, 导致应用崩溃或抛出异常, 或者有一个组件存在问题, 或者某些地方看起来不对劲.
+title: "[Bug]: "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        感谢对项目的支持与关注。在提出问题之前，请确保你已查看相关开发或使用文档：
+        - https://...
+  - type: checkboxes
+    attributes:
+      label: 这个问题是否已经存在？
+      options:
+        - label: 我已经搜索过现有的问题
+          required: false
+  - type: textarea
+    attributes:
+      label: 如何复现
+      description: 请详细告诉我们如何复现你遇到的问题，如涉及代码，可提供一个最小代码示例，并使用反引号```附上它
+      placeholder: |
+        1. ...
+        2. ...
+        3. ...
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: 预期结果
+      description: 请告诉我们你预期会发生什么。
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: 实际结果
+      description: 请告诉我们实际发生了什么。
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: 截图或视频
+      description: 如果可以的话，上传任何关于 bug 的截图。
+      value: |
+        [在这里上传图片]
+  - type: dropdown
+    id: version
+    attributes:
+      label: 版本
+      description: 你当前正在使用我们软件的哪个版本/分支？
+      options:
+        - 0.1 (默认)
+        - 0.2
+    validations:
+      required: true

fyre_toolkit-0.1.13/.github/workflows/test.yml

@@ -0,0 +1,131 @@
+# This workflow will install Python dependencies, run tests, lint and build with a variety of Python versions
+# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
+
+name: pytest
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["feature-**"]
+
+jobs:
+  build-artifacts:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          persist-credentials: false
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install uv flake8 pytest ruff
+          if [ -f pyproject.toml ]; then uv sync; fi
+        env:
+          CI: true
+      - name: Install pypa/build
+        run: |
+          python -m pip install build --user
+      - name: Lint with ruff
+        run: |
+          # stop the build if there are Python syntax errors or undefined names
+          # flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+          # exit-zero treats all errors as warnings. The GitHub editor is 127 chars wide
+          # flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+          uv run ruff check
+      - name: Test with pytest
+        run: |
+          uv run pytest --disable-warnings --tb=short
+      - name: Build a binary wheel and a source tarball
+        run: python3 -m build
+      - name: Store the distribution packages
+        if: matrix.python-version == '3.12'
+        uses: actions/upload-artifact@v5
+        with:
+          name: python-package-distributions
+          path: dist/
+ 
+  bump-version:
+    # Use a condition to prevent infinite loops from the bot's own commits
+    if: "! contains(github.event.head_commit.message, 'Bump version')"
+    runs-on: ubuntu-latest
+    needs: build-artifacts
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v5
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.BOT_TOKEN }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.12"
+
+      - name: Install and link bump2version
+        run: |
+          # Install to the specific local directory the action expects
+          python -m pip install --user bump2version
+          
+          # Ensure the directory exists and add to PATH
+          mkdir -p /home/runner/.local/bin
+          echo "/home/runner/.local/bin" >> $GITHUB_PATH
+          
+          # Verify installation path
+          which bumpversion || echo "Warning: bumpversion not found in PATH"
+          which bump2version || echo "Warning: bump2version not found in PATH"
+
+      - name: Bump Version and Push
+        run: |
+          # 1. Configure Git identity
+          git config --global user.name "Automated Version Bump Bot"
+          git config --global user.email "actions@github.com"
+          
+          # 2. Extract current version from file to avoid the "parse" error
+          # This finds the first x.y.z string in your file
+          CURRENT_VERSION=$(grep -oE "[0-9]+\.[0-9]+\.[0-9]+" src/testkit/__init__.py | head -1)
+          
+          # 3. Execute bump2version directly
+          # This updates [src/testkit/__init__.py]
+          # and creates a git commit automatically
+          bump2version patch \
+            --current-version "$CURRENT_VERSION" \
+            --commit \
+            --message "Bump version: {current_version} -> {new_version} [skip ci]" \
+            src/testkit/__init__.py
+
+          # 4. Push the changes
+          git push origin main
+
+  publish-to-pypi:
+    name: >-
+      Publish Python 🐍 distribution 📦 to PyPI
+    if: startsWith(github.ref, 'refs/heads/main') && !contains(github.event.head_commit.message, 'Bump version')
+    needs: bump-version
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/fyre-toolkit/
+    permissions:
+      id-token: write
+
+    steps:
+    - name: Download all the dists
+      uses: actions/download-artifact@v6
+      with:
+        name: python-package-distributions
+        path: dist/
+    - name: Publish distribution 📦 to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1

fyre_toolkit-0.1.13/.gitignore

@@ -0,0 +1,156 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+pkg_deps/
+requirements.txt
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*-results.xml
+pytest_result.xml
+*_report.html
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# UV
+uv.lock
+.ruff_cache/
+
+# PyCharm
+.idea/
+
+# SonarQube
+.scannerwork/
+
+# Others
+workspace-*/

fyre_toolkit-0.1.13/.vscode/settings.json

@@ -0,0 +1,7 @@
+{
+    "python.testing.pytestArgs": [
+        "tests"
+    ],
+    "python.testing.unittestEnabled": false,
+    "python.testing.pytestEnabled": true
+}

fyre_toolkit-0.1.13/AGENTS.md

@@ -0,0 +1,129 @@
+# AGENTS.md — Fyre Toolkit
+
+> Guidelines for agentic coding agents operating in this repository.
+
+## Project Overview
+
+Python 3.12+ package (`fyre-toolkit`) that generates pytest test cases from YAML definitions using Pydantic schema validation. Built with `uv` + `hatchling`.
+
+## Build / Lint / Test Commands
+
+### Dependency Management
+```bash
+uv sync                    # Install all deps (including dev)
+uv lock --no-cache         # Re-lock dependencies
+```
+
+### Linting
+```bash
+uv run ruff check           # Lint src/ (excludes tests/)
+uv run ruff check --fix     # Auto-fix linting issues
+```
+
+### Type Checking
+```bash
+uv run mypy src/            # Strict type checking
+```
+
+### Testing
+```bash
+uv run pytest               # Run all tests (with coverage)
+uv run pytest -k "keyword"  # Run tests matching keyword
+uv run pytest tests/test_testkit_parser.py                    # Single file
+uv run pytest tests/test_testkit_parser.py::TestLoadYamlFile  # Single class
+uv run pytest tests/test_testkit_parser.py::TestLoadYamlFile::test_load_valid_file  # Single test
+uv run pytest -v            # Verbose output
+uv run pytest --no-cov      # Run without coverage (faster)
+```
+
+### Coverage
+```bash
+uv run pytest --cov=src --cov-report=term    # Terminal report
+uv run pytest --cov=src --cov-report=html    # HTML report in htmlcov/
+```
+
+### Building
+```bash
+uv build --wheel             # Build wheel distribution
+uv run twine upload ...      # Publish to PyPI
+```
+
+### CI Pipeline (Jenkinsfile)
+- **PR branches**: `pytest --cov=src` + `diff-cover --fail-under=80`
+- **Main branch**: `pytest --cov=src --cov-fail-under=80` + SonarQube scan
+
+## Code Style
+
+### Imports
+- Standard library → third-party → local, separated by blank lines (isort ordering via ruff `I`)
+- Use `from pathlib import Path` instead of `os.path`
+- Use `collections.abc` for type hints (`Callable`, `Iterator`)
+
+### Formatting
+- 4-space indentation, UTF-8 encoding
+- Max line length: 80 characters (ruff ignores E501 but .editorconfig enforces 80)
+- LF line endings, trailing newline required
+- Use `uv run ruff check --fix` before committing
+
+### Type Hints
+- **mypy strict mode** is enforced — no `Any`, no suppressed errors
+- All function parameters and return types must be annotated
+- Use `collections.abc` types: `Callable[[str, str], str]`, `Iterator[str]`
+- Pydantic v2 models for data structures (`model_dump()`, not `.dict()`)
+
+### Naming Conventions
+- Modules: `snake_case` (e.g., `generator.py`, `testkit_utils.py`)
+- Classes: `PascalCase` (e.g., `TestCase`, `TestSuite`, `TestLoadYamlFile`)
+- Functions/variables: `snake_case` (e.g., `sanitize_identifier`, `test_suite`)
+- Constants: `UPPER_SNAKE_CASE` (e.g., `PYTEST_MODULE_HEADER`)
+- Private helpers: leading underscore (e.g., `_load_yaml_file`, `_check_package`)
+- Test classes: `Test` + CamelCase (e.g., `TestLoadYamlFile`)
+- Test methods: `test_` + snake_case (e.g., `test_load_valid_file`)
+
+### Docstrings
+- Google-style with triple-quoted strings
+- Include: brief description, Args, Returns, Raises, Example sections
+- Doctest examples encouraged for pure functions
+
+### Error Handling
+- Raise specific exceptions: `TypeError`, `ValueError`, `FileNotFoundError`, `RuntimeError`
+- Use descriptive error messages with context (e.g., f-strings with file paths)
+- Chain exceptions with `from e` when re-raising (except where ruff allows `B904`)
+- Use `pytest.raises` for testing expected exceptions
+- Log exceptions with `logging.exception()` before re-raising in library code
+
+### Testing Patterns
+- Use pytest fixtures in `conftest.py` for shared test data
+- Class-based tests for grouping related test methods
+- Use `unittest.mock.patch` for mocking external dependencies
+- Use `tmp_path` fixture for temporary file testing
+- Integration tests alongside unit tests (see `test_integration_*`)
+- Test resources (YAML files) go in `tests/resources/`
+
+### Pydantic Models
+- Use Pydantic v2 (`model_dump()`, not `.dict()`)
+- Models defined in `testkit/schema.py` — do not duplicate
+- Validation errors surface as `pydantic.ValidationError`
+
+## Project Structure
+```
+src/testkit/          # Main package
+  __init__.py         # Public API exports, __version__
+  schema.py           # Pydantic models (TestCase, TestSuite, etc.)
+  parser.py           # YAML loading and validation
+  generator.py        # Pytest code generation
+  aggregator.py       # Component aggregation
+  utils.py            # Utility functions
+tests/                # Test suite
+  conftest.py         # Shared pytest fixtures
+  resources/          # Test data (YAML files)
+  test_testkit_*.py   # Test modules (one per source module)
+examples/             # Usage examples
+```
+
+## Key Constraints
+- **Never suppress type errors** (`as any`, `# type: ignore`, `@ts-ignore`)
+- **Never commit** unless explicitly requested
+- **Match existing patterns** — this codebase is disciplined; follow its style
+- **Fix minimally** — do not refactor while fixing bugs
+- **Run `ruff check`** on changed files before declaring work complete

fyre_toolkit-0.1.13/Jenkinsfile

@@ -0,0 +1,124 @@
+pipeline {
+    agent { label 'python' }
+    environment {
+        PATH="${env.HOME}/.local/bin:${env.PATH}"
+        SONAR_HOST_URL="http://192.168.119.2:9000"
+        SONAR_PROJECT_KEY="fyre_toolkit"
+        SONAR_TOKEN=credentials('sonar')
+        UV_PUBLISH_URL="http://192.168.119.2:8082/repository/pypi-internal/"
+        UV_PUBLISH_USERNAME="devs"
+        UV_PUBLISH_PASSWORD=credentials("uv")
+    }
+    options {
+        skipStagesAfterUnstable()
+    }
+    stages {
+        stage ('Setup') {
+            steps {
+                script {
+                    sh '''
+                    printenv
+                    uv lock --no-cache
+                    uv sync --no-cache --no-editable
+                    '''
+                }
+            }
+        }
+        stage ('Lint') {
+            steps {
+                sh 'uv run ruff check'
+            }
+        }
+        stage ('Build') {
+            steps {
+                sh 'uv build --wheel'
+
+            }
+        }
+        stage ('Feature Branch Test') {
+            when { branch 'PR-*' }
+            steps {
+                sh '''
+                uv run pytest \
+                --cov=src \
+                --junitxml=pytest_result.xml
+                '''
+                sh '''
+                uv run diff-cover \
+                --format html:diff_report.html ./coverage.xml \
+                --compare-branch origin/main \
+                --ignore-unstaged \
+                --ignore-staged \
+                --fail-under=80
+                '''
+            }
+        }
+        stage ('Main Branch Test') {
+            when { branch 'main' }
+            steps {
+                sh '''
+                uv run pytest \
+                --cov=src \
+                --cov-fail-under=80 \
+                --junitxml=pytest_result.xml
+                '''
+                sh '''
+                uv run diff-cover \
+                --format html:diff_report.html ./coverage.xml \
+                --compare-branch HEAD^ \
+                --ignore-unstaged \
+                --ignore-staged \
+                --fail-under=50
+                '''
+            }
+        }
+        stage ('Quality Gate') {
+            when { anyOf { branch 'main'; branch 'release-*' } }
+            steps {
+                withEnv(["SONAR_TOKEN=${SONAR_TOKEN}"]) {
+                    sh '''
+                    $SONAR_SCANNER_HOME/bin/sonar-scanner \
+                    -Dsonar.projectKey=${SONAR_PROJECT_KEY} \
+                    -Dsonar.sources=src \
+                    -Dsonar.exclusions=tests/** \
+                    -Dsonar.python.coverage.reportPaths=./coverage.xml \
+                    -Dsonar.host.url=${SONAR_HOST_URL} \
+                    -Dsonar.login=${SONAR_TOKEN}
+                    '''
+
+                    // timeout(time: 1, unit: 'HOURS') {
+                    //     waitForQualityGate abortPipeline: true
+                    // }
+                }
+            }
+        }
+        stage ('Install') {
+            when { anyOf { branch 'main'; branch 'release-*' } }
+            steps {
+                sh 'uv pip install --upgrade dist/fyre_toolkit-0.1.0-py3-none-any.whl'
+                sh 'uv run python -c "from testkit import __version__; print(__version__)"'
+                sh 'uv pip uninstall fyre-toolkit'
+            }
+        }
+        stage ('Publish') {
+            when { anyOf { branch 'main'; branch 'release-*' } }
+            steps {
+                echo 'Start Publish...'
+                // sh 'uv publish --username ${UV_PUBLISH_USERNAME} --password ${UV_PUBLISH_PASSWORD} --publish-url ${UV_PUBLISH_URL}'
+            }
+        }
+    }
+    post {
+        always {
+            archiveArtifacts artifacts: '**/coverage.xml, **/diff_report.html, dist/fyre_toolkit-0.1.0-py3-none-any.whl', allowEmptyArchive: true
+            echo "Pipeline completed."
+        }
+        success {
+            echo "Pipeline succeeded."
+        }
+        failure {
+            echo "Pipeline failed. Check logs or SonarQube for details."
+        }
+    }
+}
+