zabob-houdini 0.1.3__tar.gz

zabob_houdini-0.1.3/.env.example.linux

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+# Houdini Python environment setup for Linux
+# Copy this to .env and adjust paths if your Houdini installation differs
+
+# Standard Houdini installation paths on Linux
+HOUDINI_PATH="/opt/hfs19.5.640"
+
+# Alternative paths for different versions or locations:
+# HOUDINI_PATH="/opt/hfs20.0.547"
+# HOUDINI_PATH="/usr/local/houdini/hfs19.5.640"
+# HOUDINI_PATH="/home/user/houdini/hfs19.5.640"
+
+# Python path setup for VS Code IntelliSense
+PYTHONPATH="${HOUDINI_PATH}/houdini/python3.11libs:${PYTHONPATH}"
+
+# SideFX credentials (optional) - required for Houdini installer download functionality
+# Create an account at https://www.sidefx.com/login/ to get these credentials
+# SIDEFX_USERNAME=""
+# SIDEFX_PASSWORD=""

zabob_houdini-0.1.3/.env.example.macos

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+# Houdini Python environment setup for macOS
+# Copy this to .env and adjust paths if your Houdini installation differs
+
+# Standard Houdini installation path on macOS
+HOUDINI_PATH="/Applications/Houdini/Current/Frameworks/Houdini.framework/Versions/Current/Resources"
+
+# Alternative paths for different versions:
+# HOUDINI_PATH="/Applications/Houdini/Houdini19.5.640/Frameworks/Houdini.framework/Versions/19.5.640/Resources"
+# HOUDINI_PATH="/Applications/Houdini/Houdini20.0.547/Frameworks/Houdini.framework/Versions/20.0.547/Resources"
+
+# Python path setup for VS Code IntelliSense
+PYTHONPATH="${HOUDINI_PATH}/houdini/python3.11libs:${PYTHONPATH}"
+
+# SideFX credentials (optional) - required for Houdini installer download functionality
+# Create an account at https://www.sidefx.com/login/ to get these credentials
+# SIDEFX_USERNAME=""
+# SIDEFX_PASSWORD=""

zabob_houdini-0.1.3/.env.example.windows

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+# Houdini Python environment setup for Windows
+# Copy this to .env and adjust paths if your Houdini installation differs
+
+# Standard Houdini installation paths on Windows
+HOUDINI_PATH="C:/Program Files/Side Effects Software/Houdini 19.5.640"
+
+# Alternative paths for different versions or locations:
+# HOUDINI_PATH="C:/Program Files/Side Effects Software/Houdini 20.0.547"
+# HOUDINI_PATH="D:/Software/Houdini/19.5.640"
+# HOUDINI_PATH="C:/Apps/Houdini/hfs19.5.640"
+
+# Python path setup for VS Code IntelliSense
+PYTHONPATH="${HOUDINI_PATH}/houdini/python3.11libs;${PYTHONPATH}"
+
+# SideFX credentials (optional) - required for Houdini installer download functionality
+# Create an account at https://www.sidefx.com/login/ to get these credentials
+# SIDEFX_USERNAME=""
+# SIDEFX_PASSWORD=""

zabob_houdini-0.1.3/.flake8

@@ -0,0 +1,3 @@
+[flake8]
+max-line-length = 120
+exclude = ".git,__pycache__,build,dist,stubs"

zabob_houdini-0.1.3/.gitattributes

