forge3d 1.13.0__tar.gz

forge3d-1.13.0/.gitattributes

@@ -0,0 +1,3 @@
+*.tif filter=lfs diff=lfs merge=lfs -text
+assets/highres.png filter=lfs diff=lfs merge=lfs -text
+assets/swiss-legend.png filter=lfs diff=lfs merge=lfs -text

forge3d-1.13.0/.github/workflows/ci.yml

@@ -0,0 +1,391 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+  workflow_dispatch:
+
+env:
+  CARGO_TERM_COLOR: always
+  RUST_BACKTRACE: 1
+
+jobs:
+  # ============================================================================
+  # Rust Tests (cargo test)
+  # ============================================================================
+  test-rust:
+    name: Test Rust (${{ matrix.os }})
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, ubuntu-latest, macos-latest]
+        include:
+          - os: windows-latest
+            target: x86_64-pc-windows-msvc
+          - os: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+          - os: macos-latest
+            target: x86_64-apple-darwin
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}
+
+      - name: Cache Rust dependencies
+        uses: actions/cache@v3
+        with:
+          path: |
+            ~/.cargo/bin/
+            ~/.cargo/registry/index/
+            ~/.cargo/registry/cache/
+            ~/.cargo/git/db/
+            target/
+          key: ${{ runner.os }}-cargo-${{ hashFiles('**/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-
+
+      - name: Install system dependencies (Linux)
+        if: matrix.os == 'ubuntu-latest'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libvulkan-dev
+
+      - name: Run cargo check
+        run: cargo check --workspace --features default,async_readback,copc_laz,weighted-oit,enable-pbr,enable-ibl,enable-csm,enable-tbn,enable-normal-mapping,enable-hdr-offscreen,enable-render-bundles,enable-renderer-config,enable-memory-pools,enable-staging-rings
+
+      - name: Run cargo test (skip GPU-dependent tests)
+        run: cargo test --workspace --features default,async_readback,copc_laz,weighted-oit,enable-pbr,enable-ibl,enable-csm,enable-tbn,enable-normal-mapping,enable-hdr-offscreen,enable-render-bundles,enable-renderer-config,enable-memory-pools,enable-staging-rings -- --test-threads=1 --skip gpu_extrusion --skip brdf_tile
+        env:
+          RUST_TEST_THREADS: 1
+
+      - name: Run cargo clippy
+        run: cargo clippy --workspace --features default,async_readback,copc_laz,weighted-oit,enable-pbr,enable-ibl,enable-csm,enable-tbn,enable-normal-mapping,enable-hdr-offscreen,enable-render-bundles,enable-renderer-config,enable-memory-pools,enable-staging-rings -- -D warnings
+
+  # ============================================================================
+  # Interactive Viewer E2E (macOS only; optional)
+  # ============================================================================
+  test-interactive-viewer-macos:
+    name: Interactive Viewer (macOS)
+    needs: build-wheels
+    runs-on: macos-latest
+    timeout-minutes: 15
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Download macOS wheel artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: wheels-macos
+          path: dist/
+
+      - name: Install wheel and pytest
+        run: |
+          python scripts/install_compatible_wheel.py dist
+          pip install pytest numpy
+
+      - name: Run interactive viewer tests
+        env:
+          FORGE3D_NO_BOOTSTRAP: '1'
+          RUN_INTERACTIVE_VIEWER_CI: '1'
+        run: |
+          pytest tests/ -m interactive_viewer -v --tb=short
+        continue-on-error: true
+
+  # ============================================================================
+  # Python Wheel Build (maturin)
+  # ============================================================================
+  build-wheels:
+    name: Build Wheel (${{ matrix.platform.os }})
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - os: windows
+            runner: windows-latest
+            target: x86_64-pc-windows-msvc
+            maturin_args: --release --out dist
+          - os: linux
+            runner: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+            maturin_args: --release --out dist -i python3.10
+          - os: macos
+            runner: macos-latest
+            target: universal2-apple-darwin
+            maturin_args: --release --out dist
+          - os: linux-arm
+            runner: ubuntu-latest
+            target: aarch64-unknown-linux-gnu
+            maturin_args: --release --out dist -i python3.10
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: ${{ matrix.platform.maturin_args }}
+          manylinux: auto
+
+      - name: Upload wheel artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.platform.os }}
+          path: dist/*.whl
+
+  # ============================================================================
+  # Python Tests (pytest)
+  # ============================================================================
+  test-python:
+    name: Test Python (${{ matrix.os }})
+    needs: build-wheels
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, ubuntu-latest, macos-latest]
+        python-version: ['3.10', '3.11', '3.12', '3.13']
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v4
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Download wheel artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: wheels-${{ runner.os == 'Windows' && 'windows' || runner.os == 'Linux' && 'linux' || 'macos' }}
+          path: dist/
+
+      - name: Install wheel and test dependencies
+        run: |
+          python scripts/install_compatible_wheel.py dist
+          pip install pytest numpy pillow
+
+      - name: Run install smoke tests
+        env:
+          FORGE3D_NO_BOOTSTRAP: '1'
+        run: pytest tests/test_install_smoke.py -v --tb=short
+
+      - name: Run license tests
+        env:
+          FORGE3D_NO_BOOTSTRAP: '1'
+        run: pytest tests/test_license.py -v --tb=short
+
+      - name: Run pytest (skip viewer/GPU tests)
+        env:
+          FORGE3D_NO_BOOTSTRAP: '1'
+        run: pytest tests/ -v --tb=short -m "not viewer and not interactive_viewer and not offscreen"
+
+  # ============================================================================
+  # Linux aarch64 Wheel Smoke Test (QEMU)
+  # ============================================================================
+  test-python-linux-arm:
+    name: Install Smoke (linux-arm)
+    needs: build-wheels
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+        with:
+          platforms: arm64
+
+      - name: Download linux-arm wheel artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: wheels-linux-arm
+          path: dist/
+
+      - name: Run smoke test in arm64 container
+        shell: bash
+        run: |
+          docker run --rm --platform linux/arm64/v8 \
+            -v "${PWD}:/workspace" \
+            -w /workspace \
+            python:3.11-slim \
+            bash -lc "python -m pip install -U pip pytest && python /workspace/scripts/install_compatible_wheel.py /workspace/dist && FORGE3D_NO_BOOTSTRAP=1 pytest tests/test_install_smoke.py -v --tb=short"
+
+  # ============================================================================
+  # Golden Image Tests
+  # ============================================================================
+  test-golden-images:
+    name: Golden Images (${{ matrix.os }})
+    needs: build-wheels
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, ubuntu-latest]  # Skip macOS for golden images (no GPU in CI)
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+
+      - name: Download wheel artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: wheels-${{ runner.os == 'Windows' && 'windows' || 'linux' }}
+          path: dist/
+
+      - name: Install wheel
+        run: python scripts/install_compatible_wheel.py dist
+
+      - name: Generate golden images
+        run: python scripts/generate_golden_images.py --output-dir tests/golden
+        continue-on-error: true
+
+      - name: Run golden image tests
+        run: cargo test --test golden_images -- --ignored --test-threads=1
+        continue-on-error: true
+
+      - name: Upload golden image artifacts on failure
+        if: failure()
+        uses: actions/upload-artifact@v4
+        with:
+          name: golden-image-diffs-${{ matrix.os }}
+          path: tests/golden/diff/
+
+  # ============================================================================
+  # Example Sanity Tests (640×360 renders within 90s)
+  # ============================================================================
+  test-examples:
+    name: Example Sanity (${{ matrix.os }})
+    needs: build-wheels
+    runs-on: ${{ matrix.os }}
+    timeout-minutes: 5
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [windows-latest, ubuntu-latest]
+        example:
+          - name: "Triangle"
+            script: "examples/triangle_png.py"
+            args: "--width 640 --height 360"
+          - name: "Terrain Single Tile"
+            script: "examples/terrain_single_tile.py"
+            args: ""
+          - name: "PNG NumPy Roundtrip"
+            script: "examples/png_numpy_roundtrip.py"
+            args: ""
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+
+      - name: Download wheel artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: wheels-${{ runner.os == 'Windows' && 'windows' || 'linux' }}
+          path: dist/
+
+      - name: Install wheel and dependencies
+        run: |
+          python scripts/install_compatible_wheel.py dist
+          pip install numpy pillow
+
+      - name: "Run example: ${{ matrix.example.name }}"
+        run: python ${{ matrix.example.script }} ${{ matrix.example.args }}
+        timeout-minutes: 2
+
+      - name: Verify output exists
+        shell: bash
+        run: |
+          # Check that at least one PNG was created
+          if ls *.png 1> /dev/null 2>&1; then
+            echo "✓ PNG output found"
+          else
+            echo "✗ No PNG output found"
+            exit 1
+          fi
+
+  # ============================================================================
+  # Documentation Build
+  # ============================================================================
+  build-docs:
+    name: Build Documentation
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Build Rust docs
+        run: cargo doc --workspace --features default,async_readback,copc_laz,weighted-oit,enable-pbr,enable-ibl,enable-csm,enable-tbn,enable-normal-mapping,enable-hdr-offscreen,enable-render-bundles,enable-renderer-config,enable-memory-pools,enable-staging-rings --no-deps
+
+      - name: Set up Python
+        uses: actions/setup-python@v4
+        with:
+          python-version: '3.11'
+
+      - name: Install Sphinx dependencies
+        run: |
+          pip install sphinx sphinx-rtd-theme myst-parser numpy pillow ipywidgets pooch
+
+      - name: Build Sphinx docs
+        run: |
+          cd docs
+          make html
+
+      - name: Upload docs artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: documentation
+          path: |
+            target/doc/
+            docs/_build/html/
+
+  # ============================================================================
+  # Final Status
+  # ============================================================================
+  ci-success:
+    name: CI Success
+    needs: [test-rust, build-wheels, test-python, test-python-linux-arm, build-docs]
+    runs-on: ubuntu-latest
+    if: always()
+
+    steps:
+      - name: Check all jobs succeeded
+        run: |
+          if [ "${{ needs.test-rust.result }}" != "success" ] || \
+             [ "${{ needs.build-wheels.result }}" != "success" ] || \
+             [ "${{ needs.test-python.result }}" != "success" ] || \
+             [ "${{ needs.test-python-linux-arm.result }}" != "success" ] || \
+             [ "${{ needs.build-docs.result }}" != "success" ]; then
+            echo "❌ CI failed"
+            exit 1
+          else
+            echo "✅ CI passed"
+          fi

forge3d-1.13.0/.github/workflows/public-funnel-monitor.yml

@@ -0,0 +1,47 @@
+name: Public Funnel Monitor
+
+on:
+  schedule:
+    - cron: "0 * * * *"
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  public-funnel:
+    name: Public Funnel Reachability
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Check homepage, docs, Pro path, PyPI, and dataset URLs
+        run: python scripts/check_public_funnel.py
+
+  source-links:
+    name: Source Link Check
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Check shipped links
+        uses: lycheeverse/lychee-action@v2
+        with:
+          fail: true
+          args: >-
+            --no-progress
+            --verbose
+            README.md
+            pyproject.toml
+            python/forge3d/datasets.py
+            docs/gallery/05-3d-buildings.md
+            docs/gallery/10-map-plate.md
+            docs/tutorials/gis-track/03-build-a-map-plate.md
+            docs/tutorials/gis-track/04-3d-buildings.md

forge3d-1.13.0/.github/workflows/publish.yml

@@ -0,0 +1,232 @@
+name: Publish to PyPI
+
+on:
+  pull_request:
+    branches: [main, develop]
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: Dry run (build artifacts only, do not publish)
+        required: false
+        default: 'true'
+        type: choice
+        options:
+          - 'true'
+          - 'false'
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  build-wheels:
+    name: Build Wheel (${{ matrix.platform.os }})
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - os: windows
+            runner: windows-latest
+            target: x86_64-pc-windows-msvc
+            maturin_args: --release --out dist
+          - os: linux
+            runner: ubuntu-latest
+            target: x86_64-unknown-linux-gnu
+            maturin_args: --release --out dist -i python3.10
+          - os: linux-arm
+            runner: ubuntu-latest
+            target: aarch64-unknown-linux-gnu
+            maturin_args: --release --out dist -i python3.10
+          - os: macos
+            runner: macos-latest
+            target: universal2-apple-darwin
+            maturin_args: --release --out dist
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build wheel
+        uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          args: ${{ matrix.platform.maturin_args }}
+          manylinux: auto
+
+      - name: Upload wheel artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.platform.os }}
+          path: dist/*.whl
+
+  build-sdist:
+    name: Build sdist
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Install maturin
+        run: python -m pip install --upgrade maturin
+
+      - name: Build sdist
+        run: maturin sdist --out dist
+
+      - name: Upload sdist artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  smoke-test:
+    name: Smoke Test (${{ matrix.platform.os }})
+    needs: [build-wheels]
+    runs-on: ${{ matrix.platform.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          - os: windows
+            runner: windows-latest
+            artifact: wheels-windows
+          - os: linux
+            runner: ubuntu-latest
+            artifact: wheels-linux
+          - os: linux-arm
+            runner: ubuntu-latest
+            artifact: wheels-linux-arm
+          - os: macos
+            runner: macos-latest
+            artifact: wheels-macos
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        if: matrix.platform.os != 'linux-arm'
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Download wheel artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: ${{ matrix.platform.artifact }}
+          path: dist/
+
+      - name: Install wheel and run smoke tests
+        if: matrix.platform.os != 'linux-arm'
+        env:
+          FORGE3D_NO_BOOTSTRAP: '1'
+        run: |
+          python -m pip install --upgrade pip pytest
+          python scripts/install_compatible_wheel.py dist
+          pytest tests/test_install_smoke.py -v --tb=short
+
+      - name: Set up QEMU
+        if: matrix.platform.os == 'linux-arm'
+        uses: docker/setup-qemu-action@v3
+        with:
+          platforms: arm64
+
+      - name: Run smoke test in arm64 container
+        if: matrix.platform.os == 'linux-arm'
+        shell: bash
+        run: |
+          docker run --rm --platform linux/arm64/v8 \
+            -v "${PWD}:/workspace" \
+            -w /workspace \
+            python:3.11-slim \
+            bash -lc "python -m pip install -U pip pytest && python /workspace/scripts/install_compatible_wheel.py /workspace/dist && FORGE3D_NO_BOOTSTRAP=1 pytest tests/test_install_smoke.py -v --tb=short"
+
+  release-assets:
+    name: Upload Release Assets
+    if: startsWith(github.ref, 'refs/tags/v')
+    needs: [build-wheels, build-sdist, smoke-test]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Validate tag matches pyproject version
+        run: |
+          python -c "import tomllib; from pathlib import Path; version = tomllib.loads(Path('pyproject.toml').read_text(encoding='utf-8'))['project']['version']; tag = '${{ github.ref_name }}'.lstrip('v'); assert version == tag, f'{version}!={tag}'"
+
+      - name: Download wheel artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist/
+
+      - name: Download sdist artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist/
+
+      - name: Create GitHub release assets
+        uses: softprops/action-gh-release@v2
+        with:
+          files: dist/*
+          generate_release_notes: true
+
+  publish:
+    name: Publish
+    if: github.event_name == 'push' || (github.event_name == 'workflow_dispatch' && github.event.inputs.dry_run == 'false')
+    needs: [build-wheels, build-sdist, smoke-test]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    environment:
+      name: pypi
+      url: https://pypi.org/project/forge3d/
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: '3.11'
+
+      - name: Validate tag matches pyproject version
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          python -c "import tomllib; from pathlib import Path; version = tomllib.loads(Path('pyproject.toml').read_text(encoding='utf-8'))['project']['version']; tag = '${{ github.ref_name }}'.lstrip('v'); assert version == tag, f'{version}!={tag}'"
+
+      - name: Download wheel artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist/
+
+      - name: Download sdist artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: sdist
+          path: dist/
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}