Tin/import cattrs (#203)

* Import cattrs first pass

* More import cattrs

* Update test_preconf

* Update docs

* Remove prints

* Fix check-wheel-contents

Author: Tinche

.github/workflows/main.yml

@@ -63,6 +63,6 @@ jobs:
       - name: "List result"
         run: "ls -l dist"
       - name: "Check wheel contents"
-        run: "check-wheel-contents dist/*.whl"
+        run: "check-wheel-contents --toplevel cattr,cattrs dist/*.whl"
       - name: "Check long_description"
         run: "python -m twine check dist/*"

HISTORY.rst

@@ -3,10 +3,11 @@ History
 =======
 1.10.0 (UNRELEASED)
 -------------------
-* Add PEP 563 (string annotations) for dataclasses.
+* Add PEP 563 (string annotations) support for dataclasses.
   (`#195 <https://github.com/python-attrs/cattrs/issues/195>`_)
 * Fix handling of dictionaries with string Enum keys for bson, orjson, and tomlkit.
 * Rename the ``cattr.gen.make_dict_unstructure_fn.omit_if_default`` parameter to ``_cattrs_omit_if_default``, for consistency. The ``omit_if_default`` parameters to ``GenConverter`` and ``override`` are unchanged.
+* Following the changes in ``attrs`` 21.3.0, add a ``cattrs`` package mirroring the existing ``cattr`` package. Both package names may be used as desired, and the ``cattr`` package isn't going away.
 
 1.9.0 (2021-12-06)
 ------------------

pyproject.toml

@@ -17,7 +17,8 @@ repository = "https://github.com/python-attrs/cattrs"
 documentation = "https://cattrs.readthedocs.io/en/latest/"
 keywords = ["attrs", "serialization", "dataclasses"]
 packages = [
-    { include = "cattr", from = "src" }
+    { include = "cattr", from = "src" },
+    { include = "cattrs", from = "src" },
 ]
 readme = "README.rst"
 

src/cattr/generics.py renamed to src/cattr/_generics.py

@@ -360,7 +360,7 @@ def _unstructure_union(self, obj):
     def _structure_error(self, _, cl):
         """At the bottom of the condition stack, we explode if we can't handle it."""
         msg = (
-            "Unsupported type: {0}. Register a structure hook for "
+            "Unsupported type: {0!r}. Register a structure hook for "
             "it.".format(cl)
         )
         raise StructureHandlerNotFoundError(msg, type_=cl)

src/cattr/converters.py

@@ -25,7 +25,7 @@
     is_bare,
     is_generic,
 )
-from .generics import deep_copy_with
+from ._generics import deep_copy_with
 
 if TYPE_CHECKING:  # pragma: no cover
     from cattr.converters import Converter

src/cattr/gen.py

@@ -0,0 +1,43 @@
+from cattr import (
+    Converter,
+    GenConverter,
+    UnstructureStrategy,
+    converters,
+    disambiguators,
+    dispatch,
+    errors,
+    gen,
+    global_converter,
+    override,
+    preconf,
+    register_structure_hook,
+    register_structure_hook_func,
+    register_unstructure_hook,
+    register_unstructure_hook_func,
+    structure,
+    structure_attrs_fromdict,
+    structure_attrs_fromtuple,
+    unstructure,
+)
+
+__all__ = (
+    "Converter",
+    "converters",
+    "disambiguators",
+    "dispatch",
+    "errors",
+    "gen",
+    "GenConverter",
+    "global_converter",
+    "override",
+    "preconf",
+    "register_structure_hook_func",
+    "register_structure_hook",
+    "register_unstructure_hook_func",
+    "register_unstructure_hook",
+    "structure_attrs_fromdict",
+    "structure_attrs_fromtuple",
+    "structure",
+    "unstructure",
+    "UnstructureStrategy",
+)

src/cattrs/__init__.py

@@ -0,0 +1,3 @@
+from cattr.converters import Converter, GenConverter, UnstructureStrategy
+
+__all__ = ["Converter", "GenConverter", "UnstructureStrategy"]

src/cattrs/converters.py

@@ -0,0 +1,3 @@
+from cattr.disambiguators import create_uniq_field_dis_func
+
+__all__ = ["create_uniq_field_dis_func"]

src/cattrs/disambiguators.py

@@ -0,0 +1,3 @@
+from cattr.dispatch import FunctionDispatch, MultiStrategyDispatch
+
+__all__ = ["FunctionDispatch", "MultiStrategyDispatch"]