Add "The zarrs Book" and zarrs-python to docs

CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 - Add `zarrs::version::version_{str,pre}`
+- Add "The zarrs Book" and `zarrs-python` to docs
 
 ### Changed
 - Make `zarrs::version::version_{,major,minor,patch}` const

README.md

@@ -16,8 +16,13 @@ Correctness issues with past versions are [detailed here](https://github.com/LDe
 
 Developed at the [Department of Materials Physics](https://physics.anu.edu.au/research/mp/), Australian National University, Canberra, Australia.
 
+> [!TIP]
+> If you are a Python user, check out [`zarrs-python`](https://github.com/ilan-gold/zarrs-python).
+> It includes a high-performance codec pipeline for the reference [`zarr-python`](https://github.com/zarr-developers/zarr-python) implementation.
+
 ## Getting Started
 - Review the [implementation status](https://docs.rs/zarrs/latest/zarrs/#implementation-status), [array support](https://docs.rs/zarrs/latest/zarrs/#array-support), and [storage support](https://docs.rs/zarrs/latest/zarrs/#storage-support).
+- Read [The `zarrs` Book](https://book.zarrs.dev).
 - View the [examples](https://github.com/LDeakin/zarrs/tree/main/zarrs/examples) and [the example below](#example).
 - Read the [documentation](https://docs.rs/zarrs/latest/zarrs/). [`array::Array`](https://docs.rs/zarrs/latest/zarrs/array/struct.Array.html) is a good place to start.
 - Check out the [`zarrs` ecosystem](#zarrs-ecosystem).
@@ -98,22 +103,31 @@ println!("{array_ndarray:4}");
 | [![zarrs_opendal_ver]](https://crates.io/crates/zarrs_opendal) `zarrs_opendal`                | [![docs]](https://docs.rs/zarrs_opendal)      [`opendal`](https://docs.rs/opendal/latest/opendal/) store support                |
 | [![zarrs_http_ver]](https://crates.io/crates/zarrs_http) `zarrs_http`                         | [![docs]](https://docs.rs/zarrs_http)         A synchronous http store                                                          |
 | [![zarrs_zip_ver]](https://crates.io/crates/zarrs_zip) `zarrs_zip`                            | [![docs]](https://docs.rs/zarrs_zip)          A storage adapter for zip files                                                   |
-| [![zarrs_icechunk_ver]](https://crates.io/crates/zarrs_icechunk) `zarrs_icechunk`             | [![docs]](https://docs.rs/zarrs_icechunk) [`icechunk`](https://docs.rs/icechunk/latest/icechunk/) store support                 |
+| [![zarrs_icechunk_ver]](https://crates.io/crates/zarrs_icechunk) [zarrs_icechunk]             | [![docs]](https://docs.rs/zarrs_icechunk)     [`icechunk`](https://docs.rs/icechunk/latest/icechunk/) store support             |
 | **Bindings**                                                                                  |                                                                                                                                 |
+| [![zarrs_python_ver]](https://pypi.org/project/zarrs/) [zarrs-python]                         | [![docs]](https://zarrs-python.readthedocs.io/en/latest/) A codec pipeline for [zarr-python]                                    |
 | [![zarrs_ffi_ver]](https://crates.io/crates/zarrs_ffi) [zarrs_ffi]                            | [![docs]](https://docs.rs/zarrs_ffi)          A subset of `zarrs` exposed as a C/C++ API                                        |
+| **Zarr Metadata Conventions**                                                                 |                                                                                                                                 |
+| [![ome_zarr_metadata_ver]](https://crates.io/crates/ome_zarr_metadata) [ome_zarr_metadata]    | [![docs]](https://docs.rs/ome_zarr_metadata)  A library for OME-Zarr (previously OME-NGFF) metadata                             |
 
 [docs]: https://img.shields.io/badge/docs-brightgreen
-[zarrs_ver]: https://img.shields.io/crates/v/zarrs?label=
-[zarrs_metadata_ver]: https://img.shields.io/crates/v/zarrs_metadata?label=
-[zarrs_storage_ver]: https://img.shields.io/crates/v/zarrs_storage?label=
-[zarrs_filesystem_ver]: https://img.shields.io/crates/v/zarrs_filesystem?label=
-[zarrs_http_ver]: https://img.shields.io/crates/v/zarrs_http?label=
-[zarrs_object_store_ver]: https://img.shields.io/crates/v/zarrs_object_store?label=
-[zarrs_opendal_ver]: https://img.shields.io/crates/v/zarrs_opendal?label=
-[zarrs_zip_ver]: https://img.shields.io/crates/v/zarrs_zip?label=
-[zarrs_icechunk_ver]: https://img.shields.io/crates/v/zarrs_icechunk?label=
-[zarrs_ffi_ver]: https://img.shields.io/crates/v/zarrs_ffi?label=
+[zarrs_ver]: https://img.shields.io/crates/v/zarrs
+[zarrs_metadata_ver]: https://img.shields.io/crates/v/zarrs_metadata
+[zarrs_storage_ver]: https://img.shields.io/crates/v/zarrs_storage
+[zarrs_filesystem_ver]: https://img.shields.io/crates/v/zarrs_filesystem
+[zarrs_http_ver]: https://img.shields.io/crates/v/zarrs_http
+[zarrs_object_store_ver]: https://img.shields.io/crates/v/zarrs_object_store
+[zarrs_opendal_ver]: https://img.shields.io/crates/v/zarrs_opendal
+[zarrs_zip_ver]: https://img.shields.io/crates/v/zarrs_zip
+[zarrs_icechunk_ver]: https://img.shields.io/crates/v/zarrs_icechunk
+[zarrs_icechunk]: https://github.com/LDeakin/zarrs_icechunk
+[zarrs_ffi_ver]: https://img.shields.io/crates/v/zarrs_ffi
 [zarrs_ffi]: https://github.com/LDeakin/zarrs_ffi
+[zarrs_python_ver]: https://img.shields.io/pypi/v/zarrs
+[zarrs-python]: https://github.com/ilan-gold/zarrs-python
+[zarr-python]: https://github.com/zarr-developers/zarr-python
+[ome_zarr_metadata_ver]: https://img.shields.io/crates/v/ome_zarr_metadata
+[ome_zarr_metadata]: https://github.com/LDeakin/rust_ome_zarr_metadata
 
 #### [zarrs_tools]
 [![zarrs_tools_ver]](https://crates.io/crates/zarrs_tools) [![zarrs_tools_doc]](https://docs.rs/zarrs_tools)

zarrs/doc/ecosystem.md

@@ -1,32 +1,41 @@
 | Crate                                                                                         | Docs / Description                                                                                                              |
 | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
-| **Core**                                                                                      |
+| **Core**                                                                                      |                                                                                                                                 |
 | [![zarrs_ver]](https://crates.io/crates/zarrs) `zarrs`                                        | [![docs]](https://docs.rs/zarrs) The core library for manipulating Zarr hierarchies                                             |
 | [![zarrs_metadata_ver]](https://crates.io/crates/zarrs_metadata) `zarrs_metadata`             | [![docs]](https://docs.rs/zarrs_metadata) Zarr metadata support                                                                 |
 | [![zarrs_storage_ver]](https://crates.io/crates/zarrs_storage) `zarrs_storage`                | [![docs]](https://docs.rs/zarrs_storage) The storage API for `zarrs`                                                            |
-| **Stores**           |
+| **Stores**                                                                                    |                                                                                                                                 |
 | [![zarrs_filesystem_ver]](https://crates.io/crates/zarrs_filesystem) `zarrs_filesystem`       | [![docs]](https://docs.rs/zarrs_filesystem) A filesystem store                                                                  |
 | [![zarrs_object_store_ver]](https://crates.io/crates/zarrs_object_store) `zarrs_object_store` | [![docs]](https://docs.rs/zarrs_object_store) [`object_store`](https://docs.rs/object_store/latest/object_store/) store support |
 | [![zarrs_opendal_ver]](https://crates.io/crates/zarrs_opendal) `zarrs_opendal`                | [![docs]](https://docs.rs/zarrs_opendal) [`opendal`](https://docs.rs/opendal/latest/opendal/) store support                     |
 | [![zarrs_http_ver]](https://crates.io/crates/zarrs_http) `zarrs_http`                         | [![docs]](https://docs.rs/zarrs_http) A synchronous http store                                                                  |
 | [![zarrs_zip_ver]](https://crates.io/crates/zarrs_zip) `zarrs_zip`                            | [![docs]](https://docs.rs/zarrs_zip) A storage adapter for zip files                                                            |
-| [![zarrs_icechunk_ver]](https://crates.io/crates/zarrs_icechunk) `zarrs_icechunk`             | [![docs]](https://docs.rs/zarrs_icechunk) [`icechunk`](https://docs.rs/icechunk/latest/icechunk/) store support                 |
-| **Bindings**         |
+| [![zarrs_icechunk_ver]](https://crates.io/crates/zarrs_icechunk) [zarrs_icechunk]             | [![docs]](https://docs.rs/zarrs_icechunk) [`icechunk`](https://docs.rs/icechunk/latest/icechunk/) store support                 |
+| **Bindings**                                                                                  |                                                                                                                                 |
+| [![zarrs_python_ver]](https://pypi.org/project/zarrs/) [zarrs-python]                         | [![docs]](https://zarrs-python.readthedocs.io/en/latest/) A codec pipeline for [zarr-python]                                  |
 | [![zarrs_ffi_ver]](https://crates.io/crates/zarrs_ffi) [zarrs_ffi]                            | [![docs]](https://docs.rs/zarrs_ffi) A subset of `zarrs` exposed as a C/C++ API                                                 |
+| **Zarr Metadata Conventions**                                                                 |                                                                                                                                 |
+| [![ome_zarr_metadata_ver]](https://crates.io/crates/ome_zarr_metadata) [ome_zarr_metadata]    | [![docs]](https://docs.rs/ome_zarr_metadata)  A library for OME-Zarr (previously OME-NGFF) metadata                             |
 
 [docs]: https://img.shields.io/badge/docs-brightgreen
-[zarrs_ver]: https://img.shields.io/crates/v/zarrs?label=
-[zarrs_metadata_ver]: https://img.shields.io/crates/v/zarrs_metadata?label=
-[zarrs_storage_ver]: https://img.shields.io/crates/v/zarrs_storage?label=
-[zarrs_filesystem_ver]: https://img.shields.io/crates/v/zarrs_filesystem?label=
-[zarrs_http_ver]: https://img.shields.io/crates/v/zarrs_http?label=
-[zarrs_object_store_ver]: https://img.shields.io/crates/v/zarrs_object_store?label=
-[zarrs_opendal_ver]: https://img.shields.io/crates/v/zarrs_opendal?label=
-[zarrs_zip_ver]: https://img.shields.io/crates/v/zarrs_zip?label=
-[zarrs_icechunk_ver]: https://img.shields.io/crates/v/zarrs_icechunk?label=
-[zarrs_ffi_ver]: https://img.shields.io/crates/v/zarrs_ffi?label=
+[zarrs_ver]: https://img.shields.io/crates/v/zarrs
+[zarrs_metadata_ver]: https://img.shields.io/crates/v/zarrs_metadata
+[zarrs_storage_ver]: https://img.shields.io/crates/v/zarrs_storage
+[zarrs_filesystem_ver]: https://img.shields.io/crates/v/zarrs_filesystem
+[zarrs_http_ver]: https://img.shields.io/crates/v/zarrs_http
+[zarrs_object_store_ver]: https://img.shields.io/crates/v/zarrs_object_store
+[zarrs_opendal_ver]: https://img.shields.io/crates/v/zarrs_opendal
+[zarrs_zip_ver]: https://img.shields.io/crates/v/zarrs_zip
+[zarrs_icechunk_ver]: https://img.shields.io/crates/v/zarrs_icechunk
+[zarrs_icechunk]: https://github.com/LDeakin/zarrs_icechunk
+[zarrs_ffi_ver]: https://img.shields.io/crates/v/zarrs_ffi
 [zarrs_ffi]: https://github.com/LDeakin/zarrs_ffi
 [zarrs_tools_ver]: https://img.shields.io/crates/v/zarrs_tools
+[zarrs_python_ver]: https://img.shields.io/pypi/v/zarrs
+[zarrs-python]: https://github.com/ilan-gold/zarrs-python
+[zarr-python]: https://github.com/zarr-developers/zarr-python
+[ome_zarr_metadata_ver]: https://img.shields.io/crates/v/ome_zarr_metadata
+[ome_zarr_metadata]: https://github.com/LDeakin/rust_ome_zarr_metadata
 
 #### [zarrs_tools]
 [![zarrs_tools_ver]](https://crates.io/crates/zarrs_tools) [![zarrs_tools_doc]](https://docs.rs/zarrs_tools)

zarrs/src/lib.rs

@@ -7,11 +7,15 @@
 //!
 //! Developed at the [Department of Materials Physics](https://physics.anu.edu.au/research/mp/), Australian National University, Canberra, Australia.
 //!
+//! If you are a Python user, check out [`zarrs-python`](https://github.com/ilan-gold/zarrs-python).
+//! It includes a high-performance codec pipeline for the reference [`zarr-python`](https://github.com/zarr-developers/zarr-python) implementation.
+//!
 //! ## Getting Started
 //! - Review the [implementation status](#implementation-status), [array support](#array-support), and [storage support](#storage-support).
+//! - Read [The `zarrs` Book](https://book.zarrs.dev).
 //! - View the [examples](https://github.com/LDeakin/zarrs/tree/main/zarrs/examples) and [the example below](#examples).
 //! - Read the [documentation](https://docs.rs/zarrs/latest/zarrs/). [`array::Array`] is a good place to start.
-//! - Check out [`zarrs` ecosystem](#zarrs-ecosystem).
+//! - Check out the [`zarrs` ecosystem](#zarrs-ecosystem).
 //!
 //! ## Implementation Status
 //!