Update docs/api/v3.rst

Co-authored-by: Jonathan Striebel <jstriebel@users.noreply.github.com>
zarr-developers · Mar 10, 2023 · d8a4131 · d8a4131
1 parent 4c1d151
commit d8a4131
Showing 1 changed file with 18 additions and 0 deletions.
diff --git a/docs/api/v3.rst b/docs/api/v3.rst
@@ -75,3 +75,21 @@ The abstract base class for storage transformers is
 .. module:: zarr._storage.store
 
 .. autoclass:: StorageTransformer
+
+In v3 `storage transformers <https://zarr-specs.readthedocs.io/en/latest/core/v3.0.html#id19>`_
+can be set via ``zarr.create(…, storage_transformers=[…])``.
+The experimental sharding storage transformer can be tested by setting
+the environment variable ``ZARR_V3_SHARDING=1``. Data written with this flag
+enabled should be expected to become stale until
+`ZEP 2 <https://zarr.dev/zeps/draft/ZEP0002.html>`_ is approved
+and fully implemented.
+
+.. module:: zarr._storage.v3_storage_transformers
+
+.. autoclass:: ShardingStorageTransformer
+
+The abstract base class for storage transformers is
+
+.. module:: zarr._storage.store
+
+.. autoclass:: StorageTransformer