@@ -0,0 +1,69 @@
+# Houdini scene files
+*.hip filter=lfs diff=lfs merge=lfs -text
+*.hipnc filter=lfs diff=lfs merge=lfs -text
+*.hiplc filter=lfs diff=lfs merge=lfs -text
+*.hda filter=lfs diff=lfs merge=lfs -text
+*.otl filter=lfs diff=lfs merge=lfs -text
+*.hdanc filter=lfs diff=lfs merge=lfs -text
+
+# Houdini geometry files
+*.bgeo filter=lfs diff=lfs merge=lfs -text
+*.bgeo.gz filter=lfs diff=lfs merge=lfs -text
+*.bgeo.bz2 filter=lfs diff=lfs merge=lfs -text
+*.bgeo.sc filter=lfs diff=lfs merge=lfs -text
+*.bgeoc filter=lfs diff=lfs merge=lfs -text
+*.geo filter=lfs diff=lfs merge=lfs -text
+*.obj filter=lfs diff=lfs merge=lfs -text
+*.ply filter=lfs diff=lfs merge=lfs -text
+*.abc filter=lfs diff=lfs merge=lfs -text
+*.fbx filter=lfs diff=lfs merge=lfs -text
+*.dae filter=lfs diff=lfs merge=lfs -text
+
+# Houdini image/texture files
+*.pic filter=lfs diff=lfs merge=lfs -text
+*.rat filter=lfs diff=lfs merge=lfs -text
+*.exr filter=lfs diff=lfs merge=lfs -text
+*.hdr filter=lfs diff=lfs merge=lfs -text
+*.tif filter=lfs diff=lfs merge=lfs -text
+*.tiff filter=lfs diff=lfs merge=lfs -text
+*.tga filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text
+*.jpg filter=lfs diff=lfs merge=lfs -text
+*.jpeg filter=lfs diff=lfs merge=lfs -text
+
+# Houdini simulation cache files
+*.sim filter=lfs diff=lfs merge=lfs -text
+*.simdata filter=lfs diff=lfs merge=lfs -text
+*.sc filter=lfs diff=lfs merge=lfs -text
+
+# Houdini rendering files
+*.ifd filter=lfs diff=lfs merge=lfs -text
+*.ass filter=lfs diff=lfs merge=lfs -text
+*.rib filter=lfs diff=lfs merge=lfs -text
+*.mi filter=lfs diff=lfs merge=lfs -text
+
+# Houdini volume files
+*.vdb filter=lfs diff=lfs merge=lfs -text
+*.vol filter=lfs diff=lfs merge=lfs -text
+
+# Houdini animation/mocap files
+*.bclip filter=lfs diff=lfs merge=lfs -text
+*.clip filter=lfs diff=lfs merge=lfs -text
+*.chan filter=lfs diff=lfs merge=lfs -text
+
+# Video files (often used in Houdini)
+*.mov filter=lfs diff=lfs merge=lfs -text
+*.mp4 filter=lfs diff=lfs merge=lfs -text
+*.avi filter=lfs diff=lfs merge=lfs -text
+*.mkv filter=lfs diff=lfs merge=lfs -text
+
+# Audio files
+*.wav filter=lfs diff=lfs merge=lfs -text
+*.aiff filter=lfs diff=lfs merge=lfs -text
+*.mp3 filter=lfs diff=lfs merge=lfs -text
+
+# Archive files
+*.zip filter=lfs diff=lfs merge=lfs -text
+*.tar.gz filter=lfs diff=lfs merge=lfs -text
+*.tar.bz2 filter=lfs diff=lfs merge=lfs -text
+*.7z filter=lfs diff=lfs merge=lfs -text

zabob_houdini-0.1.3/.github/copilot-instructions.md

