moat-lib-codec 0.4.18__tar.gz → 0.4.21__tar.gz

moat_lib_codec-0.4.21/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: moat-lib-codec
+Version: 0.4.21
+Summary: A simple command/stream multiplexer
+Author-email: Matthias Urlichs <matthias@urlichs.de>
+Maintainer-email: Matthias Urlichs <matthias@urlichs.de>
+Project-URL: homepage, https://m-o-a-t.org
+Project-URL: repository, https://github.com/M-o-a-T/moat
+Keywords: MoaT
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AnyIO
+Classifier: Framework :: Trio
+Classifier: Framework :: AsyncIO
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: anyio~=4.2
+Requires-Dist: moat-lib-rpc~=0.7.6
+Requires-Dist: moat-lib-micro~=0.3.4
+Requires-Dist: moat-lib-proxy~=0.1.3
+Requires-Dist: moat-util~=0.64.0
+Dynamic: license-file
+
+# The MoaT-Codec library
+
+% start synopsis
+% start main
+
+This library packages various codecs used for MoaT protocols
+in a way that's reason- and stream-able.
+
+% end synopsis
+
+## Supplied codecs
+
+- CBOR
+- msgpack
+- no-op
+- UTF-8
+- JSON
+- YAML
+
+% end main
+
+## Interface
+
+### Codec
+
+- encode(obj)
+
+  Encode the object to a bytestream.
+
+- decode(bytes)
+
+  Decode the given bytes to a single object.
+
+- feed(bytes, final=False)
+
+  Data stream. Returns an array of objects.
+
+  This method only exists when a sequence of encoded objects can be streamed,
+  i.e. contains built-in message boundaries.
+
+  if @final is `True`, raise an exception if there is an incomplete
+  object in the buffer after this call.
+
+- getstate(), setstate(\*args)
+
+  A streaming decoder may store partially-decoded state (unprocessed
+  buffer) here.
+
+The list of accepted objects is implementation dependent.
+
+### Extension
+
+Extension types vary by whether they carry binary data as in (msgpack), or
+objects (as in cbor).
+
+- binary (classvar): True if msgpack-style, False if cbor-style
+
+- encoder(cls, key, fn)
+
+  Encode an object `obj` of type `type`. `fn(codec, obj)` must return
+  a bytestring / an encodeable object. If the registration key is `None`
+  the function must return a tuple with the key as first element.
+
+- decoder(key, fn)
+
+  Add a decoder (key, data) to an object. `fn(codec, data)` is called with a
+  bytestring / a decoded object, and returns whatever has been encoded.
+
+Extensions get the codec as their first argument. They can use it to store
+data, e.g. references. The extension object is available as `codec.ext`.

{moat_lib_codec-0.4.18 → moat_lib_codec-0.4.21}/debian/changelog

@@ -1,3 +1,45 @@
+moat-lib-codec (0.4.21-2) unstable; urgency=medium
+
+  * New release for 26.4.8
+
+ -- Matthias Urlichs <matthias@urlichs.de>  Thu, 01 Oct 2026 11:15:17 +0200
+
+moat-lib-codec (0.4.21-1) unstable; urgency=medium
+
+  * New release for 26.4.0
+
+ -- Matthias Urlichs <matthias@urlichs.de>  Tue, 29 Sep 2026 16:47:21 +0200
+
+moat-lib-codec (0.4.20-1) unstable; urgency=medium
+
+  * New release for 26.2.13
+
+ -- Matthias Urlichs <matthias@urlichs.de>  Wed, 23 Sep 2026 15:11:05 +0200
+
+moat-lib-codec (0.4.19-3) unstable; urgency=medium
+
+  * New release for 26.2.3
+
+ -- Matthias Urlichs <matthias@urlichs.de>  Mon, 15 Jun 2026 17:44:22 +0200
+
+moat-lib-codec (0.4.19-2) unstable; urgency=medium
+
+  * New release for 26.1.19
+
+ -- Matthias Urlichs <matthias@urlichs.de>  Wed, 03 Jun 2026 20:27:16 +0200
+
+moat-lib-codec (0.4.19-1) unstable; urgency=medium
+
+  * New release for 26.1.18
+
+ -- Matthias Urlichs <matthias@urlichs.de>  Wed, 03 Jun 2026 18:49:14 +0200
+
+moat-lib-codec (0.4.18-2) unstable; urgency=medium
+
+  * New release for 26.1.12
+
+ -- Matthias Urlichs <matthias@urlichs.de>  Fri, 24 Apr 2026 15:33:49 +0200
+
 moat-lib-codec (0.4.18-1) unstable; urgency=medium
 
   * New release for 26.1.10

{moat_lib_codec-0.4.18 → moat_lib_codec-0.4.21}/debian/control

