Abstract

swerex.runtime.abstract.AbstractRuntime

AbstractRuntime(*args: Any, **kwargs: Any)

Bases: ABC

This is the main entry point for running stuff.

It keeps track of all the sessions (individual repls) that are currently open.

Source code in swerex/runtime/abstract.py

def __init__(self, *args: Any, **kwargs: Any):
    self.logger: logging.Logger

logger instance-attribute

logger: Logger

close abstractmethod async

close() -> CloseResponse

Closes the runtime.

Source code in swerex/runtime/abstract.py

@abstractmethod
async def close(self) -> CloseResponse:
    """Closes the runtime."""
    pass

close_session abstractmethod async

close_session(request: CloseSessionRequest) -> CloseSessionResponse

Closes a shell session (e.g., a bash shell that we started earlier).

Source code in swerex/runtime/abstract.py

@abstractmethod
async def close_session(self, request: CloseSessionRequest) -> CloseSessionResponse:
    """Closes a shell session (e.g., a bash shell that we started earlier)."""
    pass

create_session abstractmethod async

create_session(request: CreateSessionRequest) -> CreateSessionResponse

Creates a new session (e.g., a bash shell).

Source code in swerex/runtime/abstract.py

@abstractmethod
async def create_session(self, request: CreateSessionRequest) -> CreateSessionResponse:
    """Creates a new session (e.g., a bash shell)."""
    pass

execute abstractmethod async

execute(command: Command) -> CommandResponse

Executes a command (in a sub-shell, similar to subprocess.run()).

Source code in swerex/runtime/abstract.py

@abstractmethod
async def execute(self, command: Command) -> CommandResponse:
    """Executes a command (in a sub-shell, similar to `subprocess.run()`)."""
    pass

is_alive abstractmethod async

is_alive(*, timeout: float | None = None) -> IsAliveResponse

Checks if the runtime is alive and running.

Source code in swerex/runtime/abstract.py

@abstractmethod
async def is_alive(self, *, timeout: float | None = None) -> IsAliveResponse:
    """Checks if the runtime is alive and running."""
    pass

read_file abstractmethod async

read_file(request: ReadFileRequest) -> ReadFileResponse

Reads a file and returns the content as a string.

Source code in swerex/runtime/abstract.py

@abstractmethod
async def read_file(self, request: ReadFileRequest) -> ReadFileResponse:
    """Reads a file and returns the content as a string."""
    pass

run_in_session abstractmethod async

run_in_session(action: Action) -> Observation

Runs a command in a session (e.g., a bash shell). The name of the session is determined by the session field in the Action.

Source code in swerex/runtime/abstract.py

@abstractmethod
async def run_in_session(self, action: Action) -> Observation:
    """Runs a command in a session (e.g., a bash shell).
    The name of the session is determined by the `session` field in the `Action`.
    """
    pass

upload abstractmethod async

upload(request: UploadRequest) -> UploadResponse

Uploads a file from the local machine to the remote machine.

Source code in swerex/runtime/abstract.py

@abstractmethod
async def upload(self, request: UploadRequest) -> UploadResponse:
    """Uploads a file from the local machine to the remote machine."""
    pass

write_file abstractmethod async

write_file(request: WriteFileRequest) -> WriteFileResponse

Writes a string to a file.

Source code in swerex/runtime/abstract.py

@abstractmethod
async def write_file(self, request: WriteFileRequest) -> WriteFileResponse:
    """Writes a string to a file."""
    pass