orionis.storage.Disk

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 Disk(IDisk): (source)

Constructor: Disk(name, driver)

View In Hierarchy

Represent a configured storage disk.

The disk is the high-level entry point to a storage backend. It builds ~orionis.storage.file.File and ~orionis.storage.directory.Directory objects bound to its driver, and its convenience methods always delegate to those objects so no logic is ever duplicated.

Method	`__init__`	Initialize the disk with its configuration name and driver.
Async Method	`copy`	Copy the file at source to target on this disk.
Async Method	`delete`	Delete the file at path from this disk.
Method	`directory`	Build a directory object for path on this disk.
Async Method	`exists`	Check whether a file exists at path on this disk.
Method	`file`	Build a file object for path on this disk.
Async Method	`move`	Move the file at source to target on this disk.
Method	`name`	Return the configuration name of the disk.
Async Method	`put`	Write contents to path on this disk.
Class Variable	`__slots__`	Undocumented
Instance Variable	`_driver`	Undocumented
Instance Variable	`_name`	Undocumented

def __init__(self, name: str, driver: IStorageDriver): (source) ¶

Initialize the disk with its configuration name and driver.

Parameters
name:`str`	Disk name as declared in the filesystems configuration.
driver:`IStorageDriver`	Driver instance backing the disk.

Returns
`None`	Undocumented

async def copy(self, source: str, target: str) -> IFile: (source) ¶

overrides orionis.storage.contracts.IDisk.copy

Copy the file at source to target on this disk.

Parameters
source:`str`	Root-relative path of the existing file.
target:`str`	Root-relative destination path.

Returns
`IFile`	File object pointing at the copy.

Raises
`StorageFileNotFoundException`	If the source file does not exist.

async def delete(self, path: str) -> bool: (source) ¶

overrides orionis.storage.contracts.IDisk.delete

Delete the file at path from this disk.

Parameters
path:`str`	Root-relative file path.

Returns
`bool`	`True` if the file existed and was removed.

def directory(self, path: str = '') -> IDirectory: (source) ¶

overrides orionis.storage.contracts.IDisk.directory

Build a directory object for path on this disk.

Parameters
path:`str`	Root-relative directory path. The empty string denotes the disk root.

Returns
`IDirectory`	Directory object bound to this disk's driver.

Raises
`StoragePathException`	If path is invalid or escapes the disk root.

async def exists(self, path: str) -> bool: (source) ¶

overrides orionis.storage.contracts.IDisk.exists

Check whether a file exists at path on this disk.

Parameters
path:`str`	Root-relative file path.

Returns
`bool`	`True` if a file exists at the given path.

def file(self, path: str) -> IFile: (source) ¶

overrides orionis.storage.contracts.IDisk.file

Build a file object for path on this disk.

Parameters
path:`str`	Root-relative file path.

Returns
`IFile`	File object bound to this disk's driver.

Raises
`StoragePathException`	If path is invalid or resolves to the disk root.

async def move(self, source: str, target: str) -> IFile: (source) ¶

overrides orionis.storage.contracts.IDisk.move

Move the file at source to target on this disk.

Parameters
source:`str`	Root-relative path of the existing file.
target:`str`	Root-relative destination path.

Returns
`IFile`	File object pointing at the moved file.

Raises
`StorageFileNotFoundException`	If the source file does not exist.

def name(self) -> str: (source) ¶

overrides orionis.storage.contracts.IDisk.name

Return the configuration name of the disk.

Returns
`str`	Disk name as declared in the filesystems configuration.

async def put(self, path: str, contents: bytes | str, visibility: str | None = None) -> IFile: (source) ¶

overrides orionis.storage.contracts.IDisk.put

Write contents to path on this disk.

Parameters
path:`str`	Root-relative file path.
contents:`bytes \| str`	Data to persist. Strings are encoded as UTF-8.
visibility:`str \| None`	Visibility to apply, or `None` for the medium default.

Returns
`IFile`	File object pointing at the written file.

__slots__: tuple[str, ...] = (source) ¶

overrides orionis.storage.contracts.IDisk.__slots__

Undocumented

_driver = (source) ¶

Undocumented

_name = (source) ¶

Undocumented