Sessions

`class ContreeSession`

class contree_sdk.sdk.objects.session.ContreeSession(image)

Attributes

timedelta

Time elapsed during execution.

int

Exit code of the executed command.

ContreeResult

Execution result. Only available after successful execution.

ImageState

Current state of the image in the execution lifecycle.

Stderr output from the execution.

Configured stdin source.

Stdout output from the execution.

UUID | None

Unique identifier of the image.

str | None

Optional tag associated with the image.

Methods

`apply_files()`

async def apply_files(*args, files) -> TypeVar(_T, bound= _ImageLikeBase)

Upload files into a new image derived from this one.

Files to upload.

default:"None"

Files as a list or a dict mapping destination paths to sources. When both args and files are provided, they are merged.

TypeVar(_T, bound= _ImageLikeBase)

New image with the uploaded files baked in.

`download()`

async def download(image_path, local_path) -> Path | None

Download a file from the image to local filesystem.

str | PurePosixPath

required

Path to the file inside the image.

str | Path | None

default:"None"

Local destination path. Defaults to filename from image_path.

Path | None

Path to the downloaded file.

`ls()`

async def ls(path) -> list[ImageFile | ImageDirectory]

List files and directories at the given path.

str | PurePosixPath

default:"'/'"

Path inside the image to list.

list[ImageFile | ImageDirectory]

list[ImageFile | ImageDirectory]List of ImageFile and ImageDirectory objects.

`read()`

async def read(image_path) -> bytes

Read file contents from the image.

str | PurePosixPath

required

Path to the file inside the image.

bytes

File contents as bytes.

`run()`

def run(command, *, shell, args, env, cwd, hostname, stdin, stdout, stderr, tag, files, timeout, disposable, truncate_output_at, preserve_env) -> TypeVar(_T, bound= _ImageLikeBase)

Prepare image for command execution.

str | None

default:"None"

Command to execute (mutually exclusive with shell).

str | None

default:"None"

Shell command string (mutually exclusive with command).

Iterable[str] | None

default:"None"

Command arguments.

dict[str, str] | None

default:"None"

Environment variables.

str | None

default:"None"

Working directory inside the image.

str | None

default:"None"

Hostname for the container.

default:"None"

Input source.

default:"<class 'str'>"

Output destination for stdout.

default:"<class 'str'>"

Output destination for stderr.

str | None

default:"None"

Tag for the resulting image.

default:"None"

Files to upload into the image.

float | timedelta | None

default:"None"

Execution timeout in seconds or as timedelta.

bool

default:"True"

If True, image is discarded after execution.

int | None

default:"None"

number of bytes to truncate stdout and stderr. Defaults to default_truncate_output_at

bool

default:"False"

If True, environment variables are preserved in resulting image after execution.

TypeVar(_T, bound= _ImageLikeBase)

New image instance configured for execution.

DisposableImageRunError – If attempting to run on a disposed image.

ValueError – If neither command nor shell is provided.

`start()`

async def start() -> TypeVar(_T, bound= _ImageLikeBase)

Start the prepared command without waiting for completion.

TypeVar(_T, bound= _ImageLikeBase)

New image instance in EXECUTING state; await it or iterate its output chunks to get the result.

`tag_as()`

async def tag_as(tag) -> TypeVar(_T, bound= _ImageLikeBase)

Tag this image with the specified tag, or remove the tag if None.

str | None

required

Tag name to apply to the image, or None to remove the tag.

TypeVar(_T, bound= _ImageLikeBase)

New instance with updated tag.

`untag()`

async def untag() -> TypeVar(_T, bound= _ImageLikeBase)

Remove the tag from this image.

TypeVar(_T, bound= _ImageLikeBase)

New instance with tag set to None.

`class ContreeSessionSync`

class contree_sdk.sdk.objects.session.ContreeSessionSync(image)

Attributes

timedelta

Time elapsed during execution.

int

Exit code of the executed command.

ContreeResult

Execution result. Only available after successful execution.

ImageState

Current state of the image in the execution lifecycle.

Stderr output from the execution.

Configured stdin source.

Stdout output from the execution.

UUID | None

Unique identifier of the image.

str | None

Optional tag associated with the image.

Methods

`apply_files()`

def apply_files(*args, files) -> TypeVar(_T, bound= _ImageLikeBase)

Upload files into a new image derived from this one.

Files to upload.

default:"None"

Files as a list or a dict mapping destination paths to sources. When both args and files are provided, they are merged.

TypeVar(_T, bound= _ImageLikeBase)

New image with the uploaded files baked in.

`download()`

def download(image_path, local_path) -> Path | None

Download a file from the image to local filesystem.

str | PurePosixPath

required

Path to the file inside the image.

str | Path | None

default:"None"

Local destination path. Defaults to filename from image_path.

Path | None

Path to the downloaded file.

`ls()`

