Started #77

Author: forman

docs/config.md

@@ -85,9 +85,16 @@ Variable metadata.
 
           * Type _array_.
             Chunk sizes in the order of the dimensions.
-            The items of the array are of type _integer_.
+            The items of the array must be one of the following:
+            
+              * Type _integer_.
+                Dimension is chunked using given size.
+            
+              * No chunking in this dimension.
+                Its value is `null`.
+            
 
-          * Disable chunking.
+          * Disable chunking in all dimensions.
             Its value is `null`.
 
 
@@ -243,7 +250,7 @@ Options for the filesystem given by the protocol of `temp_dir`.
 ## `force_new`
 
 Type _boolean_.
-Force creation of a new target dataset. An existing target dataset (and its lock) will be permanently deleted before appending of slice datasets begins. WARNING: the deletion cannot be rolled back.
+Force creation of a new target dataset.  An existing target dataset (and its lock) will be permanently deleted before appending of slice datasets begins. WARNING: the deletion cannot be rolled back.
 Defaults to `false`.
 
 ## `disable_rollback`

tests/test_api.py

@@ -177,6 +177,10 @@ def process_slice(ctx, slice_ds: xr.Dataset) -> SliceSource:
             ds.attrs,
         )
 
+    def test_some_slices_with_cropping_slice_source(self):
+        # TODO: implement me after #78
+        pass
+
     def test_some_slices_with_inc_append_step(self):
         target_dir = "memory://target.zarr"
         slices = [make_test_dataset(index=i, shape=(1, 50, 100)) for i in range(3)]

zappend/config/schema.py

@@ -73,11 +73,23 @@
             "description": "Storage chunking.",
             "oneOf": [
                 {
-                    "description": "Chunk sizes in the order of the dimensions.",
+                    "description": "Chunk sizes for each dimension of the variable.",
                     "type": "array",
-                    "items": {"type": "integer", "minimum": 1},
+                    "items": {
+                        "oneOf": [
+                            {
+                                "description": "Dimension is chunked using given size.",
+                                "type": "integer",
+                                "minimum": 1,
+                            },
+                            {
+                                "description": "Disable chunking in this dimension.",
+                                "const": None,
+                            },
+                        ]
+                    },
                 },
-                {"description": "Disable chunking.", "const": None},
+                {"description": "Disable chunking in all dimensions.", "const": None},
             ],
         },
         fill_value={