huitzo-sdk 0.0.0__tar.gz

huitzo_sdk-0.0.0/.github/workflows/publish-sdk.yml

@@ -0,0 +1,329 @@
+# =============================================================================
+# SDK Publishing Workflow
+# =============================================================================
+# Implements:
+#     - docs/architecture/ci-cd.md#workflows
+#     - docs/architecture/ci-cd.md#self-hosted-runners
+#
+# Jobs:
+#     - detect-version: Determine version and targets from branch/tag
+#     - test: Cross-platform unit tests (3.11-3.14 all on self-hosted Linux)
+#     - build: Build distribution packages
+#     - publish-to-testpypi: Publish to TestPyPI for develop branches
+#     - publish-to-pypi: Publish to PyPI for main/tags
+#     - publish-release-notes: Create GitHub release for tags
+#
+# Self-Hosted Runners:
+#     - linux: All Python versions and builds
+# =============================================================================
+
+name: Publish Huitzo SDK 🐍 to PyPI and TestPyPI
+
+on:
+  push:
+    branches:
+      - main
+      - 'develop/**'
+    tags:
+      - 'v*'
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  detect-version:
+    name: Detect Release Version
+    runs-on:
+      group: linux
+      labels: [self-hosted, Linux, X64]
+    outputs:
+      version: ${{ steps.version.outputs.version }}
+      is-release: ${{ steps.version.outputs.is-release }}
+      target: ${{ steps.version.outputs.target }}
+
+    steps:
+    - name: Pre-cleanup
+      run: |
+        docker image prune -f 2>/dev/null || true
+
+    - uses: actions/checkout@v6
+      with:
+        fetch-depth: 0
+
+    - name: Detect version strategy
+      id: version
+      run: |
+        if [[ "${{ github.ref }}" == refs/tags/v* ]]; then
+          # Tag push: use tag as version
+          VERSION="${{ github.ref_name }}"
+          IS_RELEASE="true"
+          TARGET="pypi"
+        elif [[ "${{ github.ref }}" == refs/heads/main ]]; then
+          # Main branch: publish to PyPI with clean version
+          if git describe --tags --abbrev=0 2>/dev/null; then
+            VERSION=$(git describe --tags --abbrev=0 | sed 's/^v//')
+          else
+            VERSION=$(grep '^version = ' pyproject.toml | cut -d'"' -f2)
+          fi
+          IS_RELEASE="false"
+          TARGET="pypi"
+        elif [[ "${{ github.ref }}" == refs/heads/develop/* ]]; then
+          # Develop branch: use dev version with timestamp only (PEP 440 compliant)
+          BASE_VERSION=$(grep '^version = ' pyproject.toml | cut -d'"' -f2)
+          VERSION="${BASE_VERSION}.dev$(date +%s)"
+          IS_RELEASE="false"
+          TARGET="testpypi"
+        else
+          VERSION="0.0.0.dev0"
+          IS_RELEASE="false"
+          TARGET="none"
+        fi
+
+        echo "version=${VERSION}" >> $GITHUB_OUTPUT
+        echo "is-release=${IS_RELEASE}" >> $GITHUB_OUTPUT
+        echo "target=${TARGET}" >> $GITHUB_OUTPUT
+        echo "::notice title=Release Info::Version: ${VERSION} | Release: ${IS_RELEASE} | Target: ${TARGET}"
+
+  test:
+    name: Test Python ${{ matrix.python-version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.11', '3.12', '3.13', '3.14']
+        
+    runs-on:
+      group: linux
+      labels: [self-hosted, Linux, X64]
+
+    # Cache directories scoped by Python version to prevent conflicts
+    env:
+      UV_CACHE_DIR: /opt/runner-cache/uv/${{ matrix.python-version }}
+      PIP_CACHE_DIR: /opt/runner-cache/pip/${{ matrix.python-version }}
+
+    steps:
+    - name: Pre-cleanup
+      run: |
+        docker image prune -f 2>/dev/null || true
+      shell: bash
+
+    - 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 uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: "latest"
+
+    - name: Install dependencies
+      run: uv sync --all-extras
+
+    - name: Lint with ruff
+      run: uv run ruff check .
+
+    - name: Type check with mypy
+      run: uv run mypy --strict src/ --ignore-missing-imports
+
+    - name: Run pytest
+      run: uv run pytest -v --tb=short --cov=huitzo_sdk --cov-report=xml
+
+    - name: Upload coverage
+      uses: codecov/codecov-action@v4
+      with:
+        files: ./coverage.xml
+        flags: unittests
+        name: Python ${{ matrix.python-version }}
+        fail_ci_if_error: false
+      env:
+        CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+    - name: Post-cleanup
+      if: always()
+      run: |
+        docker image prune -f 2>/dev/null || true
+
+  build:
+    name: Build distribution 📦
+    needs:
+      - test
+      - detect-version
+    runs-on:
+      group: linux
+      labels: [self-hosted, Linux, X64]
+
+    env:
+      UV_CACHE_DIR: /opt/runner-cache/uv/3.14
+      PIP_CACHE_DIR: /opt/runner-cache/pip/3.14
+
+    steps:
+    - name: Pre-cleanup
+      run: |
+        docker image prune -f 2>/dev/null || true
+
+    - uses: actions/checkout@v6
+      with:
+        persist-credentials: false
+
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: '3.14'
+
+    - name: Install uv
+      uses: astral-sh/setup-uv@v7
+      with:
+        version: "latest"
+
+    - name: Update version in pyproject.toml
+      run: |
+        # Replace version in pyproject.toml (if not a release tag)
+        if [[ "${{ needs.detect-version.outputs.is-release }}" != "true" ]]; then
+          sed -i 's/^version = ".*/version = "${{ needs.detect-version.outputs.version }}"/' pyproject.toml
+        fi
+
+    - name: Build distribution
+      run: uv build
+
+    - name: Store the distribution packages
+      uses: actions/upload-artifact@v5
+      with:
+        name: python-package-distributions
+        path: dist/
+
+    - name: Post-cleanup
+      if: always()
+      run: |
+        docker image prune -f 2>/dev/null || true
+
+  publish-to-testpypi:
+    name: Publish to TestPyPI 🧪
+    if: needs.detect-version.outputs.target == 'testpypi'
+    needs:
+      - build
+      - detect-version
+    runs-on:
+      group: linux
+      labels: [self-hosted, Linux, X64]
+
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/huitzo-sdk
+
+    permissions:
+      id-token: write  # For trusted publishing
+      contents: write  # For commit comments
+
+    steps:
+    - name: Pre-cleanup
+      run: |
+        docker image prune -f 2>/dev/null || true
+
+    - name: Download all the dists
+      uses: actions/download-artifact@v6
+      with:
+        name: python-package-distributions
+        path: dist/
+
+    - name: Publish distribution to TestPyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        repository-url: https://test.pypi.org/legacy/
+
+    - name: Comment on commit
+      uses: actions/github-script@v7
+      with:
+        script: |
+          github.rest.repos.createCommitComment({
+            owner: context.repo.owner,
+            repo: context.repo.repo,
+            commit_sha: context.sha,
+            body: '✅ Published to TestPyPI v${{ needs.detect-version.outputs.version }}\n\n[View Package](https://test.pypi.org/project/huitzo-sdk/${{ needs.detect-version.outputs.version }})'
+          })
+
+  publish-to-pypi:
+    name: Publish to PyPI 🚀
+    if: needs.detect-version.outputs.target == 'pypi'
+    needs:
+      - build
+      - detect-version
+    runs-on:
+      group: linux
+      labels: [self-hosted, Linux, X64]
+
+    environment:
+      name: pypi
+      url: https://pypi.org/p/huitzo-sdk
+
+    permissions:
+      id-token: write  # For trusted publishing
+      contents: write  # For commit comments
+
+    steps:
+    - name: Pre-cleanup
+      run: |
+        docker image prune -f 2>/dev/null || true
+
+    - 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
+
+  publish-release-notes:
+    name: Create GitHub Release
+    if: needs.detect-version.outputs.target == 'pypi' && needs.detect-version.outputs.is-release == 'true'
+    needs:
+      - publish-to-pypi
+      - detect-version
+    runs-on:
+      group: linux
+      labels: [self-hosted, Linux, X64]
+
+    permissions:
+      contents: write
+
+    steps:
+    - name: Pre-cleanup
+      run: |
+        docker image prune -f 2>/dev/null || true
+
+    - uses: actions/checkout@v6
+      with:
+        fetch-depth: 0
+
+    - name: Generate changelog
+      id: changelog
+      run: |
+        TAG="${{ github.ref_name }}"
+        PREV_TAG=$(git describe --tags --abbrev=0 ${TAG}^ 2>/dev/null || echo "")
+        if [ -z "$PREV_TAG" ]; then
+          CHANGELOG=$(git log --pretty=format:"- %s" | head -20)
+        else
+          CHANGELOG=$(git log ${PREV_TAG}..${TAG} --pretty=format:"- %s")
+        fi
+        echo "CHANGELOG<<EOF" >> $GITHUB_OUTPUT
+        echo "$CHANGELOG" >> $GITHUB_OUTPUT
+        echo "EOF" >> $GITHUB_OUTPUT
+
+    - name: Create Release
+      uses: softprops/action-gh-release@v1
+      with:
+        body: |
+          ## Changes in ${{ needs.detect-version.outputs.version }}
+
+          ${{ steps.changelog.outputs.CHANGELOG }}
+
+          Published to [PyPI](https://pypi.org/project/huitzo-sdk/${{ needs.detect-version.outputs.version }})
+        draft: false
+        prerelease: false
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

huitzo_sdk-0.0.0/.github/workflows/test.yml

@@ -0,0 +1,167 @@
+# =============================================================================
+# SDK CI Workflow
+# =============================================================================
+# Implements:
+#     - docs/architecture/ci-cd.md#workflows
+#     - docs/architecture/ci-cd.md#self-hosted-runners
+#
+# Jobs:
+#     - test: Cross-platform unit tests (3.11-3.14 all on self-hosted Linux)
+#     - lint: Lint and type checking
+#     - build: Build package
+#     - ci-success: Summary job
+#
+# Self-Hosted Runners:
+#     - linux: All Python versions and builds
+# =============================================================================
+
+name: SDK CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: Test Python ${{ matrix.python-version }}
+    runs-on:
+      group: linux
+      labels: [self-hosted, Linux, X64]
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
+    
+    # Cache directories scoped by Python version to prevent conflicts
+    env:
+      UV_CACHE_DIR: /opt/runner-cache/uv/${{ matrix.python-version }}
+      PIP_CACHE_DIR: /opt/runner-cache/pip/${{ matrix.python-version }}
+    
+    steps:
+      - name: Pre-cleanup
+        run: |
+          docker image prune -f 2>/dev/null || true
+      - uses: actions/checkout@v6
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run tests
+        run: uv run pytest tests/ -v --cov=src/huitzo_sdk --cov-report=xml
+
+      - name: Upload coverage
+        if: matrix.python-version == '3.14'
+        uses: actions/upload-artifact@v6
+        with:
+          name: coverage-report
+          path: coverage.xml
+          retention-days: 30
+        env:
+          CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}
+
+      - name: Post-cleanup
+        if: always()
+        run: |
+          docker image prune -f 2>/dev/null || true
+
+  lint:
+    name: Lint & Type Check
+    runs-on:
+      group: linux
+      labels: [self-hosted, Linux, X64]
+    
+    env:
+      UV_CACHE_DIR: /opt/runner-cache/uv/3.14
+      PIP_CACHE_DIR: /opt/runner-cache/pip/3.14
+      
+    steps:
+      - name: Pre-cleanup
+        run: |
+          docker image prune -f 2>/dev/null || true
+      - uses: actions/checkout@v6
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.14"
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Ruff check
+        run: uv run ruff check .
+
+      - name: Ruff format check
+        run: uv run ruff format --check .
+
+      - name: Mypy strict
+        run: uv run mypy src/ --strict --ignore-missing-imports
+
+      - name: Post-cleanup
+        if: always()
+        run: |
+          docker image prune -f 2>/dev/null || true
+
+  build:
+    name: Build Package
+    runs-on:
+      group: linux
+      labels: [self-hosted, Linux, X64]
+    needs: [test, lint]
+    
+    env:
+      UV_CACHE_DIR: /opt/runner-cache/uv/3.14
+      PIP_CACHE_DIR: /opt/runner-cache/pip/3.14
+      
+    steps:
+      - name: Pre-cleanup
+        run: |
+          docker image prune -f 2>/dev/null || true
+      - uses: actions/checkout@v6
+
+      - uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.14"
+
+      - name: Build
+        run: uv build
+
+      - name: Upload dist
+        uses: actions/upload-artifact@v6
+        with:
+          name: dist
+          path: dist/
+          retention-days: 30
+
+      - name: Post-cleanup
+        if: always()
+        run: |
+          docker image prune -f 2>/dev/null || true
+
+  ci-success:
+    name: CI Success
+    runs-on:
+      group: linux
+      labels: [self-hosted, Linux, X64]
+    needs: [test, lint, build]
+    if: always()
+    steps:
+      - name: Check results
+        run: |
+          if [[ "${{ needs.test.result }}" != "success" || "${{ needs.lint.result }}" != "success" || "${{ needs.build.result }}" != "success" ]]; then
+            echo "CI failed"
+            exit 1
+          fi
+          echo "All checks passed"

huitzo_sdk-0.0.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.venv/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+*.lock
+!uv.lock

huitzo_sdk-0.0.0/PKG-INFO

@@ -0,0 +1,12 @@
+Metadata-Version: 2.4
+Name: huitzo-sdk
+Version: 0.0.0
+Summary: Huitzo SDK for building Intelligence Packs
+Requires-Python: >=3.11
+Requires-Dist: pydantic>=2.12
+Provides-Extra: dev
+Requires-Dist: mypy>=1.19; extra == 'dev'
+Requires-Dist: pytest-asyncio>=1.0; extra == 'dev'
+Requires-Dist: pytest-cov>=7.0; extra == 'dev'
+Requires-Dist: pytest>=9.0; extra == 'dev'
+Requires-Dist: ruff>=0.14; extra == 'dev'