Merge branch 'main' into keyword-only

Author: d-v-b

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -57,7 +57,22 @@ body:
     id: reproduce
     attributes:
       label: Steps to reproduce
-      description: Minimal, reproducible code sample, a copy-pastable example if possible.
+      description: Minimal, reproducible code sample. Must list dependencies in [inline script metadata](https://packaging.python.org/en/latest/specifications/inline-script-metadata/#example). When put in a file named `issue.py` calling `uv run issue.py` should show the issue.
+      value: |
+        ```python
+        # /// script
+        # requires-python = ">=3.11"
+        # dependencies = [
+        #   "zarr@git+https://github.com/zarr-developers/zarr-python.git@main",
+        # ]
+        # ///
+        #
+        # This script automatically imports the development branch of zarr to check for issues
+
+        import zarr
+        # your reproducer code
+        # zarr.print_debug_info()
+        ```
     validations:
       required: true
   - type: textarea

changes/3081.feature.rst

@@ -0,0 +1 @@
+Adds ``fill_value`` to the list of attributes displayed in the output of the ``AsyncArray.info()`` method.

docs/user-guide/arrays.rst

@@ -183,6 +183,7 @@ which can be used to print useful diagnostics, e.g.::
    Type               : Array
    Zarr format        : 3
    Data type          : DataType.int32
+   Fill value         : 0
    Shape              : (10000, 10000)
    Chunk shape        : (1000, 1000)
    Order              : C
@@ -200,6 +201,7 @@ prints additional diagnostics, e.g.::
    Type               : Array
    Zarr format        : 3
    Data type          : DataType.int32
+   Fill value         : 0
    Shape              : (10000, 10000)
    Chunk shape        : (1000, 1000)
    Order              : C
@@ -287,6 +289,7 @@ Here is an example using a delta filter with the Blosc compressor::
    Type               : Array
    Zarr format        : 3
    Data type          : DataType.int32
+   Fill value         : 0
    Shape              : (10000, 10000)
    Chunk shape        : (1000, 1000)
    Order              : C
@@ -601,6 +604,7 @@ Sharded arrays can be created by providing the ``shards`` parameter to :func:`za
   Type               : Array
   Zarr format        : 3
   Data type          : DataType.uint8
+  Fill value         : 0
   Shape              : (10000, 10000)
   Shard shape        : (1000, 1000)
   Chunk shape        : (100, 100)

docs/user-guide/groups.rst

@@ -129,6 +129,7 @@ property. E.g.::
    Type               : Array
    Zarr format        : 3
    Data type          : DataType.int64
+   Fill value         : 0
    Shape              : (1000000,)
    Chunk shape        : (100000,)
    Order              : C
@@ -145,6 +146,7 @@ property. E.g.::
    Type               : Array
    Zarr format        : 3
    Data type          : DataType.float32
+   Fill value         : 0.0
    Shape              : (1000, 1000)
    Chunk shape        : (100, 100)
    Order              : C

docs/user-guide/performance.rst

@@ -92,6 +92,7 @@ To use sharding, you need to specify the ``shards`` parameter when creating the
    Type               : Array
    Zarr format        : 3
    Data type          : DataType.uint8
+   Fill value         : 0
    Shape              : (10000, 10000, 1000)
    Shard shape        : (1000, 1000, 1000)
    Chunk shape        : (100, 100, 100)
@@ -122,6 +123,7 @@ ratios, depending on the correlation structure within the data. E.g.::
    Type               : Array
    Zarr format        : 3
    Data type          : DataType.int32
+   Fill value         : 0
    Shape              : (10000, 10000)
    Chunk shape        : (1000, 1000)
    Order              : C
@@ -141,6 +143,7 @@ ratios, depending on the correlation structure within the data. E.g.::
    Type               : Array
    Zarr format        : 3
    Data type          : DataType.int32
+   Fill value         : 0
    Shape              : (10000, 10000)
    Chunk shape        : (1000, 1000)
    Order              : F

src/zarr/core/_info.py

@@ -67,7 +67,7 @@ def byte_info(size: int) -> str:
         return f"{size} ({human_readable_size(size)})"
 
 
-@dataclasses.dataclass(kw_only=True)
+@dataclasses.dataclass(kw_only=True, frozen=True, slots=True)
 class ArrayInfo:
     """
     Visual summary for an Array.
@@ -79,6 +79,7 @@ class ArrayInfo:
     _type: Literal["Array"] = "Array"
     _zarr_format: ZarrFormat
     _data_type: np.dtype[Any] | DataType
+    _fill_value: object
     _shape: tuple[int, ...]
     _shard_shape: tuple[int, ...] | None = None
     _chunk_shape: tuple[int, ...] | None = None
@@ -97,6 +98,7 @@ def __repr__(self) -> str:
         Type               : {_type}
         Zarr format        : {_zarr_format}
         Data type          : {_data_type}
+        Fill value         : {_fill_value}
         Shape              : {_shape}""")
 
         if self._shard_shape is not None:

src/zarr/core/array.py

@@ -1700,6 +1700,7 @@ def _info(
         return ArrayInfo(
             _zarr_format=self.metadata.zarr_format,
             _data_type=_data_type,
+            _fill_value=self.metadata.fill_value,
             _shape=self.shape,
             _order=self.order,
             _shard_shape=self.shards,

tests/test_array.py

@@ -482,6 +482,7 @@ def test_info_v2(self, chunks: tuple[int, int], shards: tuple[int, int] | None)
         expected = ArrayInfo(
             _zarr_format=2,
             _data_type=np.dtype("float64"),
+            _fill_value=arr.fill_value,
             _shape=(8, 8),
             _chunk_shape=chunks,
             _shard_shape=None,
@@ -499,6 +500,7 @@ def test_info_v3(self, chunks: tuple[int, int], shards: tuple[int, int] | None)
         expected = ArrayInfo(
             _zarr_format=3,
             _data_type=DataType.parse("float64"),
+            _fill_value=arr.fill_value,
             _shape=(8, 8),
             _chunk_shape=chunks,
             _shard_shape=shards,
@@ -524,6 +526,7 @@ def test_info_complete(self, chunks: tuple[int, int], shards: tuple[int, int] |
         expected = ArrayInfo(
             _zarr_format=3,
             _data_type=DataType.parse("float64"),
+            _fill_value=arr.fill_value,
             _shape=(8, 8),
             _chunk_shape=chunks,
             _shard_shape=shards,
@@ -559,6 +562,7 @@ async def test_info_v2_async(
         expected = ArrayInfo(
             _zarr_format=2,
             _data_type=np.dtype("float64"),
+            _fill_value=arr.metadata.fill_value,
             _shape=(8, 8),
             _chunk_shape=(2, 2),
             _shard_shape=None,
@@ -584,6 +588,7 @@ async def test_info_v3_async(
         expected = ArrayInfo(
             _zarr_format=3,
             _data_type=DataType.parse("float64"),
+            _fill_value=arr.metadata.fill_value,
             _shape=(8, 8),
             _chunk_shape=chunks,
             _shard_shape=shards,
@@ -611,6 +616,7 @@ async def test_info_complete_async(
         expected = ArrayInfo(
             _zarr_format=3,
             _data_type=DataType.parse("float64"),
+            _fill_value=arr.metadata.fill_value,
             _shape=(8, 8),
             _chunk_shape=chunks,
             _shard_shape=shards,

tests/test_info.py

@@ -54,6 +54,7 @@ def test_array_info(zarr_format: ZarrFormat) -> None:
     info = ArrayInfo(
         _zarr_format=zarr_format,
         _data_type=np.dtype("int32"),
+        _fill_value=0,
         _shape=(100, 100),
         _chunk_shape=(10, 100),
         _order="C",
@@ -66,6 +67,7 @@ def test_array_info(zarr_format: ZarrFormat) -> None:
         Type               : Array
         Zarr format        : {zarr_format}
         Data type          : int32
+        Fill value         : 0
         Shape              : (100, 100)
         Chunk shape        : (10, 100)
         Order              : C
@@ -92,6 +94,7 @@ def test_array_info_complete(
     info = ArrayInfo(
         _zarr_format=zarr_format,
         _data_type=np.dtype("int32"),
+        _fill_value=0,
         _shape=(100, 100),
         _chunk_shape=(10, 100),
         _order="C",
@@ -107,6 +110,7 @@ def test_array_info_complete(
         Type               : Array
         Zarr format        : {zarr_format}
         Data type          : int32
+        Fill value         : 0
         Shape              : (100, 100)
         Chunk shape        : (10, 100)
         Order              : C