@@ -0,0 +1,171 @@
+# Copilot Instructions for Zabob-Houdini
+
+## Project Overview
+Zabob-Houdini is a Python API for creating Houdini node graphs programmatically. This is an early-stage project that provides a simplified interface for building and connecting Houdini nodes.
+
+## Core Architecture Concepts
+
+### Node Graph API Design
+- **`node()`** function: Core API for creating individual nodes
+  - Takes `NodeType`, optional name, and keyword attributes
+  - Returns `NodeInstance` objects
+  - Special `_input` keyword connects 0+ input nodes
+- **`chain()`** function: Creates linear node sequences
+  - Connects nodes in sequence automatically
+  - Accepts `_input` for external connections
+  - Can be nested/spliced into other chains
+  - Returns `Chain` objects
+- **Instantiation Pattern**: Both `NodeInstance` and `Chain` use `.create()` method for actual creation
+
+### Project Structure
+- `src/zabob_houdini/`: Main package directory
+- Currently minimal implementation - most API described in README is not yet implemented
+- Uses modern Python packaging with `pyproject.toml` and hatchling
+
+## Development Conventions
+
+### Response Guidelines
+- **Be concise and focused** in all responses to prevent context overflow
+- When performing code changes:
+  - Make minimal, targeted edits that address the specific request
+  - Avoid explaining what you're doing unless asked
+  - Don't repeat information already established in the conversation
+  - Skip verbose descriptions of obvious changes
+- **Inline chat spatial signals**: When user starts with "here," "this line," "on this line," etc., make surgical changes at that exact location only
+- **Context preservation**: Prioritize actionable content over explanatory text to maintain focus on technical work
+
+### Python Standards
+- **Compatibility**: Requires Python 3.11+ (pyproject.toml), for hython compatibility.
+- Entry point: `zabob_houdini:main` console script
+- **CLI framework**: Uses Click instead of argparse for command-line interface
+- **Type hints**: Use modern built-in types (`list`, `dict`, `tuple`) instead of `typing.List`, etc.
+- **Docstrings**: Write comprehensive docstrings for all public functions and classes, global variables.
+  - Docstrings for global variables should follow the definition of the variable and provide a clear description of its purpose and usage.
+- **Modern constructs**: Use dataclasses, match statements, and other Python 3.13+ features
+- **Parameter typing**: Declare all parameter types explicitly
+
+### Key Files to Understand
+- `README.md`: Contains the complete API specification and usage patterns
+- `src/zabob_houdini/__init__.py`: Current minimal implementation
+- `pyproject.toml`: Project configuration and dependencies
+- `.gitignore`: Python and Houdini-specific ignore patterns
+- `.gitattributes`: LFS configuration for Houdini binary files
+- `.env.example.*`: Platform-specific environment variable templates (users copy to `.env`)
+- `stubs/hou.pyi`: Type stubs for Houdini's `hou` module for development IntelliSense
+- `TODO.md`: Deferred tasks to avoid branching work - add items here instead of implementing immediately
+
+## Implementation Notes
+
+### Current State
+The project is in early development - the README describes the intended API, but implementation is minimal (just a hello world function). When implementing:
+
+1. **Follow the README specification exactly** - it defines the expected behavior
+2. **Implement the `node()` and `chain()` functions** as the core API
+3. **Create `NodeInstance` and `Chain` classes** with `.create()` methods
+4. **Handle the `_input` keyword parameter** for node connections
+5. **Start with string-based NodeType** (SOP node names like "box", "merge")
+6. **Defer `hou` module calls** - only execute during `.create()`, not during node definition
+7. **Plan for NodeTypeInstance expansion** - namespace resolution for duplicate names across categories
+
+### Integration Considerations
+- **Abstraction Layer**: This is a Python wrapper that calls Houdini's `hou` module during `.create()` execution
+- **Houdini Python compatibility**: Watch for potential issues with `hython` and other Houdini Python tools due to historical version constraints
+- **NodeType Implementation**:
+  - Initially: strings representing SOP node type names (e.g., "box", "merge", "transform")
+  - Future: `NodeTypeInstance` objects to resolve namespace conflicts across categories
+  - Long-term: Context-aware validation (e.g., SOPs under `geo` nodes)
+- **Creation Pattern**: Nodes are defined declaratively, then `.create()` calls `hou` module functions
+
+## Testing & Development
+- **Testing**: Uses pytest framework for testing
+- **Package management**: Uses UV - always run `uv sync` after modifying dependencies in pyproject.toml
+- **Code organization**: Consider dataclasses for structured data (e.g., node configurations)
+- **Modern Python**: Leverage Python 3.13+ features like improved type hints and pattern matching
+- No CI/CD setup yet - runs as console application via entry point
+- Development should focus on implementing the API described in README.md first
+
+### Test Architecture
+- **Unit Tests**: Test object construction, equality, hashing, copying WITHOUT importing hou
+  - **NEVER mock modules** - restructure tests to avoid import issues instead
+  - Focus on dataclass behavior, caching via @functools.cache, immutability
+  - Test the API functions (node(), chain()) rather than classes directly if needed
+- **Integration Tests**: Use `hython_test` fixture to run actual Houdini operations
+  - Never mock hou in integration tests - they should run in real Houdini environment
+  - Call functions in `houdini_test_functions.py` via the bridge
+
+### Module Import Strategy
+- core.py imports hou at module level - this is correct for Houdini environment
+- Unit tests should avoid importing core directly if it causes hou import issues
+- Integration tests run in Houdini via hython_test fixture
+
+### Context Overflow Prevention
+- **Be extremely concise** - this project has hit context limits multiple times
+- When architectural changes are needed, focus on ONE specific issue at a time
+- Don't explain what you're doing unless asked - just make the minimal change
+- If you find yourself in an edit loop, stop and ask for clarification
+- The core.py architecture is mature - be very cautious about major changes
+
+### Immutable Architecture (ESTABLISHED - Don't Change)
+- Frozen dataclasses with @functools.cache for automatic caching
+- HashableMapping for dict fields to enable hashing
+- Objects constructed without hou imports, hou only imported in .create() methods
+- Identity-based hashing allows object-specific caching
+- .copy() methods create deep copies, .create() returns cached hou.Node instances
+
+## Task Management
+- **TODO.md**: Use for deferred tasks to avoid branching current work
+- When encountering complex tasks that would derail current focus, add to TODO.md instead of implementing
+- Keep TODO.md organized with categories and clear descriptions
+- Mark completed items and remove them periodically
+
+## VS Code Configuration Management
+- **Personal Settings**: `.vscode/settings.json` is personal (not committed) and created from `.vscode/settings.json.example`
+- **Template Sync**: When `.vscode/settings.json` is modified with project-relevant changes, remind the user to update `.vscode/settings.json.example` for other contributors
+- **Project Files**: `.vscode/project-dictionary.txt`, `.vscode/extensions.json`, and `.vscode/setup-vscode.sh` are committed
+- **Setup Script**: New contributors use `./.vscode/setup-vscode.sh` for automated setup
+- **Spell Checking**: Uses cSpell with project dictionary - add technical terms to `.vscode/project-dictionary.txt`
+
+## Communication Guidelines
+
+### Avoid Sycophantic Language
+- **NEVER** use phrases like "You're absolutely right!", "You're absolutely correct!", "Excellent point!", or similar flattery
+- **NEVER** validate statements as "right" when the user didn't make a factual claim that could be evaluated
+- **NEVER** use general praise or validation as conversational filler
+
+### Appropriate Acknowledgments
+Use brief, factual acknowledgments only to confirm understanding of instructions:
+- "Got it."
+- "Ok, that makes sense."
+- "I understand."
+- "I see the issue."
+
+These should only be used when:
+1. You genuinely understand the instruction and its reasoning
+2. The acknowledgment adds clarity about what you'll do next
+3. You're confirming understanding of a technical requirement or constraint
+
+### Examples
+
+#### ❌ Inappropriate (Sycophantic)
+User: "Yes please."
+Assistant: "You're absolutely right! That's a great decision."
+
+User: "Let's remove this unused code."
+Assistant: "Excellent point! You're absolutely correct that we should clean this up."
+
+#### ✅ Appropriate (Brief Acknowledgment)
+User: "Yes please."
+Assistant: "Got it." [proceeds with the requested action]
+
+User: "Let's remove this unused code."
+Assistant: "I'll remove the unused code path." [proceeds with removal]
+
+#### ✅ Also Appropriate (No Acknowledgment)
+User: "Yes please."
+Assistant: [proceeds directly with the requested action]
+
+### Rationale
+- Maintains professional, technical communication
+- Avoids artificial validation of non-factual statements
+- Focuses on understanding and execution rather than praise
+- Prevents misrepresenting user statements as claims that could be "right" or "wrong"

