TypeDAL 4.8.2__tar.gz → 4.8.3__tar.gz

{typedal-4.8.2 → typedal-4.8.3}/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 <!--next-version-placeholder-->
 
+## v4.8.3 (2026-05-25)
+
+### Fix
+
+* Improved typing hints on TypedField properties ([`55b5ce4`](https://github.com/trialandsuccess/TypeDAL/commit/55b5ce4ae2657ae43b9cfa19dbe90e4386609495))
+
 ## v4.8.2 (2026-05-20)
 
 ### Fix

{typedal-4.8.2 → typedal-4.8.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: TypeDAL
-Version: 4.8.2
+Version: 4.8.3
 Summary: Typing support for PyDAL
 Project-URL: Documentation, https://typedal.readthedocs.io/
 Project-URL: Issues, https://github.com/trialandsuccess/TypeDAL/issues

{typedal-4.8.2 → typedal-4.8.3}/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.8.2"
+__version__ = "4.8.3"

{typedal-4.8.2 → typedal-4.8.3}/src/typedal/fields.py

@@ -18,9 +18,11 @@ from pydal.objects import Table
 
 from .core import TypeDAL
 from .types import (
+    AnyCallable,
     Expression,
     Field,
     FieldSettings,
+    FileSystemLike,
     Query,
     T_annotation,
     T_MetaInstance,
@@ -50,7 +52,44 @@ class TypedField[T_Value](Expression):  # pragma: no cover
     _type: T_annotation
     kwargs: t.Any
 
+    # Typed hints for common pydal.Field attrs forwarded via __getattr__ after bind().
+    type: str | type | Table | Field | SQLCustomType
+    type_name: str
+    length: int
+    default: T_Value
+    required: bool
+    ondelete: str
+    onupdate: str
+    notnull: bool
+    unique: bool
+    regex: str | None
+    options: list[t.Any] | AnyCallable | None
+    uploadfield: bool | str
+    uploadfolder: str | None
+    uploadseparate: bool
+    uploadfs: FileSystemLike | None
+    widget: AnyCallable | None
+    label: str
+    comment: str | None
+    writable: bool
+    readable: bool
+    searchable: bool
+    listable: bool
+    update: T_Value | AnyCallable | None
+    authorize: AnyCallable | None
+    autodelete: bool
     requires: Validator | t.Iterable[Validator]
+    represent: t.Callable[[T_Value, TypedTable | None], t.Any]
+    compute: AnyCallable | None
+    custom_store: AnyCallable | None
+    custom_retrieve: AnyCallable | None
+    custom_retrieve_file_properties: AnyCallable | None
+    custom_delete: AnyCallable | None
+    filter_in: AnyCallable | None
+    filter_out: AnyCallable | None
+    custom_qualifier: AnyCallable | None
+    map_none: T_Value | None
+    _raw_rname: str | None
 
     # NOTE: for the logic of converting a TypedField into a pydal Field, see TypeDAL._to_field
 
@@ -228,7 +267,6 @@ class TypedField[T_Value](Expression):  # pragma: no cover
 
         return t.cast(Expression, self._field.lower())
 
-
 def is_typed_field(cls: t.Any) -> t.TypeGuard["TypedField[t.Any]"]:
     """
     Is `cls` an instance or subclass of TypedField?

{typedal-4.8.2 → typedal-4.8.3}/typing_again.py

@@ -33,3 +33,8 @@ reveal_type(row.rel)  # expected: OtherTable | None; pycharm: Relationship[Other
 
 reveal_type(MyTable.multiple) # expected: Relationship[list[OtherTable]]; pycharm: Relationship[list[OtherTable]]
 reveal_type(row.multiple)  # expected: list[OtherTable]; pycharm: Relationship[list[OtherTable]]
+
+
+
+MyTable.field.label = "Test Label"
+MyTable.field.represent = lambda value, row: "Test Repr"