@@ -2,13 +2,12 @@ Source: moat-lib-codec
 Maintainer: "Matthias Urlichs" <matthias@urlichs.de>
 Section: python
 Priority: optional
-Build-Depends: dh-python, python3-all, debhelper (>= 13),
+Build-Depends: dh-python, python3-all, debhelper (>= 13), debhelper-compat (= 13),
   python3-setuptools,
   python3-wheel,
 Standards-Version: 3.9.6
 Homepage: https://m-o-a-t.org
 Testsuite: autopkgtest-pkg-pybuild
-X-DH-Compat: 13
 
 Package: python3-moat-lib-codec
 Architecture: all

{moat_lib_codec-0.4.18 → moat_lib_codec-0.4.21}/pyproject.toml

@@ -13,19 +13,19 @@ classifiers = [
 ]
 dependencies = [
     "anyio ~= 4.2",
-    "moat-lib-rpc ~= 0.7.0",
-    "moat-lib-micro ~= 0.3.0",
-    "moat-lib-proxy ~= 0.1.1",
-    "moat-util ~= 0.63.0",
+    "moat-lib-rpc ~= 0.7.6",
+    "moat-lib-micro ~= 0.3.4",
+    "moat-lib-proxy ~= 0.1.3",
+    "moat-util ~= 0.64.0",
 ]
 keywords = ["MoaT"]
 requires-python = ">=3.8"
 name = "moat-lib-codec"
 maintainers = [{email = "matthias@urlichs.de",name = "Matthias Urlichs"}]
 description='A simple command/stream multiplexer'
-readme = "README.rst"
+readme = "README.md"
 authors = [{email = "matthias@urlichs.de",name = "Matthias Urlichs"}]
-version = "0.4.18"
+version = "0.4.21"
 
 [project.urls]
 homepage = "https://m-o-a-t.org"

{moat_lib_codec-0.4.18 → moat_lib_codec-0.4.21}/src/moat/lib/codec/_base.py

@@ -90,6 +90,14 @@ class Codec:
         """
         raise NotImplementedError
 
+    def eof(self) -> None:
+        """
+        Signal that no more data will be fed.
+
+        Afterwards, iterating returns any objects still in the buffer
+        that are not terminated explicitly. The default does nothing.
+        """
+
     def unfeed(self, buf: VarByteType) -> int:
         """
         Take from the front of the decoder's buffer.

{moat_lib_codec-0.4.18 → moat_lib_codec-0.4.21}/src/moat/lib/codec/_cbor.py

@@ -13,6 +13,8 @@ from moat.util import OutOfData
 from ._base import Codec as _Codec
 from ._base import NoCodecError
 
+from collections.abc import Mapping
+
 # Typing
 from typing import TYPE_CHECKING, cast  # isort:skip
 
@@ -297,7 +299,7 @@ class Codec(_Codec):
         elif isinstance(ob, (list, tuple)):
             self._enc_array(ob)
         # TODO: accept other enumerables and emit a variable length array
-        elif isinstance(ob, dict):
+        elif isinstance(ob, Mapping):
             self._enc_dict(ob)
         elif isinstance(ob, float):
             self._enc_float(ob)

{moat_lib_codec-0.4.18 → moat_lib_codec-0.4.21}/src/moat/lib/codec/_moat_msgpack.py

@@ -12,11 +12,13 @@ Extension types defined here:
 from __future__ import annotations
 
 from moat.lib.path import Path
-from moat.lib.proxy import DProxy, Proxy, _CProxy, get_proxy, obj2name, unwrap_obj, wrap_obj
+from moat.lib.proxy import DProxy, Proxy, _lookup_proxy, get_proxy, obj2name, unwrap_obj, wrap_obj
 
 from . import Extension
 from . import msgpack as _msgpack
 
+from collections.abc import Mapping
+
 __all__ = ["Codec", "std_ext"]
 
 
@@ -34,7 +36,7 @@ class Codec(_msgpack.Codec):
 @std_ext.encoder(5, DProxy)
 def _enc_dproxy(codec, obj):
     a = obj.a[:]
-    if obj.k or (a and isinstance(a[-1], dict)):
+    if obj.k or (a and isinstance(a[-1], Mapping)):
         a.append(obj.k)
     return codec.encode(obj.name) + b"".join(codec.encode(x) for x in a)
 
@@ -103,7 +105,7 @@ def _dec_proxy(codec, data):
     except UnicodeError:
         n = str(data)
     try:
-        return _CProxy[n]
+        return _lookup_proxy(n)
     except KeyError:
         return Proxy(n)
 

{moat_lib_codec-0.4.18 → moat_lib_codec-0.4.21}/src/moat/lib/codec/msgpack.py

@@ -27,6 +27,7 @@ from moat.lib.micro import byte2utf8, const
 from ._base import Codec as _Codec
 from ._base import NoCodecError
 
