Desktop Class

Desktop Class

start()

def start(self) -> Container:
    """
    Starts the container if it's not already running.
    """

Behavior:

Starts the docker container thats initialized in the Desktop() constructor
Checks if a container with the specified name already exists.
If the container exists but is not running, it starts it.
Note: In this case, it will not pull the latest image
If the container does not exist, the method attempts to run it:
- It will attempt to pull the latest image before starting the container
Waits a short time (2 seconds) for services to initialize.
Returns the running container object.

Returns:

Exceptions:

stop()

def stop(self) -> None:
    """
    Stops and removes the container.
    """

Behavior:

Returns:

exec(command)

def exec(self, command: str) -> dict:
    """
    Runs a shell command inside the container.
    """

Arguments:

Behavior:

Returns: A dictionary with:

{
  "result": (string output),
  "returncode": (integer exit code)
}