fix(chunk-grids): one invariant for zero-length axes across model, clamps, and metadata - #4334

Draft

d-v-b wants to merge 46 commits into

zarr-developers:mainfrom

d-v-b:fix/zero-length-single-invariant

Commits on Sep 12, 2026

Merge branch 'main' into fix/zero-length-single-invariant
d-v-b
authored
7a2a71a

Commits on Sep 13, 2026

docs: qualify zero-chunk compatibility history
d-v-b
committed
2297c62

Commits on Sep 16, 2026

Merge branch 'main' into fix/zero-length-single-invariant
d-v-b
authored
2873178
Merge branch 'main' into fix/zero-length-single-invariant
d-v-b
authored
d868213

Commits on Sep 25, 2026

Merge branch 'main' into fix/zero-length-single-invariant
d-v-b
authored
64b3550
fix(metadata): read a stored zero chunk size on a grown axis as one spanning chunk

d-v-b
and
claude
committed
8414ea3
test: a stateful test of one array's create/append/resize/write life

d-v-b
and
claude
committed
2bf32df
fix(metadata): stop the zero chunk size warning from naming writers

d-v-b
and
claude
committed
1723f0b
chore(metadata): drop an orphaned comment in ArrayV2Metadata.__init__

d-v-b
and
claude
committed
3d223f1
fix(chunk-grids): size a full-span shard as a multiple of the inner chunk

d-v-b
and
claude
committed
339c514
refactor(metadata): read invalid stored chunk sizes in one module of document upgrades

d-v-b
and
claude
committed
e49eb7e
docs: rewrite the 4334 changelog fragment and trim restating docstrings

d-v-b
and
claude
committed
f6f5c7b
test: model exactly what the store holds in the array lifecycle state machine

d-v-b
and
claude
committed
f873358
refactor(metadata): warn about an upgraded document only once it validates

d-v-b
and
claude
committed
d9549b8

Commits on Sep 26, 2026

refactor(metadata): one per-axis rule for stored chunk sizes, one rule for edges

d-v-b
and
claude
committed
5ef0f51
refactor(chunk-grids): start chunk guessing from the one full-span rule

d-v-b
and
claude
committed
192f86c
test: run the array lifecycle state machine in the slow Hypothesis job

d-v-b
and
claude
committed
2e878cf
fix(array): store upgraded metadata before writing the first chunk

d-v-b
and
claude
committed
c0d4b3c
refactor(metadata): name an array one way in upgrade warnings

d-v-b
and
claude
committed
121b6b2
refactor(metadata): one rule for bare sizes and edge lists; one noun in messages

d-v-b
and
claude
committed
c1353bf
fix(array): store the upgrade of the current stored document before writing

d-v-b
and
claude
committed
f081f1b
test: prefer zero-length axes for stored chunk size 0 in the lifecycle machine

d-v-b
and
claude
committed
9e29333
fix(metadata): keep accepting the chunk sizes zarr 3.4.0 accepted in metadata constructors (patch release)

d-v-b
and
claude
committed
632ac2b
fix(array): leave a valid stored document as written on a stale handle's first write

d-v-b
and
claude
committed
245acae
docs: describe the 4334 changes to metadata constructors for a patch release

d-v-b
and
claude
committed
2d0121d
fix(metadata): read float edges only in stored rectilinear documents

d-v-b
and
claude
committed
4c4fe21
test(codecs): pickle a ShardingCodec with an inner chunk size of 0

d-v-b
and
claude
committed
6fde402
fix(group): build every node before create_hierarchy deletes or stores anything

d-v-b
and
claude
committed
b0ea125
fix(metadata): warn only where the user must act; guard and refresh upgraded copies

d-v-b
and
claude
committed
a903d66
test: expect the lifecycle machine's upgrade warning only on non-empty axes

d-v-b
and
claude
committed
f78e115
fix(metadata): leave a sharded chunk size of 0 unread when the inner shape is invalid

d-v-b
and
claude
committed
bc306aa
perf(metadata): read each upgraded member once, concurrently, and adopt it

d-v-b
and
claude
committed
3bc802f
fix(group): adopt refreshed consolidated members in place

d-v-b
and
claude
committed
dc50ec6
fix(metadata): raise the rectilinear flag error when refreshing a consolidated member

d-v-b
and
claude
committed
cddb877
fix(group): store a group's documents only; keep upgraded members as stored

d-v-b
and
claude
committed
4b9f82c
docs(group): say what consolidated metadata stores for an upgraded array

d-v-b
and
claude
committed
65f3f8e
fix(array): clear the stored document whenever an array stores its metadata

d-v-b
and
claude
committed
faa6efe
test(metadata): pin that a failed metadata save keeps the stored document mark

d-v-b
and
claude
committed
30d7ca6