rustytree-xarray 0.1.0__tar.gz → 0.2.1__tar.gz

{rustytree_xarray-0.1.0 → rustytree_xarray-0.2.1}/.github/workflows/ci.yml

@@ -60,7 +60,7 @@ jobs:
         # 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
+        run: uv pip install --python .venv/bin/python pytest pytest-cov 'zarr>=3.0' 'icechunk>=2.0.5' ruff
       - name: Build extension (maturin develop)
         run: .venv/bin/maturin develop
       - name: pytest

{rustytree_xarray-0.1.0 → rustytree_xarray-0.2.1}/CHANGELOG.md

@@ -11,6 +11,68 @@ release, that section is renamed to `[x.y.z] - YYYY-MM-DD` and a fresh
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-05-23
+
+### Fixed
+
+- Compatibility with icechunk 2.0.5: pin Rust-side `icechunk` crate to
+  `=2.0.5` and bump Python-side floor to `>=2.0.5`. Fixes #37.
+  The `Session::from_bytes` msgpack format changed between 2.0.4 and
+  2.0.5; the 0.2.0 wheel (built against 2.0.4) could not deserialise
+  session bytes produced by icechunk-python 2.0.5.
+
+## [0.2.0] - 2026-05-08
+
+### Changed
+
+- `include_ancestor_coords=True` against an icechunk Session/Store now
+  serialises the session snapshot exactly once, instead of once per
+  ancestor. Fixes #34 — addresses the audit finding from #33 that
+  each `self.open_dataset(...)` call in the ancestor-merge loop was
+  re-running `session.as_bytes()`. `_to_rust_source` short-circuits
+  on `bytes` input, and `open_datatree` threads its already-serialised
+  `source` through the loop. Behaviour-only refactor; measured saving
+  is small (~8 µs per depth-2 call against local KLOT, snapshot
+  size 600 B), so this is mostly a code-hygiene fix.
+
+### Added
+
+- `include_ancestor_coords=True` (default) on
+  `xr.open_datatree(..., engine="rustytree", group=...)` for literal
+  group paths. Promotes ancestor group datasets into the new root so
+  `latitude`/`longitude`/`altitude` (and any other ancestor-level
+  coords/vars) are present after a subtree open — matches what users
+  get from a full-tree open + slice with
+  `inherit="all_coords"`. Glob mode (`group="*/sweep_0"`) is unchanged
+  (already correct via `_filter_by_glob`). Set to `False` to keep the
+  pre-flag orphaned-subtree behavior.
+
+- Logo + README header. New `assets/logo.png` (transparent icon) and a
+  light/dark banner pair (`assets/logo-banner-{light,dark}.png` plus
+  SVG sources). README replaces the `# rustytree` heading with a
+  `<picture>` tag that auto-switches between light and dark variants
+  via `prefers-color-scheme`. Palette aligns with the AtmoScale brand
+  (cyan `#00D4FF`, deep navy `#0F1724`) with rust-orange tip accents
+  on the chunked-cube tree icon. All text passes WCAG AAA on its
+  intended background.
+
+- Status badges in the README: CI status, PyPI version, supported
+  Python versions, and license — all clickable to the relevant page.
+
+### Fixed
+
+- Accept `zarr_format` and `consolidated` kwargs in
+  `xr.open_datatree(..., engine="rustytree")` and
+  `xr.open_dataset(..., engine="rustytree")`. Previously the entrypoint
+  raised `TypeError: unexpected keyword argument` because the kwargs
+  weren't declared. They're now declared on both methods and validated:
+  v3-implying values (`zarr_format=3` / `None`, `consolidated=False` /
+  `None`) pass through silently; v2-implying values (`zarr_format=2`
+  or any non-3 int, `consolidated=True`) raise
+  `NotImplementedError` pointing the user at `engine="zarr"`. rustytree
+  currently supports Zarr v3 only; the icechunk snapshot plays the
+  consolidated-metadata role for icechunk repos.
+
 ## [0.1.0] - 2026-05-05
 
 First tagged release. The engine is end-to-end usable against
@@ -468,7 +530,8 @@ below.
   intentionally not normalized — relative-vs-absolute glob
   semantics differ in `PurePosixPath.match`.
 