def ls(path) -> list[ImageFileSync | ImageDirectorySync]

List files and directories at the given path.

str | PurePosixPath

default:"'/'"

Path inside the image to list.

list[ImageFileSync | ImageDirectorySync]

list[ImageFileSync | ImageDirectorySync]List of ImageFileSync and ImageDirectorySync objects.

`popen()`

def popen(args, *, stdin, input, stdout, stderr, shell, cwd, timeout, check, text, env) -> ContreeProcessSync

Run a command with subprocess-like interface.

list[str] | str | None

default:"None"

Command and arguments list.

default:"None"

Input source.

default:"None"

Alternative input source (alias for stdin).

default:"None"

Output destination for stdout.

default:"None"

Output destination for stderr.

bool

default:"False"

If True, treat args as shell command.

str | None

default:"None"

Working directory inside the image.

float | None

default:"None"

Execution timeout in seconds.

bool

default:"False"

If True, raise on non-zero exit code.

bool | None

default:"None"

If True, decode output as text.

dict[str, str] | None

default:"None"

Environment variables.

ContreeProcessSync

ContreeProcessSyncContreeProcessSync object with execution results.

`read()`

def read(image_path) -> bytes

Read file contents from the image.

str | PurePosixPath

required

Path to the file inside the image.

bytes

File contents as bytes.

`run()`

def run(command, *, shell, args, env, cwd, hostname, stdin, stdout, stderr, tag, files, timeout, disposable, truncate_output_at, preserve_env) -> TypeVar(_T, bound= _ImageLikeBase)

Prepare image for command execution.

str | None

default:"None"

Command to execute (mutually exclusive with shell).

str | None

default:"None"

Shell command string (mutually exclusive with command).

Iterable[str] | None

default:"None"

Command arguments.

dict[str, str] | None

default:"None"

Environment variables.

str | None

default:"None"

Working directory inside the image.

str | None

default:"None"

Hostname for the container.

default:"None"

Input source.

default:"<class 'str'>"

Output destination for stdout.

default:"<class 'str'>"

Output destination for stderr.

str | None

default:"None"

Tag for the resulting image.

default:"None"

Files to upload into the image.

float | timedelta | None

default:"None"

Execution timeout in seconds or as timedelta.

bool

default:"True"

If True, image is discarded after execution.

int | None

default:"None"

number of bytes to truncate stdout and stderr. Defaults to default_truncate_output_at

bool

default:"False"

If True, environment variables are preserved in resulting image after execution.

TypeVar(_T, bound= _ImageLikeBase)

New image instance configured for execution.

DisposableImageRunError – If attempting to run on a disposed image.

ValueError – If neither command nor shell is provided.

`start()`

def start() -> TypeVar(_T, bound= _ImageLikeBase)

Start the prepared command without waiting for completion.

TypeVar(_T, bound= _ImageLikeBase)

New image instance in EXECUTING state; await it or iterate its output chunks to get the result.

`tag_as()`

def tag_as(tag) -> TypeVar(_T, bound= _ImageLikeBase)

Tag this image with the specified tag, or remove the tag if None.

str | None

required

Tag name to apply to the image, or None to remove the tag.

TypeVar(_T, bound= _ImageLikeBase)

New instance with updated tag.

`untag()`

def untag() -> TypeVar(_T, bound= _ImageLikeBase)

Remove the tag from this image.

TypeVar(_T, bound= _ImageLikeBase)

New instance with tag set to None.

`wait()`

def wait() -> TypeVar(_T, bound= _ImageLikeSync)

Execute the prepared command and wait for completion.

TypeVar(_T, bound= _ImageLikeSync)

New image instance with execution results.

Get Started

Inference

Observability

Post-training

Data Lab

Sandboxes

Teams & Access Management

Other Capabilities

Integrations

`class ContreeSession`

Attributes

Methods

`apply_files()`

`download()`

`ls()`

`read()`

`run()`

`start()`

`tag_as()`

`untag()`

`class ContreeSessionSync`

Attributes

Methods

`apply_files()`

`download()`

`ls()`

`popen()`

`read()`

`run()`

`start()`

`tag_as()`

`untag()`

`wait()`

​class ContreeSession

​Attributes

​Methods

​apply_files()

​download()

​ls()

​read()

​run()

​start()

​tag_as()

​untag()

​class ContreeSessionSync

​Attributes

​Methods

​apply_files()

​download()

​ls()

​popen()

​read()

​run()

​start()

​tag_as()

​untag()

​wait()

`class ContreeSession`

Attributes

Methods

`apply_files()`

`download()`

`ls()`

`read()`

`run()`

`start()`

`tag_as()`

`untag()`

`class ContreeSessionSync`

Attributes

Methods

`apply_files()`

`download()`

`ls()`

`popen()`

`read()`

`run()`

`start()`

`tag_as()`

`untag()`

`wait()`