+from collections.abc import Mapping
 from typing import TYPE_CHECKING, cast
 
 if TYPE_CHECKING:
@@ -524,7 +525,7 @@ class Packer:
                     n -= 1
                     todo.append(obj[n])
                 continue
-            if is_(obj, dict):
+            if is_(obj, Mapping):
                 n = len(obj)
                 if n <= 0x0F:
                     wb(struct.pack("B", 0x80 + n))

moat_lib_codec-0.4.21/src/moat/lib/codec/null.py

@@ -0,0 +1,32 @@
+"""Null codec — accepts only ``None``.
+
+This codec exists as a placeholder, e.g. for use in conversion-vector
+trees to mark paths whose payload should be silently dropped by gateways.
+It encodes ``None`` to an empty byte string and refuses any other value.
+Decoding ignores the input and returns ``None``.
+"""
+
+from __future__ import annotations
+
+from ._base import Codec as _Codec
+
+from typing import Any
+
+
+class Codec(_Codec):
+    """Codec that only accepts :data:`None` as a value."""
+
+    def __init__(self, ext: Any | None = None) -> None:
+        if ext is not None:
+            raise ValueError("You can't extend the null codec")
+        super().__init__()
+
+    def encode(self, obj: Any) -> bytes:
+        """Encode :data:`None` to empty bytes; raise otherwise."""
+        if obj is None:
+            return b""
+        raise ValueError(f"The null codec only accepts None, not {obj!r}")
+
+    def decode(self, data: bytes | bytearray | memoryview) -> None:  # noqa: ARG002
+        """Discard ``data`` and return :data:`None`."""
+        return None

{moat_lib_codec-0.4.18 → moat_lib_codec-0.4.21}/src/moat/lib/codec/yaml.py

@@ -20,6 +20,7 @@ class Codec(_Codec):
             raise ValueError("You can't extend the JSON codec")
         super().__init__()
         self._buf = bytearray()
+        self._eof = False
 
     def encode(self, obj):
         "basic encoder"
@@ -32,10 +33,23 @@ class Codec(_Codec):
     def feed(self, data: ByteType) -> None:  # noqa: D102
         self._buf.extend(data)
 
+    def eof(self) -> None:  # noqa: D102
+        self._eof = True
+
     def __next__(self):
         i = self._buf.find(b"\n---\n")
-        if i < 0:
+        if i >= 0:
+            res = yload(self._buf[0 : i + 1].decode("utf-8", "surrogateescape"))
+            self._buf[0 : i + 5] = b""
+            return res
+        if not self._eof:
+            raise StopIteration
+
+        # last document, not terminated by "---"
+        rest = bytes(self._buf).strip()
+        self._buf.clear()
+        if rest.endswith(b"\n---"):
+            rest = rest[:-4]
+        if not rest or rest == b"---":
             raise StopIteration
-        res = yload(self._buf[0 : i + 1].decode("utf-8", "surrogateescape"))
-        self._buf[0 : i + 5] = b""
-        return res
+        return yload(rest.decode("utf-8", "surrogateescape"))

moat_lib_codec-0.4.21/src/moat_lib_codec.egg-info/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.4
+Name: moat-lib-codec
+Version: 0.4.21
+Summary: A simple command/stream multiplexer
+Author-email: Matthias Urlichs <matthias@urlichs.de>
+Maintainer-email: Matthias Urlichs <matthias@urlichs.de>
+Project-URL: homepage, https://m-o-a-t.org
+Project-URL: repository, https://github.com/M-o-a-T/moat
+Keywords: MoaT
+Classifier: Development Status :: 4 - Beta
+Classifier: Framework :: AnyIO
+Classifier: Framework :: Trio
+Classifier: Framework :: AsyncIO
+Classifier: Programming Language :: Python :: 3
+Classifier: Intended Audience :: Developers
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE.txt
+Requires-Dist: anyio~=4.2
+Requires-Dist: moat-lib-rpc~=0.7.6
+Requires-Dist: moat-lib-micro~=0.3.4
+Requires-Dist: moat-lib-proxy~=0.1.3
+Requires-Dist: moat-util~=0.64.0
+Dynamic: license-file
+
+# The MoaT-Codec library
+
+% start synopsis
+% start main
+
+This library packages various codecs used for MoaT protocols
+in a way that's reason- and stream-able.
+
+% end synopsis
+
+## Supplied codecs
+
+- CBOR
+- msgpack
+- no-op
+- UTF-8
+- JSON
+- YAML
+
+% end main
+
+## Interface
+
+### Codec
+
+- encode(obj)
+
+  Encode the object to a bytestream.
+
+- decode(bytes)
+
+  Decode the given bytes to a single object.
+
+- feed(bytes, final=False)
+
+  Data stream. Returns an array of objects.
+
+  This method only exists when a sequence of encoded objects can be streamed,
+  i.e. contains built-in message boundaries.
+
+  if @final is `True`, raise an exception if there is an incomplete
+  object in the buffer after this call.
+
+- getstate(), setstate(\*args)
+
+  A streaming decoder may store partially-decoded state (unprocessed
+  buffer) here.
+
+The list of accepted objects is implementation dependent.
+
+### Extension
+
+Extension types vary by whether they carry binary data as in (msgpack), or
+objects (as in cbor).
+
+- binary (classvar): True if msgpack-style, False if cbor-style
+
+- encoder(cls, key, fn)
+
+  Encode an object `obj` of type `type`. `fn(codec, obj)` must return
+  a bytestring / an encodeable object. If the registration key is `None`
+  the function must return a tuple with the key as first element.
+
+- decoder(key, fn)
+
+  Add a decoder (key, data) to an object. `fn(codec, data)` is called with a
+  bytestring / a decoded object, and returns whatever has been encoded.
+
+Extensions get the codec as their first argument. They can use it to store
+data, e.g. references. The extension object is available as `codec.ext`.

