field

DTO domain types.

class litestar.dto.field.DTOField

Bases: object

For configuring DTO behavior on model fields.

__init__(mark: Mark | Literal['read-only', 'write-only', 'private'] | None = None) → None

mark: Mark | Literal['read-only', 'write-only', 'private'] | None = None

Mark the field as read-only, or private.

class litestar.dto.field.Mark

Bases: str, Enum

For marking field definitions on domain models.

READ_ONLY = 'read-only'

To mark a field that can be read, but not updated by clients.

WRITE_ONLY = 'write-only'

To mark a field that can be written to, but not read by clients.

PRIVATE = 'private'

To mark a field that can neither be read or updated by clients.

__new__(value)

litestar.dto.field.dto_field(mark: Literal['read-only', 'write-only', 'private'] | Mark) → dict[str, litestar.dto.field.DTOField]

Create a field metadata mapping.

Parameters:

mark – A DTO mark for the field, e.g., “read-only”.

Returns:

A dict for setting as field metadata, such as the dataclass “metadata” field key, or the SQLAlchemy “info” field.

Marking a field automates its inclusion/exclusion from DTO field definitions, depending on the DTO’s purpose.