auroraview 0.2.19__tar.gz

auroraview-0.2.19/.cargo/config.toml

@@ -0,0 +1,26 @@
+# Cargo configuration for AuroraView
+
+# Profile configurations
+[profile.test]
+# Use debug symbols for better test output
+debug = true
+opt-level = 0
+
+[profile.dev]
+opt-level = 0
+
+[profile.release]
+opt-level = 3
+lto = true
+codegen-units = 1
+strip = true
+
+# Build settings
+[build]
+# Use default number of jobs (don't set to 0 as it causes errors)
+# jobs = 0  # Disabled: causes "jobs may not be 0" error
+
+# Linker settings for different platforms
+# Note: Do not add rustflags here as it will break CI builds
+# PyO3 handles Python linking automatically
+

auroraview-0.2.19/.codecov.yml

@@ -0,0 +1,117 @@
+# Codecov Configuration for AuroraView
+# https://docs.codecov.com/docs/codecov-yaml
+
+# Coverage targets and thresholds
+coverage:
+  precision: 2  # 2 decimal places
+  round: down
+  range: 70..100  # Green at 70%+, red below
+
+  status:
+    # Overall project coverage
+    project:
+      default:
+        target: 70%  # Target coverage for the entire project
+        threshold: 2%  # Allow 2% drop before failing
+        if_ci_failed: error  # Fail if CI failed
+        informational: false  # Block PR if coverage drops
+
+    # Patch coverage (new code in PR)
+    # Note: Some code in native.rs requires GUI environment and cannot be tested in CI
+    patch:
+      default:
+        target: 70%  # Lowered due to untestable GUI code in native backend
+        threshold: 10%  # More lenient for patches with GUI code
+        if_ci_failed: error
+        informational: true  # Don't block PR for patch coverage
+
+    # Changes coverage (lines changed in PR)
+    changes:
+      default:
+        target: 80%
+        threshold: 5%
+        if_ci_failed: error
+        informational: true  # Don't block PR, just inform
+
+# Comment configuration
+comment:
+  layout: "header, diff, flags, components, footer"
+  behavior: default  # Update existing comment
+  require_changes: false  # Always comment
+  require_base: false  # Comment even without base
+  require_head: true  # Require head commit
+
+# Flag configuration for different test types
+flags:
+  # Python coverage
+  python:
+    paths:
+      - python/
+    carryforward: true  # Carry forward if missing
+
+  # Rust coverage
+  rust:
+    paths:
+      - src/
+    carryforward: true
+
+  # Unit tests
+  unit:
+    carryforward: true
+
+  # Qt tests
+  qt:
+    carryforward: true
+
+  # Windows-specific
+  windows:
+    carryforward: true
+
+# Component configuration
+component_management:
+  individual_components:
+    # Python components
+    - component_id: python_core
+      name: Python Core
+      paths:
+        - python/auroraview/*.py
+      flag_regexes:
+        - python
+
+    # Rust components
+    - component_id: rust_core
+      name: Rust Core
+      paths:
+        - src/**/*.rs
+      flag_regexes:
+        - rust
+
+    # Qt integration
+    - component_id: qt_integration
+      name: Qt Integration
+      paths:
+        - python/auroraview/qt_integration.py
+      flag_regexes:
+        - qt
+
+# Ignore paths (for project coverage calculation only, not patch coverage)
+ignore:
+  - "tests/"
+  - "examples/"
+  - "docs/"
+  - "*.md"
+  - "*.toml"
+  - "*.yml"
+  - "*.yaml"
+  - ".github/"
+  - "scripts/"
+  - "python/auroraview/_version.py"  # Auto-generated
+
+# GitHub checks
+github_checks:
+  annotations: true  # Add annotations to PR
+
+# Codecov AI (if enabled)
+codecov_ai:
+  enabled: true
+

auroraview-0.2.19/.githooks/pre-commit

