orionis.schemas.rules.Size

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.

class documentation

class Size(Rule): (source)

Ensure a value has an exact size.

Numbers are compared by magnitude, strings and collections by length, and uploaded files by their size in kilobytes.

Method	`__init__`	Initialize the rule with the required size.
Method	`enforce`	Validate a field value against the required size.
Class Variable	`__code__`	Undocumented
Class Variable	`__message__`	Undocumented
Class Variable	`__slots__`	Undocumented
Instance Variable	`_size`	Undocumented

Inherited from Rule:

Async Method	`enforceAsync`	Run an explicitly asynchronous rule check without blocking the loop.
Method	`validate`	Validate the field value and return a failure when invalid.
Async Method	`validateAsync`	Await the rule and describe an invalid field value.
Instance Variable	`_code`	Undocumented
Instance Variable	`_message`	Undocumented

def __init__(self, size: float, *, message: str | None = None): (source) ¶

overrides orionis.schemas.rule.Rule.__init__

Initialize the rule with the required size.

Parameters
size:`int \| float`	Exact size the value must have.
message:`str \| None, optional`	Override message used when validation fails.

Returns
`None`	This method initializes the instance and returns None.

Raises
`ValueError`	If `size` is negative.

def enforce(self, field: str, value: object, instance: object) -> bool: (source) ¶

overrides orionis.schemas.rule.Rule.enforce

Validate a field value against the required size.

Parameters
field:`str`	Field name associated with the value.
value:`object`	Value to validate.
instance:`object`	Owning object instance. This argument is accepted for interface compatibility.

Returns
`bool`	Return `True` when the value passes validation.

Undocumented

Undocumented

overrides orionis.schemas.rule.Rule.__slots__

Undocumented

Undocumented