Simple fields

Factory functions that return FieldSpec instances for common scalar types. Each factory accepts keyword arguments for validation constraints like required, max_length, min_value, choices, etc.

See Simple Fields reference for a summary table and Field Arguments for all available keyword arguments.

String

String(
    max_length: int = 255,
    min_length: int | None = None,
    sanitize: bool = True,
    **kwargs: Any,
) -> str

Source code in src/protean/fields/simple.py

def String(  # type: ignore[misc]
    max_length: int = 255,
    min_length: int | None = None,
    sanitize: bool = True,
    **kwargs: Any,
) -> str: ...

---

Text

Text(sanitize: bool = True, **kwargs: Any) -> str

Source code in src/protean/fields/simple.py

def Text(sanitize: bool = True, **kwargs: Any) -> str: ...  # type: ignore[misc]

---

Integer

Integer(
    min_value: int | None = None,
    max_value: int | None = None,
    **kwargs: Any,
) -> int

Source code in src/protean/fields/simple.py

def Integer(  # type: ignore[misc]
    min_value: int | None = None,
    max_value: int | None = None,
    **kwargs: Any,
) -> int: ...

---

Float

Float(
    min_value: float | None = None,
    max_value: float | None = None,
    **kwargs: Any,
) -> float

Source code in src/protean/fields/simple.py

def Float(  # type: ignore[misc]
    min_value: float | None = None,
    max_value: float | None = None,
    **kwargs: Any,
) -> float: ...

---

Boolean

Boolean(**kwargs: Any) -> bool

Source code in src/protean/fields/simple.py

def Boolean(**kwargs: Any) -> bool: ...  # type: ignore[misc]

---

Date

Date(**kwargs: Any) -> date

Source code in src/protean/fields/simple.py

def Date(**kwargs: Any) -> datetime.date: ...  # type: ignore[misc]

---

DateTime

DateTime(**kwargs: Any) -> datetime

Source code in src/protean/fields/simple.py

def DateTime(**kwargs: Any) -> datetime.datetime: ...  # type: ignore[misc]

---

Identifier

Identifier(identifier: bool = False, **kwargs: Any) -> str

Source code in src/protean/fields/simple.py

def Identifier(identifier: bool = False, **kwargs: Any) -> str: ...  # type: ignore[misc]

---

Auto

Auto(
    increment: bool = False,
    identifier: bool = False,
    identity_strategy: str | None = None,
    identity_function: str | Callable | None = None,
    identity_type: str | None = None,
    **kwargs: Any,
) -> str

Source code in src/protean/fields/simple.py

def Auto(  # type: ignore[misc]
    increment: bool = False,
    identifier: bool = False,
    identity_strategy: str | None = None,
    identity_function: str | Callable | None = None,
    identity_type: str | None = None,
    **kwargs: Any,
) -> str: ...