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

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

@@ -11,6 +11,58 @@ release, that section is renamed to `[x.y.z] - YYYY-MM-DD` and a fresh
 
 ## [Unreleased]
 
+## [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 +520,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.0}/Cargo.lock

@@ -3346,7 +3346,7 @@ checksum = "b39cdef0fa800fc44525c84ccb54a029961a8215f9619753635a9c0d2538d46d"
 
 [[package]]
 name = "rustytree"
-version = "0.1.0"
+version = "0.2.0"
 dependencies = [
  "futures",
  "icechunk",

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

@@ -1,6 +1,6 @@
 [package]
 name = "rustytree"
-version = "0.1.0"
+version = "0.2.0"
 edition = "2024"
 rust-version = "1.91.1"
 license = "Apache-2.0"

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rustytree-xarray
-Version: 0.1.0
+Version: 0.2.0
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Science/Research
 Classifier: License :: OSI Approved :: Apache Software 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.0}/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):