TypeDAL 4.5.0__tar.gz → 4.6.0__tar.gz

typedal-4.6.0/.crush/.gitignore

@@ -0,0 +1 @@
+*

typedal-4.6.0/.crush/logs/crush.log

@@ -0,0 +1,19 @@
+{"time":"2026-03-13T20:12:28.275088774+01:00","level":"INFO","source":{"function":"github.com/charmbracelet/crush/internal/config.(*catwalkSync).Get.func1","file":"github.com/charmbracelet/crush/internal/config/catwalk.go","line":55},"msg":"Fetching providers from Catwalk"}
+{"time":"2026-03-13T20:12:28.486572096+01:00","level":"INFO","source":{"function":"github.com/charmbracelet/crush/internal/config.(*catwalkSync).Get.func1","file":"github.com/charmbracelet/crush/internal/config/catwalk.go","line":63},"msg":"Catwalk providers not modified"}
+{"time":"2026-03-13T20:12:28.486667656+01:00","level":"WARN","source":{"function":"github.com/charmbracelet/crush/internal/config.(*Config).configureProviders","file":"github.com/charmbracelet/crush/internal/config/load.go","line":296},"msg":"Skipping provider due to missing API key","provider":"anthropic"}
+{"time":"2026-03-13T20:12:28.497862335+01:00","level":"INFO","msg":"OK   20250424200609_initial.sql (1.55ms)"}
+{"time":"2026-03-13T20:12:28.498184106+01:00","level":"INFO","msg":"OK   20250515105448_add_summary_message_id.sql (300.3µs)"}
+{"time":"2026-03-13T20:12:28.498510046+01:00","level":"INFO","msg":"OK   20250624000000_add_created_at_indexes.sql (298.08µs)"}
+{"time":"2026-03-13T20:12:28.498811912+01:00","level":"INFO","msg":"OK   20250627000000_add_provider_to_messages.sql (289.51µs)"}
+{"time":"2026-03-13T20:12:28.499108738+01:00","level":"INFO","msg":"OK   20250810000000_add_is_summary_message.sql (245.48µs)"}
+{"time":"2026-03-13T20:12:28.499362065+01:00","level":"INFO","msg":"OK   20250812000000_add_todos_to_sessions.sql (241.95µs)"}
+{"time":"2026-03-13T20:12:28.499726903+01:00","level":"INFO","msg":"OK   20260127000000_add_read_files_table.sql (351.05µs)"}
+{"time":"2026-03-13T20:12:28.499731494+01:00","level":"INFO","msg":"goose: successfully migrated database to version: 20260127000000"}
+{"time":"2026-03-13T20:12:28.50106094+01:00","level":"INFO","source":{"function":"github.com/charmbracelet/crush/internal/agent/tools/mcp.Initialize","file":"github.com/charmbracelet/crush/internal/agent/tools/mcp/init.go","line":167},"msg":"Initializing MCP clients"}
+{"time":"2026-03-13T20:12:31.915239786+01:00","level":"INFO","source":{"function":"github.com/charmbracelet/crush/internal/config.(*catwalkSync).Get.func1","file":"github.com/charmbracelet/crush/internal/config/catwalk.go","line":55},"msg":"Fetching providers from Catwalk"}
+{"time":"2026-03-13T20:12:32.150078123+01:00","level":"INFO","source":{"function":"github.com/charmbracelet/crush/internal/config.(*catwalkSync).Get.func1","file":"github.com/charmbracelet/crush/internal/config/catwalk.go","line":63},"msg":"Catwalk providers not modified"}
+{"time":"2026-03-13T20:12:32.150303604+01:00","level":"WARN","source":{"function":"github.com/charmbracelet/crush/internal/config.(*Config).configureProviders","file":"github.com/charmbracelet/crush/internal/config/load.go","line":296},"msg":"Skipping provider due to missing API key","provider":"anthropic"}
+{"time":"2026-03-13T20:12:32.15507598+01:00","level":"INFO","msg":"goose: no migrations to run. current version: 20260127000000"}
+{"time":"2026-03-13T20:12:32.161646966+01:00","level":"INFO","source":{"function":"github.com/charmbracelet/crush/internal/agent/tools/mcp.Initialize","file":"github.com/charmbracelet/crush/internal/agent/tools/mcp/init.go","line":167},"msg":"Initializing MCP clients"}
+{"time":"2026-03-13T20:15:20.65020982+01:00","level":"ERROR","source":{"function":"github.com/charmbracelet/x/powernap/pkg/lsp.startServerProcess.func1","file":"github.com/charmbracelet/x/powernap@v0.1.3/pkg/lsp/client.go","line":650},"msg":"Language server stderr","command":"ty","output":"2026-03-13 20:15:20.650149482  INFO Version: 0.0.20\n"}
+{"time":"2026-03-13T20:15:20.651255948+01:00","level":"ERROR","source":{"function":"github.com/charmbracelet/x/powernap/pkg/lsp.startServerProcess.func1","file":"github.com/charmbracelet/x/powernap@v0.1.3/pkg/lsp/client.go","line":650},"msg":"Language server stderr","command":"ty","output":"2026-03-13 20:15:20.651183033 ERROR Invalid client response: did not contain a result or error (method=workspace/configuration)\n"}

