improvement: Expose public API in databind.core root module.

Author: NiklasRosenstein

databind.core/.changelog/_unreleased.toml

@@ -3,3 +3,9 @@ id = "34f4cbf8-4bd4-4b6d-837f-6bf4b2006803"
 type = "feature"
 description = "Add `DeserializeAs` setting"
 author = "@NiklasRosenstein"
+
+[[entries]]
+id = "78606f4e-7b4c-4f88-9143-e40b12d86100"
+type = "improvement"
+description = "Expose public API in `databind.core` root module."
+author = "@NiklasRosenstein"

databind.core/src/databind/core/__init__.py

@@ -1 +1,66 @@
 __version__ = "4.2.8"
+
+from .context import Context, Direction, Location
+from .converter import ConversionError, Converter, DelegateToClassmethodConverter, Module, NoMatchingConverter
+from .mapper import ObjectMapper
+from .schema import Schema, convert_dataclass_to_schema, convert_to_schema, convert_typed_dict_to_schema
+from .settings import (
+    Alias,
+    BooleanSetting,
+    ClassDecoratorSetting,
+    DateFormat,
+    DeserializeAs,
+    ExtraKeys,
+    Flattened,
+    Precision,
+    Priority,
+    Remainder,
+    Required,
+    SerializeDefaults,
+    Setting,
+    Settings,
+    SettingsProvider,
+    Strict,
+    Union,
+    get_annotation_setting,
+    get_class_setting,
+    get_class_settings,
+    get_highest_setting,
+)
+
+__all__ = [
+    "Context",
+    "Direction",
+    "Location",
+    "Converter",
+    "ConversionError",
+    "NoMatchingConverter",
+    "DelegateToClassmethodConverter",
+    "Module",
+    "ObjectMapper",
+    "Schema",
+    "convert_dataclass_to_schema",
+    "convert_to_schema",
+    "convert_typed_dict_to_schema",
+    "Setting",
+    "Settings",
+    "SettingsProvider",
+    "SerializeDefaults",
+    "Alias",
+    "BooleanSetting",
+    "ClassDecoratorSetting",
+    "DateFormat",
+    "Precision",
+    "DeserializeAs",
+    "Union",
+    "ExtraKeys",
+    "Remainder",
+    "Strict",
+    "Flattened",
+    "Required",
+    "Priority",
+    "get_highest_setting",
+    "get_class_setting",
+    "get_annotation_setting",
+    "get_class_settings",
+]

databind.json/tests/test_converters.py

@@ -399,11 +399,13 @@ class MyClass:
         assert mapper.serialize(MyClass(A(1)), MyClass) == {"a": {"a": 1}}
     assert (
         str(excinfo.value)
-        == """expected test_converters.test_deserialize_as.<locals>.B, got test_converters.test_deserialize_as.<locals>.A instead
+        == """expected test_converters.test_deserialize_as.<locals>.B, got test_converters.test_deserialize_as.\
+<locals>.A instead
 
 Trace:
     $: TypeHint(test_converters.test_deserialize_as.<locals>.MyClass)
-    .a: TypeHint(typing_extensions.Annotated[test_converters.test_deserialize_as.<locals>.A, DeserializeAs(type=<class 'test_converters.test_deserialize_as.<locals>.B'>, priority=<Priority.NORMAL: 1>)])"""
+    .a: TypeHint(typing_extensions.Annotated[test_converters.test_deserialize_as.<locals>.A, DeserializeAs(type=<class \
+'test_converters.test_deserialize_as.<locals>.B'>, priority=<Priority.NORMAL: 1>)])"""
     )
 
     assert mapper.serialize(MyClass(B(2)), MyClass) == {"a": {"a": 2}}