@@ -0,0 +1,57 @@
+#!/usr/bin/env bash
+# AuroraView pre-commit hook
+# Ensures Python & Rust lint pass before committing.
+# Requires: ruff and cargo available on PATH for their respective checks.
+
+set -euo pipefail
+
+# Resolve ruff command (prefer direct, fallback to uvx)
+if command -v ruff >/dev/null 2>&1; then
+  RUFF_CMD="ruff"
+elif command -v uvx >/dev/null 2>&1; then
+  RUFF_CMD="uvx ruff"
+elif command -v uv >/dev/null 2>&1; then
+  RUFF_CMD="uvx ruff"
+else
+  RUFF_CMD=""
+fi
+
+# Detect changed files in index (staged)
+changed_files=$(git diff --cached --name-only --diff-filter=ACM || true)
+
+# ---------- Python (ruff) ----------
+if echo "$changed_files" | grep -E '^(python/|tests/).*\.py$' >/dev/null 2>&1; then
+  py_changed=$(echo "$changed_files" | grep -E '^(python/|tests/).*\.py$' || true)
+
+  if [ -z "$RUFF_CMD" ]; then
+    echo "[pre-commit] ruff not found (and uv/uvx not available); skipping Python checks"
+  else
+    echo "[pre-commit] Running ruff format on staged Python files"
+    $RUFF_CMD format $py_changed
+
+    echo "[pre-commit] Running ruff check --fix on staged Python files"
+    $RUFF_CMD check --fix $py_changed
+
+    echo "[pre-commit] Running ruff check (repo-level)"
+    $RUFF_CMD check python/ tests/
+  fi
+else
+  echo "[pre-commit] Skipping ruff (no Python changes staged)"
+fi
+
+# ---------- Rust (fmt + clippy) ----------
+if echo "$changed_files" | grep -E '(^src/.*\.rs$|^Cargo\.toml$|^build\.rs$)' >/dev/null 2>&1; then
+  if command -v cargo >/dev/null 2>&1; then
+    echo "[pre-commit] Running cargo fmt --all -- --check"
+    cargo fmt --all -- --check
+
+    echo "[pre-commit] Running cargo clippy --all-targets --all-features -- -D warnings"
+    cargo clippy --all-targets --all-features -- -D warnings
+  else
+    echo "[pre-commit] cargo not found; skipping Rust checks"
+  fi
+else
+  echo "[pre-commit] Skipping cargo (no Rust changes staged)"
+fi
+
+echo "[pre-commit] OK"

auroraview-0.2.19/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,66 @@
+name: Bug report
+description: Report a reproducible problem
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the form below.
+  - type: input
+    id: version
+    attributes:
+      label: AuroraView version
+      placeholder: e.g. 0.2.4
+    validations:
+      required: true
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating system
+      options:
+        - Windows
+        - macOS
+        - Linux
+    validations:
+      required: true
+  - type: input
+    id: python
+    attributes:
+      label: Python version
+      placeholder: e.g. 3.11.9
+  - type: textarea
+    id: dcc
+    attributes:
+      label: DCC host and version (if applicable)
+      placeholder: e.g. Maya 2023 / Houdini 20 / Nuke 15 / Blender 4.x ...
+  - type: textarea
+    id: repro
+    attributes:
+      label: Steps to reproduce
+      description: Provide a minimal, complete, and reproducible example
+      placeholder: |
+        1. ...
+        2. ...
+        3. ...
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behavior and logs/traceback
+  - type: checkboxes
+    id: checks
+    attributes:
+      label: Checklist
+      options:
+        - label: I searched existing issues
+          required: true
+        - label: I tested on the latest main build (if possible)
+          required: false
+        - label: I can provide a minimal repro script or project
+          required: false
+

auroraview-0.2.19/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,6 @@
+blank_issues_disabled: true
+contact_links:
+  - name: Documentation
+    url: https://github.com/loonghao/auroraview#readme
+    about: Read the README and docs before filing an issue
+

auroraview-0.2.19/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,39 @@
+name: Feature request
+description: Propose an idea to improve AuroraView
+labels: [enhancement]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for the suggestion! Tell us what problem this would solve and why it matters.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem statement
+      description: What problem are you trying to solve?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposed solution
+      description: Describe the solution you'd like
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional context
+  - type: checkboxes
+    id: scope
+    attributes:
+      label: Scope & impact
+      options:
+        - label: Backward compatible
+        - label: Requires docs update
+        - label: Requires API change
+

auroraview-0.2.19/.github/actions/build-and-test/action.yml

