u-msgpack-python 2.7.2__tar.gz → 2.9.0__tar.gz

{u-msgpack-python-2.7.2 → u_msgpack_python-2.9.0}/LICENSE

@@ -1,4 +1,4 @@
- Copyright (c) 2013-2022 vsergeev / Ivan (Vanya) A. Sergeev
+ Copyright (c) 2013-2026 vsergeev / Ivan (Vanya) A. Sergeev
 
  Permission is hereby granted, free of charge, to any person obtaining a copy
  of this software and associated documentation files (the "Software"), to deal

{u-msgpack-python-2.7.2 → u_msgpack_python-2.9.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: u-msgpack-python
-Version: 2.7.2
+Version: 2.9.0
 Summary: A portable, lightweight MessagePack serializer and deserializer written in pure Python.
 Home-page: https://github.com/vsergeev/u-msgpack-python
 Author: vsergeev
@@ -15,6 +15,17 @@ Classifier: Programming Language :: Python :: 2
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
+Description-Content-Type: text/x-rst
 License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: summary
 
-u-msgpack-python is a lightweight `MessagePack <http://msgpack.org/>`_ serializer and deserializer module written in pure Python, compatible with both Python 2 and Python 3, as well as CPython and PyPy implementations of Python. u-msgpack-python is fully compliant with the latest `MessagePack specification <https://github.com/msgpack/msgpack/blob/master/spec.md>`_. In particular, it supports the new binary, UTF-8 string, and application-defined ext types. See https://github.com/vsergeev/u-msgpack-python for more information.
+u-msgpack-python is a lightweight `MessagePack <http://msgpack.org/>`_ serializer and deserializer module written in pure Python, compatible with both Python 2 and Python 3, as well as CPython and PyPy implementations of Python. u-msgpack-python is fully compliant with the latest `MessagePack specification <https://github.com/msgpack/msgpack/blob/master/spec.md>`_. In particular, it supports the new binary, UTF-8 string, application-defined ext, and timestamp types. See https://github.com/vsergeev/u-msgpack-python for more information.

u_msgpack_python-2.9.0/README.md

@@ -0,0 +1,163 @@
+# u-msgpack-python [![Tests Status](https://github.com/vsergeev/u-msgpack-python/actions/workflows/tests.yml/badge.svg)](https://github.com/vsergeev/u-msgpack-python/actions/workflows/tests.yml) [![Docs Status](https://app.readthedocs.org/projects/u-msgpack-python/badge/)](https://u-msgpack-python.readthedocs.io/en/latest/) [![GitHub release](https://img.shields.io/github/release/vsergeev/u-msgpack-python.svg?maxAge=7200)](https://github.com/vsergeev/u-msgpack-python) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/vsergeev/u-msgpack-python/blob/master/LICENSE)
+
+u-msgpack-python is a lightweight [MessagePack](http://msgpack.org/) serializer and deserializer module written in pure Python, compatible with Python 2 and 3, as well as CPython and PyPy implementations of Python. u-msgpack-python is fully compliant with the latest [MessagePack specification](https://github.com/msgpack/msgpack/blob/master/spec.md). In particular, it supports the new binary, UTF-8 string, application-defined ext, and timestamp types.
+
+u-msgpack-python is currently distributed as a package on [PyPI](https://pypi.python.org/pypi/u-msgpack-python) and as a single file module.
+
+## Installation
+
+With pip:
+``` text
+$ pip install u-msgpack-python
+```
+
+or simply drop `umsgpack.py` into your project!
+``` text
+$ wget https://raw.github.com/vsergeev/u-msgpack-python/master/umsgpack/__init__.py -O umsgpack.py
+```
+
+## Examples
+
+Basic Example:
+``` python
+>>> import umsgpack
+>>> umsgpack.packb({u"compact": True, u"schema": 0})
+b'\x82\xa7compact\xc3\xa6schema\x00'
+>>> umsgpack.unpackb(_)
+{u'compact': True, u'schema': 0}
+>>> 
+```
+
+A more complicated example:
+``` python
+>>> umsgpack.packb([1, True, False, 0xffffffff, {u"foo": b"\x80\x01\x02", \
+...                 u"bar": [1,2,3, {u"a": [1,2,3,{}]}]}, -1, 2.12345])
+b'\x97\x01\xc3\xc2\xce\xff\xff\xff\xff\x82\xa3foo\xc4\x03\x80\x01\
+\x02\xa3bar\x94\x01\x02\x03\x81\xa1a\x94\x01\x02\x03\x80\xff\xcb\
+@\x00\xfc\xd3Z\x85\x87\x94'
+>>> umsgpack.unpackb(_)
+[1, True, False, 4294967295, {u'foo': b'\x80\x01\x02', \
+ u'bar': [1, 2, 3, {u'a': [1, 2, 3, {}]}]}, -1, 2.12345]
+>>> 
+```
+
+Streaming serialization with file-like objects:
+``` python
+>>> f = open('test.bin', 'wb')
+>>> umsgpack.pack({u"compact": True, u"schema": 0}, f)
+>>> umsgpack.pack([1,2,3], f)
+>>> f.close()
+>>> 
+>>> f = open('test.bin', 'rb')
+>>> umsgpack.unpack(f)
+{u'compact': True, u'schema': 0}
+>>> umsgpack.unpack(f)
+[1, 2, 3]
+>>> f.close()
+>>> 
+```
+
+Serializing and deserializing a raw Ext type:
+``` python
+>>> # Create an Ext object with type 5 and data b"\x01\x02\x03"
+... foo = umsgpack.Ext(5, b"\x01\x02\x03")
+>>> umsgpack.packb({u"stuff": foo, u"awesome": True})
+b'\x82\xa5stuff\xc7\x03\x05\x01\x02\x03\xa7awesome\xc3'
+>>> 
+>>> bar = umsgpack.unpackb(_)
+>>> print(bar['stuff'])
+Ext Object (Type: 5, Data: 0x01 0x02 0x03)
+>>> bar['stuff'].type
+5
+>>> bar['stuff'].data
+b'\x01\x02\x03'
+>>> 
+```
+
+Serializing and deserializing application-defined types with `ext_serializable()`:
+``` python
+>>> @umsgpack.ext_serializable(0x50)
+... class Point(collections.namedtuple('Point', ['x', 'y'])):
+...     def packb(self):
+...         return struct.pack(">ii", self.x, self.y)
+...     @staticmethod
+...     def unpackb(data):
+...         return Point(*struct.unpack(">ii", data))
+... 
+>>> umsgpack.packb(Point(1, 2))
+b'\xd7P\x00\x00\x00\x01\x00\x00\x00\x02'
+>>> umsgpack.unpackb(_)
+Point(x=1, y=2)
+>>> 
+```
+
+Serializing and deserializing application-defined types with Ext handlers:
+``` python
+>>> umsgpack.packb([complex(1,2), decimal.Decimal("0.31")],
+...  ext_handlers = {
+...   complex: lambda obj: umsgpack.Ext(0x30, struct.pack("ff", obj.real, obj.imag)),
+...   decimal.Decimal: lambda obj: umsgpack.Ext(0x40, str(obj).encode()),
+... })
+b'\x92\xd70\x00\x00\x80?\x00\x00\x00@\xd6@0.31'
+>>> umsgpack.unpackb(_,
+...  ext_handlers = {
+...   0x30: lambda ext: complex(*struct.unpack("ff", ext.data)),
+...   0x40: lambda ext: decimal.Decimal(ext.data.decode()),
+... })
+[(1+2j), Decimal('0.31')]
+>>> 
+```
+
+Python standard library style names `dump`, `dumps`, `load`, `loads` are also available:
+``` python
+>>> umsgpack.dumps({u"compact": True, u"schema": 0})
+b'\x82\xa7compact\xc3\xa6schema\x00'
+>>> umsgpack.loads(_)
+{u'compact': True, u'schema': 0}
+>>> 
+>>> f = open('test.bin', 'wb')
+>>> umsgpack.dump({u"compact": True, u"schema": 0}, f)
+>>> f.close()
+>>> 
+>>> f = open('test.bin', 'rb')
+>>> umsgpack.load(f)
+{u'compact': True, u'schema': 0}
+>>> 
+```
+
+## Documentation
+
+Documentation is hosted at [https://u-msgpack-python.readthedocs.io](https://u-msgpack-python.readthedocs.io).
+
+To build documentation locally with Sphinx, run:
+
+```
+cd docs
+make html
+```
+
+Sphinx will produce the HTML documentation in `docs/_build/html/`.
+
+Run `make help` to see other output targets (LaTeX, man, text, etc.).
+
+## Testing
+
+The included unit tests may be run with `test_umsgpack.py`, under your favorite interpreter.
+
+``` text
+$ python2 test_umsgpack.py
+$ python3 test_umsgpack.py
+$ pypy test_umsgpack.py
+$ pypy3 test_umsgpack.py
+```
+
+Alternatively, you can use `tox` or `detox` to test multiple Python versions at once.
+
+``` text
+$ pip install tox
+$ tox
+```
+
+## License
+
+u-msgpack-python is MIT licensed. See the included `LICENSE` file for more details.

{u-msgpack-python-2.7.2 → u_msgpack_python-2.9.0}/setup.cfg

@@ -1,6 +1,3 @@
-[metadata]
-description_file = README.md
-
 [bdist_wheel]
 universal = True
 

{u-msgpack-python-2.7.2 → u_msgpack_python-2.9.0}/setup.py

@@ -5,13 +5,15 @@ except ImportError:
 
 setup(
     name='u-msgpack-python',
-    version='2.7.2',
+    version='2.9.0',
     description='A portable, lightweight MessagePack serializer and deserializer written in pure Python.',
     author='vsergeev',
     author_email='v@sergeev.io',
     url='https://github.com/vsergeev/u-msgpack-python',
-    py_modules=['umsgpack'],
-    long_description="""u-msgpack-python is a lightweight `MessagePack <http://msgpack.org/>`_ serializer and deserializer module written in pure Python, compatible with both Python 2 and Python 3, as well as CPython and PyPy implementations of Python. u-msgpack-python is fully compliant with the latest `MessagePack specification <https://github.com/msgpack/msgpack/blob/master/spec.md>`_. In particular, it supports the new binary, UTF-8 string, and application-defined ext types. See https://github.com/vsergeev/u-msgpack-python for more information.""",
+    packages=['umsgpack'],
+    package_data={'umsgpack': ['*.pyi', 'py.typed']},
+    long_description="""u-msgpack-python is a lightweight `MessagePack <http://msgpack.org/>`_ serializer and deserializer module written in pure Python, compatible with both Python 2 and Python 3, as well as CPython and PyPy implementations of Python. u-msgpack-python is fully compliant with the latest `MessagePack specification <https://github.com/msgpack/msgpack/blob/master/spec.md>`_. In particular, it supports the new binary, UTF-8 string, application-defined ext, and timestamp types. See https://github.com/vsergeev/u-msgpack-python for more information.""",
+    long_description_content_type='text/x-rst',
     classifiers=[
         "Development Status :: 5 - Production/Stable",
         "License :: OSI Approved :: MIT License",

{u-msgpack-python-2.7.2 → u_msgpack_python-2.9.0}/test_umsgpack.py

@@ -381,6 +381,7 @@ exported_vars_test_vector = [
     "ReservedCodeException",
     "UnhashableKeyException",
     "DuplicateKeyException",
+    "MaximumDepthException",
     "KeyNotPrimitiveException",
     "KeyDuplicateException",
     "ext_serializable",
@@ -438,9 +439,9 @@ class TestUmsgpack(unittest.TestCase):
             # one we end up with depends on the architecture (32-bit/64-bit)
             if sys.version_info[0] == 2:
                 # Allow both {int,long} -> unpackb -> {int,long}
-                if isinstance(obj, int) or isinstance(obj, long):
+                if isinstance(obj, int) or isinstance(obj, long):  # noqa: F821
                     self.assertTrue(isinstance(unpacked, int) or
-                                    isinstance(unpacked, long))
+                                    isinstance(unpacked, long))  # noqa: F821
                 else:
                     self.assertTrue(isinstance(unpacked, type(obj)))
             # In Python3, we only have the int integer type
@@ -490,7 +491,7 @@ class TestUmsgpack(unittest.TestCase):
             # so convert any string obj to bytes before comparison
             if sys.version_info[0] == 3 and isinstance(obj, str):
                 _obj = obj.encode('utf-8')
-            elif sys.version_info[0] == 2 and isinstance(obj, unicode):
+            elif sys.version_info[0] == 2 and isinstance(obj, unicode):  # noqa: F821
                 _obj = bytes(obj)
             else:
                 _obj = obj
@@ -712,11 +713,6 @@ class TestUmsgpack(unittest.TestCase):
         with self.assertRaises(NotImplementedError):
             umsgpack.unpackb(b"\xd4\x21\x00")
 
-        # Unregister Ext serializable classes to prevent interference with
-        # subsequent tests
-        umsgpack._ext_classes_to_code = {}
-        umsgpack._ext_code_to_classes = {}
-
     def test_ext_serializable_subclass(self):
         @umsgpack.ext_serializable(0x10)
         class Rectangle:
@@ -746,17 +742,12 @@ class TestUmsgpack(unittest.TestCase):
         unpacked = umsgpack.unpackb(packed)
         self.assertEqual(unpacked, Rectangle(5, 5))
 
-        # Unregister Ext serializable classes to prevent interference with
-        # subsequent tests
-        umsgpack._ext_classes_to_code = {}
-        umsgpack._ext_code_to_classes = {}
-
     def test_streaming_writer(self):
         # Try first composite test vector
         (_, obj, data) = composite_test_vectors[0]
         writer = io.BytesIO()
         umsgpack.pack(obj, writer)
-        self.assertTrue(writer.getvalue(), data)
+        self.assertEqual(writer.getvalue(), data)
 
     def test_streaming_reader(self):
         # Try first composite test vector
@@ -764,12 +755,34 @@ class TestUmsgpack(unittest.TestCase):
         reader = io.BytesIO(data)
         self.assertEqual(umsgpack.unpack(reader), obj)
 
+    def test_max_depth_default_wraps_recursion(self):
+        # Default (no max_depth): deeply nested input must raise a
+        # MaximumDepthException (an UnpackException), not a bare RecursionError.
+        payload = b"\x91" * 5000 + b"\xc0"
+        self.assertRaises(umsgpack.MaximumDepthException, umsgpack.unpackb, payload)
+        self.assertRaises(umsgpack.UnpackException, umsgpack.unpackb, payload)
+        # Moderate nesting still works.
+        self.assertEqual(umsgpack.unpackb(b"\x91" * 100 + b"\xc0"),
+                         umsgpack.unpackb(b"\x91" * 100 + b"\xc0"))
+
+    def test_max_depth_cap_arrays_and_maps(self):
+        self.assertTrue(
+            umsgpack.unpackb(b"\x91" * 32 + b"\xc0", max_depth=32) is not None)
+        self.assertRaises(umsgpack.MaximumDepthException,
+                          umsgpack.unpackb, b"\x91" * 33 + b"\xc0", max_depth=32)
+        self.assertRaises(umsgpack.MaximumDepthException,
+                          umsgpack.unpackb, b"\x81\xa1k" * 17 + b"\xc0", max_depth=16)
+        # Siblings are not counted, only nesting depth.
+        self.assertEqual(
+            len(umsgpack.unpackb(b"\xdc\x00\xc8" + b"\xc0" * 200, max_depth=1)), 200)
+
     def test_namespacing(self):
         # Get a list of global variables from umsgpack module
         exported_vars = list([x for x in dir(umsgpack) if not x.startswith("_")])
         # Ignore imports
-        exported_vars = list([x for x in exported_vars if x != "struct" and x != "collections" and x != "datetime" and x !=
-                                    "sys" and x != "io" and x != "xrange" and x != "Hashable"])
+        ignore_vars = ["struct", "collections", "datetime", "sys", "io",
+                       "xrange", "Hashable", "functools"]
+        exported_vars = [x for x in exported_vars if x not in ignore_vars]
 
         self.assertTrue(len(exported_vars) == len(exported_vars_test_vector))
         for var in exported_vars_test_vector:

{u-msgpack-python-2.7.2 → u_msgpack_python-2.9.0}/u_msgpack_python.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: u-msgpack-python
-Version: 2.7.2
+Version: 2.9.0
 Summary: A portable, lightweight MessagePack serializer and deserializer written in pure Python.
 Home-page: https://github.com/vsergeev/u-msgpack-python
 Author: vsergeev
@@ -15,6 +15,17 @@ Classifier: Programming Language :: Python :: 2
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
+Description-Content-Type: text/x-rst
 License-File: LICENSE
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: license-file
+Dynamic: summary
 
-u-msgpack-python is a lightweight `MessagePack <http://msgpack.org/>`_ serializer and deserializer module written in pure Python, compatible with both Python 2 and Python 3, as well as CPython and PyPy implementations of Python. u-msgpack-python is fully compliant with the latest `MessagePack specification <https://github.com/msgpack/msgpack/blob/master/spec.md>`_. In particular, it supports the new binary, UTF-8 string, and application-defined ext types. See https://github.com/vsergeev/u-msgpack-python for more information.
+u-msgpack-python is a lightweight `MessagePack <http://msgpack.org/>`_ serializer and deserializer module written in pure Python, compatible with both Python 2 and Python 3, as well as CPython and PyPy implementations of Python. u-msgpack-python is fully compliant with the latest `MessagePack specification <https://github.com/msgpack/msgpack/blob/master/spec.md>`_. In particular, it supports the new binary, UTF-8 string, application-defined ext, and timestamp types. See https://github.com/vsergeev/u-msgpack-python for more information.

{u-msgpack-python-2.7.2 → u_msgpack_python-2.9.0}/u_msgpack_python.egg-info/SOURCES.txt

@@ -4,8 +4,10 @@ README.md
 setup.cfg
 setup.py
 test_umsgpack.py
-umsgpack.py
 u_msgpack_python.egg-info/PKG-INFO
 u_msgpack_python.egg-info/SOURCES.txt
 u_msgpack_python.egg-info/dependency_links.txt
-u_msgpack_python.egg-info/top_level.txt
+u_msgpack_python.egg-info/top_level.txt
+umsgpack/__init__.py
+umsgpack/__init__.pyi
+umsgpack/py.typed