tweak example

Author: alimanfoo

zarr/convenience.py

@@ -396,8 +396,9 @@ def copy_store(source, dest, source_path='', dest_path='', excludes=None,
     """Copy data directly from the `source` store to the `dest` store. Use this
     function when you want to copy a group or array in the most efficient way,
     preserving all configuration and attributes. This function is more efficient
-    because it avoids de-compressing and re-compressing data, rather the compressed
-    chunk data for each array are copied directly between stores.
+    than the copy() or copy_all() functions because it avoids de-compressing and
+    re-compressing data, rather the compressed chunk data for each array are copied
+    directly between stores.
 
     Parameters
     ----------
@@ -423,7 +424,8 @@ def copy_store(source, dest, source_path='', dest_path='', excludes=None,
     Examples
     --------
     >>> import zarr
-    >>> root = zarr.group()
+    >>> store1 = zarr.DirectoryStore('data/example.zarr')
+    >>> root = zarr.group(store1, overwrite=True)
     >>> foo = root.create_group('foo')
     >>> bar = foo.create_group('bar')
     >>> baz = bar.create_dataset('baz', shape=100, chunks=50, dtype='i8')
@@ -434,24 +436,24 @@ def copy_store(source, dest, source_path='', dest_path='', excludes=None,
      └── foo
          └── bar
              └── baz (100,) int64
-    >>> source = root.store
-    >>> dest = dict()  # or could be any other type of store
     >>> import sys
-    >>> zarr.copy_store(source, dest, log=sys.stdout)
+    >>> store2 = zarr.ZipStore('data/example.zip', mode='w')  # or any type of store
+    >>> zarr.copy_store(store1, store2, log=sys.stdout)
     .zgroup -> .zgroup
     foo/.zgroup -> foo/.zgroup
     foo/bar/.zgroup -> foo/bar/.zgroup
     foo/bar/baz/.zarray -> foo/bar/baz/.zarray
     foo/bar/baz/0 -> foo/bar/baz/0
     foo/bar/baz/1 -> foo/bar/baz/1
-    >>> new_root = zarr.group(dest)
+    >>> new_root = zarr.group(store2)
     >>> new_root.tree()
     /
      └── foo
          └── bar
              └── baz (100,) int64
     >>> new_root['foo/bar/baz'][:]
     array([ 0,  1,  2,  ..., 97, 98, 99])
+    >>> store2.close()  # zip stores need to be closed
 
     """