@@ -0,0 +1,166 @@
+name: 'Build and Test AuroraView'
+description: 'Builds AuroraView extension and runs tests'
+
+inputs:
+  test-type:
+    description: 'Type of tests to run (basic, full, rust, python, benchmark)'
+    required: true
+    default: 'basic'
+  generate-stubs:
+    description: 'Whether to generate type stubs'
+    required: false
+    default: 'true'
+  upload-artifacts:
+    description: 'Whether to upload test artifacts'
+    required: false
+    default: 'false'
+  artifact-name:
+    description: 'Name for uploaded artifacts'
+    required: false
+    default: 'test-results'
+
+outputs:
+  build-status:
+    description: 'Build status (success/failure)'
+    value: ${{ steps.build.outcome }}
+  test-status:
+    description: 'Test status (success/failure)'
+    value: ${{ steps.test.outcome }}
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Cache build artifacts
+      uses: actions/cache@v4
+      with:
+        path: |
+          target/release/
+          target/debug/
+          build/
+        key: ${{ runner.os }}-build-${{ hashFiles('Cargo.lock') }}-${{ github.sha }}
+        restore-keys: |
+          ${{ runner.os }}-build-${{ hashFiles('Cargo.lock') }}-
+          ${{ runner.os }}-build-
+
+    - name: Prefetch Cargo crates (retry)
+      shell: bash
+      run: |
+        set -e
+        n=0
+        until [ "$n" -ge 3 ]; do
+          echo "[TRY $((n+1))/3] cargo fetch...";
+          CARGO_HTTP_TIMEOUT=600 CARGO_NET_RETRY=10 cargo fetch --locked --verbose && break;
+          n=$((n+1));
+          echo "[WARN] cargo fetch failed, retrying in 5s..."; sleep 5;
+        done
+
+    - name: Build extension
+      id: build
+      shell: bash
+      run: |
+        uv pip install maturin
+        if [ "$RUNNER_OS" = "Windows" ]; then
+          echo "Building with Windows feature: win-webview2 + ext-module"
+          uv run maturin develop --features "win-webview2,ext-module"
+        else
+          echo "Building with ext-module feature"
+          uv run maturin develop --features "ext-module"
+        fi
+      env:
+        RUST_BACKTRACE: 1
+        CARGO_HTTP_TIMEOUT: '600'
+        CARGO_NET_RETRY: '10'
+        CARGO_REGISTRIES_CRATES_IO_PROTOCOL: sparse
+
+    - name: Install cargo-llvm-cov
+      if: inputs.test-type == 'rust' || inputs.test-type == 'full'
+      shell: bash
+      run: |
+        if ! command -v cargo-llvm-cov &> /dev/null; then
+          echo "Installing cargo-llvm-cov..."
+          cargo install cargo-llvm-cov --locked
+        fi
+
+    - name: Run tests
+      id: test
+      shell: bash
+      run: |
+        case "${{ inputs.test-type }}" in
+          "basic")
+            echo "Running basic import tests..."
+            just ci-test-basic
+            ;;
+          "rust")
+            echo "Running Rust tests with coverage..."
+            echo "  -> Rust integration tests with coverage..."
+            # Exclude ipc_batch_integration_tests which requires Python bindings
+            cargo llvm-cov --features "test-helpers" --lcov --output-path rust-coverage.lcov \
+              --test config_integration_tests \
+              --test file_protocol_integration_tests \
+              --test http_discovery_integration_tests \
+              --test ipc_json_integration_tests \
+              --test ipc_message_queue_integration_tests \
+              --test lifecycle_integration_tests \
+              --test mdns_integration_tests \
+              --test parent_monitor_integration_tests \
+              --test port_allocator_integration_tests \
+              --test protocol_handlers_integration_tests \
+              --test protocol_integration_tests \
+              --test standalone_integration_tests \
+              --test timer_integration_tests \
+              --test window_utils_integration_tests
+            echo "  -> Rust doc tests..."
+            cargo test --doc
+            ;;
+          "python")
+            echo "Running Python unit tests..."
+            just ci-test-python
+            ;;
+          "full")
+            echo "Running comprehensive test suite..."
+            echo "  -> Rust integration tests with coverage..."
+            # Exclude ipc_batch_integration_tests which requires Python bindings
+            cargo llvm-cov --features "test-helpers" --lcov --output-path rust-coverage.lcov \
+              --test config_integration_tests \
+              --test file_protocol_integration_tests \
+              --test http_discovery_integration_tests \
+              --test ipc_json_integration_tests \
+              --test ipc_message_queue_integration_tests \
+              --test lifecycle_integration_tests \
+              --test mdns_integration_tests \
+              --test parent_monitor_integration_tests \
+              --test port_allocator_integration_tests \
+              --test protocol_handlers_integration_tests \
+              --test protocol_integration_tests \
+              --test standalone_integration_tests \
+              --test timer_integration_tests \
+              --test window_utils_integration_tests
+            echo "  -> Rust doc tests..."
+            cargo test --doc
+            echo "  -> Python unit tests..."
+            just ci-test-python
+            echo "  -> Basic functionality tests..."
+            just ci-test-basic
+            echo "[OK] All tests completed"
+            ;;
+          *)
+            echo "[ERROR] Unknown test type: ${{ inputs.test-type }}"
+            echo "Available types: basic, rust, python, full"
+            exit 1
+            ;;
+        esac
+      env:
+        PYTHONUNBUFFERED: 1
+
+    - name: Upload test artifacts
+      if: inputs.upload-artifacts == 'true' && always()
+      uses: actions/upload-artifact@v4
+      with:
+        name: ${{ inputs.artifact-name }}-${{ runner.os }}-${{ github.run_id }}
+        path: |
+          .pytest_cache/
+          htmlcov/
+          coverage.xml
+          rust-coverage.lcov
+        retention-days: 7
+