zabob_houdini-0.1.3/.github/workflows/publish.yml

@@ -0,0 +1,197 @@
+name: Publish to PyPI
+
+on:
+  # Trigger on tags that look like version numbers
+  push:
+    tags:
+      - 'v*.*.*'
+
+  # Allow manual trigger from GitHub UI
+  workflow_dispatch:
+    inputs:
+      pypi_repository:
+        description: 'PyPI repository to publish to'
+        required: true
+        default: 'testpypi'
+        type: choice
+        options:
+          - testpypi
+          - pypi
+
+permissions:
+  contents: read
+  id-token: write  # Required for trusted publishing
+
+jobs:
+  build:
+    name: Build package
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.13'
+
+    - name: Install UV
+      uses: astral-sh/setup-uv@v3
+      with:
+        enable-cache: true
+
+    - name: Install dependencies
+      run: uv sync --all-extras --dev
+
+    - name: Run unit tests (excluding Houdini integration tests)
+      run: uv run pytest -m "unit and not integration" -v
+
+    - name: Run spell check
+      run: |
+        npm install
+        npm run spell-check
+
+    - name: Build package
+      run: uv build
+
+    - name: Verify package contents
+      run: |
+        echo "Built packages:"
+        ls -la dist/
+        echo "Package info:"
+        uv run python -m tarfile -l dist/*.tar.gz
+
+    - name: Upload build artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+        retention-days: 7
+
+  publish-testpypi:
+    name: Publish to TestPyPI
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name == 'workflow_dispatch' && github.event.inputs.pypi_repository == 'testpypi'
+
+    environment:
+      name: testpypi
+      url: https://test.pypi.org/p/zabob-houdini
+
+    steps:
+    - name: Download build artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+
+    - name: Publish to TestPyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        repository-url: https://test.pypi.org/legacy/
+        print-hash: true
+
+  publish-pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    needs: build
+    if: |
+      (github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')) ||
+      (github.event_name == 'workflow_dispatch' && github.event.inputs.pypi_repository == 'pypi')
+
+    environment:
+      name: pypi
+      url: https://pypi.org/p/zabob-houdini
+
+    steps:
+    - name: Download build artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+      with:
+        print-hash: true
+
+  create-release:
+    name: Create GitHub Release
+    runs-on: ubuntu-latest
+    needs: publish-pypi
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/v')
+
+    permissions:
+      contents: write
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Download build artifacts
+      uses: actions/download-artifact@v4
+      with:
+        name: python-package-distributions
+        path: dist/
+
+    - name: Extract version from tag
+      id: version
+      run: echo "version=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+
+    - name: Extract changelog for this version
+      id: changelog
+      run: |
+        if [ -f "CHANGELOG.md" ]; then
+          # Extract changelog section for this version
+          awk "/^## \[?v?${{ steps.version.outputs.version }}\]?/,/^## \[?v?[0-9]/ { if (/^## \[?v?[0-9]/ && !/^## \[?v?${{ steps.version.outputs.version }}\]?/) exit; print }" CHANGELOG.md | head -n -1 > changelog_section.md
+          if [ -s changelog_section.md ]; then
+            echo "changelog_content<<EOF" >> $GITHUB_OUTPUT
+            cat changelog_section.md >> $GITHUB_OUTPUT
+            echo "EOF" >> $GITHUB_OUTPUT
+          else
+            echo "changelog_content=" >> $GITHUB_OUTPUT
+          fi
+        else
+          echo "changelog_content=" >> $GITHUB_OUTPUT
+        fi
+
+    - name: Generate release notes from commits
+      id: commits
+      run: |
+        # Get previous tag
+        PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
+        if [ -n "$PREV_TAG" ]; then
+          echo "commits_content<<EOF" >> $GITHUB_OUTPUT
+          echo "### Changes since $PREV_TAG" >> $GITHUB_OUTPUT
+          echo "" >> $GITHUB_OUTPUT
+          git log --oneline --no-merges $PREV_TAG..HEAD | sed 's/^/- /' >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+        else
+          echo "commits_content=" >> $GITHUB_OUTPUT
+        fi
+
+    - name: Create GitHub Release
+      uses: softprops/action-gh-release@v2
+      with:
+        name: Release v${{ steps.version.outputs.version }}
+        body: |
+          ## Zabob-Houdini v${{ steps.version.outputs.version }}
+
+          This release has been automatically published to PyPI.
+
+          ### Installation
+          ```bash
+          pip install zabob-houdini==${{ steps.version.outputs.version }}
+          ```
+
+          ### Development Installation
+          ```bash
+          uv add zabob-houdini==${{ steps.version.outputs.version }}
+          ```
+
+          ${{ steps.changelog.outputs.changelog_content || steps.commits.outputs.commits_content || '### Changes\n\nSee the [CHANGELOG](CHANGELOG.md) for details about this release.' }}
+        files: dist/*
+        draft: false
+        prerelease: false
+        make_latest: true

zabob_houdini-0.1.3/.github/workflows/test.yml

@@ -0,0 +1,118 @@
+name: Tests
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  unit-tests:
+    name: Unit Tests (No Houdini)
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.11', '3.12', '3.13']
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Install UV
+      uses: astral-sh/setup-uv@v3
+      with:
+        enable-cache: true
+
+    - name: Install dependencies
+      run: uv sync --all-extras --dev
+
+    - name: Run unit tests (excluding Houdini integration tests)
+      run: |
+        uv run pytest -m "unit and not integration" -v \
+          --tb=short \
+          --junit-xml=test-results-${{ matrix.python-version }}.xml
+
+    - name: Upload test results
+      uses: actions/upload-artifact@v4
+      if: always()
+      with:
+        name: test-results-${{ matrix.python-version }}
+        path: test-results-${{ matrix.python-version }}.xml
+        retention-days: 30
+
+  lint-and-type-check:
+    name: Linting and Type Checking
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.13'
+
+    - name: Install UV
+      uses: astral-sh/setup-uv@v3
+      with:
+        enable-cache: true
+
+    - name: Install dependencies
+      run: uv sync --all-extras --dev
+
+    - name: Run spell check
+      run: |
+        npm install
+        npm run spell-check
+
+    - name: Run type checking (if mypy is available)
+      run: |
+        # Test if mypy can run without segfaulting
+        if timeout 10s uv run mypy --version >/dev/null 2>&1; then
+          echo "Running mypy type checking..."
+          uv run mypy src/zabob_houdini --ignore-missing-imports || echo "MyPy found issues but continuing..."
+        else
+          echo "Mypy not available or incompatible with this Python version, skipping type checking"
+        fi
+      continue-on-error: true
+
+  integration-tests:
+    name: Integration Tests (Houdini Required)
+    runs-on: ubuntu-latest
+    # Only run integration tests on main branch or when explicitly requested
+    if: github.ref == 'refs/heads/main' || contains(github.event.pull_request.labels.*.name, 'test-integration')
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: '3.13'
+
+    - name: Install UV
+      uses: astral-sh/setup-uv@v3
+      with:
+        enable-cache: true
+
+    - name: Install dependencies
+      run: uv sync --all-extras --dev
+
+    - name: Skip integration tests (Houdini not available in CI)
+      run: |
+        echo "Integration tests require Houdini installation."
+        echo "These tests are skipped in CI but can be run locally with:"
+        echo "  uv run pytest tests/test_core_caching.py tests/test_houdini_integration.py -v"
+        echo ""
+        echo "To run with Houdini locally:"
+        echo "1. Install Houdini"
+        echo "2. Set up your .env file with HOUDINI_PATH"
+        echo "3. Run: uv run pytest tests/ -v"
+        exit 0