litellm/tests/unit/test_container_router.py
yuneng-jiang f6882246d4
test: move tests/test_litellm root and small trees into tests/unit (#43186)
* ci: run the unit_selection.sh shard files on every event instead of only fork pull requests

Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>

* ci: rename fork-flag to unit-flag now that it applies on every event

* test: move tests/test_litellm root and small trees into tests/unit

Pure renames, no content changes. Follow-up commits in this PR fix
references, merge the three files that already existed in tests/unit,
keep live-provider tests in tests/test_litellm and wire CI.

* test: carry tests/test_litellm conftest isolation into tests/unit

Callback lists, routing fallbacks, cached HTTP clients, logger state, AWS,
proxy-URL and keychain env, and session-end client cleanup now reset for
unit tests too. The environment isolation owns its MonkeyPatch so a test's
own monkeypatch is undone before the model-cost teardown runs.

* test: merge, split and prune the moved root and small-tree tests

Merge batches/test_batch_utils.py and the chat_completions and messages
dispatch tests into the files that already existed in tests/unit. Keep
the live Gemini interactions tests, the async image-fetch format test and
the OpenAI embedding scorer test in tests/test_litellm since they need
real network or keys. Put test_router.py under tests/unit/test_router so
the existing package no longer shadows it. Delete eight tests the audit
found superseded by stronger ones kept in this move.

* ci: run the moved root and small-tree tests under their legacy flags

Add the misc and responses-caching-types flags to unit_selection.sh and
CircleCI, extend enterprise-routing and mcp-integration, and point the
legacy GHA shards, Makefile, redis-compat workflow, merge smoke manifest
and change classifier at the new paths.

* test: make the new tests/unit directories packages

tests/unit/test_package_layout.py requires every directory to carry an
__init__.py, and without one the moved and retained
test_litellm_responses_bridge.py modules collide on import.

* test: scope the unit socket block to tests/unit in shared sessions

The GHA shards collect the legacy test-path and the unit selection in one
pytest session. The unit conftest's loopback-only block leaked into legacy
modules that reach the network at import. The legacy conftest now lifts the
restriction at collect and setup time, and the unit conftest re-applies it
when collecting its own modules.

* test: give the shard-script tests their own GITHUB_OUTPUT

They only passed where the runner set it. The CircleCI unit job's env
allowlist drops it, so the script's redirect failed there.

* test: point the router and module-deletion checks at tests/unit

router_code_coverage and code_qa_check_tests only searched tests/test_litellm,
so the moved router tests no longer counted. The two silent-experiment tests
the audit deleted were the only direct callers of those methods; they are
replaced with tests that assert the forwarded shadow request and the
recursion guard.

---------

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
2026-09-25 11:30:43 -07:00

204 lines
7.5 KiB
Python

"""
Test suite for Container API router functionality.
Tests that the router method gets called correctly for container operations.
"""
import pytest
from unittest.mock import Mock, patch, MagicMock
import litellm
class TestContainerRouter:
"""Test suite for Container API router functionality"""
def setup_method(self):
"""Setup test fixtures"""
self.container_name = "Test Container"
self.container_id = "cntr_123456789"
@patch("litellm.containers.main.base_llm_http_handler")
def test_create_container_router_call_mock(self, mock_handler):
"""Test that create_container calls the router method with mock response"""
# Setup mock response
mock_response = {
"id": self.container_id,
"object": "container",
"created_at": 1747857508,
"status": "running",
"expires_after": {"anchor": "last_active_at", "minutes": 20},
"last_active_at": 1747857508,
"name": self.container_name,
}
# Configure the mock handler
mock_handler.container_create_handler.return_value = mock_response
# Call the create_container function with mock response
result = litellm.create_container(
name=self.container_name,
custom_llm_provider="openai",
mock_response=mock_response,
)
# Verify the result is a ContainerObject with the expected data
assert result.id == mock_response["id"]
assert result.object == mock_response["object"]
assert result.name == mock_response["name"]
assert result.status == mock_response["status"]
assert result.created_at == mock_response["created_at"]
@patch("litellm.containers.main.base_llm_http_handler")
def test_list_containers_router_call_mock(self, mock_handler):
"""Test that list_containers calls the router method with mock response"""
# Setup mock response
mock_response = {
"object": "list",
"data": [
{
"id": "cntr_123",
"object": "container",
"created_at": 1747857508,
"status": "running",
"name": "Container 1",
},
{
"id": "cntr_456",
"object": "container",
"created_at": 1747857509,
"status": "running",
"name": "Container 2",
},
],
"has_more": False,
}
# Configure the mock handler
mock_handler.container_list_handler.return_value = mock_response
# Call the list_containers function with mock response
result = litellm.list_containers(
custom_llm_provider="openai", mock_response=mock_response
)
# Verify the result is a ContainerListResponse with the expected data
assert result.object == "list"
assert len(result.data) == 2
assert result.data[0].id == "cntr_123"
assert result.data[1].id == "cntr_456"
assert result.has_more is False
@patch("litellm.containers.main.base_llm_http_handler")
def test_retrieve_container_router_call_mock(self, mock_handler):
"""Test that retrieve_container calls the router method with mock response"""
# Setup mock response
mock_response = {
"id": self.container_id,
"object": "container",
"created_at": 1747857508,
"status": "running",
"expires_after": {"anchor": "last_active_at", "minutes": 20},
"last_active_at": 1747857508,
"name": self.container_name,
}
# Configure the mock handler
mock_handler.container_retrieve_handler.return_value = mock_response
# Call the retrieve_container function with mock response
result = litellm.retrieve_container(
container_id=self.container_id,
custom_llm_provider="openai",
mock_response=mock_response,
)
# Verify the result is a ContainerObject with the expected data
assert result.id == mock_response["id"]
assert result.object == mock_response["object"]
assert result.name == mock_response["name"]
assert result.status == mock_response["status"]
@patch("litellm.containers.main.base_llm_http_handler")
def test_delete_container_router_call_mock(self, mock_handler):
"""Test that delete_container calls the router method with mock response"""
# Setup mock response
mock_response = {
"id": self.container_id,
"object": "container.deleted",
"deleted": True,
}
# Configure the mock handler
mock_handler.container_delete_handler.return_value = mock_response
# Call the delete_container function with mock response
result = litellm.delete_container(
container_id=self.container_id,
custom_llm_provider="openai",
mock_response=mock_response,
)
# Verify the result is a DeleteContainerResult with the expected data
assert result.id == mock_response["id"]
assert result.object == mock_response["object"]
assert result.deleted is True
@pytest.mark.asyncio
@patch("litellm.containers.main.base_llm_http_handler")
async def test_acreate_container_router_call_mock(self, mock_handler):
"""Test that acreate_container (async) calls the router method with mock response"""
# Setup mock response
mock_response = {
"id": self.container_id,
"object": "container",
"created_at": 1747857508,
"status": "running",
"name": self.container_name,
}
# Configure the mock handler
mock_handler.container_create_handler.return_value = mock_response
# Call the async create_container function with mock response
result = await litellm.acreate_container(
name=self.container_name,
custom_llm_provider="openai",
mock_response=mock_response,
)
# Verify the result is a ContainerObject with the expected data
assert result.id == mock_response["id"]
assert result.object == mock_response["object"]
assert result.name == mock_response["name"]
assert result.status == mock_response["status"]
@pytest.mark.asyncio
@patch("litellm.containers.main.base_llm_http_handler")
async def test_alist_containers_router_call_mock(self, mock_handler):
"""Test that alist_containers (async) calls the router method with mock response"""
# Setup mock response
mock_response = {
"object": "list",
"data": [
{
"id": "cntr_123",
"object": "container",
"created_at": 1747857508,
"status": "running",
"name": "Container 1",
}
],
"has_more": False,
}
# Configure the mock handler
mock_handler.container_list_handler.return_value = mock_response
# Call the async list_containers function with mock response
result = await litellm.alist_containers(
custom_llm_provider="openai", mock_response=mock_response
)
# Verify the result is a ContainerListResponse with the expected data
assert result.object == "list"
assert len(result.data) == 1
assert result.data[0].id == "cntr_123"