-[Unreleased]: https://github.com/aladinor/rustytree/compare/v0.1.0...HEAD
+[Unreleased]: https://github.com/aladinor/rustytree/compare/v0.2.0...HEAD
+[0.2.0]: https://github.com/aladinor/rustytree/compare/v0.1.0...v0.2.0
 [0.1.0]: https://github.com/aladinor/rustytree/releases/tag/v0.1.0
 [#1]: https://github.com/aladinor/rustytree/pull/1
 [#3]: https://github.com/aladinor/rustytree/pull/3

{rustytree_xarray-0.1.0 → rustytree_xarray-0.2.1}/Cargo.lock

@@ -1846,9 +1846,9 @@ dependencies = [
 
 [[package]]
 name = "icechunk"
-version = "2.0.4"
+version = "2.0.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6cd081b98a0fc1f38f7c8cd0082f4b87075e94f88619838fe7783ac29f1739bb"
+checksum = "7af416f5b28f3bea35f2d48dd018b7cba711c35a1c965311782222ac337bbccd"
 dependencies = [
  "async-compression",
  "async-recursion",
@@ -1887,9 +1887,9 @@ dependencies = [
 
 [[package]]
 name = "icechunk-arrow-object-store"
-version = "2.0.4"
+version = "2.0.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "6b7e797322c9d6bbd3589533cad88019c2efba36b9d0b9806bed2fdbf92b1549"
+checksum = "8e7610964a5f7859731c95eaec642fcf839e5467137da10d9a2a477c47c1ca2b"
 dependencies = [
  "async-trait",
  "bytes",
@@ -1909,9 +1909,9 @@ dependencies = [
 
 [[package]]
 name = "icechunk-format"
-version = "2.0.4"
+version = "2.0.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "77683814f4550c7c01bf48a56575dbf886e274db08e4b58976dc306549c0b1e1"
+checksum = "258c49d6a1b89fab075fa8b9c31829861ec52f92e5984ab924f4ad834ede13a6"
 dependencies = [
  "base32",
  "bytes",
@@ -1935,9 +1935,9 @@ dependencies = [
 
 [[package]]
 name = "icechunk-s3"
-version = "2.0.4"
+version = "2.0.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "56ba9e07dab11d9ded393b5e225fafb722f3b0469c4353725ea9edd05b801185"
+checksum = "79e08bc924fcc375bf6a2214cc897c09d46b242821999f6c6e3eb87adb0fb0a4"
 dependencies = [
  "async-trait",
  "aws-config",
@@ -1960,9 +1960,9 @@ dependencies = [
 
 [[package]]
 name = "icechunk-storage"
-version = "2.0.4"
+version = "2.0.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "7e9e26e88b9ac7442546a1fa3633065997a9bf7fbdd812c3bfe11517e0d3a754"
+checksum = "d8341b2ce1729d586b9460af93c5c0549d2937df48ad7407101498f56ce99d75"
 dependencies = [
  "async-trait",
  "bytes",
@@ -1981,9 +1981,9 @@ dependencies = [
 
 [[package]]
 name = "icechunk-types"
-version = "2.0.4"
+version = "2.0.5"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "b26efddd99ae14e4106f969567e7cd330501409cf187106199b34b7fdb95c40c"
+checksum = "3ae8062e3d19227364ba07bd13f2b3bfbb33beaf46883b72b26f36d0ae359449"
 dependencies = [
  "serde",
  "serde_with",
@@ -3346,7 +3346,7 @@ checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
 
 [[package]]
 name = "rustytree"
-version = "0.1.0"
+version = "0.2.1"
 dependencies = [
  "futures",
  "icechunk",

{rustytree_xarray-0.1.0 → rustytree_xarray-0.2.1}/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "rustytree"
-version = "0.1.0"
+version = "0.2.1"
 edition = "2024"
 rust-version = "1.91.1"
 license = "Apache-2.0"
@@ -45,7 +45,7 @@ serde_json = "1"
 # icechunk `Session` as `AsyncReadableListableStorageTraits` so the walk
 # code stays polymorphic: the same `open_single` runs against either an
 # icechunk session or a vanilla object_store-backed store.
-icechunk = "2"
+icechunk = "=2.0.5"
 zarrs_icechunk = "0.5"
 
 [lints.clippy]

{rustytree_xarray-0.1.0 → rustytree_xarray-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rustytree-xarray
-Version: 0.1.0
+Version: 0.2.1
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: Apache Software License
@@ -14,7 +14,7 @@ Requires-Dist: xarray>=2024.10
 Requires-Dist: pytest>=7.0 ; extra == 'dev'
 Requires-Dist: pytest-cov>=4.0 ; extra == 'dev'
 Requires-Dist: zarr>=3.0 ; extra == 'dev'
-Requires-Dist: icechunk>=2.0 ; extra == 'dev'
+Requires-Dist: icechunk>=2.0.5 ; extra == 'dev'
 Requires-Dist: ruff>=0.5.0 ; extra == 'dev'
 Provides-Extra: dev
 License-File: LICENSE
@@ -27,9 +27,15 @@ Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
 Project-URL: Homepage, https://github.com/aladinor/rustytree
 Project-URL: Repository, https://github.com/aladinor/rustytree
 
-# rustytree
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="assets/logo-banner-dark.png">
+  <img src="assets/logo-banner-light.png" alt="rustytree — Rust-backed xarray DataTree backend" width="720">
+</picture>
 
-> Rust-backed xarray DataTree backend for fast Zarr (incl. icechunk) access from object storage.
+[![CI](https://github.com/aladinor/rustytree/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/aladinor/rustytree/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/rustytree-xarray.svg)](https://pypi.org/project/rustytree-xarray/)
+[![Python versions](https://img.shields.io/pypi/pyversions/rustytree-xarray.svg)](https://pypi.org/project/rustytree-xarray/)
+[![License](https://img.shields.io/pypi/l/rustytree-xarray.svg)](https://github.com/aladinor/rustytree/blob/main/LICENSE)
 
 `rustytree` registers as `xr.open_datatree(engine="rustytree")` and walks Zarr
 v3 hierarchies — both icechunk-backed and vanilla — concurrently in async
@@ -48,6 +54,17 @@ inference), the recursive multi-node walk, glob `group=` filtering, and
 non-recursive single-Dataset opens are all in. See
 [`CHANGELOG.md`](CHANGELOG.md) for the per-PR breakdown.
 
+## Compatibility
+
+| Surface | Supported | Not supported |
+|---|---|---|
+| **Zarr format** | v3 only | v2 — passing `zarr_format=2` or `consolidated=True` raises `NotImplementedError`; use stock `engine="zarr"` for v2 stores |
+| **icechunk** | `icechunk>=2.0` (the current major) | older icechunk releases |
+| **Python** | 3.12, 3.13 | older versions |
+| **Platforms** | manylinux x86_64, manylinux aarch64, macOS arm64 (wheels); other platforms via sdist | Windows / macOS Intel / linux musl wheels (build from source via sdist) |
+
+## Install
+
 Install from PyPI (the import name stays `rustytree`; the
 distribution name on PyPI is `rustytree-xarray` because `rustytree`
 collides with an unrelated dormant package):

{rustytree_xarray-0.1.0 → rustytree_xarray-0.2.1}/README.md

@@ -1,6 +1,12 @@
-# rustytree
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="assets/logo-banner-dark.png">
+  <img src="assets/logo-banner-light.png" alt="rustytree — Rust-backed xarray DataTree backend" width="720">
+</picture>
 
-> Rust-backed xarray DataTree backend for fast Zarr (incl. icechunk) access from object storage.
+[![CI](https://github.com/aladinor/rustytree/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/aladinor/rustytree/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/rustytree-xarray.svg)](https://pypi.org/project/rustytree-xarray/)
+[![Python versions](https://img.shields.io/pypi/pyversions/rustytree-xarray.svg)](https://pypi.org/project/rustytree-xarray/)
+[![License](https://img.shields.io/pypi/l/rustytree-xarray.svg)](https://github.com/aladinor/rustytree/blob/main/LICENSE)
 
 `rustytree` registers as `xr.open_datatree(engine="rustytree")` and walks Zarr
 v3 hierarchies — both icechunk-backed and vanilla — concurrently in async
@@ -19,6 +25,17 @@ inference), the recursive multi-node walk, glob `group=` filtering, and
 non-recursive single-Dataset opens are all in. See
 [`CHANGELOG.md`](CHANGELOG.md) for the per-PR breakdown.
 
+## Compatibility
+
+| Surface | Supported | Not supported |
+|---|---|---|
+| **Zarr format** | v3 only | v2 — passing `zarr_format=2` or `consolidated=True` raises `NotImplementedError`; use stock `engine="zarr"` for v2 stores |
+| **icechunk** | `icechunk>=2.0` (the current major) | older icechunk releases |
+| **Python** | 3.12, 3.13 | older versions |
+| **Platforms** | manylinux x86_64, manylinux aarch64, macOS arm64 (wheels); other platforms via sdist | Windows / macOS Intel / linux musl wheels (build from source via sdist) |
+
+## Install
+
 Install from PyPI (the import name stays `rustytree`; the
 distribution name on PyPI is `rustytree-xarray` because `rustytree`
 collides with an unrelated dormant package):