search

zarr-developers / zarr-python

An implementation of chunked, compressed, N-dimensional arrays for Python.
https://zarr.readthedocs.io
MIT License
1.53k stars 286 forks source link

Announcement: Zarr-Python version 3 release schedule #1777

Open jhamman opened 7 months ago

jhamman commented 7 months ago

This issue describes the planned development path toward the 3.0 release of Zarr-Python.

Important information

Release schedule

2.18.0 - May 9, 2024 (Milestone)

3.0.0.alpha0 - June 5, 2024 (Milestone)

(edit: we are making weekly alpha releases right now)

3.0.0 - Early October, 2024 (Milestone)

Note to contributors

Over the next 2-3 months, we expect to transition the majority of development to the v3 branch. By no means are we ceasing support for the 2.* series but the general direction of the library is toward v3. If you are considering a contribution to Zarr-Python beyond the scope of a bug fix, the v3 branch is likely your best bet.

Update 5/31/24: We have fallen off our intended timeline by a few weeks. I've updated the alpha release and full release dates accordingly.

cwognum commented 6 months ago

Hey @jhamman, super excited about the v3 release! 🎉

I hope you don't mind me asking, but I was wondering if you're still operating under the same timeline? Looking at the 3.0 Project Board as an outsider, it appears the team is currently behind schedule. Don't mean to critique, but we are planning to use Zarr for a project and are wondering whether it makes sense to wait for the 3.0 release.

  1. Do you think you'll still release 3.0.0 by June 14th?
  2. If not:
    1. Would you already be able to communicate a new date?
    2. Would you already be able to share more details about the migration process? Could Zarr archives created with v2 still be opened by v3? What about the other way around?

Thank you!

jhamman commented 6 months ago

Hi @cwognum - thanks for the question. We are probably a few weeks behind schedule. Hoping to get the alpha release our in the next few days. I suspect the full release will happen a few weeks behind our initial target but I don't think its worth being more specific than that at this point. I would advise you to start using Zarr-Python 2 now as the migration is going to be quite straightforward, as long as you stick to the core API.

Could Zarr archives created with v2 still be opened by v3? What about the other way around?

Yes, 100%. There are PBs of Zarr v2 data out there today and we're not expecting anyone to migrate their data.

jakirkham commented 6 months ago

FYI we have changed the default branch to v3 from main. So new PRs opened will automatically point to v3

The main branch is still around. Just not the default

AIUI this reflects what the current state of things has been for some time (development should be on v3 and main should be for maintenance of v2). This merely formalizes that state

braingram commented 6 months ago

Is there a plan for a migration guide for developers of packages that use zarr (or does one already exist)?

I maintain asdf-zarr and it looks like some API has changed including no zarr.storage zarr.creation zarr.open etc. I initially saw zarr.v2 thinking that was a compatibility API that I could use but it looks like that is being removed in https://github.com/zarr-developers/zarr-python/pull/1898

jhamman commented 5 months ago

We have hit the first alpha release milestone! This means we will be making the 3.0.0.alpha0. Rest assured, more API compatibility changes will be coming before the full 3.0 release.

Edit: the pre-release is now live: