zarr-developers · alimanfoo · Dec 5, 2017 · Dec 4, 2017 · Dec 4, 2017 · Dec 5, 2017
diff --git a/docs/index.rst b/docs/index.rst
@@ -74,6 +74,7 @@ Contents
     json
     pickles
     msgpacks
+    vlen
     release
 
 Acknowledgments

diff --git a/docs/release.rst b/docs/release.rst
@@ -1,22 +1,31 @@
 Release notes
 =============
 
-.. _release_0.4.1:
+.. _release_0.5.0:
+
+0.5.0
+-----
 
+* Added new codecs for encoding arrays with variable-length unicode strings
+  (:class:`numcodecs.vlen.VLenUTF8`), variable-length byte strings
+  (:class:`numcodecs.vlen.VLenBytes`) and variable-length numerical arrays
+  ((:class:`numcodecs.vlen.VLenArray`) (:issue:`56`).
+
+.. _release_0.4.1:
 
 0.4.1
 -----
 
 * Resolved an issue where providing an array with dtype ``object`` as the destination
-  when decoding could cause segaults with some codecs.
+  when decoding could cause segaults with some codecs (:issue:`55`).
 
 .. _release_0.4.0:
 
 0.4.0
 -----
 
 * Added a new :class:`numcodecs.json.JSON` codec as an alternative for encoding of
-  object arrays.
+  object arrays (:issue:`54`).
 
 .. _release_0.3.1:
 

diff --git a/docs/vlen.rst b/docs/vlen.rst
@@ -0,0 +1,35 @@
+Codecs for variable-length objects
+==================================
+.. automodule:: numcodecs.vlen
+
+VLenUTF8
+--------
+.. autoclass:: VLenUTF8
+
+    .. autoattribute:: codec_id
+    .. automethod:: encode
+    .. automethod:: decode
+    .. automethod:: get_config
+    .. automethod:: from_config
+
+
+VLenBytes
+---------
+.. autoclass:: VLenBytes
+
+    .. autoattribute:: codec_id
+    .. automethod:: encode
+    .. automethod:: decode
+    .. automethod:: get_config
+    .. automethod:: from_config
+
+
+VLenArray
+---------
+.. autoclass:: VLenArray
+
+    .. autoattribute:: codec_id
+    .. automethod:: encode
+    .. automethod:: decode
+    .. automethod:: get_config
+    .. automethod:: from_config
diff --git a/fixture/vlen-array/array.00.npy b/fixture/vlen-array/array.00.npy
diff --git a/fixture/vlen-array/array.01.npy b/fixture/vlen-array/array.01.npy
diff --git a/fixture/vlen-array/codec.00/config.json b/fixture/vlen-array/codec.00/config.json
@@ -0,0 +1,4 @@
+{
+    "dtype": "|i1",
+    "id": "vlen-array"
+}
diff --git a/fixture/vlen-array/codec.00/encoded.00.dat b/fixture/vlen-array/codec.00/encoded.00.dat
diff --git a/fixture/vlen-array/codec.00/encoded.01.dat b/fixture/vlen-array/codec.00/encoded.01.dat
diff --git a/fixture/vlen-array/codec.01/config.json b/fixture/vlen-array/codec.01/config.json
@@ -0,0 +1,4 @@
+{
+    "dtype": "<i2",
+    "id": "vlen-array"
+}
diff --git a/fixture/vlen-array/codec.01/encoded.00.dat b/fixture/vlen-array/codec.01/encoded.00.dat
diff --git a/fixture/vlen-array/codec.01/encoded.01.dat b/fixture/vlen-array/codec.01/encoded.01.dat
diff --git a/fixture/vlen-array/codec.02/config.json b/fixture/vlen-array/codec.02/config.json
@@ -0,0 +1,4 @@
+{
+    "dtype": "<i4",
+    "id": "vlen-array"
+}
diff --git a/fixture/vlen-array/codec.02/encoded.00.dat b/fixture/vlen-array/codec.02/encoded.00.dat
diff --git a/fixture/vlen-array/codec.02/encoded.01.dat b/fixture/vlen-array/codec.02/encoded.01.dat
diff --git a/fixture/vlen-array/codec.03/config.json b/fixture/vlen-array/codec.03/config.json
@@ -0,0 +1,4 @@
+{
+    "dtype": "<i8",
+    "id": "vlen-array"
+}
diff --git a/fixture/vlen-array/codec.03/encoded.00.dat b/fixture/vlen-array/codec.03/encoded.00.dat
diff --git a/fixture/vlen-array/codec.03/encoded.01.dat b/fixture/vlen-array/codec.03/encoded.01.dat
diff --git a/fixture/vlen-array/codec.04/config.json b/fixture/vlen-array/codec.04/config.json
@@ -0,0 +1,4 @@
+{
+    "dtype": "|u1",
+    "id": "vlen-array"
+}
diff --git a/fixture/vlen-array/codec.04/encoded.00.dat b/fixture/vlen-array/codec.04/encoded.00.dat
diff --git a/fixture/vlen-array/codec.04/encoded.01.dat b/fixture/vlen-array/codec.04/encoded.01.dat
diff --git a/fixture/vlen-array/codec.05/config.json b/fixture/vlen-array/codec.05/config.json
@@ -0,0 +1,4 @@
+{
+    "dtype": "<u2",
+    "id": "vlen-array"
+}
diff --git a/fixture/vlen-array/codec.05/encoded.00.dat b/fixture/vlen-array/codec.05/encoded.00.dat
diff --git a/fixture/vlen-array/codec.05/encoded.01.dat b/fixture/vlen-array/codec.05/encoded.01.dat
diff --git a/fixture/vlen-array/codec.06/config.json b/fixture/vlen-array/codec.06/config.json
@@ -0,0 +1,4 @@
+{
+    "dtype": "<u4",
+    "id": "vlen-array"
+}
diff --git a/fixture/vlen-array/codec.06/encoded.00.dat b/fixture/vlen-array/codec.06/encoded.00.dat
diff --git a/fixture/vlen-array/codec.06/encoded.01.dat b/fixture/vlen-array/codec.06/encoded.01.dat
diff --git a/fixture/vlen-array/codec.07/config.json b/fixture/vlen-array/codec.07/config.json
@@ -0,0 +1,4 @@
+{
+    "dtype": "<u8",
+    "id": "vlen-array"
+}
diff --git a/fixture/vlen-array/codec.07/encoded.00.dat b/fixture/vlen-array/codec.07/encoded.00.dat
diff --git a/fixture/vlen-array/codec.07/encoded.01.dat b/fixture/vlen-array/codec.07/encoded.01.dat
diff --git a/fixture/vlen-bytes/array.00.npy b/fixture/vlen-bytes/array.00.npy
diff --git a/fixture/vlen-bytes/array.01.npy b/fixture/vlen-bytes/array.01.npy
diff --git a/fixture/vlen-bytes/array.02.npy b/fixture/vlen-bytes/array.02.npy
diff --git a/fixture/vlen-bytes/array.03.npy b/fixture/vlen-bytes/array.03.npy
diff --git a/fixture/vlen-bytes/codec.00/config.json b/fixture/vlen-bytes/codec.00/config.json
@@ -0,0 +1,3 @@
+{
+    "id": "vlen-bytes"
+}
diff --git a/fixture/vlen-bytes/codec.00/encoded.00.dat b/fixture/vlen-bytes/codec.00/encoded.00.dat
diff --git a/fixture/vlen-bytes/codec.00/encoded.01.dat b/fixture/vlen-bytes/codec.00/encoded.01.dat
diff --git a/fixture/vlen-bytes/codec.00/encoded.02.dat b/fixture/vlen-bytes/codec.00/encoded.02.dat
diff --git a/fixture/vlen-bytes/codec.00/encoded.03.dat b/fixture/vlen-bytes/codec.00/encoded.03.dat
diff --git a/fixture/vlen-utf8/array.00.npy b/fixture/vlen-utf8/array.00.npy
diff --git a/fixture/vlen-utf8/array.01.npy b/fixture/vlen-utf8/array.01.npy
diff --git a/fixture/vlen-utf8/array.02.npy b/fixture/vlen-utf8/array.02.npy
diff --git a/fixture/vlen-utf8/array.03.npy b/fixture/vlen-utf8/array.03.npy
diff --git a/fixture/vlen-utf8/codec.00/config.json b/fixture/vlen-utf8/codec.00/config.json
@@ -0,0 +1,3 @@
+{
+    "id": "vlen-utf8"
+}
diff --git a/fixture/vlen-utf8/codec.00/encoded.00.dat b/fixture/vlen-utf8/codec.00/encoded.00.dat
diff --git a/fixture/vlen-utf8/codec.00/encoded.01.dat b/fixture/vlen-utf8/codec.00/encoded.01.dat
diff --git a/fixture/vlen-utf8/codec.00/encoded.02.dat b/fixture/vlen-utf8/codec.00/encoded.02.dat
diff --git a/fixture/vlen-utf8/codec.00/encoded.03.dat b/fixture/vlen-utf8/codec.00/encoded.03.dat
-Original file line number
+Diff line change
@@ Expand Up / @@ -74,6 +74,7 @@ Contents @@
         json
         pickles
         msgpacks
+        vlen
         release
     Acknowledgments
@@ Expand Down @@