clean up types and docstrings

Author: d-v-b

src/zarr/api/asynchronous.py

@@ -789,7 +789,7 @@ async def create(
     meta_array: Any | None = None,  # TODO: need type
     attributes: dict[str, JSON] | None = None,
     # v3 only
-    chunk_shape: tuple[int, ...] | int | None = None,
+    chunk_shape: ChunkCoords | int | None = None,
     chunk_key_encoding: (
         ChunkKeyEncoding
         | tuple[Literal["default"], Literal[".", "/"]]
@@ -1095,6 +1095,8 @@ async def open_array(
     ----------
     store : Store or str
         Store or path to directory in file system or name of zip file.
+    zarr_version : {2, 3, None}, optional
+        The zarr format to use when saving. Deprecated in favor of zarr_format.
     zarr_format : {2, 3, None}, optional
         The zarr format to use when saving.
     path : str, optional

tests/test_api.py

@@ -1064,6 +1064,12 @@ def test_derived_docstrings(func_name: str) -> None:
     Test that functions in the synchronous API module have
     docstrings that are derived from those in the asynchronous API module
     """
+    if func_name in ("open_array",):
+        msg = (
+            '"open_array" gets xfailed because the async version and the sync '
+            "version have meaningful differences in their docstrings."
+        )
+        pytest.xfail(reason=msg)
     assert (
         getattr(zarr.api.synchronous, func_name).__doc__
         == getattr(zarr.api.asynchronous, func_name).__doc__
@@ -1075,7 +1081,7 @@ def test_derived_signatures(func_name: str) -> None:
     """
     Test that functions in the API module have signatures that are derived from those in the asynchronous API module
     """
-    if func_name in ("tree", "load", "open", "open_array"):
+    if func_name in ("tree", "load", "open", "open_array", "group"):
         msg = (
             f"{func_name} gets xfailed because the async version and the sync "
             "version have meaningful differences in their signatures."