6.8 KiB
fields.base
BaseField Objects
class BaseField(FieldInfo)
BaseField serves as a parent class for all basic Fields in ormar. It keeps all common parameters available for all fields as well as set of useful functions.
All values are kept as class variables, ormar Fields are never instantiated. Subclasses pydantic.FieldInfo to keep the fields related to pydantic field types like ConstrainedStr
is_valid_uni_relation
| is_valid_uni_relation() -> bool
Checks if field is a relation definition but only for ForeignKey relation, so excludes ManyToMany fields, as well as virtual ForeignKey (second side of FK relation).
Is used to define if a field is a db ForeignKey column that should be saved/populated when dealing with internal/own Model columns only.
Returns:
(bool): result of the check
get_alias
| get_alias() -> str
Used to translate Model column names to database column names during db queries.
Returns:
(str): returns custom database column name if defined by user,
otherwise field name in ormar/pydantic
get_pydantic_default
| get_pydantic_default() -> Dict
Generates base pydantic.FieldInfo with only default and optionally required to fix pydantic Json field being set to required=False. Used in an ormar Model Metaclass.
Returns:
(pydantic.FieldInfo): instance of base pydantic.FieldInfo
default_value
| default_value(use_server: bool = False) -> Optional[Dict]
Returns a FieldInfo instance with populated default (static) or default_factory (function). If the field is a autoincrement primary key the default is None. Otherwise field have to has either default, or default_factory populated.
If all default conditions fail None is returned.
Used in converting to pydantic FieldInfo.
Arguments:
use_server (bool): flag marking if server_default should be treated as default value, default False
Returns:
(Optional[pydantic.FieldInfo]): returns a call to pydantic.Field
which is returning a FieldInfo instance
get_default
| get_default(use_server: bool = False) -> Any
Return default value for a field. If the field is Callable the function is called and actual result is returned. Used to populate default_values for pydantic Model in ormar Model Metaclass.
Arguments:
use_server (bool): flag marking if server_default should be treated as default value, default False
Returns:
(Any): default value for the field if set, otherwise implicit None
has_default
| has_default(use_server: bool = True) -> bool
Checks if the field has default value set.
Arguments:
use_server (bool): flag marking if server_default should be treated as default value, default False
Returns:
(bool): result of the check if default value is set
is_auto_primary_key
| is_auto_primary_key() -> bool
Checks if field is first a primary key and if it, it's than check if it's set to autoincrement. Autoincrement primary_key is nullable/optional.
Returns:
(bool): result of the check for primary key and autoincrement
construct_constraints
| construct_constraints() -> List
Converts list of ormar constraints into sqlalchemy ForeignKeys. Has to be done dynamically as sqlalchemy binds ForeignKey to the table. And we need a new ForeignKey for subclasses of current model
Returns:
(List[sqlalchemy.schema.ForeignKey]): List of sqlalchemy foreign keys - by default one.
get_column
| get_column(name: str) -> sqlalchemy.Column
Returns definition of sqlalchemy.Column used in creation of sqlalchemy.Table. Populates name, column type constraints, as well as a number of parameters like primary_key, index, unique, nullable, default and server_default.
Arguments:
name (str): name of the db column - used if alias is not set
Returns:
(sqlalchemy.Column): actual definition of the database column as sqlalchemy requires.
_get_encrypted_column
| _get_encrypted_column(name: str) -> sqlalchemy.Column
Returns EncryptedString column type instead of actual column.
Arguments:
name (str): column name
Returns:
(sqlalchemy.Column): newly defined column
expand_relationship
| expand_relationship(value: Any, child: Union["Model", "NewBaseModel"], to_register: bool = True) -> Any
Function overwritten for relations, in basic field the value is returned as is. For relations the child model is first constructed (if needed), registered in relation and returned. For relation fields the value can be a pk value (Any type of field), dict (from Model) or actual instance/list of a "Model".
Arguments:
value (Any): a Model field value, returned untouched for non relation fields.child (Union["Model", "NewBaseModel"]): a child Model to registerto_register (bool): flag if the relation should be set in RelationshipManager
Returns:
(Any): returns untouched value for normal fields, expands only for relations
set_self_reference_flag
| set_self_reference_flag() -> None
Sets self_reference to True if field to and owner are same model.
Returns:
(None): None
has_unresolved_forward_refs
| has_unresolved_forward_refs() -> bool
Verifies if the filed has any ForwardRefs that require updating before the model can be used.
Returns:
(bool): result of the check
evaluate_forward_ref
| evaluate_forward_ref(globalns: Any, localns: Any) -> None
Evaluates the ForwardRef to actual Field based on global and local namespaces
Arguments:
globalns (Any): global namespacelocalns (Any): local namespace
Returns:
(None): None
get_related_name
| get_related_name() -> str
Returns name to use for reverse relation.
It's either set as related_name or by default it's owner model. get_name + 's'
Returns:
(str): name of the related_name or default related name.