add missing import for format_context_trace, update docs

Author: NiklasRosenstein

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

@@ -1,6 +1,6 @@
 __version__ = "4.2.8"
 
-from .context import Context, Direction, Location
+from .context import Context, Direction, Location, format_context_trace
 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
@@ -44,6 +44,7 @@
     "Direction",
     "ExtraKeys",
     "Flattened",
+    "format_context_trace",
     "get_annotation_setting",
     "get_class_setting",
     "get_class_settings",

docs/content/core/basic-usage.md

@@ -12,8 +12,7 @@ from dataclasses import dataclass
 from urllib.parse import urlparse
 from typing import Any
 
-from databind.core.context import Context
-from databind.core.converter import Converter
+from databind.core import Context, Converter
 
 
 @dataclass
@@ -44,7 +43,7 @@ class URI:
 To use this new converter, you need to register it to an {@pylink databind.core.mapper.ObjectMapper} instance.
 
 ```python
-from databind.core.mapper import ObjectMapper
+from databind.core import ObjectMapper
 
 mapper = ObjectMapper()
 mapper.module.register(URI.URIConverter())
@@ -65,7 +64,7 @@ convenient methods to access settings that are relevant for the current value be
 
 ```python
 #  ...
-from databind.core.settings import BooleanSetting
+from databind.core import BooleanSetting
 
 
 @dataclass
@@ -100,7 +99,7 @@ The setting can now be specified when serializing a `URI` instance as a global s
 ```python
 # ...
 
-from databind.core.converter import NoMatchingConverter
+from databind.core import NoMatchingConverter
 from pytest import raises
 
 # When the setting is not enabled, the converter raises a NotImplementedError, having databind search for

docs/content/json/examples/unknown-keys.md

@@ -11,7 +11,7 @@ When using this setting, you can also record any unexpected keys so you can repo
 ```py
 # cat <<EOF | python -
 from dataclasses import dataclass
-from databind.core.settings import ExtraKeys
+from databind.core import ExtraKeys
 from databind.json import load
 
 @ExtraKeys()
@@ -31,7 +31,7 @@ assert load({"a": 42, "b": "ignored"}, MyClass) == MyClass(42)
 ```py
 # cat <<EOF | python -
 from dataclasses import dataclass
-from databind.core.settings import ExtraKeys
+from databind.core import ExtraKeys
 from databind.json import load
 from typing_extensions import Annotated
 
@@ -63,7 +63,7 @@ except for those that have a different setting "closer by" (you can use `ExtraKe
 ```py
 # cat <<EOF | python -
 from dataclasses import dataclass
-from databind.core.settings import ExtraKeys
+from databind.core import ExtraKeys
 from databind.json import load
 
 @dataclass
@@ -81,8 +81,7 @@ warn about unused keys in a payload.
 ```py
 # cat <<EOF | python -
 from dataclasses import dataclass
-from databind.core.settings import ExtraKeys
-from databind.core.context import format_context_trace
+from databind.core import format_context_trace, ExtraKeys
 from databind.json import load
 
 @dataclass