Files
litellm/tests/test_litellm/containers/test_container_utils.py
T
Sameer Kankute d03ecedba1 feat(containers): Azure routing, managed container IDs, delete response parsing (#25287)
* feat(containers): Azure container routing, managed IDs, and delete response wire format

- Add AzureContainerConfig and safe URL joining for paths with api-version query
- Encode/decode managed container IDs in responses, streaming, and proxy handlers
- Accept OpenAI delete response object literal container.file.deleted
- Tests for Azure URL regression and DeleteContainerFileResponse parsing

Made-with: Cursor

* fix(responses): gate response id update on parsed_chunk having response

Delta stream events do not include a response body; Mock-based tests
(and any truthy synthetic .response on transforms) must not trigger
_update_responses_api_response_id_with_model_id. Fixes
test_stop_async_iteration_not_logged_as_failure (TypeError: Mock not iterable).

Made-with: Cursor

* feat(containers): encode container IDs in SDK responses for routing

- Add ContainerRequestUtils.encode_container_id_in_response utility
- Encode container_id in create/retrieve/delete responses (SDK path)
- Fix streaming iterator: gate response ID update on parsed_chunk key
- Follows responses API pattern (encode after handler, not in handler)

Made-with: Cursor

* fix(containers): module-level imports and managed cntr_ ID encoding

- Move ResponsesAPIRequestUtils imports to module scope (utils, main, handler_factory).
- Serialize absent model_id as empty segment instead of literal None; decode empty
  and legacy "None" segments as missing for router affinity.
- Add unit tests for build/decode round-trip and legacy IDs.

Made-with: Cursor

* fix(containers): decode managed IDs in endpoint_factory SDK path

- Add decode_managed_container_id_for_request in containers/utils and reuse from main.
- Strip LiteLLM cntr_ wrappers before generic_container_handler (64-char API limit).
- Resolve provider for logging/errors; add unit test for decode helper.
- Use resolved_custom_llm_provider after decode for mypy-safe provider typing.

Made-with: Cursor

* Fix p1 concern

* Fix p1 concern
2026-04-11 09:21:01 -07:00

274 lines
9.7 KiB
Python

import os
import sys
import pytest
sys.path.insert(
0, os.path.abspath("../../..")
) # Adds the parent directory to the system path
import litellm
from litellm.containers.utils import (
ContainerRequestUtils,
decode_managed_container_id_for_request,
)
from litellm.responses.utils import ResponsesAPIRequestUtils
from litellm.types.router import GenericLiteLLMParams
from litellm.llms.openai.containers.transformation import OpenAIContainerConfig
from litellm.types.containers.main import (
ContainerCreateOptionalRequestParams,
ContainerListOptionalRequestParams,
DeleteContainerFileResponse,
)
class TestContainerRequestUtils:
"""Test suite for container request utilities."""
def test_get_optional_params_container_create_basic(self):
"""Test that optional parameters are correctly processed for container creation."""
# Setup
config = OpenAIContainerConfig()
optional_params = ContainerCreateOptionalRequestParams(
{
"expires_after": {"anchor": "last_active_at", "minutes": 30},
"file_ids": ["file_123", "file_456"]
}
)
# Execute
result = ContainerRequestUtils.get_optional_params_container_create(
container_provider_config=config,
container_create_optional_params=optional_params,
)
# Assert
assert result == optional_params
assert "expires_after" in result
assert result["expires_after"]["minutes"] == 30
assert "file_ids" in result
assert result["file_ids"] == ["file_123", "file_456"]
def test_get_optional_params_container_create_unsupported_param(self):
"""Test that unsupported parameters are filtered out by ContainerCreateOptionalRequestParams."""
# Setup
config = OpenAIContainerConfig()
# ContainerCreateOptionalRequestParams will only accept valid parameters
# so this test verifies the type validation works correctly
valid_params = ContainerCreateOptionalRequestParams(
{
"expires_after": {"anchor": "last_active_at", "minutes": 30},
"file_ids": ["file_123"]
}
)
# Execute - should work fine with valid parameters
result = ContainerRequestUtils.get_optional_params_container_create(
container_provider_config=config,
container_create_optional_params=valid_params,
)
assert result["expires_after"]["minutes"] == 30
assert result["file_ids"] == ["file_123"]
def test_get_requested_container_create_optional_param(self):
"""Test filtering parameters to only include those in ContainerCreateOptionalRequestParams."""
# Setup
params = {
"name": "Test Container", # This should be excluded as it's required
"expires_after": {"anchor": "last_active_at", "minutes": 30},
"file_ids": ["file_123"],
"invalid_param": "value",
"custom_llm_provider": "openai", # This should be excluded
}
# Execute
result = ContainerRequestUtils.get_requested_container_create_optional_param(
params
)
# Assert
assert "expires_after" in result
assert "file_ids" in result
assert "invalid_param" not in result
assert "name" not in result
assert "custom_llm_provider" not in result
assert result["expires_after"]["minutes"] == 30
assert result["file_ids"] == ["file_123"]
def test_get_requested_container_list_optional_param(self):
"""Test filtering parameters for container list requests."""
# Setup
params = {
"after": "cntr_123",
"limit": 10,
"order": "desc",
"invalid_param": "value",
"custom_llm_provider": "openai", # This should be excluded
}
# Execute
result = ContainerRequestUtils.get_requested_container_list_optional_param(
params
)
# Assert
assert "after" in result
assert "limit" in result
assert "order" in result
assert "invalid_param" not in result
assert "custom_llm_provider" not in result
assert result["after"] == "cntr_123"
assert result["limit"] == 10
assert result["order"] == "desc"
def test_get_optional_params_container_create_empty_params(self):
"""Test handling of empty optional parameters."""
# Setup
config = OpenAIContainerConfig()
optional_params = ContainerCreateOptionalRequestParams({})
# Execute
result = ContainerRequestUtils.get_optional_params_container_create(
container_provider_config=config,
container_create_optional_params=optional_params,
)
# Assert
assert result == optional_params
assert len(result) == 0
def test_get_optional_params_container_create_with_none_values(self):
"""Test handling of None values in optional parameters."""
# Setup
config = OpenAIContainerConfig()
optional_params = ContainerCreateOptionalRequestParams(
{
"expires_after": None,
"file_ids": None
}
)
# Execute
result = ContainerRequestUtils.get_optional_params_container_create(
container_provider_config=config,
container_create_optional_params=optional_params,
)
# Assert
assert result == optional_params
assert "expires_after" in result
assert "file_ids" in result
assert result["expires_after"] is None
assert result["file_ids"] is None
def test_get_requested_container_list_optional_param_partial(self):
"""Test filtering with only some list parameters present."""
# Setup
params = {
"limit": 5,
"custom_llm_provider": "openai", # Should be excluded
"timeout": 600, # Should be excluded
}
# Execute
result = ContainerRequestUtils.get_requested_container_list_optional_param(
params
)
# Assert
assert "limit" in result
assert "custom_llm_provider" not in result
assert "timeout" not in result
assert "after" not in result # Not present in input
assert "order" not in result # Not present in input
assert result["limit"] == 5
def test_container_create_optional_params_type_validation(self):
"""Test that ContainerCreateOptionalRequestParams validates types correctly."""
# Test with valid expires_after
valid_params = ContainerCreateOptionalRequestParams(
{
"expires_after": {"anchor": "last_active_at", "minutes": 20},
"file_ids": ["file_1", "file_2"]
}
)
assert valid_params["expires_after"]["anchor"] == "last_active_at"
assert valid_params["expires_after"]["minutes"] == 20
assert valid_params["file_ids"] == ["file_1", "file_2"]
def test_container_list_optional_params_type_validation(self):
"""Test that ContainerListOptionalRequestParams validates types correctly."""
# Test with valid parameters
valid_params = ContainerListOptionalRequestParams(
{
"after": "cntr_123",
"limit": 10,
"order": "desc"
}
)
assert valid_params["after"] == "cntr_123"
assert valid_params["limit"] == 10
assert valid_params["order"] == "desc"
def test_get_optional_params_with_supported_params_check(self):
"""Test that only supported parameters are accepted."""
# Setup
config = OpenAIContainerConfig()
# Get supported params to understand what should be allowed
supported_params = config.get_supported_openai_params()
# Create params with only valid parameters
test_params = {"expires_after": {"anchor": "last_active_at", "minutes": 15}}
optional_params = ContainerCreateOptionalRequestParams(test_params)
# Execute - should work fine with supported params
result = ContainerRequestUtils.get_optional_params_container_create(
container_provider_config=config,
container_create_optional_params=optional_params,
)
assert result["expires_after"]["minutes"] == 15
def test_decode_managed_container_id_returns_provider_container_id(self):
"""Managed IDs must decode to the short ID sent on upstream requests."""
inner = "cntr_69d4ff00deadbeef"
managed = ResponsesAPIRequestUtils._build_container_id(
custom_llm_provider="openai",
model_id=None,
container_id=inner,
)
assert len(managed) > len(inner)
litellm_params: GenericLiteLLMParams = GenericLiteLLMParams()
original_id, provider, updated = decode_managed_container_id_for_request(
managed, "openai", litellm_params
)
assert original_id == inner
assert provider == "openai"
assert updated is litellm_params
class TestDeleteContainerFileResponseWireFormat:
"""OpenAI / Azure return ``container.file.deleted`` on DELETE file."""
def test_accepts_openai_dot_notation(self):
m = DeleteContainerFileResponse(
id="cfile_abc",
object="container.file.deleted",
deleted=True,
)
assert m.object == "container.file.deleted"
def test_accepts_legacy_underscore(self):
m = DeleteContainerFileResponse(
id="cfile_abc",
object="container_file.deleted",
deleted=True,
)
assert m.object == "container_file.deleted"