py-serializable 2.0.0__tar.gz → 2.1.0__tar.gz

{py_serializable-2.0.0 → py_serializable-2.1.0}/CHANGELOG.md

@@ -1,131 +1,50 @@
 # CHANGELOG
 
 
-## Unreleased
 
-### Unknown
-
-* Delete duplicate CODEOWNERS (#156)
-
-we have a codeowners file in root already ([`b64cdde`](https://github.com/madpah/serializable/commit/b64cdde6d4561355f7b92416dfcb36a8ff770be5))
-
-
-
-## v2.0.0-alpha.1 (2025-01-16)
+## v2.0.0 (2025-02-09)
 
 ### Breaking
 
-* refactor!: rename installable `serializable` -> `py_serializable`
-
-Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com> ([`39bfc1a`](https://github.com/madpah/serializable/commit/39bfc1a3f20efdb75be3b14e9bfa845dc1f62142))
+* refactor!: rename python package `serializable` -> `py_serializable` (#155)
 
-### Chore
-
-* chore: Create CODEOWNERS ([`960331a`](https://github.com/madpah/serializable/commit/960331ad5181b64afa140d1fd0d2d59b687d782b))
-
-* chore(deps-dev): update mypy requirement from 1.13.0 to 1.14.1 (#154)
-
-Updates the requirements on [mypy](https://github.com/python/mypy) to permit the latest version.
-- [Changelog](https://github.com/python/mypy/blob/master/CHANGELOG.md)
-- [Commits](https://github.com/python/mypy/compare/v1.13.0...v1.14.1)
+The python package was renamed from `serializable` to `py_serializable`.
+Therefore, you need to adjust your imports.
 
----
-updated-dependencies:
-- dependency-name: mypy
-  dependency-type: direct:development
-...
+The following shows a quick way to adjust imports in the most efficient way.
 
-Signed-off-by: dependabot[bot] <support@github.com>
-Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> ([`afe70c8`](https://github.com/madpah/serializable/commit/afe70c81e20ac678bfeaedd2588083d5ba4ab4d5))
-
-* chore(deps-dev): update flake8-bugbear requirement (#150)
-
-Updates the requirements on [flake8-bugbear](https://github.com/PyCQA/flake8-bugbear) to permit the latest version.
-- [Release notes](https://github.com/PyCQA/flake8-bugbear/releases)
-- [Commits](https://github.com/PyCQA/flake8-bugbear/compare/24.10.31...24.12.12)
-
----
-updated-dependencies:
-- dependency-name: flake8-bugbear
-  dependency-type: direct:development
-...
-
-Signed-off-by: dependabot[bot] <support@github.com>
-Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> ([`cb8a91b`](https://github.com/madpah/serializable/commit/cb8a91b6c5a42f5a46379adc272ec8fa4cc2cc37))
-
-* chore(deps-dev): update flake8-bugbear requirement (#146)
-
-Updates the requirements on [flake8-bugbear](https://github.com/PyCQA/flake8-bugbear) to permit the latest version.
-- [Release notes](https://github.com/PyCQA/flake8-bugbear/releases)
-- [Commits](https://github.com/PyCQA/flake8-bugbear/compare/24.8.19...24.10.31)
+### OLD imports
+```py
+import serializable
+from serializable import ViewType, XmlArraySerializationType, XmlStringSerializationType
+from serializable.helpers import BaseHelper, Iso8601Date
+```
 
----
-updated-dependencies:
-- dependency-name: flake8-bugbear
-  dependency-type: direct:development
-...
+### ADJUSTED imports
+```py
+import py_serializable as serializable
+from py_serializable import ViewType, XmlArraySerializationType, XmlStringSerializationType
+from py_serializable.helpers import BaseHelper, Iso8601Date
+```
 
-Signed-off-by: dependabot[bot] <support@github.com>
-Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> ([`f6574e7`](https://github.com/madpah/serializable/commit/f6574e757695a4afc6922138a5e3cc8bdade2142))
-
-* chore(deps-dev): update mypy requirement from 1.12.0 to 1.13.0 (#145)
-
-Updates the requirements on [mypy](https://github.com/python/mypy) to permit the latest version.
-- [Changelog](https://github.com/python/mypy/blob/master/CHANGELOG.md)
-- [Commits](https://github.com/python/mypy/compare/v1.12.0...v1.13.0)
+see migration path: <https://py-serializable.readthedocs.io/en/refactor-rename-installable-py_serializable/migration.html>
 
----
-updated-dependencies:
-- dependency-name: mypy
-  dependency-type: direct:development
-...
+----
 
-Signed-off-by: dependabot[bot] <support@github.com>
-Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> ([`c5117ba`](https://github.com/madpah/serializable/commit/c5117ba0ef716b8cc7a3f1d639df585bba36f5e3))
-
-* chore(deps-dev): update mypy requirement from 1.11.2 to 1.12.0 (#143)
-
-Updates the requirements on [mypy](https://github.com/python/mypy) to permit the latest version.
-- [Changelog](https://github.com/python/mypy/blob/master/CHANGELOG.md)
-- [Commits](https://github.com/python/mypy/compare/v1.11.2...v1.12.0)
+fixes #151
 
----
-updated-dependencies:
-- dependency-name: mypy
-  dependency-type: direct:development
-...
+---------
 
-Signed-off-by: dependabot[bot] <support@github.com>
-Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> ([`6c354e2`](https://github.com/madpah/serializable/commit/6c354e2ef3ec276d624553e29adb705c9d9f33ec))
+Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com>
+Signed-off-by: semantic-release <semantic-release>
+Co-authored-by: semantic-release <semantic-release> ([`67afaef`](https://github.com/madpah/serializable/commit/67afaef4a5e670c533409f1ccbc3d2dbb263d2de))
 
 ### Unknown
 
-* Merge branch 'main' into refactor/rename-installable-py_serializable ([`5b62208`](https://github.com/madpah/serializable/commit/5b622084eb016765096679451ce15801c45d707d))
-
 * Delete duplicate CODEOWNERS (#156)
 
 we have a codeowners file in root already ([`b64cdde`](https://github.com/madpah/serializable/commit/b64cdde6d4561355f7b92416dfcb36a8ff770be5))
 
-* docs
-
-Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com> ([`e3708ec`](https://github.com/madpah/serializable/commit/e3708ec0fbd23a3705a5fe49c8a31293bbf7446f))
-
-* docs
-
-Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com> ([`225b614`](https://github.com/madpah/serializable/commit/225b614346f89a04cce759fc617a42d647f8a4a9))
-
-* docs
-
-Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com> ([`a581861`](https://github.com/madpah/serializable/commit/a58186100361e48135b630a42bc5b5929af3dd15))
-
-* docs
-
-Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com> ([`2df3e21`](https://github.com/madpah/serializable/commit/2df3e21012fc9499bf47236fb85925394b3bfc2d))
-
-* style
-
-Signed-off-by: Jan Kowalleck <jan.kowalleck@gmail.com> ([`42cf87b`](https://github.com/madpah/serializable/commit/42cf87bb30c4cf2d19eba4a86c20fa198ff48208))
-
 
 ## v1.1.2 (2024-10-01)
 

{py_serializable-2.0.0 → py_serializable-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: py-serializable
-Version: 2.0.0
+Version: 2.1.0
 Summary: Library for serializing and deserializing Python Objects to and from JSON and XML.
 License: Apache-2.0
 Keywords: serialization,deserialization,JSON,XML

{py_serializable-2.0.0 → py_serializable-2.1.0}/docs/conf.py

@@ -24,7 +24,7 @@ author = 'Paul Horton'
 
 # The full version, including alpha/beta/rc tags
 # !! version is managed by semantic_release
-release = "2.0.0"
+release = "2.1.0"
 
 # -- General configuration ---------------------------------------------------
 

{py_serializable-2.0.0 → py_serializable-2.1.0}/py_serializable/__init__.py

@@ -1,5 +1,3 @@
-# encoding: utf-8
-
 # This file is part of py-serializable
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -60,7 +58,7 @@ import typing  # noqa: F401 # isort: skip
 
 # !! version is managed by semantic_release
 # do not use typing here, or else `semantic_release` might have issues finding the variable
-__version__ = '2.0.0'
+__version__ = '2.1.0'
 
 _logger = getLogger(__name__)
 _logger.addHandler(NullHandler())
@@ -322,10 +320,10 @@ class _JsonSerializable(Protocol):
 
         _data = copy(data)
         for k, v in data.items():
+            del _data[k]
             decoded_k = CurrentFormatter.formatter.decode(property_name=k)
             if decoded_k in klass.ignore_during_deserialization:
                 _logger.debug('Ignoring %s when deserializing %s.%s', k, cls.__module__, cls.__qualname__)
-                del _data[k]
                 continue
 
             new_key = None
@@ -338,13 +336,14 @@ class _JsonSerializable(Protocol):
                 new_key = decoded_k
 
             if new_key is None:
+                if klass.ignore_unknown_during_deserialization:
+                    _logger.debug('Ignoring %s when deserializing %s.%s', k, cls.__module__, cls.__qualname__)
+                    continue
                 _logger.error('Unexpected key %s/%s in data being serialized to %s.%s',
                               k, decoded_k, cls.__module__, cls.__qualname__)
                 raise ValueError(
                     f'Unexpected key {k}/{decoded_k} in data being serialized to {cls.__module__}.{cls.__qualname__}'
                 )
-
-            del (_data[k])
             _data[new_key] = v
 
         for k, v in _data.items():
@@ -595,6 +594,9 @@ class _XmlSerializable(Protocol):
 
             prop_info = klass_properties.get(decoded_k)
             if not prop_info:
+                if klass.ignore_unknown_during_deserialization:
+                    _logger.debug('Ignoring %s when deserializing %s.%s', decoded_k, cls.__module__, cls.__qualname__)
+                    continue
                 raise ValueError(f'Non-primitive types not supported from XML Attributes - see {decoded_k} for '
                                  f'{cls.__module__}.{cls.__qualname__} which has Prop Metadata: {prop_info}')
 
@@ -648,6 +650,11 @@ class _XmlSerializable(Protocol):
 
             prop_info = klass_properties.get(decoded_k)
             if not prop_info:
+                if klass.ignore_unknown_during_deserialization:
+                    _logger.debug('Ignoring %s when deserializing %s.%s', decoded_k, cls.__module__, cls.__qualname__)
+                    continue
+                _logger.error('Unexpected key %s/%s in data being serialized to %s.%s',
+                              k, decoded_k, cls.__module__, cls.__qualname__)
                 raise ValueError(f'{decoded_k} is not a known Property for {cls.__module__}.{cls.__qualname__}')
 
             try:
@@ -760,7 +767,12 @@ class ObjectMetadataLibrary:
 
         def __init__(self, *, klass: type, custom_name: Optional[str] = None,
                      serialization_types: Optional[Iterable[SerializationType]] = None,
-                     ignore_during_deserialization: Optional[Iterable[str]] = None) -> None:
+                     ignore_during_deserialization: Optional[Iterable[str]] = None,
+                     ignore_unknown_during_deserialization: bool = False) -> None:
+            # param ignore_unknown_during_deserialization defaults to False, since we deserialize from JSON/XML
+            # and both have mechanisms for arbitrary content that might be intended to pass to the constructors:
+            # - JSON has `additionalProperties:true`
+            # - XML has `##any` and `##other`
             self._name = str(klass.__name__)
             self._klass = klass
             self._custom_name = custom_name
@@ -768,6 +780,7 @@ class ObjectMetadataLibrary:
                 serialization_types = _DEFAULT_SERIALIZATION_TYPES
             self._serialization_types = serialization_types
             self._ignore_during_deserialization = set(ignore_during_deserialization or ())
+            self._ignore_unknown_during_deserialization = ignore_unknown_during_deserialization
 
         @property
         def name(self) -> str:
@@ -789,6 +802,10 @@ class ObjectMetadataLibrary:
         def ignore_during_deserialization(self) -> Set[str]:
             return self._ignore_during_deserialization
 
+        @property
+        def ignore_unknown_during_deserialization(self) -> bool:
+            return self._ignore_unknown_during_deserialization
+
         def __repr__(self) -> str:
             return f'<s.oml.SerializableClass name={self.name}>'
 
@@ -1096,14 +1113,20 @@ class ObjectMetadataLibrary:
     @classmethod
     def register_klass(cls, klass: Type[_T], custom_name: Optional[str],
                        serialization_types: Iterable[SerializationType],
-                       ignore_during_deserialization: Optional[Iterable[str]] = None
+                       ignore_during_deserialization: Optional[Iterable[str]] = None,
+                       ignore_unknown_during_deserialization: bool = False
                        ) -> Intersection[Type[_T], Type[_JsonSerializable], Type[_XmlSerializable]]:
+        # param ignore_unknown_during_deserialization defaults to False, since we deserialize from JSON/XML
+        # and both have mechanisms for arbitrary content that might be intended to pass to the constructors:
+        # - JSON has `additionalProperties:true`
+        # - XML has `##any` and `##other`
         if cls.is_klass_serializable(klass=klass):
             return klass
 
         cls.klass_mappings[f'{klass.__module__}.{klass.__qualname__}'] = ObjectMetadataLibrary.SerializableClass(
             klass=klass, serialization_types=serialization_types,
-            ignore_during_deserialization=ignore_during_deserialization
+            ignore_during_deserialization=ignore_during_deserialization,
+            ignore_unknown_during_deserialization=ignore_unknown_during_deserialization
         )
 
         qualified_class_name = f'{klass.__module__}.{klass.__qualname__}'
@@ -1243,7 +1266,8 @@ def serializable_class(
     cls: Literal[None] = None, *,
     name: Optional[str] = ...,
     serialization_types: Optional[Iterable[SerializationType]] = ...,
-    ignore_during_deserialization: Optional[Iterable[str]] = ...
+    ignore_during_deserialization: Optional[Iterable[str]] = ...,
+    ignore_unknown_during_deserialization: bool = ...
 ) -> Callable[[Type[_T]], Intersection[Type[_T], Type[_JsonSerializable], Type[_XmlSerializable]]]:
     ...
 
@@ -1253,7 +1277,8 @@ def serializable_class(  # type:ignore[misc] # mypy on py37
     cls: Type[_T], *,
     name: Optional[str] = ...,
     serialization_types: Optional[Iterable[SerializationType]] = ...,
-    ignore_during_deserialization: Optional[Iterable[str]] = ...
+    ignore_during_deserialization: Optional[Iterable[str]] = ...,
+    ignore_unknown_during_deserialization: bool = ...
 ) -> Intersection[Type[_T], Type[_JsonSerializable], Type[_XmlSerializable]]:
     ...
 
@@ -1262,7 +1287,8 @@ def serializable_class(
     cls: Optional[Type[_T]] = None, *,
     name: Optional[str] = None,
     serialization_types: Optional[Iterable[SerializationType]] = None,
-    ignore_during_deserialization: Optional[Iterable[str]] = None
+    ignore_during_deserialization: Optional[Iterable[str]] = None,
+    ignore_unknown_during_deserialization: bool = False
 ) -> Union[
     Callable[[Type[_T]], Intersection[Type[_T], Type[_JsonSerializable], Type[_XmlSerializable]]],
     Intersection[Type[_T], Type[_JsonSerializable], Type[_XmlSerializable]]
@@ -1274,15 +1300,22 @@ def serializable_class(
     :param name: Alternative name to use for this Class
     :param serialization_types: Serialization Types that are to be supported for this class.
     :param ignore_during_deserialization: List of properties/elements to ignore during deserialization
+    :param ignore_unknown_during_deserialization: Whether to ignore all properties/elements/attributes that are unknown
+           to the class during deserialization
     :return:
     """
+    # param ignore_unknown_during_deserialization defaults to False, since we deserialize from JSON/XML
+    # and both have mechanisms for arbitrary content that might be intended to pass to the constructors:
+    # - JSON has `additionalProperties:true`
+    # - XML has `##any` and `##other`
     if serialization_types is None:
         serialization_types = _DEFAULT_SERIALIZATION_TYPES
 
     def decorate(kls: Type[_T]) -> Intersection[Type[_T], Type[_JsonSerializable], Type[_XmlSerializable]]:
         ObjectMetadataLibrary.register_klass(
             klass=kls, custom_name=name, serialization_types=serialization_types or [],
-            ignore_during_deserialization=ignore_during_deserialization
+            ignore_during_deserialization=ignore_during_deserialization,
+            ignore_unknown_during_deserialization=ignore_unknown_during_deserialization
         )
         return kls
 

{py_serializable-2.0.0 → py_serializable-2.1.0}/py_serializable/formatters.py

@@ -1,5 +1,3 @@
-# encoding: utf-8
-
 # This file is part of py-serializable
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

{py_serializable-2.0.0 → py_serializable-2.1.0}/py_serializable/helpers.py

@@ -1,5 +1,3 @@
-# encoding: utf-8
-
 # This file is part of py-serializable
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

{py_serializable-2.0.0 → py_serializable-2.1.0}/py_serializable/json.py

@@ -1,5 +1,3 @@
-# encoding: utf-8
-
 # This file is part of py-serializable
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

{py_serializable-2.0.0 → py_serializable-2.1.0}/py_serializable/xml.py

@@ -1,5 +1,3 @@
-# encoding: utf-8
-
 # This file is part of py-serializable
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

{py_serializable-2.0.0 → py_serializable-2.1.0}/pyproject.toml

@@ -5,7 +5,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "py-serializable"
-version = "2.0.0"
+version = "2.1.0"
 description = "Library for serializing and deserializing Python Objects to and from JSON and XML."
 authors = ["Paul Horton <paul.horton@owasp.org>"]
 maintainers = [
@@ -64,13 +64,14 @@ xmldiff = "2.7.0"
 mypy =  "1.14.1"
 autopep8 = "2.3.1"
 isort = "5.13.2"
-flake8 = { version="7.1.1", python=">=3.8.1" }
+flake8 = { version="7.1.2", python=">=3.8.1" }
 flake8-annotations = { version="3.1.1", python=">=3.8.1" }
 flake8-bugbear = { version="24.12.12", python=">=3.8.1" }
 flake8-isort = "6.1.1"
 flake8-quotes = "3.4.0"
 flake8-use-fstring = "1.4"
 flake8-logging = "1.6.0"
+pyupgrade = { version="3.20.0", python=">=3.9" }
 
 
 

{py_serializable-2.0.0 → py_serializable-2.1.0}/tests/__init__.py

@@ -1,5 +1,3 @@
-# encoding: utf-8
-
 # This file is part of py-serializable
 #
 # Licensed under the Apache License, Version 2.0 (the "License");

{py_serializable-2.0.0 → py_serializable-2.1.0}/tests/base.py

@@ -1,5 +1,3 @@
-# encoding: utf-8
-
 # This file is part of py-serializable
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
@@ -62,7 +60,7 @@ class BaseTestCase(TestCase):
                          f'There are XML differences: {diff_results!r}\n- {a!s}\n+ {b!s}')
 
 
-class DeepCompareMixin(object):
+class DeepCompareMixin:
     def assertDeepEqual(self: Union[TestCase, 'DeepCompareMixin'],
                         first: Any, second: Any, msg: Optional[str] = None) -> None:
         """costly compare, but very verbose"""

py_serializable-2.1.0/tests/fixtures/the-phoenix-project-defaultNS-isset.SNAPSHOT.xml

@@ -0,0 +1 @@
+<book xmlns="http://the.phoenix.project/testing/defaultNS" isbnNumber="978-1942788294"><id>f3758bf0-0ff7-4366-a5e5-c209d4352b2d</id><title>{X} The Phoenix Project</title><edition number="5">5th Anniversary Limited Edition</edition><publishDate>2018-04-16</publishDate><author>Karl Ranseier</author><type>fiction</type><publisher><name>IT Revolution Press LLC</name></publisher><chapters><chapter><number>1</number><title>Tuesday, September 2</title></chapter><chapter><number>2</number><title>Tuesday, September 2</title></chapter><chapter><number>3</number><title>Tuesday, September 2</title></chapter><chapter><number>4</number><title>Wednesday, September 3</title></chapter></chapters><rating>9.8</rating></book>

py_serializable-2.1.0/tests/fixtures/the-phoenix-project-defaultNS-unset.SNAPSHOT.xml

@@ -0,0 +1 @@
+<ns0:book xmlns:ns0="http://the.phoenix.project/testing/defaultNS" ns0:isbnNumber="978-1942788294"><ns0:id>f3758bf0-0ff7-4366-a5e5-c209d4352b2d</ns0:id><ns0:title>{X} The Phoenix Project</ns0:title><ns0:edition ns0:number="5">5th Anniversary Limited Edition</ns0:edition><ns0:publishDate>2018-04-16</ns0:publishDate><ns0:author>Karl Ranseier</ns0:author><ns0:type>fiction</ns0:type><ns0:publisher><ns0:name>IT Revolution Press LLC</ns0:name></ns0:publisher><ns0:chapters><ns0:chapter><ns0:number>1</ns0:number><ns0:title>Tuesday, September 2</ns0:title></ns0:chapter><ns0:chapter><ns0:number>2</ns0:number><ns0:title>Tuesday, September 2</ns0:title></ns0:chapter><ns0:chapter><ns0:number>3</ns0:number><ns0:title>Tuesday, September 2</ns0:title></ns0:chapter><ns0:chapter><ns0:number>4</ns0:number><ns0:title>Wednesday, September 3</ns0:title></ns0:chapter></ns0:chapters><ns0:rating>9.8</ns0:rating></ns0:book>

py_serializable-2.1.0/tests/fixtures/the-phoenix-project_unknown_ignored_attributes.xml

@@ -0,0 +1,54 @@
+<?xml version='1.0' encoding='utf-8'?>
+<book xmlns="http://the.phoenix.project/testing/defaultNS"
+      xmlns:foo="https://example.com/foo"
+      something_to_be_ignored="foo"
+      isbnNumber="978-1942788294"
+      ignore_me="bar"
+>
+    <!-- some attributes are registered to be ignored -->
+    <id>f3758bf0-0ff7-4366-a5e5-c209d4352b2d</id>
+    <title>{X} The Phoenix Project</title>
+    <edition number="5">5th Anniversary Limited Edition</edition>
+    <publishDate>2018-04-16</publishDate>
+    <author>Kevin Behr</author>
+    <author>George Spafford</author>
+    <author>Gene Kim</author>
+    <type>fiction</type>
+    <publisher foo:my-other-attribute="my-value"
+               unknown-other-attribute="some-value"
+    >
+        <address>10 Downing Street</address>
+        <name>IT Revolution Press LLC</name>
+    </publisher>
+    <references>
+        <reference ref="my-ref-2">
+            <reference ref="sub-ref-3"/>
+            <reference ref="sub-ref-1"/>
+        </reference>
+        <reference ref="my-ref-1"/>
+        <reference ref="my-ref-3">
+            <reference ref="sub-ref-2"/>
+        </reference>
+    </references>
+    <chapters>
+        <chapter>
+            <number>1</number>
+            <title>Tuesday, September 2</title>
+        </chapter>
+        <chapter>
+            <number>2</number>
+            <title>Tuesday, September 2</title>
+        </chapter>
+        <chapter>
+            <number>3</number>
+            <title>Tuesday, September 2</title>
+        </chapter>
+        <chapter>
+            <number>4</number>
+            <title>Wednesday, September 3</title>
+        </chapter>
+    </chapters>
+    <rating>9.8</rating>
+    <stockId>stock-id-1</stockId>
+    <stockId>stock-id-2</stockId>
+</book>

py_serializable-2.1.0/tests/fixtures/the-phoenix-project_unknown_ignored_elements.xml

@@ -0,0 +1,59 @@
+<?xml version='1.0' encoding='utf-8'?>
+<book xmlns="http://the.phoenix.project/testing/defaultNS"
+      xmlns:foo="https://example.com/foo"
+      isbnNumber="978-1942788294"
+>
+    <!-- some elements are registered to be ignored -->
+    <something_to_be_ignored>foo</something_to_be_ignored>>
+    <id>f3758bf0-0ff7-4366-a5e5-c209d4352b2d</id>
+    <title>{X} The Phoenix Project</title>
+    <edition number="5">5th Anniversary Limited Edition</edition>
+    <publishDate>2018-04-16</publishDate>
+    <author>Gene Kim</author>
+    <author>George Spafford</author>
+    <author>Kevin Behr</author>
+    <type>fiction</type>
+    <ignore_me>bar</ignore_me>
+    <publisher>
+        <address>10 Downing Street</address>
+        <foo:my-unknown-element>some-value</foo:my-unknown-element>
+        <other-unknwon-elemment-bar xmlns="https://example.com/bar"
+                                    bar-thing="the-value"
+        >
+            <bar-elem>some-other-value</bar-elem>
+        </other-unknwon-elemment-bar>
+        <name>IT Revolution Press LLC</name>
+    </publisher>
+    <references>
+        <reference ref="my-ref-2">
+            <reference ref="sub-ref-3"/>
+            <reference ref="sub-ref-1"/>
+        </reference>
+        <reference ref="my-ref-3">
+            <reference ref="sub-ref-2"/>
+        </reference>
+        <reference ref="my-ref-1"/>
+    </references>
+    <chapters>
+        <chapter>
+            <number>1</number>
+            <title>Tuesday, September 2</title>
+        </chapter>
+        <chapter>
+            <number>2</number>
+            <title>Tuesday, September 2</title>
+        </chapter>
+        <chapter>
+            <number>3</number>
+            <title>Tuesday, September 2</title>
+        </chapter>
+        <chapter>
+            <number>4</number>
+            <title>Wednesday, September 3</title>
+        </chapter>
+    </chapters>
+    <rating>9.8</rating>
+    <stockId>stock-id-2</stockId>
+    <stockId>stock-id-1</stockId>
+    <ignored>bazz</ignored>
+</book>

py_serializable-2.1.0/tests/fixtures/the-phoenix-project_unknown_ignored_properties.json

@@ -0,0 +1,66 @@
+{
+  "$comment": "some properties are registered as ignored",
+  "something_to_be_ignored": "foo",
+  "authors": [
+    "Kevin Behr",
+    "Gene Kim",
+    "George Spafford"
+  ],
+  "chapters": [
+    {
+      "number": 1,
+      "title": "Tuesday, September 2"
+    },
+    {
+      "number": 2,
+      "title": "Tuesday, September 2"
+    },
+    {
+      "number": 3,
+      "title": "Tuesday, September 2"
+    },
+    {
+      "number": 4,
+      "title": "Wednesday, September 3"
+    }
+  ],
+  "ignored": "bar",
+  "edition": {
+    "name": "5th Anniversary Limited Edition",
+    "number": 5
+  },
+  "id": "f3758bf0-0ff7-4366-a5e5-c209d4352b2d",
+  "isbnNumber": "978-1942788294",
+  "publishDate": "2018-04-16",
+  "publisher": {
+    "address": "10 Downing Street",
+    "name": "IT Revolution Press LLC",
+    "other-unknown-property": "my-value"
+  },
+  "rating": 9.8,
+  "references": [
+    {
+      "reference": "my-ref-3",
+      "refersTo": [
+        "sub-ref-2"
+      ]
+    },
+    {
+      "reference": "my-ref-1"
+    },
+    {
+      "reference": "my-ref-2",
+      "refersTo": [
+        "sub-ref-1",
+        "sub-ref-3"
+      ]
+    }
+  ],
+  "stockIds": [
+    "stock-id-1",
+    "stock-id-2"
+  ],
+  "title": "{J} The Phoenix Project",
+  "type": "fiction",
+  "ignore_me": "bazz"
+}