Merge branch 'main' of github.com:zarr-developers/zarr-python into feat/numcodecs-compat

Author: d-v-b

changes/3151.bugfix.rst

@@ -0,0 +1,2 @@
+Fixed an issue preventing correct parsing of NumPy ``int32`` dtypes when constructed via
+``np.dtype('i')``.

changes/3157.doc.rst

@@ -0,0 +1,2 @@
+Add a self-contained example of data type extension to the ``examples`` directory, and expanded
+the documentation for data types.

changes/3170.bugfix.rst

@@ -0,0 +1,6 @@
+Fixes a variety of issues related to string data types.
+
+- Brings the ``VariableLengthUTF8`` data type Zarr V3 identifier in alignment with Zarr Python 3.0.8
+- Disallows creation of 0-length fixed-length data types
+- Adds a regression test for the ``VariableLengthUTF8`` data type that checks against version 3.0.8
+- Allows users to request the ``VariableLengthUTF8`` data type with ``str``, ``"str"``, or ``"string"``.

changes/3191.feature.rst

@@ -0,0 +1 @@
+Added `NDBuffer.empty` method for faster ndbuffer initialization.

changes/3193.bugfix.rst

@@ -0,0 +1,2 @@
+Removed an unnecessary check from ``_fsspec._make_async`` that would raise an exception when
+creating a read-only store backed by a local file system with ``auto_mkdir`` set  to ``False``.

changes/3195.bugfix.rst

@@ -0,0 +1 @@
+Add missing import for AsyncFileSystemWrapper for _make_async in _fsspec.py

changes/3198.bugfix.rst

@@ -0,0 +1,4 @@
+Restores the ability to create a Zarr V2 array with a ``null`` fill value by introducing a new
+class ``DefaultFillValue``, and setting the default value of the ``fill_value`` parameter in array
+creation routines to an instance of ``DefaultFillValue``. For Zarr V3 arrays, ``None`` will act as an
+alias for a ``DefaultFillValue`` instance, thus preserving compatibility with existing code.

docs/conf.py

@@ -38,14 +38,14 @@
 extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.autosummary",
-    "sphinx.ext.viewcode",
     "sphinx.ext.intersphinx",
     'autoapi.extension',
     "numpydoc",
     "sphinx_issues",
     "sphinx_copybutton",
     "sphinx_design",
     'sphinx_reredirects',
+    "sphinx.ext.viewcode",
 ]
 
 issues_github_path = "zarr-developers/zarr-python"
@@ -56,7 +56,7 @@
 autoapi_member_order = "groupwise"
 autoapi_root = "api"
 autoapi_keep_files = True
-autoapi_options = [ 'members', 'undoc-members', 'show-inheritance', 'show-module-summary', 'imported-members', ]
+autoapi_options = [ 'members', 'undoc-members', 'show-inheritance', 'show-module-summary', 'imported-members', 'inherited-members']
 
 def skip_submodules(
         app: sphinx.application.Sphinx,

docs/user-guide/arrays.rst

@@ -23,7 +23,8 @@ The code above creates a 2-dimensional array of 32-bit integers with 10000 rows
 and 10000 columns, divided into chunks where each chunk has 1000 rows and 1000
 columns (and so there will be 100 chunks in total). The data is written to a
 :class:`zarr.storage.MemoryStore` (e.g. an in-memory dict). See
-:ref:`user-guide-persist` for details on storing arrays in other stores.
+:ref:`user-guide-persist` for details on storing arrays in other stores, and see
+:ref:`user-guide-data-types` for an in-depth look at the data types supported by Zarr.
 
 For a complete list of array creation routines see the :mod:`zarr`
 module documentation.
@@ -629,29 +630,6 @@ Missing features in 3.0
 
 The following features have not been ported to 3.0 yet.
 
-.. _user-guide-objects:
-
-Object arrays
-~~~~~~~~~~~~~
-
-See the Zarr-Python 2 documentation on `Object arrays <https://zarr.readthedocs.io/en/support-v2/tutorial.html#object-arrays>`_ for more details.
-
-.. _user-guide-strings:
-
-Fixed-length string arrays
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-See the Zarr-Python 2 documentation on `Fixed-length string arrays <https://zarr.readthedocs.io/en/support-v2/tutorial.html#string-arrays>`_ for more details.
-
-.. _user-guide-datetime:
-
-Datetime and Timedelta arrays
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-See the Zarr-Python 2 documentation on `Datetime and Timedelta <https://zarr.readthedocs.io/en/support-v2/tutorial.html#datetimes-and-timedeltas>`_ for more details.
-
-.. _user-guide-copy:
-
 Copying and migrating data
 ~~~~~~~~~~~~~~~~~~~~~~~~~~