orionis.foundation.config.scheduler.Database

THE ORIONIS API

Build with clarity.

Explore the building blocks of an async-first Python framework. Every module, class, and method — connected, searchable, and ready to build with.

Explore modules View classes

class documentation

class Database(BaseEntity): (source)

View In Hierarchy

Represent the configuration entity for a database-backed job store.

Mirrors APScheduler's SQLAlchemy job store configuration, allowing a dedicated connection/table to persist scheduled task definitions.

Method	`__post_init__`	Validate the Database job store configuration after initialization.
Method	`__validateConnection`	Validate the `connection` property.
Method	`__validateDriver`	Validate the `driver` property.
Method	`__validateTable`	Validate the `table` property.
Instance Variable	`connection`	The database connection name used to store scheduled tasks. Resolved from the `DB_TASK_CONNECTION` environment variable or `None` to use the application's default connection.
Instance Variable	`driver`	The driver type. Defaults to `'database'`.
Instance Variable	`table`	The database table name used to store scheduled tasks. Must match the pattern `[a-z_]+`. Resolved from the `DB_TASK_TABLE` environment variable or defaults to `'scheduler_tasks'`.

Inherited from BaseEntity:

Class Method	`_cachedFieldMetadata`	Retrieve field definitions and normalized types cached by class.
Method	`getFields`	Describe field names, normalized types, defaults, and metadata.
Method	`toDict`	Convert the dataclass instance to a recursively copied dictionary.
Class Variable	`__slots__`	Undocumented

def __post_init__(self): (source) ¶

overrides orionis.support.entities.BaseEntity.__post_init__

Validate the Database job store configuration after initialization.

Returns
`None`	Validates every field against its declared type hint.

Raises
`TypeError`	If any property does not match its expected type.
`ValueError`	If `table` fails table-name validation.

def __validateConnection(self): (source) ¶

Validate the connection property.

Returns
`None`	This method performs validation and returns None.

Raises
`TypeError`	If `connection` is neither a string nor `None`.

def __validateDriver(self): (source) ¶

Validate the driver property.

Returns
`None`	This method performs validation and returns None.

Raises
`TypeError`	If `driver` is not a string.
`ValueError`	If `driver` is an empty string.

def __validateTable(self): (source) ¶

Validate the table property.

Returns
`None`	This method performs validation and returns None.

Raises
`TypeError`	If `table` is not a string.
`ValueError`	If `table` does not match the required pattern.

connection: str | None = (source) ¶

The database connection name used to store scheduled tasks. Resolved from the DB_TASK_CONNECTION environment variable or None to use the application's default connection.

driver: str = (source) ¶

The driver type. Defaults to 'database'.

table: str = (source) ¶

The database table name used to store scheduled tasks. Must match the pattern [a-z_]+. Resolved from the DB_TASK_TABLE environment variable or defaults to 'scheduler_tasks'.