Volume Async

AsyncVolumeCopy Anchor Link

class AsyncVolume()

E2B Volume for persistent storage that can be mounted to sandboxes (async).

createCopy Anchor Link

@classmethod
async def create(cls, name: str, **opts: Unpack[ApiParams]) -> "AsyncVolume"

Create a new volume.

Arguments:

• name: Name of the volume

Returns:

An AsyncVolume instance for the new volume

connectCopy Anchor Link

@classmethod
async def connect(cls, volume_id: str,
                  **opts: Unpack[ApiParams]) -> "AsyncVolume"

Connect to an existing volume by ID.

Arguments:

• volume_id: Volume ID

Returns:

An AsyncVolume instance for the existing volume

destroyCopy Anchor Link

@staticmethod
async def destroy(volume_id: str, **opts: Unpack[ApiParams]) -> bool

Destroy a volume.

Arguments:

• volume_id: Volume ID

make_dirCopy Anchor Link

async def make_dir(path: str,
                   uid: Optional[int] = None,
                   gid: Optional[int] = None,
                   mode: Optional[int] = None,
                   force: Optional[bool] = None,
                   **opts: Unpack[VolumeApiParams]) -> VolumeEntryStat

Create a directory.

Arguments:

• path: Path to the directory to create
• uid: User ID of the created directory
• gid: Group ID of the created directory
• mode: Mode of the created directory
• force: Create parent directories if they don’t exist
• opts: Connection options

Returns:

Information about the created directory

existsCopy Anchor Link

async def exists(path: str, **opts: Unpack[VolumeApiParams]) -> bool

Check whether a file or directory exists.

Uses get_info under the hood. Returns True if the path exists, False if it does not (404). Other errors are re-raised.

Arguments:

• path: Path to the file or directory
• opts: Connection options

Returns:

True if the path exists, False otherwise

update_metadataCopy Anchor Link

async def update_metadata(path: str,
                          uid: Optional[int] = None,
                          gid: Optional[int] = None,
                          mode: Optional[int] = None,
                          **opts: Unpack[VolumeApiParams]) -> VolumeEntryStat

Update file or directory metadata.

Arguments:

• path: Path to the file or directory
• uid: User ID of the file or directory
• gid: Group ID of the file or directory
• mode: Mode of the file or directory
• opts: Connection options

Returns:

Updated entry information

read_fileCopy Anchor Link

async def read_file(
    path: str,
    format: Literal["text", "bytes", "stream"] = "text",
    **opts: Unpack[VolumeApiParams]
) -> Union[str, bytes, AsyncIterator[bytes]]

Read file content.

You can pass text, bytes, or stream to format to change the return type.

Arguments:

• path: Path to the file
• format: Format of the file content—text by default
• opts: Connection options

Returns:

File content as string, bytes, or async iterator of bytes

write_fileCopy Anchor Link

async def write_file(path: str,
                     data: Union[str, bytes, IO[bytes]],
                     uid: Optional[int] = None,
                     gid: Optional[int] = None,
                     mode: Optional[int] = None,
                     force: Optional[bool] = None,
                     **opts: Unpack[VolumeApiParams]) -> VolumeEntryStat

Write content to a file.

Writing to a file that doesn’t exist creates the file. Writing to a file that already exists overwrites the file.

Arguments:

• path: Path to the file
• data: Data to write to the file. Data can be a string, bytes, or IO.
• uid: User ID of the created file
• gid: Group ID of the created file
• mode: Mode of the created file
• force: Force overwrite of an existing file
• opts: Connection options

Returns:

Information about the written file

removeCopy Anchor Link

async def remove(path: str, **opts: Unpack[VolumeApiParams]) -> None

Remove a file or directory.

Arguments:

• path: Path to the file or directory to remove
• opts: Connection options