ORIONIS API REFERENCE

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.

module documentation

Session store that persists each session as a JSON file on disk.

Class _SessionPayload Represent the serialized payload stored for a session.
Class FileSessionStore Session store that persists each session as a JSON file on disk.
Constant _DECODER Decoder used by file.
Constant _ENCODER msgspec resolves the struct layout at construction time instead of on every encode/decode call.
Constant _LOCK_STRIPES Lock stripes value used by file.
Constant _REPLACE_ATTEMPTS Windows refuses a rename while another process swaps the same destination.
Constant _REPLACE_BACKOFF_SECONDS Replace backoff seconds value used by file.
Constant _STALE_TEMP_SECONDS A staging file younger than this may still belong to an in-flight write.
Constant _VALID_FILE Recognize filenames that can be produced from valid session identifiers.
Constant _VALID_ID Compiled pattern used to recognize valid id.
Constant _VALID_TEMP Recognize staging files created by the session writer.
_DECODER = (source)

Decoder used by file.

Value
_msgspec_json.Decoder(_SessionPayload)
_ENCODER = (source)

msgspec resolves the struct layout at construction time instead of on every encode/decode call.

Value
_msgspec_json.Encoder()
_LOCK_STRIPES: int = (source)

Lock stripes value used by file.

Value
64
_REPLACE_ATTEMPTS: int = (source)

Windows refuses a rename while another process swaps the same destination.

Value
3
_REPLACE_BACKOFF_SECONDS: float = (source)

Replace backoff seconds value used by file.

Value
0.005
_STALE_TEMP_SECONDS: float = (source)

A staging file younger than this may still belong to an in-flight write.

Value
3600.0
_VALID_FILE = (source)

Recognize filenames that can be produced from valid session identifiers.

Value
re.compile(r'[A-Za-z0-9_-]{1,255}\.json\Z')
_VALID_ID = (source)

Compiled pattern used to recognize valid id.

Value
re.compile(r'[A-Za-z0-9_-]{1,255}\Z')
_VALID_TEMP = (source)

Recognize staging files created by the session writer.

Value
re.compile(r'[A-Za-z0-9_-]{1,255}\.json\.[0-9a-f]{16}\.tmp\Z')