Skip to content

DOC: fix v3 migration guide store table - #3850

Merged
d-v-b merged 8 commits into
zarr-developers:mainfrom
nuglifeleoji:doc/fix-store-migration-guide
Oct 9, 2026
Merged

d-v-b merged 8 commits into
zarr-developers:mainfrom
nuglifeleoji:doc/fix-store-migration-guide

Conversation

@nuglifeleoji

@nuglifeleoji nuglifeleoji commented Mar 30, 2026 •

Copy link
Copy Markdown
Contributor

Closes #2699. Closes #2857.

  • Removes a truncated/broken table row (| zarr.)
  • Adds a migration note for LRUStoreCache, which was removed in v3 with no direct equivalent

Leo Ji added 2 commits March 30, 2026 12:52
…note

Removes truncated table row and adds migration note for LRUStoreCache.
Closes zarr-developers#2699. Closes zarr-developers#2857.

Made-with: Cursor
@github-actions github-actions Bot added the needs release notes Automatically applied to PRs which haven't added release notes label Mar 30, 2026
@codecov

codecov Bot commented Jun 25, 2026 •

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 94.71%. Comparing base (6599477) to head (8f09ae7).
⚠️ Report is 1 commits behind head on main.

Additional details and impacted files
@@           Coverage Diff           @@
##             main    #3850   +/-   ##
=======================================
  Coverage   94.71%   94.71%           
=======================================
  Files          94       94           
  Lines       13663    13663           
=======================================
  Hits        12941    12941           
  Misses        722      722           
🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Comment thread docs/user-guide/v3_migration.md Outdated
N5 formatted data.
- `ABSStore` - use the [`zarr.storage.FsspecStore`][] instead along with fsspec's
[adlfs backend](https://github.com/fsspec/adlfs).
- `LRUStoreCache` - no direct equivalent in Zarr-Python 3. Caching behaviour can be

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

maybe this can be updated to refer to the CacheStore that we added to the experimental module.

d-v-b added 2 commits October 9, 2026 19:07
# Conflicts:
#	docs/user-guide/v3_migration.md
Move `LRUStoreCache` into the renamed-stores table, since it was never
deprecated in 2.x, and point it at the experimental
`zarr.experimental.cache_store.CacheStore`. Replace the nonexistent
`fsspec.implementations.caching` module with `fsspec.implementations.cached`,
and add the changelog fragment.

Assisted-by: ClaudeCode:claude-opus-5-5
@github-actions github-actions Bot removed the needs release notes Automatically applied to PRs which haven't added release notes label Oct 9, 2026
@d-v-b

d-v-b commented Oct 9, 2026

Copy link
Copy Markdown
Contributor

🤖 AI text below 🤖

The agent pushed two commits to this branch, on behalf of @d-v-b, to make it mergeable for 3.4.2:

  • e845f6b08 merges main. The only conflict was the truncated | zarr. row, which docs: fix errors and improve consistency across the documentation #4132 had already removed, so main's version was kept.
  • 7783ebf92 reworks the LRUStoreCache note:
    • Moves LRUStoreCache from the "deprecated stores" list into the renamed-stores table, since it was not deprecated in 2.x (see DOC: LRUStoreCache removed in Zarr 3.0, not documented #2857). It now maps to the experimental zarr.experimental.cache_store.CacheStore, as suggested in the inline review comment.
    • Adds a short paragraph that links to the CacheStore section of the experimental guide.
    • Fixes the fsspec reference: fsspec.implementations.caching does not exist, and the caching filesystems live in fsspec.implementations.cached.
    • Adds changes/3850.doc.md.

mkdocs build --strict passes locally.

Other 2.x stores are still missing from the migration guide: NestedDirectoryStore, KVStore/DictStore, ConsolidatedMetadataStore and N5FSStore. They are left for a follow-up.

@d-v-b
d-v-b enabled auto-merge (squash) October 9, 2026 17:58
@d-v-b
d-v-b merged commit bd0dc84 into zarr-developers:main Oct 9, 2026
32 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

DOC: LRUStoreCache removed in Zarr 3.0, not documented AttributeError: module 'zarr.storage' has no attribute 'DirectoryStore'

3 participants