"""Unit tests for the tool instance service.""" from unittest.mock import MagicMock, AsyncMock import pytest from src.services.tool.instance_service import ( _get_repository_mount_name, modify_compose_file, prepare_manifest_instance, ) @pytest.mark.unit class TestModifyComposeFile: """Tests for modify_compose_file home-directory expansion.""" def test_extra_volumes_expand_home_dir(self, tmp_path): compose_path = tmp_path / "docker-compose.yml" compose_path.write_text( "services:\n app:\n image: test:latest\n volumes: []\n" ) modify_compose_file( str(compose_path), extra_volumes=[ {"source": "/host/config", "target": "~/.config", "type": "bind"}, {"source": "/host/code", "target": "$HOME/code", "type": "bind"}, ], home_dir="/home/user", ) content = compose_path.read_text() assert "/host/config:/home/user/.config" in content assert "/host/code:/home/user/code" in content def test_working_directory_expands_home_dir(self, tmp_path): compose_path = tmp_path / "docker-compose.yml" compose_path.write_text("services:\n app:\n image: test:latest\n") modify_compose_file( str(compose_path), working_directory="~/workspace", home_dir="/home/user", ) content = compose_path.read_text() assert "working_dir: /home/user/workspace" in content @pytest.mark.unit class TestGetRepositoryMountName: """Tests for _get_repository_mount_name.""" def test_prefers_remote_url_name_over_user_provided_name(self): repo = MagicMock() repo.name = "src" repo.remote_url = "git@git.example.com:acme/headquarter.git" assert _get_repository_mount_name(repo) == "headquarter" def test_parses_browser_url_to_repo_name(self): repo = MagicMock() repo.name = "src" repo.remote_url = "https://github.com/acme/headquarter/tree/main" assert _get_repository_mount_name(repo) == "headquarter" def test_uses_workspace_path_basename_when_workspace_provided(self): repo = MagicMock() repo.name = "src" repo.remote_url = "git@git.example.com:acme/headquarter.git" workspace = MagicMock() workspace.path = "/data/working-copies/uuid/headquarter" assert _get_repository_mount_name(repo, workspace) == "headquarter" def test_falls_back_to_repo_name_when_remote_url_missing(self): repo = MagicMock() repo.name = "my-cool-repo" repo.remote_url = None assert _get_repository_mount_name(repo) == "my-cool-repo" def test_falls_back_to_repo_name_for_unparseable_url(self): repo = MagicMock() repo.name = "my-cool-repo" repo.remote_url = "" assert _get_repository_mount_name(repo) == "my-cool-repo" @pytest.mark.unit async def test_prepare_manifest_instance_uses_workspace_path_basename(): """WORKSPACE_NAME must be the repo-named workspace directory, not workspace.name.""" repo = MagicMock() repo.name = "src" repo.remote_url = "git@git.example.com:acme/headquarter.git" repo.path = "/data/repos/main" workspace = MagicMock() workspace.id = "workspace-uuid" workspace.repo_id = "repo-uuid" workspace.name = "main" workspace.path = "/data/working-copies/workspace-uuid/headquarter" tool_type = MagicMock() tool_type.name = "pi-agent" tool_type.manifest_id = "manifest-uuid" manifest_def = MagicMock() manifest_def.id = "manifest-uuid" manifest_def.manifest = { "base_image": "ubuntu:24.04", "interface_type": "terminal", "user": {"name": "user", "uid": 1001, "gid": 1001}, } manifest_def.base_definition_id = None instance = MagicMock() instance.id = "instance-uuid" instance.name = "pi-agent-headquarter-abc123" instance.repository_id = "repo-uuid" instance.tool_type_id = "tooltype-uuid" instance.port = 0 instance.selected_config_profile_id = None instance.workspace_id = "workspace-uuid" session = AsyncMock() async def session_get(model, obj_id): if model.__name__ == "ToolType": return tool_type if model.__name__ == "ToolDefinitionManifest": return manifest_def if model.__name__ == "GitRepository": return repo if model.__name__ == "Workspace": return workspace return None session.get.side_effect = session_get # Patch docker images check to report the image already exists so we skip # the actual Docker build. import subprocess from src.services.tool import instance_service original_run = subprocess.run def fake_run(cmd, **kwargs): class Result: returncode = 0 stdout = "image-id" stderr = "" return Result() instance_service.subprocess.run = fake_run try: ( image_tag, compose_content, manifest, home_dir, ) = await prepare_manifest_instance( session=session, instance=instance, instance_dir="/tmp/instance", repo_path="/data/working-copies/workspace-uuid/headquarter", env_vars={}, extra_volumes=[], working_directory=None, ) finally: instance_service.subprocess.run = original_run assert "WORKSPACE_NAME: headquarter" in compose_content assert "/data/working-copies/workspace-uuid/headquarter:/home/user/headquarter" in compose_content