rustytree-xarray 0.1.0__tar.gz

rustytree_xarray-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,67 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+# Cancel in-progress runs for the same branch when new commits land.
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+env:
+  CARGO_TERM_COLOR: always
+  RUSTFLAGS: -D warnings
+
+jobs:
+  # Cargo gates run once on stable Rust. Cheap; no Python needed.
+  cargo:
+    name: cargo (fmt, clippy, test)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          components: clippy, rustfmt
+      - uses: Swatinem/rust-cache@v2
+      - run: cargo fmt --check
+      - run: cargo clippy --all-targets --all-features --locked -- -D warnings
+      - run: cargo test --locked
+
+  # Python integration: build the cdylib via maturin and run pytest against
+  # the supported interpreter range. Each matrix cell rebuilds the extension
+  # because PyO3 cdylibs are interpreter-specific.
+  python:
+    name: pytest (Python ${{ matrix.python-version }})
+    needs: cargo
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+      - uses: Swatinem/rust-cache@v2
+        with:
+          # Keyed by Python version so each matrix cell gets its own cache.
+          key: py-${{ matrix.python-version }}
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - uses: astral-sh/setup-uv@v4
+      - name: Set up venv and install maturin
+        run: |
+          uv venv --python "${{ matrix.python-version }}"
+          uv pip install --python .venv/bin/python maturin
+      - name: Install dev extras
+        # Install the [dev] extras directly rather than `pip install -e ".[dev]"`,
+        # which would re-trigger a full cdylib rebuild on top of maturin develop
+        # below (we'd build the wheel twice — saves ~80s per matrix cell).
+        # Keep this list in sync with the `dev` extra in pyproject.toml.
+        run: uv pip install --python .venv/bin/python pytest pytest-cov 'zarr>=3.0' 'icechunk>=2.0' ruff
+      - name: Build extension (maturin develop)
+        run: .venv/bin/maturin develop
+      - name: pytest
+        run: .venv/bin/pytest tests/ -v

rustytree_xarray-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,137 @@
+name: Release
+
+# Tag-driven: pushing a `vX.Y.Z` tag builds wheels + sdist and attaches
+# them to a GitHub Release with auto-generated notes. PyPI publishing
+# is gated behind a manual flip below — switch on once trusted
+# publishing is configured for the project on PyPI.
+#
+# `workflow_dispatch` lets us dry-run the matrix without cutting a
+# real release (e.g. on a release-prep branch) — the artifacts are
+# uploaded but the `release` job is skipped because the ref isn't a
+# tag.
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+permissions:
+  contents: write   # gh release create
+  id-token: write   # PyPI trusted publishing (when enabled)
+
+env:
+  CARGO_TERM_COLOR: always
+  RUSTFLAGS: -D warnings
+
+jobs:
+  build-wheels:
+    name: wheel ${{ matrix.platform.target }} py${{ matrix.python-version }}
+    strategy:
+      fail-fast: false
+      matrix:
+        platform:
+          # manylinux x86_64 — auto picks the most compatible PEP 600
+          # tag the toolchain supports (manylinux_2_28 today).
+          - { os: ubuntu-latest, target: x86_64-unknown-linux-gnu, manylinux: auto }
+          # manylinux aarch64 — Graviton, ARM cloud, Raspberry Pi.
+          # Native arm runner (`ubuntu-24.04-arm`, free for public
+          # repos): no QEMU emulation, no cross-compile toolchain
+          # quirks. Tried QEMU cross-compile first; `ring`'s ARM
+          # assembly bails because the manylinux cross-gcc doesn't
+          # define `__ARM_ARCH`. Native build sidesteps that and is
+          # ~3× faster too.
+          - { os: ubuntu-24.04-arm, target: aarch64-unknown-linux-gnu, manylinux: auto }
+          # Apple Silicon. The macos-14 runner is arm64-native, so the
+          # default target works without cross-compile.
+          - { os: macos-14, target: aarch64-apple-darwin, manylinux: auto }
+        python-version: ["3.12", "3.13"]
+    runs-on: ${{ matrix.platform.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - uses: dtolnay/rust-toolchain@stable
+      # PyO3/maturin-action handles `--release`, manylinux container
+      # provisioning, and Python interpreter detection. We pass `-i
+      # python${PY}` so the wheel is built for exactly the matrix's
+      # interpreter rather than whatever happens to be on PATH.
+      - uses: PyO3/maturin-action@v1
+        with:
+          target: ${{ matrix.platform.target }}
+          manylinux: ${{ matrix.platform.manylinux }}
+          args: --release --strip --out dist -i python${{ matrix.python-version }}
+      - uses: actions/upload-artifact@v4
+        with:
+          name: wheel-${{ matrix.platform.target }}-py${{ matrix.python-version }}
+          path: dist/*.whl
+          if-no-files-found: error
+
+  build-sdist:
+    name: sdist
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: PyO3/maturin-action@v1
+        with:
+          command: sdist
+          args: --out dist
+      - uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+          if-no-files-found: error
+
+  # Tag-only: assemble all wheels + sdist into a GitHub Release. Skipped
+  # on workflow_dispatch (no tag) so a dry-run from a branch builds the
+  # matrix without cutting a release.
+  release:
+    name: GitHub release
+    needs: [build-wheels, build-sdist]
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    # Two rapid tag pushes shouldn't race: serialize per-tag, but
+    # don't cancel an in-flight release run (it's already uploaded
+    # most of its artifacts).
+    concurrency:
+      group: release-${{ github.ref }}
+      cancel-in-progress: false
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+      - name: Create GitHub Release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          gh release create "${GITHUB_REF#refs/tags/}" \
+            --generate-notes \
+            --verify-tag \
+            dist/*
+
+  # PyPI publish via OIDC trusted publishing. Requires:
+  #   - PyPI Pending/Trusted Publisher configured for the project name
+  #     `rustytree-xarray` (atmoscale org), pointing at this workflow
+  #     file and the `pypi` environment.
+  #   - GitHub repo Settings → Environments → `pypi` (with
+  #     deployment-tag rule `v*.*.*` for safety).
+  # Both done; flipping the job on means every `vX.Y.Z` tag
+  # publishes both a GitHub Release and a PyPI release.
+  pypi-publish:
+    name: PyPI publish
+    needs: [build-wheels, build-sdist]
+    if: startsWith(github.ref, 'refs/tags/v')
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write   # mint short-lived OIDC tokens for trusted publishing
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          path: dist
+          merge-multiple: true
+      - uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist

rustytree_xarray-0.1.0/.gitignore

@@ -0,0 +1,49 @@
+# Rust
+target/
+**/*.rs.bk
+
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg
+*.egg-info/
+.pytest_cache/
+.coverage
+.coverage.*
+htmlcov/
+.tox/
+.nox/
+build/
+dist/
+
+# Maturin / extension artifacts inside the source tree
+python/rustytree/*.so
+python/rustytree/*.dylib
+python/rustytree/*.pyd
+
+# Virtual envs
+.venv/
+venv/
+env/
+.python-version
+
+# Editors
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Local env
+.env
+.envrc
+
+# Local planning notes (per-developer; not part of repo)
+plans/
+
+# Jupyter
+.ipynb_checkpoints/