{typedal-4.5.0 → typedal-4.6.0}/.github/workflows/su6.yml

@@ -11,7 +11,7 @@ jobs:
       - uses: actions/checkout@v3
       - uses: actions/setup-python@v4
         with:
-          python-version: '3.11'
+          python-version: '3.12'
       - uses: yezz123/setup-uv@v4
         with:
           uv-venv: ".venv"

{typedal-4.5.0 → typedal-4.6.0}/.readthedocs.yml

@@ -3,7 +3,7 @@ version: 2
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.11"
+    python: "3.13"
 
 mkdocs:
    configuration: mkdocs.yml

{typedal-4.5.0 → typedal-4.6.0}/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 <!--next-version-placeholder-->
 
+## v4.6.0 (2026-03-13)
+
+### Documentation
+
+* Add section about PydanticMixin ([`d91c504`](https://github.com/trialandsuccess/TypeDAL/commit/d91c50485f7f7dd7a1e04ae93998475a05bb3742))
+
 ## v4.5.0 (2026-03-06)
 
 ### Feature

{typedal-4.5.0 → typedal-4.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TypeDAL
-Version: 4.5.0
+Version: 4.6.0
 Summary: Typing support for PyDAL
 Project-URL: Documentation, https://typedal.readthedocs.io/
 Project-URL: Issues, https://github.com/trialandsuccess/TypeDAL/issues
@@ -8,13 +8,12 @@ Project-URL: Source, https://github.com/trialandsuccess/TypeDAL
 Author-email: Robin van der Noord <contact@trialandsuccess.nl>
 Classifier: Development Status :: 4 - Beta
 Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
-Requires-Python: >=3.11
+Requires-Python: >=3.12
 Requires-Dist: configurable-json<2
 Requires-Dist: configuraptor<3,>=2.0.1
 Requires-Dist: dill<1
@@ -26,6 +25,7 @@ Provides-Extra: all
 Requires-Dist: edwh-migrate[full]>=0.8.0; extra == 'all'
 Requires-Dist: py4web; extra == 'all'
 Requires-Dist: pydal2sql[all]>=1.2.0; extra == 'all'
+Requires-Dist: pydantic<3; extra == 'all'
 Requires-Dist: questionary; extra == 'all'
 Requires-Dist: tabulate; extra == 'all'
 Requires-Dist: tomlkit; extra == 'all'
@@ -36,6 +36,7 @@ Requires-Dist: ewok; extra == 'dev'
 Requires-Dist: hatch; extra == 'dev'
 Requires-Dist: mkdocs; extra == 'dev'
 Requires-Dist: mkdocs-dracula-theme; extra == 'dev'
+Requires-Dist: pydantic<3; extra == 'dev'
 Requires-Dist: pytest-mypy-testing; extra == 'dev'
 Requires-Dist: python-semantic-release<8; extra == 'dev'
 Requires-Dist: requests<2.32; extra == 'dev'

{typedal-4.5.0 → typedal-4.6.0}/docs/8_mixins.md

@@ -47,6 +47,58 @@ class MyTable(TypedTable, SlugMixin, slug_field="title"):
 # Now, whenever you insert a record into MyTable, the 'slug' field will be automatically generated based on the 'title' field.
 ```
 
+## Using `PydanticMixin`
+
+The `PydanticMixin` enables seamless integration with Pydantic-based frameworks (like FastAPI) by adding schema generation
+capabilities to your models. Without this mixin, you cannot return TypedTable instances directly as FastAPI responses
+or use them with `pydantic.TypeAdapter`.
+
+Add the mixin to enable `model_dump()` for serialization, including support for relationships and computed properties:
+
+```python
+from typedal import TypedTable
+from typedal.mixins import PydanticMixin
+
+
+class Author(TypedTable, PydanticMixin):
+    name: str
+
+
+class Book(TypedTable, PydanticMixin):
+    title: str
+    author: Author
+
+    @property
+    def display_title(self) -> str:
+        return f"{self.title} by {self.author.name}"
+
+
+# After inserting records and joining relationships:
+book = Book.where(id=1).join("author").first()
+
+# model_dump() serializes the full object graph
+data = book.model_dump()
+# -> {"id": 1, "title": "...", "author": {"id": 1, "name": "..."}, "display_title": "..."}
+
+# Use mode="json" for JSON-serializable output (dates as ISO strings, etc.)
+data = book.model_dump(mode="json")
+```
+
+> **Note:** When referencing other TypedTable models from a PydanticMixin class, those models must also include
+> `PydanticMixin`. This ensures the entire object graph can be serialized consistently.
+
+With this mixin, TypedTable instances work seamlessly as FastAPI response models:
+
+```python
+from fastapi import FastAPI
+
+app = FastAPI()
+
+@app.get("/books/{book_id}")
+def get_book(book_id: int) -> Book:
+    return Book.where(id=book_id).join("author").first()
+```
+
 ## Creating Custom Mixins
 
 To create your own mixins for additional functionality, follow these steps:
@@ -122,6 +174,7 @@ recent_articles = (
 By using these mixins, you can enhance the functionality of your models in a modular and reusable manner, saving you
 time and effort in your development process.
 
+
 ---
 
 Looking to cache expensive function results? Head to [9. Function Memoization](./9_memoization.md) to learn about `db.memoize()`.

{typedal-4.5.0 → typedal-4.6.0}/pyproject.toml

@@ -10,7 +10,7 @@ name = "TypeDAL"
 dynamic = ["version"]
 description = 'Typing support for PyDAL'
 readme = "README.md"
-requires-python = ">=3.11"
+requires-python = ">=3.12"
 license-expression = "MIT"
 keywords = []
 authors = [
@@ -19,7 +19,6 @@ authors = [
 classifiers = [
     "Development Status :: 4 - Beta",
     "Programming Language :: Python",
-    "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
     "Programming Language :: Python :: 3.14",
@@ -56,6 +55,7 @@ all = [
     "tabulate",
     "pydal2sql[all]>=1.2.0",
     "edwh-migrate[full]>=0.8.0",
+    "pydantic < 3",
     "questionary",
     "tomlkit",
 ]
@@ -70,6 +70,7 @@ dev = [
     "pytest-mypy-testing",
     "contextlib-chdir",
     "testcontainers",
+    "pydantic < 3",
     # depends on ->
     "requests<2.32",
     # mypy:
@@ -142,7 +143,7 @@ exclude_also = [
     ]
 
 [tool.mypy]
-python_version = "3.11"
+python_version = "3.13"
 
 # `some: int = None` looks nicer than `some: int | None = None` and pycharm still understands it
 no_implicit_optional = false  # I guess 'strict_optional' should be true, but disable this one because it's double!

{typedal-4.5.0 → typedal-4.6.0}/src/typedal/__about__.py

@@ -5,4 +5,4 @@ This file contains the Version info for this package.
 # SPDX-FileCopyrightText: 2023-present Robin van der Noord <robinvandernoord@gmail.com>
 #
 # SPDX-License-Identifier: MIT
-__version__ = "4.5.0"
+__version__ = "4.6.0"

{typedal-4.5.0 → typedal-4.6.0}/src/typedal/caching.py

@@ -203,10 +203,6 @@ def _remove_cache(s: Set, tablename: str) -> None:
     indeces = s.select("id").column("id")
     remove_cache(indeces, tablename)
 
-
-T_TypedTable = t.TypeVar("T_TypedTable", bound=TypedTable)
-
-
 def get_expire(
     expires_at: t.Optional[dt.datetime] = None,
     ttl: t.Optional[int | dt.timedelta] = None,
@@ -250,7 +246,7 @@ def _insert_cache_entry(
     db.commit()
 
 
-def save_to_cache(
+def save_to_cache[T_TypedTable: TypedTable](
     instance: TypedRows[T_TypedTable],
     rows: Rows,
     expires_at: t.Optional[dt.datetime] = None,
@@ -418,8 +414,10 @@ def _expired_and_valid_query() -> tuple[str, str]:
     return expired_items, valid_items
 
 
-T = t.TypeVar("T")
-Stats = t.TypedDict("Stats", {"total": T, "valid": T, "expired": T})
+class Stats[T](t.TypedDict):
+    total: T
+    valid: T
+    expired: T
 
 RowStats = t.TypedDict(
     "RowStats",
@@ -527,7 +525,7 @@ def calculate_stats(db: "TypeDAL") -> Stats[GenericStats]:
     }
 
 
-def memoize(
+def memoize[T: t.Any](
     db: "TypeDAL",
     func: t.Callable[..., T],
     *args: TypedRows[t.Any] | TypedTable,

{typedal-4.5.0 → typedal-4.6.0}/src/typedal/cli.py

@@ -94,12 +94,10 @@ questionary_types: dict[typing.Hashable, Optional[AnyDict]] = {
     "fake_migrate": None,  # only enable via config if required
 }
 
-T = typing.TypeVar("T")
-
 notfound = object()
 
 
-def _get_question(prop: str, annotation: typing.Type[T]) -> Optional[AnyDict]:  # pragma: no cover
+def _get_question[T](prop: str, annotation: typing.Type[T]) -> Optional[AnyDict]:  # pragma: no cover
     question = questionary_types.get(prop, notfound)
     if question is notfound:
         # None means skip the question, notfound means use the type default!
@@ -111,7 +109,7 @@ def _get_question(prop: str, annotation: typing.Type[T]) -> Optional[AnyDict]:
     return question.copy()  # type: ignore
 
 
-def get_question(prop: str, annotation: typing.Type[T], default: T | None) -> Optional[T]:  # pragma: no cover
+def get_question[T](prop: str, annotation: typing.Type[T], default: T | None) -> Optional[T]:  # pragma: no cover
     """
     Generate a question based on a config property and prompt the user for it.
     """
@@ -449,7 +447,7 @@ def migrations_stub(
     return 0
 
 
-AnyNestedDict: typing.TypeAlias = dict[str, AnyDict]
+type AnyNestedDict = dict[str, AnyDict]
 
 
 def tabulate_data(data: AnyNestedDict) -> None:
@@ -466,7 +464,7 @@ def tabulate_data(data: AnyNestedDict) -> None:
     print(tabulate(flattened_data, headers="keys"))
 
 
-FormatOptions: typing.TypeAlias = typing.Literal["plaintext", "json", "yaml", "toml"]
+type FormatOptions = typing.Literal["plaintext", "json", "yaml", "toml"]
 
 
 def get_output_format(fmt: FormatOptions) -> typing.Callable[[AnyNestedDict], None]:

{typedal-4.5.0 → typedal-4.6.0}/src/typedal/core.py

@@ -21,7 +21,7 @@ from .helpers import (
     sql_expression,
     to_snake,
 )
-from .types import CacheStatus, Field, T, Template  # type: ignore
+from .types import CacheStatus, Field, Template  # noqa: F401
 
 try:
     # python 3.14+
@@ -246,7 +246,7 @@ class TypeDAL(pydal.DAL):
             self.try_define(_TypedalCache)
             self.try_define(_TypedalCacheDependency)
 
-    def try_define(self, model: t.Type[T], verbose: bool = False) -> t.Type[T]:
+    def try_define[T: t.Any](self, model: t.Type[T], verbose: bool = False) -> t.Type[T]:
         """
         Try to define a model with migrate or fall back to fake migrate.
         """
@@ -270,7 +270,7 @@ class TypeDAL(pydal.DAL):
     }
 
     @t.overload
-    def define(self, maybe_cls: None = None, **kwargs: t.Any) -> t.Callable[[t.Type[T]], t.Type[T]]:
+    def define[T: t.Any](self, maybe_cls: None = None, **kwargs: t.Any) -> t.Callable[[t.Type[T]], t.Type[T]]:
         """
         Typing Overload for define without a class.
 
@@ -279,7 +279,7 @@ class TypeDAL(pydal.DAL):
         """
 
     @t.overload
-    def define(self, maybe_cls: t.Type[T], **kwargs: t.Any) -> t.Type[T]:
+    def define[T: t.Any](self, maybe_cls: t.Type[T], **kwargs: t.Any) -> t.Type[T]:
         """
         Typing Overload for define with a class.
 
@@ -287,7 +287,7 @@ class TypeDAL(pydal.DAL):
         class MyTable(TypedTable): ...
         """
 
-    def define(
+    def define[T: t.Any](
         self,
         maybe_cls: t.Type[T] | None = None,
         **kwargs: t.Any,
@@ -379,6 +379,14 @@ class TypeDAL(pydal.DAL):
         # alias for backward-compatibility
         return self._builder.class_map
 
+    def _known_classes(self) -> dict[str, t.Type["TypedTable"]]:
+        """
+        Return currently defined TypedTable classes keyed by class name.
+
+        Useful when resolving forward references in annotations/relationships.
+        """
+        return {table.__name__: table for table in self._class_map.values()}
+
     @staticmethod
     def to_snake(camel: str) -> str:
         """
@@ -460,7 +468,7 @@ class TypeDAL(pydal.DAL):
         """
         return sql_expression(self, sql_fragment, *raw_args, output_type=output_type, **raw_kwargs)
 
-    def memoize(
+    def memoize[T: t.Any](
         self,
         func: t.Callable[..., T],
         # should be TypedRows[TypedTable] or TypedTable but for some reason that breaks

{typedal-4.5.0 → typedal-4.6.0}/src/typedal/define.py

@@ -29,7 +29,6 @@ from .relationships import Relationship, to_relationship
 from .tables import TypedTable
 from .types import (
     Field,
-    T,
     T_annotation,
     Table,
     _Types,
@@ -53,7 +52,7 @@ class TableDefinitionBuilder:
         self.db = db
         self.class_map: dict[str, t.Type["TypedTable"]] = {}
 
-    def define(self, cls: t.Type[T], **kwargs: t.Any) -> t.Type[T]:
+    def define[T: t.Any](self, cls: t.Type[T], **kwargs: t.Any) -> t.Type[T]:
         """Build and register a table from a TypedTable class."""
         full_dict = all_dict(cls)
         tablename = to_snake(cls.__name__)
@@ -133,7 +132,7 @@ class TableDefinitionBuilder:
         """Convert Python type annotation to pydal field type string."""
         ftype = t.cast(type, ftype_annotation)  # cast from Type to type to make mypy happy)
 
-        known_classes = {table.__name__: table for table in self.class_map.values()}
+        known_classes = self.db._known_classes()
 
         if isinstance(ftype, str):
             # extract type from string

{typedal-4.5.0 → typedal-4.6.0}/src/typedal/fields.py

@@ -24,8 +24,6 @@ from .types import (
     Query,
     T_annotation,
     T_MetaInstance,
-    T_subclass,
-    T_Value,
     Validator,
 )
 
@@ -37,7 +35,7 @@ if t.TYPE_CHECKING:
 ## general
 
 
-class TypedField(Expression, t.Generic[T_Value]):  # pragma: no cover
+class TypedField[T_Value](Expression):  # pragma: no cover
     """
     Typed version of pydal.Field, which will be converted to a normal Field in the background.
     """
@@ -375,7 +373,9 @@ def UploadField(**kw: t.Unpack[FieldSettings]) -> TypedField[str]:
 Upload = UploadField
 
 
-def ReferenceField(
+def ReferenceField[
+    T_subclass: (TypedTable, Table)
+](
     other_table: str | t.Type[TypedTable] | TypedTable | Table | T_subclass,
     **kw: t.Unpack[FieldSettings],
 ) -> TypedField[int]:

{typedal-4.5.0 → typedal-4.6.0}/src/typedal/helpers.py

@@ -15,7 +15,7 @@ from collections import ChainMap
 
 from pydal import DAL
 
-from .types import AnyDict, Expression, Field, Row, T, Table, Template  # type: ignore
+from .types import AnyDict, Expression, Field, Row, Table, Template
 
 try:
     import annotationlib
@@ -91,7 +91,7 @@ def all_annotations(cls: type, _except: t.Optional[t.Iterable[str]] = None) -> d
     return {k: v for k, v in _all.items() if k not in _except}
 
 
-def instanciate(cls: t.Type[T] | T, with_args: bool = False) -> T:
+def instanciate[T: t.Any](cls: t.Type[T] | T, with_args: bool = False) -> T:
     """
     Create an instance of T (if it is a class).
 
@@ -173,10 +173,6 @@ def mktable(
     return output.getvalue()
 
 
-K = t.TypeVar("K")
-V = t.TypeVar("V")
-
-
 def looks_like(v: t.Any, _type: type[t.Any]) -> bool:
     """
     Returns true if v or v's class is of type _type, including if it is a generic.
@@ -189,7 +185,7 @@ def looks_like(v: t.Any, _type: type[t.Any]) -> bool:
     return isinstance(v, _type) or (isinstance(v, type) and issubclass(v, _type)) or origin_is_subclass(v, _type)
 
 
-def filter_out(mut_dict: dict[K, V], _type: type[T]) -> dict[K, T]:
+def filter_out[K, V, T](mut_dict: dict[K, V], _type: type[T]) -> dict[K, T]:
     """
     Split a dictionary into things matching _type and the rest.
 
@@ -211,20 +207,20 @@ def unwrap_type(_type: type) -> type:
 
 
 @t.overload
-def extract_type_optional(annotation: T) -> tuple[T, bool]:
+def extract_type_optional[T](annotation: T) -> tuple[T, bool]:
     """
     T -> T is not exactly right because you'll get the inner type, but mypy seems happy with this.
     """
 
 
 @t.overload
-def extract_type_optional(annotation: None) -> tuple[None, bool]:
+def extract_type_optional[T](annotation: None) -> tuple[None, bool]:
     """
     None leads to None, False.
     """
 
 
-def extract_type_optional(annotation: T | None) -> tuple[T | None, bool]:
+def extract_type_optional[T](annotation: T | None) -> tuple[T | None, bool]:
     """
     Given an annotation, extract the actual type and whether it is optional.
     """
@@ -256,13 +252,13 @@ class DummyQuery:
     Placeholder to &= and |= actual query parts.
     """
 
-    def __or__(self, other: T) -> T:
+    def __or__[T](self, other: T) -> T:
         """
         For 'or': DummyQuery | Other == Other.
         """
         return other
 
-    def __and__(self, other: T) -> T:
+    def __and__[T](self, other: T) -> T:
         """
         For 'and': DummyQuery & Other == Other.
         """
@@ -275,7 +271,7 @@ class DummyQuery:
         return False
 
 
-def as_lambda(value: T) -> t.Callable[..., T]:
+def as_lambda[T](value: T) -> t.Callable[..., T]:
     """
     Wrap value in a callable.
     """
@@ -342,7 +338,7 @@ class classproperty:
         """
         self.fget = fget
 
-    def __get__(self, obj: t.Any, owner: t.Type[T]) -> t.Any:
+    def __get__[T](self, obj: t.Any, owner: t.Type[T]) -> t.Any:
         """
         Retrieve the property value.
 
@@ -589,7 +585,7 @@ def normalize_table_keys(row: Row, pattern: re.Pattern[str] = re.compile(r"^([a-
     return Row(new_data)
 
 
-def default_representer(field: TypedField[T], value: T, table: t.Type[TypedTable]) -> str:
+def default_representer[T: t.Any](field: TypedField[T], value: T, table: t.Type[TypedTable]) -> str:
     """
     Simply call field.represent on the value.
     """