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 IStorageManager(ABC): (source)
Known subclasses: orionis.storage.StorageManager
Define the contract for the storage manager.
The manager resolves the filesystems configuration, builds
orionis.storage.contracts.IDisk objects on demand,
caches them, and exposes extension points for custom drivers. It
never performs file operations itself.
| Method | default |
Resolve the default disk from the configuration. |
| Method | disk |
Resolve the disk registered under name. |
| Method | extend |
Register a custom driver factory under driver. |
| Method | uploaded |
Wrap an HTTP multipart payload as a storable uploaded file. |
| Class Variable | __slots__ |
Declare that this class introduces no additional instance slots. |
orionis.storage.StorageManagerResolve the default disk from the configuration.
| Returns | |
orionis.storage.contracts.IDisk | The disk configured as default. |
| Raises | |
orionis.storage.exceptions.DiskNotFoundException | If the default disk is not declared in the configuration. |
orionis.storage.StorageManagerResolve the disk registered under name.
The disk is built on first access and cached for reuse.
| Parameters | |
name:str | None | Disk name as declared in the filesystems configuration, or None for the default disk. |
| Returns | |
orionis.storage.contracts.IDisk | Disk bound to its configured driver. |
| Raises | |
orionis.storage.exceptions.DiskNotFoundException | If the disk is not declared in the configuration. |
orionis.storage.exceptions.DriverNotSupportedException | If the disk references a driver with no implementation. |
str, factory: Callable[ [ object], IStorageDriver]):
(source)
¶
orionis.storage.StorageManagerRegister a custom driver factory under driver.
The factory receives the disk configuration entity and must return a ready-to-use driver instance. Registering a factory clears the disk cache so new resolutions pick it up.
| Parameters | |
driver:str | Driver name as referenced by disk configurations. |
factory:typing.Callable[[object], IStorageDriver] | Callable building the driver from a disk configuration. |
| Returns | |
None | No return value. |
orionis.storage.StorageManagerWrap an HTTP multipart payload as a storable uploaded file.
| Parameters | |
source:orionis.http.payload.contracts.uploaded_file.IUploadedFile | Buffered multipart payload produced by the HTTP layer. |
| Returns | |
orionis.storage.contracts.IUploadedFile | Uploaded file bound to this manager for disk resolution. |
orionis.storage.StorageManagerDeclare that this class introduces no additional instance slots.