{moat_lib_codec-0.4.18 → moat_lib_codec-0.4.21}/src/moat_lib_codec.egg-info/SOURCES.txt

@@ -24,6 +24,7 @@ src/moat/lib/codec/moat_kv.py
 src/moat/lib/codec/moat_msgpack.py
 src/moat/lib/codec/msgpack.py
 src/moat/lib/codec/noop.py
+src/moat/lib/codec/null.py
 src/moat/lib/codec/utf8.py
 src/moat/lib/codec/yaml.py
 src/moat_lib_codec.egg-info/PKG-INFO

moat_lib_codec-0.4.21/src/moat_lib_codec.egg-info/requires.txt

@@ -0,0 +1,5 @@
+anyio~=4.2
+moat-lib-micro~=0.3.4
+moat-lib-proxy~=0.1.3
+moat-lib-rpc~=0.7.6
+moat-util~=0.64.0

moat_lib_codec-0.4.18/PKG-INFO

@@ -1,24 +0,0 @@
-Metadata-Version: 2.4
-Name: moat-lib-codec
-Version: 0.4.18
-Summary: A simple command/stream multiplexer
-Author-email: Matthias Urlichs <matthias@urlichs.de>
-Maintainer-email: Matthias Urlichs <matthias@urlichs.de>
-Project-URL: homepage, https://m-o-a-t.org
-Project-URL: repository, https://github.com/M-o-a-T/moat
-Keywords: MoaT
-Classifier: Development Status :: 4 - Beta
-Classifier: Framework :: AnyIO
-Classifier: Framework :: Trio
-Classifier: Framework :: AsyncIO
-Classifier: Programming Language :: Python :: 3
-Classifier: Intended Audience :: Developers
-Requires-Python: >=3.8
-Description-Content-Type: text/x-rst
-License-File: LICENSE.txt
-Requires-Dist: anyio~=4.2
-Requires-Dist: moat-lib-rpc~=0.7.0
-Requires-Dist: moat-lib-micro~=0.3.0
-Requires-Dist: moat-lib-proxy~=0.1.1
-Requires-Dist: moat-util~=0.63.0
-Dynamic: license-file

moat_lib_codec-0.4.18/src/moat_lib_codec.egg-info/PKG-INFO

@@ -1,24 +0,0 @@
-Metadata-Version: 2.4
-Name: moat-lib-codec
-Version: 0.4.18
-Summary: A simple command/stream multiplexer
-Author-email: Matthias Urlichs <matthias@urlichs.de>
-Maintainer-email: Matthias Urlichs <matthias@urlichs.de>
-Project-URL: homepage, https://m-o-a-t.org
-Project-URL: repository, https://github.com/M-o-a-T/moat
-Keywords: MoaT
-Classifier: Development Status :: 4 - Beta
-Classifier: Framework :: AnyIO
-Classifier: Framework :: Trio
-Classifier: Framework :: AsyncIO
-Classifier: Programming Language :: Python :: 3
-Classifier: Intended Audience :: Developers
-Requires-Python: >=3.8
-Description-Content-Type: text/x-rst
-License-File: LICENSE.txt
-Requires-Dist: anyio~=4.2
-Requires-Dist: moat-lib-rpc~=0.7.0
-Requires-Dist: moat-lib-micro~=0.3.0
-Requires-Dist: moat-lib-proxy~=0.1.1
-Requires-Dist: moat-util~=0.63.0
-Dynamic: license-file

moat_lib_codec-0.4.18/src/moat_lib_codec.egg-info/requires.txt

@@ -1,5 +0,0 @@
-anyio~=4.2
-moat-lib-micro~=0.3.0
-moat-lib-proxy~=0.1.1
-moat-lib-rpc~=0.7.0
-moat-util~=0.63.0