Use doctests for storage.rst

Author: dstansby

docs/user-guide/storage.rst

@@ -16,25 +16,26 @@ Implicit Store Creation
 -----------------------
 
 In most cases, it is not required to create a ``Store`` object explicitly. Passing a string
-to Zarr's top level API will result in the store being created automatically.
-
-.. ipython:: python
-
-   import zarr
-
-   # Implicitly create a writable LocalStore
-   zarr.open_group("data/foo/bar", mode="w")
-
-   # Implicitly create a read-only FsspecStore
-   zarr.open_group(
-      "s3://noaa-nwm-retro-v2-zarr-pds",
-      mode="r",
-      storage_options={"anon": True}
-   )
-
-   # Implicitly creates a MemoryStore
-   data = {}
-   zarr.open_group(data, mode="w")
+to Zarr's top level API will result in the store being created automatically.:
+
+   >>> import zarr
+   >>>
+   >>> # Implicitly create a writable LocalStore
+   >>> zarr.open_group("data/foo/bar", mode="w")
+   <Group file://data/foo/bar>
+   >>>
+   >>> # Implicitly create a read-only FsspecStore
+   >>> zarr.open_group(
+   ...    "s3://noaa-nwm-retro-v2-zarr-pds",
+   ...    mode="r",
+   ...    storage_options={"anon": True}
+   ... )
+   <Group <FsspecStore(S3FileSystem, noaa-nwm-retro-v2-zarr-pds)>>
+   >>>
+   >>> # Implicitly creates a MemoryStore
+   >>> data = {}
+   >>> zarr.open_group(data, mode="w")
+   <Group memory://...>
 
 Explicit Store Creation
 -----------------------
@@ -47,25 +48,23 @@ Local Store
 ~~~~~~~~~~~
 
 The :class:`zarr.storage.LocalStore` stores data in a nested set of directories on a local
-filesystem.
+filesystem.:
 
-.. ipython:: python
-
-   store = zarr.storage.LocalStore("data/foo/bar", read_only=True)
-   # TODO: replace with create_group after #2463
-   zarr.open(store=store, mode='r')
+   >>> store = zarr.storage.LocalStore("data/foo/bar", read_only=True)
+   >>> # TODO: replace with create_group after #2463
+   >>> zarr.open(store=store, mode='r')
+   <Group file://data/foo/bar>
 
 Zip Store
 ~~~~~~~~~
 
 The :class:`zarr.storage.ZipStore` stores the contents of a Zarr hierarchy in a single
-Zip file. The `Zip Store specification`_ is currently in draft form.
-
-.. ipython:: python
+Zip file. The `Zip Store specification`_ is currently in draft form.:
 
-   store = zarr.storage.ZipStore("data.zip", mode="w")
-   # TODO: replace with create_array after #2463
-   zarr.open(store=store, shape=(2,))
+   >>> store = zarr.storage.ZipStore("data.zip", mode="w")
+   >>> # TODO: replace with create_array after #2463
+   >>> zarr.open(store=store, shape=(2,))
+   <Array zip://data.zip shape=(2,) dtype=float64>
 
 Remote Store
 ~~~~~~~~~~~~
@@ -75,29 +74,27 @@ logical layout as the ``LocalStore``, except the store is assumed to be on a rem
 such as cloud object storage (e.g. AWS S3, Google Cloud Storage, Azure Blob Store). The
 :class:`zarr.storage.FsspecStore` is backed by `fsspec`_ and can support any backend
 that implements the `AbstractFileSystem <https://filesystem-spec.readthedocs.io/en/stable/api.html#fsspec.spec.AbstractFileSystem>`_
-API. ``storage_options`` can be used to configure the fsspec backend.
+API. ``storage_options`` can be used to configure the fsspec backend.:
 
-.. ipython:: python
-
-   store = zarr.storage.FsspecStore.from_url(
-      "s3://noaa-nwm-retro-v2-zarr-pds",
-      read_only=True,
-      storage_options={"anon": True}
-   )
-   zarr.open_group(store=store, mode='r')
+   >>> store = zarr.storage.FsspecStore.from_url(
+   ...    "s3://noaa-nwm-retro-v2-zarr-pds",
+   ...    read_only=True,
+   ...    storage_options={"anon": True}
+   ... )
+   >>> zarr.open_group(store=store, mode='r')
+   <Group <FsspecStore(S3FileSystem, noaa-nwm-retro-v2-zarr-pds)>>
 
 Memory Store
 ~~~~~~~~~~~~
 
 The :class:`zarr.storage.MemoryStore` a in-memory store that allows for serialization of
-Zarr data (metadata and chunks) to a dictionary.
-
-.. ipython:: python
+Zarr data (metadata and chunks) to a dictionary.:
 
-   data = {}
-   store = zarr.storage.MemoryStore(data)
-   # TODO: replace with create_array after #2463
-   zarr.open(store=store, shape=(2, ))
+   >>> data = {}
+   >>> store = zarr.storage.MemoryStore(data)
+   >>> # TODO: replace with create_array after #2463
+   >>> zarr.open(store=store, shape=(2, ))
+   <Array memory://... shape=(2,) dtype=float64>
 
 Developing custom stores
 ------------------------