Replace more instances of group()

Author: dstansby

docs/developers/contributing.rst

@@ -31,7 +31,7 @@ a bug report:
 
     ```python
     import zarr
-    g = zarr.group()
+    g = zarr.create_group(store={})
     # etc.
     ```
 

docs/quickstart.rst

@@ -98,7 +98,7 @@ Hierarchical Groups
 Zarr allows you to create hierarchical groups, similar to directories::
 
     >>> # Create nested groups and add arrays
-    >>> root = zarr.group("data/example-2.zarr")
+    >>> root = zarr.create_group("data/example-2.zarr")
     >>> foo = root.create_group(name="foo")
     >>> bar = root.create_array(
     ...     name="bar", shape=(100, 10), chunks=(10, 10), dtype="f4"
@@ -126,7 +126,7 @@ Zarr provides tools for creating a collection of arrays and groups with a single
 Suppose we want to copy existing groups and arrays into a new storage backend:
 
     >>> # Create nested groups and add arrays
-    >>> root = zarr.group("data/example-3.zarr", attributes={'name': 'root'})
+    >>> root = zarr.create_group("data/example-3.zarr", attributes={'name': 'root'})
     >>> foo = root.create_group(name="foo")
     >>> bar = root.create_array(
     ...     name="bar", shape=(100, 10), chunks=(10, 10), dtype="f4"

docs/user-guide/groups.rst

@@ -107,7 +107,7 @@ Diagnostic information about arrays and groups is available via the ``info``
 property. E.g.::
 
    >>> store = zarr.storage.MemoryStore()
-   >>> root = zarr.group(store=store)
+   >>> root = zarr.create_group(store=store)
    >>> foo = root.create_group('foo')
    >>> bar = foo.create_array(name='bar', shape=1000000, chunks=100000, dtype='int64')
    >>> bar[:] = 42

src/zarr/core/group.py

@@ -1969,7 +1969,7 @@ def __iter__(self) -> Iterator[str]:
         Examples
         --------
         >>> import zarr
-        >>> g1 = zarr.group()
+        >>> g1 = zarr.create_group(store={})
         >>> g2 = g1.create_group('foo')
         >>> g3 = g1.create_group('bar')
         >>> d1 = g1.create_array('baz', shape=(10,), chunks=(10,))
@@ -2003,7 +2003,7 @@ def __setitem__(self, key: str, value: Any) -> None:
         Examples
         --------
         >>> import zarr
-        >>> group = zarr.group()
+        >>> group = zarr.create_group(store={})
         >>> group["foo"] = zarr.zeros((10,))
         >>> group["foo"]
         <Array memory://132270269438272/foo shape=(10,) dtype=float64>
@@ -2019,7 +2019,7 @@ async def update_attributes_async(self, new_attributes: dict[str, Any]) -> Group
         Examples
         --------
         >>> import zarr
-        >>> group = zarr.group()
+        >>> group = zarr.create_group(store={})
         >>> await group.update_attributes_async({"foo": "bar"})
         >>> group.attrs.asdict()
         {'foo': 'bar'}
@@ -2120,7 +2120,7 @@ def update_attributes(self, new_attributes: dict[str, Any]) -> Group:
         Examples
         --------
         >>> import zarr
-        >>> group = zarr.group()
+        >>> group = zarr.create_group(store={})
         >>> group.update_attributes({"foo": "bar"})
         >>> group.attrs.asdict()
         {'foo': 'bar'}
@@ -2245,7 +2245,7 @@ def keys(self) -> Generator[str, None]:
         Examples
         --------
         >>> import zarr
-        >>> g1 = zarr.group()
+        >>> g1 = zarr.create_group(store={})
         >>> g2 = g1.create_group('foo')
         >>> g3 = g1.create_group('bar')
         >>> d1 = g1.create_array('baz', shape=(10,), chunks=(10,))
@@ -2265,7 +2265,7 @@ def __contains__(self, member: str) -> bool:
         Examples
         --------
         >>> import zarr
-        >>> g1 = zarr.group()
+        >>> g1 = zarr.create_group(store={})
         >>> g2 = g1.create_group('foo')
         >>> d1 = g1.create_array('bar', shape=(10,), chunks=(10,))
         >>> 'foo' in g1
@@ -2284,7 +2284,7 @@ def groups(self) -> Generator[tuple[str, Group], None]:
         Examples
         --------
         >>> import zarr
-        >>> group = zarr.group()
+        >>> group = zarr.create_group(store={})
         >>> group.create_group("subgroup")
         >>> for name, subgroup in group.groups():
         ...     print(name, subgroup)
@@ -2299,7 +2299,7 @@ def group_keys(self) -> Generator[str, None]:
         Examples
         --------
         >>> import zarr
-        >>> group = zarr.group()
+        >>> group = zarr.create_group(store={})
         >>> group.create_group("subgroup")
         >>> for name in group.group_keys():
         ...     print(name)
@@ -2314,7 +2314,7 @@ def group_values(self) -> Generator[Group, None]:
         Examples
         --------
         >>> import zarr
-        >>> group = zarr.group()
+        >>> group = zarr.create_group(store={})
         >>> group.create_group("subgroup")
         >>> for subgroup in group.group_values():
         ...     print(subgroup)
@@ -2329,7 +2329,7 @@ def arrays(self) -> Generator[tuple[str, Array], None]:
         Examples
         --------
         >>> import zarr
-        >>> group = zarr.group()
+        >>> group = zarr.create_group(store={})
         >>> group.create_array("subarray", shape=(10,), chunks=(10,))
         >>> for name, subarray in group.arrays():
         ...     print(name, subarray)
@@ -2344,7 +2344,7 @@ def array_keys(self) -> Generator[str, None]:
         Examples
         --------
         >>> import zarr
-        >>> group = zarr.group()
+        >>> group = zarr.create_group(store={})
         >>> group.create_array("subarray", shape=(10,), chunks=(10,))
         >>> for name in group.array_keys():
         ...     print(name)
@@ -2360,7 +2360,7 @@ def array_values(self) -> Generator[Array, None]:
         Examples
         --------
         >>> import zarr
-        >>> group = zarr.group()
+        >>> group = zarr.create_group(store={})
         >>> group.create_array("subarray", shape=(10,), chunks=(10,))
         >>> for subarray in group.array_values():
         ...     print(subarray)
@@ -2405,7 +2405,7 @@ def create_group(self, name: str, **kwargs: Any) -> Group:
         Examples
         --------
         >>> import zarr
-        >>> group = zarr.group()
+        >>> group = zarr.create_group(store={})
         >>> subgroup = group.create_group("subgroup")
         >>> subgroup
         <Group memory://132270269438272/subgroup>

src/zarr/testing/stateful.py

@@ -88,7 +88,7 @@ def __init__(self, store: Store) -> None:
         self.store = store
 
         self.model = MemoryStore()
-        zarr.group(store=self.model)
+        zarr.create_group(store=self.model)
 
         # Track state of the hierarchy, these should contain fully qualified paths
         self.all_groups: set[str] = set()