fimage-python 0.1.2__tar.gz

fimage_python-0.1.2/.bazelignore

@@ -0,0 +1,14 @@
+# Bazel convenience symlinks. Normally these are filtered by Bazel's
+# root-workspace heuristic, but only when fimage IS the root module. When the
+# monorepo loads fimage via `local_path_override`, the heuristic does not apply
+# and `@fimage//...` would otherwise descend into the execroot mirror. Explicit
+# ignores fix that for both contexts.
+bazel-bin
+bazel-out
+bazel-testlogs
+bazel-fimage
+# Leftover Meson subprojects (the standalone repo is Bazel-only for dev; these
+# directories are not generated, but the entry is harmless if absent).
+# NOTE: .bazelignore entries are literal directory paths -- wildcards are not
+# supported and Bazel 9.1+ errors on them (e.g. "Illegal char <*>").
+subprojects

fimage_python-0.1.2/.bazelrc

@@ -0,0 +1,76 @@
+# =============================================================================
+# Common Settings
+# =============================================================================
+# Re-enable autoloading for BCR deps (e.g. googletest 1.17.0) that still rely
+# on the legacy native cc_library/cc_test globals removed in Bazel 9.
+build --incompatible_autoload_externally=+@rules_cc,+@rules_python,+@rules_shell
+
+common --enable_platform_specific_config
+
+# Do NOT auto-synthesize empty __init__.py files into Python runfiles. The
+# legacy behavior turns every directory (including each wheel's `sphinxcontrib/`)
+# into a regular package, which shadows the PEP 420 `sphinxcontrib` namespace
+# shared across the `sphinxcontrib-*` wheels Sphinx depends on.
+build --incompatible_default_to_explicit_init_py
+
+# =============================================================================
+# C++ Compiler Settings
+# =============================================================================
+build --cxxopt=-std=c++20
+build --host_cxxopt=-std=c++20
+
+# =============================================================================
+# Release Config (opt + strip)
+# =============================================================================
+# Without an explicit compilation_mode, Bazel defaults to `fastbuild` (-O0).
+# Make optimized builds the default here too. Use --config=debug to opt out.
+build:release --compilation_mode=opt
+build:release --copt=-O3
+build:release --copt=-DNDEBUG
+build:release --strip=always
+
+build --config=release
+test  --config=release
+run   --config=release
+
+# =============================================================================
+# Debug Config (Opt-in: --config=debug)
+# =============================================================================
+build:debug --compilation_mode=dbg
+build:debug --copt=-O0
+build:debug --copt=-g3
+build:debug --strip=never
+build:debug --copt=-fno-omit-frame-pointer
+build:debug --verbose_failures
+
+# =============================================================================
+# Developer Experience
+# =============================================================================
+build --color=yes
+build --show_timestamps
+build --announce_rc
+test  --test_output=errors
+
+# =============================================================================
+# Sandbox (macOS needs /var/tmp mounted into the sandbox for some toolchains)
+# =============================================================================
+build:macos --sandbox_add_mount_pair=/var/tmp
+build:linux --sandbox_add_mount_pair=/tmp
+build:windows --sandbox_add_mount_pair=C:\Temp
+
+# =============================================================================
+# Hermetic Cross-Compilation Config (Opt-in: --config=hermetic)
+# =============================================================================
+# Use --config=hermetic to enable hermetic cross-compilation with Zig.
+# This allows building Linux wheels from macOS and vice versa.
+build:hermetic --extra_toolchains=@zig_sdk//toolchain:linux_amd64_gnu.2.28
+build:hermetic --extra_toolchains=@zig_sdk//toolchain:linux_arm64_gnu.2.28
+build:hermetic --extra_toolchains=@zig_sdk//toolchain:darwin_amd64
+build:hermetic --extra_toolchains=@zig_sdk//toolchain:darwin_arm64
+build:hermetic --extra_toolchains=@zig_sdk//toolchain:windows_amd64
+build:hermetic --extra_toolchains=@zig_sdk//toolchain:windows_arm64
+
+# =============================================================================
+# Import Local Settings
+# =============================================================================
+try-import %workspace%/.bazelrc.local

fimage_python-0.1.2/.bazelversion

@@ -0,0 +1 @@
+9.0.0

fimage_python-0.1.2/.github/workflows/release.yml

@@ -0,0 +1,299 @@
+# Build, test, and publish the fimage (fim) Python wheels + sdist to PyPI.
+#
+# Design:
+#   - build-wheels: produce each platform's wheels where they CAN be built:
+#       * linux/darwin: built with Bazel on a matching runner (darwin_x86_64 is
+#         cross-built on the arm64 Mac via the Apple toolchain).
+#       * windows_x86_64 / windows_arm64: built NATIVELY on a matching Windows
+#         runner (windows-2022 / windows-11-arm) with MSVC via Meson + nanobind +
+#         cibuildwheel. All deps compile from source through subprojects/*.wrap
+#         and link statically, sidestepping the missing Windows Bazel rules.
+#   - build-sdist: platform-independent source distribution (pip falls back to a
+#     meson-python source build where no wheel matches).
+#   - smoke-wheels: install the freshly built wheel on the real target and run
+#     tools/smoke_test_python.py (import + tiny pipeline) for every Python.
+#   - publish-pypi / publish-testpypi: upload via Trusted Publishing (OIDC).
+#
+# Unlike fastslide, NO artifacts are attached to a GitHub Release: PyPI is the
+# sole distribution channel for fimage.
+#
+# Trigger: manual only (`workflow_dispatch`). It does NOT run on a version bump.
+name: Release fimage
+on:
+  workflow_dispatch:
+    inputs:
+      release:
+        description: "Publish a full release to PyPI (false = TestPyPI snapshot)"
+        type: boolean
+        default: false
+      platforms:
+        description: "Comma-separated platform keys to build"
+        type: string
+        default: "linux_x86_64,linux_arm64,darwin_x86_64,darwin_aarch64,windows_x86_64,windows_arm64"
+permissions:
+  contents: read
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: true
+# Force UTF-8 for Python stdio so the build scripts' status glyphs do not crash
+# on Windows runners (default code page is cp1252). Run all JavaScript actions
+# on Node.js 24 (Node.js 20 is deprecated on the runners).
+env:
+  PYTHONUTF8: "1"
+  PYTHONIOENCODING: "utf-8"
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: "true"
+jobs:
+  build-wheels:
+    name: Build wheels ${{ matrix.platform }}
+    runs-on: ${{ matrix.builder }}
+    strategy:
+      fail-fast: false
+      matrix:
+        # Linux/macOS wheels are built with Bazel (method: bazel). Windows wheels
+        # (both amd64 and arm64) are built NATIVELY on a matching Windows runner
+        # via Meson + nanobind + cibuildwheel (method: meson). cibw_arch selects
+        # the cibuildwheel target arch.
+        include:
+          - platform: linux_x86_64
+            builder: ubuntu-24.04
+            method: bazel
+          - platform: linux_arm64
+            builder: ubuntu-24.04-arm
+            method: bazel
+          - platform: darwin_x86_64
+            builder: macos-14
+            method: bazel
+          - platform: darwin_aarch64
+            builder: macos-14
+            method: bazel
+          - platform: windows_x86_64
+            builder: windows-2022
+            method: meson
+            cibw_arch: AMD64
+          - platform: windows_arm64
+            builder: windows-11-arm
+            method: meson
+            cibw_arch: ARM64
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+      - name: Decide whether to build this platform
+        id: gate
+        shell: bash
+        run: |
+          selected=",${{ inputs.platforms }},"
+          selected="${selected// /}"
+          if [[ "${selected}" == *",${{ matrix.platform }},"* ]]; then
+            echo "run=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "run=false (not in inputs.platforms)"
+            echo "run=false" >> "$GITHUB_OUTPUT"
+          fi
+      - name: Free disk space (Linux)
+        if: steps.gate.outputs.run == 'true' && runner.os == 'Linux'
+        uses: jlumbroso/free-disk-space@v1.3.1
+        with:
+          android: true
+          dotnet: true
+          haskell: true
+          large-packages: true
+      # --- Bazel path (linux/darwin) ---
+      - name: Pin Bazel version
+        if: steps.gate.outputs.run == 'true' && matrix.method == 'bazel'
+        shell: bash
+        run: echo "USE_BAZEL_VERSION=$(tr -d '[:space:]' < .bazelversion)" >> "$GITHUB_ENV"
+      - name: Set up Bazel
+        if: steps.gate.outputs.run == 'true' && matrix.method == 'bazel'
+        uses: bazel-contrib/setup-bazel@0.19.0
+        with:
+          bazelisk-cache: true
+          repository-cache: true
+          disk-cache: wheels-${{ matrix.platform }}
+      - name: Build wheels (${{ matrix.platform }})
+        if: steps.gate.outputs.run == 'true' && matrix.method == 'bazel'
+        shell: bash
+        run: python3 tools/build_wheels.py --platform ${{ matrix.platform }} --bazel bazel
+      # --- Native Meson path (windows) ---
+      # Windows wheels are compiled on a real Windows host with MSVC. cibuildwheel
+      # drives meson-python once per CPython; meson-python reads the forcefallback
+      # setup args from pyproject.toml, so every dependency is built from source
+      # and linked statically into the self-contained _fim.pyd.
+      - name: Build wheels (${{ matrix.platform }})
+        if: steps.gate.outputs.run == 'true' && matrix.method == 'meson'
+        uses: pypa/cibuildwheel@v3.2.0
+        with:
+          package-dir: .
+          output-dir: artifacts/wheels
+        env:
+          # cp310 has no official Windows ARM64 CPython; cibuildwheel skips it
+          # there automatically, so the same build set is safe for both arches.
+          CIBW_BUILD: "cp310-* cp311-* cp312-* cp313-* cp314-*"
+          CIBW_ARCHS_WINDOWS: ${{ matrix.cibw_arch }}
+          CIBW_BUILD_VERBOSITY: "1"
+          # Force MSVC. The windows runner images ship MinGW GCC on PATH, and
+          # Meson's auto-detection would otherwise pick that `cc` over MSVC.
+          # `--vsenv` makes Meson activate the Visual Studio environment.
+          CIBW_CONFIG_SETTINGS_WINDOWS: "setup-args=--vsenv"
+      - name: Upload wheels
+        if: steps.gate.outputs.run == 'true'
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-${{ matrix.platform }}
+          path: artifacts/wheels/*.whl
+          if-no-files-found: error
+          retention-days: 7
+  build-sdist:
+    # The source distribution is platform-independent and is what
+    # `pip install fimage-python` falls back to on any platform/Python without a
+    # prebuilt wheel: pip builds it from source via meson-python, where
+    # --wrap-mode=forcefallback (from pyproject.toml) fetches every dependency
+    # through subprojects/*.wrap and links it statically.
+    name: Build sdist
+    runs-on: ubuntu-24.04
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+      - name: Set up uv
+        uses: astral-sh/setup-uv@v6
+      - name: Build sdist
+        shell: bash
+        run: uv build --sdist --out-dir artifacts/sdist
+      - name: Upload sdist
+        uses: actions/upload-artifact@v6
+        with:
+          name: sdist
+          path: artifacts/sdist/*.tar.gz
+          if-no-files-found: error
+          retention-days: 7
+  smoke-wheels:
+    name: Smoke wheel ${{ matrix.target.platform }} py${{ matrix.python }}
+    needs: build-wheels
+    runs-on: ${{ matrix.target.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+        target:
+          - platform: linux_x86_64
+            runner: ubuntu-24.04
+          - platform: linux_arm64
+            runner: ubuntu-24.04-arm
+          # x86_64 wheel runs under Rosetta on the arm64 mac with an x86_64
+          # CPython (uv downloads the matching build).
+          - platform: darwin_x86_64
+            runner: macos-14
+            rosetta: true
+          - platform: darwin_aarch64
+            runner: macos-14
+          - platform: windows_x86_64
+            runner: windows-2022
+          - platform: windows_arm64
+            runner: windows-11-arm
+        # No official CPython 3.10 for Windows ARM64, so no cp310 win_arm64 wheel
+        # is built; drop that smoke combination.
+        exclude:
+          - python: "3.10"
+            target:
+              platform: windows_arm64
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+      - name: Decide whether to smoke this platform
+        id: gate
+        shell: bash
+        run: |
+          selected=",${{ inputs.platforms }},"
+          selected="${selected// /}"
+          if [[ "${selected}" == *",${{ matrix.target.platform }},"* ]]; then
+            echo "run=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "run=false" >> "$GITHUB_OUTPUT"
+          fi
+      - name: Install Rosetta
+        if: steps.gate.outputs.run == 'true' && matrix.target.rosetta
+        run: softwareupdate --install-rosetta --agree-to-license
+      - name: Set up uv
+        if: steps.gate.outputs.run == 'true'
+        uses: astral-sh/setup-uv@v6
+      - name: Download wheels
+        if: steps.gate.outputs.run == 'true'
+        uses: actions/download-artifact@v6
+        with:
+          path: dist
+          pattern: "wheels-*"
+          merge-multiple: true
+      # Build a venv on the right interpreter (x86_64 CPython for the Rosetta
+      # leg), install the local wheel under test (uv picks the dist wheel whose
+      # tags match the venv's Python/arch), and run the import + pipeline smoke.
+      # --find-links dist makes the local wheel the source for fimage-python,
+      # while the index supplies its runtime dep (numpy).
+      - name: Import + pipeline smoke (${{ matrix.target.platform }} py${{ matrix.python }})
+        if: steps.gate.outputs.run == 'true'
+        shell: bash
+        run: |
+          set -euo pipefail
+          pyreq="${{ matrix.python }}"
+          if [ "${{ matrix.target.rosetta }}" = "true" ]; then
+            pyreq="cpython-${{ matrix.python }}-macos-x86_64"
+          fi
+          uv python install "$pyreq"
+          uv venv --python "$pyreq" .venv
+          if [ "${{ runner.os }}" = "Windows" ]; then
+            py=".venv/Scripts/python.exe"
+          else
+            py=".venv/bin/python"
+          fi
+          uv pip install --python "$py" --find-links dist fimage-python
+          "$py" tools/smoke_test_python.py
+  publish-pypi:
+    name: Publish wheels + sdist to PyPI
+    # Full release -> real PyPI. Only after the wheels pass their smoke tests.
+    # The sdist is uploaded alongside the wheels so pip can fall back to a source
+    # build on any platform without a prebuilt wheel.
+    if: inputs.release == true
+    needs: [smoke-wheels, build-sdist]
+    runs-on: ubuntu-24.04
+    environment: pypi
+    permissions:
+      id-token: write # OIDC for PyPI Trusted Publishing (no API token)
+    steps:
+      - name: Download wheels + sdist
+        uses: actions/download-artifact@v6
+        with:
+          path: dist
+          pattern: "{wheels-*,sdist}"
+          merge-multiple: true
+      - name: List distributions
+        shell: bash
+        run: ls -l dist
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist
+          skip-existing: true
+  publish-testpypi:
+    name: Publish wheels + sdist to TestPyPI
+    # Snapshot -> TestPyPI, so the publish path is exercised without touching the
+    # real index (re-runs of the same version are no-ops thanks to skip-existing).
+    if: inputs.release == false
+    needs: [smoke-wheels, build-sdist]
+    runs-on: ubuntu-24.04
+    environment: testpypi
+    permissions:
+      id-token: write
+    steps:
+      - name: Download wheels + sdist
+        uses: actions/download-artifact@v6
+        with:
+          path: dist
+          pattern: "{wheels-*,sdist}"
+          merge-multiple: true
+      - name: List distributions
+        shell: bash
+        run: ls -l dist
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist
+          repository-url: https://test.pypi.org/legacy/
+          skip-existing: true

fimage_python-0.1.2/.gitignore

@@ -0,0 +1,19 @@
+builddir/
+node_modules/
+artifacts/
+
+# Meson subprojects: commit only the wrap files and the vendored packagefiles
+# (meson.build overlays + header shims). Everything else under subprojects/ is
+# either downloaded/extracted dependency sources, the package cache, or local
+# dev symlinks, none of which should be tracked.
+subprojects/*
+!subprojects/*.wrap
+!subprojects/packagefiles/
+# Meson auto-generates this [wrap-redirect] into libdicom's nested check.wrap
+# whenever libdicom is extracted. It points at subprojects/libdicom-1.3.0/...,
+# which does not exist on a fresh checkout, so committing it makes `meson setup`
+# abort with "wrap-redirect ... filename does not exist" (validated eagerly,
+# before -Dlibdicom:tests=false can take effect). `check` is only libdicom's
+# test dependency, which we never build, so this redirect is pure build-time
+# noise -- keep it untracked.
+subprojects/check.wrap