pyproject.toml

[project]
name = "llm-interactive-proxy"
version = "0.1.0"
description = "The swiss-army knife for LLM-powered applications. A universal proxy that seamlessly translates between OpenAI, Anthropic, and Gemini APIs while routing to any provider you choose. Override hardcoded models, prevent infinite loops, rotate API keys, capture and debug traffic, and automatically steer conversations away from trouble. Perfect for making any AI client work with any model, anywhere."
authors = [
    { name = "Mateusz B.", email = "llm.interactive.proxy@matdev83.anonaddy.com" },
]
dependencies = [
    "fastapi",
    "uvicorn[standard]",
    "httpx[http2]",
    "python-dotenv",
    "pydantic>=2",
    "openai==1.84.0",
    "tomli",
    "typer",
    "rich",
    "llm-accounting",
    "tiktoken",
    "google-genai",
    "anthropic",
    "structlog",
    "pyyaml",
    "jsonschema>=4.19.0",
    "google-auth>=2.27.0",
    "json-repair",
    "ijson",
    "watchdog",
    "pytz",
    "pytest-asyncio==0.23.7",
    "pytest-xdist==3.6.1",
    "cbor2>=5.6.0",
    "authlib>=1.3.0",
    "argon2-cffi>=23.1.0",
    "aiosqlite>=0.19.0",
    "python-multipart>=0.0.6",
    "ping3>=4.0.0",
    "sqlmodel>=0.0.22",
    "alembic>=1.13.0",
    "greenlet>=3.0.0",
    "cachetools>=5.3.0",
    "desktop-notifier",
    "websockets>=12.0",
]
requires-python = ">=3.10"
readme = "README.md"
# License per PEP 621: string SPDX identifier
license = "AGPL-3.0-or-later"
keywords = ["llm", "proxy", "interactive", "api", "ai", "chatgpt", "openai", "gemini", "openrouter"]
urls = { Home = "https://github.com/matdev83/llm-interactive-proxy" } 
classifiers = [
    "Development Status :: 3 - Alpha",
    "Intended Audience :: Developers",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.10",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",
    "Topic :: Scientific/Engineering :: Artificial Intelligence",
    "Topic :: Internet :: Proxy Servers",
    "Operating System :: OS Independent", # Common classifier
]



[project.optional-dependencies]
oauth = [
    "llm-proxy-oauth-connectors",
]

dev = [
    # Test stack (pin to match local green runs)
    "pytest==8.3.2",
    "pytest-asyncio==0.23.7",
    "pytest-cov==5.0.0",
    "pytest-xdist==3.6.1",
    "pytest-httpx==0.30.0",
    "pytest-mock==3.14.0",
    "freezegun==1.5.1",
    # Linters/formatters
    "ruff==0.5.6",
    "black==24.8.0",
    "requests",
    "bandit",
    "mdformat",
    "pymarkdownlnt",
    "types-PyYAML==6.0.12.20240808",
    "types-jsonschema==4.23.0.20240813",
    "types-colorama==0.4.15.20240311",
    "types-cachetools>=5.3.0",
    "respx",
    "dependency-injector",
    "vulture",
    "pytest-snapshot==0.9.0",
    "mypy==1.10.0",
    "hypothesis==6.112.1",
    "xenon",
    "radon",
    "types-pytz",
    "pytest-testmon",
    "pytest-timeout",


]

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[tool.setuptools]
package-dir = {"" = "src"}

[tool.pytest.ini_options]
testpaths = ["tests"]
norecursedirs = ["tmp.*", "build", "benchmark", "_site", "OLD", "dev/thrdparty"]
# JUnit XML generation is conditional - only when CI env var is set or explicitly requested
# This reduces I/O overhead during local development
# Use --junit-xml=test-results.xml to enable explicitly
# Using loadfile distribution - more efficient for test suites with file-level fixtures
addopts = "--asyncio-mode=auto -W ignore --max-worker-restart=50 -n 4 --dist=loadfile --timeout=400 --timeout-method=thread -r fE"
asyncio_mode = "auto"
junit_duration_report = "call"
log_cli_level = "WARNING"

# Logging configuration
# Reduced from DEBUG to WARNING to minimize disk I/O overhead during test execution
# Use --log-cli-level=DEBUG or --log-file-level=DEBUG when debugging is needed
log_file = "./var/logs/pytest.log"
log_file_level = "WARNING"
log_file_format = "%(asctime)s [%(levelname)8s] %(name)s:%(lineno)s %(message)s"
log_file_date_format = "%Y-%m-%d %H:%M:%S"
# Filter warnings
filterwarnings = [
    "ignore::UserWarning:pydantic._internal._fields",
    "ignore::DeprecationWarning",
    "ignore:coroutine 'AsyncMockMixin\\._execute_mock_call' was never awaited:RuntimeWarning",
    "ignore:DI CONTAINER VIOLATIONS DETECTED:UserWarning",
    "ignore::ResourceWarning",
    "ignore::Warning",
    # Targeted upstream/runtime warnings (Windows + websockets)
    "ignore:unclosed event loop <ProactorEventLoop.*:ResourceWarning",
    "ignore:.*websockets\\.legacy is deprecated.*:DeprecationWarning",
    "ignore:.*websockets\\.server\\.WebSocketServerProtocol is deprecated.*:DeprecationWarning",
    "ignore:.*Construction of dict of EntryPoints is deprecated.*:DeprecationWarning",
    "ignore:unclosed file <_io\\..*:ResourceWarning",
    # Pydantic V2 deprecation warnings from external library
    "ignore:Support for class-based.*:pydantic.warnings.PydanticDeprecatedSince20",
]
# To run integration tests, use: pytest -m integration
# To run command tests, use: pytest -m command
# To run session tests, use: pytest -m session
# To run backend tests, use: pytest -m backend
# To run DI tests, use: pytest -m di
# To run tests without global mock, use: pytest -m no_global_mock
# To run slow tests, use: pytest -m slow
# To run codex tests (development only): pytest -m codex
markers = [
    "integration: marks tests as integration tests (deselect with '-m \"not integration\"')",
    "unit: marks tests as unit tests",
    "network: marks tests that require network access (deselect with '-m \"not network\"')",
    "regression: marks tests as regression tests",
    "backends: marks tests that need specific backends to be initialized",
    "backend: marks tests that need a specific backend to be initialized",
    "custom_backend_mock: marks tests that use custom backend mocking strategies",
    "httpx_mock: marks tests that use httpx mocking (provided by pytest-httpx plugin)",
    "no_global_mock: marks tests that should not use global mocking",
    "command: marks tests related to command handling",
    "session: marks tests related to session state management",
    "di: marks tests that use the dependency injection architecture",
    "loop_detection: marks tests related to loop detection",
    "multimodal: marks tests related to multimodal content",
    "quality: Tests that check code quality (linting, formatting)",
    "slow: marks tests that are slow to run and should be excluded by default",
    "codex: marks tests for Codex backend (included by default)",
    "testmon_cache: marks tests that should disable testmon cache",
    "real_time: marks tests that legitimately require real system wall-clock time (requires reason parameter)",
    "performance: marks tests as performance benchmarks (excluded by default, use with -m performance)",
]

[tool.mdformat]
# Disable automatic line wrapping for Markdown files to match CI expectations
wrap = 0

[tool.pylint.messages_control]
disable = ["C0301", "C0303", "C0114", "C0116"]

[tool.ruff]
# Target src and tests directories with Python files
src = ["src", "tests"]

# Exclude common directories
exclude = [
    ".bzr",
    ".direnv",
    ".eggs",
    ".git",
    ".git-rewrite",
    ".hg",
    ".mypy_cache",
    ".nox",
    ".pants.d",
    ".pytype",
    ".ruff_cache",
    ".svn",
    ".tox",
    ".venv",
    "__pypackages__",
    "_build",
    "buck-out",
    "build",
    "dist",
    "node_modules",
    "venv",
    ".pytest_cache",
    "__pycache__",
    "dev/thrdparty",
]

# Same as Black.
line-length = 88
indent-width = 4

# Assume Python 3.10+
target-version = "py310"

[tool.ruff.lint]
# Enable only rules that catch real issues, not formatting
select = [
    # Pyflakes - catches unused imports, undefined names, etc.
    "F",
    # pycodestyle errors - only serious runtime/syntax errors
    "E9",   # Runtime errors
    # isort - import sorting issues
    "I",
    # pep8-naming - naming convention violations
    "N",
    # pyupgrade - outdated syntax
    "UP",
    # flake8-bugbear - likely bugs
    "B",
    # flake8-simplify - code simplification
    "SIM",
    # flake8-comprehensions - list/dict/set comprehension issues
    "C4",
    # flake8-pie - unnecessary code
    "PIE",
    # mccabe - cyclomatic complexity checking
    "C90",
    # Ruff-specific rules
    "RUF",
]

# Ignore formatting and whitespace-related rules
ignore = [
    # Pycodestyle whitespace and newline rules
    "E1", "E2", "E3",
    "W1", "W2", "W3",
    # Pydocstyle
    "D",
    # Specific formatting rules to ignore
    "E501",  # Line too long
    "E701",  # Multiple statements on one line
    "E702",  # Multiple statements on one line (semicolon)
    "E711",  # Comparison to None should be 'is' or 'is not'
    "E712",  # Comparison to True should be 'is' or 'is not'
    "E713",  # Test for membership should be 'not in'
    "E714",  # Test for object identity should be 'is not'
    "COM812", # Missing trailing comma
    "COM819", # Trailing comma prohibited
    "Q000", # Double quotes found but single quotes preferred

    # Ignore some overly strict rules
    "B008",  # Do not perform function calls in argument defaults
    "B904",  # Within an except clause, raise exceptions with raise ... from err
    "SIM108", # Use ternary operator instead of if-else-block
    "RUF012", # Mutable class attributes should be annotated with `typing.ClassVar`
    "N806", # Variable in function should be lowercase (for test constants)
]

# Allow fix for all enabled rules (except those in unfixable)
fixable = ["ALL"]
unfixable = []

# Allow unused variables when underscore-prefixed
dummy-variable-rgx = "^(_+|(_+[a-zA-Z0-9_]*[a-zA-Z0-9]+?))$"

[tool.ruff.lint.mccabe]
# Maximum cyclomatic complexity threshold (Requirement 4.2)
max-complexity = 50

[tool.ruff.lint.per-file-ignores]
# Pre-existing complexity violations outside DI refactoring scope.
# These files exceed the C901 complexity threshold and are documented as technical debt.
# Per tasks.md requirement 4.2, complexity gates only apply to DI-scope files.
# Tracking issue: Consider refactoring these files in dedicated efforts.
"src/anthropic_converters.py" = ["C901"]  # openai_stream_to_anthropic_stream (58)
"src/connectors/gemini_base/streaming_executor.py" = ["C901"]  # _stream_generator (65)
"src/connectors/openai_codex.py" = ["C901"]  # _call_codex_responses_api (72)
"src/connectors/openai.py" = ["C901"]  # _handle_streaming_response (51)
"src/core/app/controllers/chat_controller.py" = ["C901"]  # handle_chat_completion (72)
"src/core/auth/sso/web_interface.py" = ["C901"]  # create_sso_router (66)
"src/core/domain/translators/gemini/request.py" = ["C901"]  # from_domain_to_gemini_request (79)
"src/core/domain/translators/responses/streaming.py" = ["C901"]  # responses_to_domain_stream_chunk (71)
"src/core/services/backend_request_manager_service.py" = ["C901"]  # _process_streaming_response (101)
"src/core/transport/fastapi/response_adapters.py" = ["C901"]  # to_fastapi_streaming_response (164), _streaming_adapter (160)
"src/core/app/controllers/responses_controller.py" = ["C901"]  # handle_responses_request (54)
"src/core/app/stages/test_stages.py" = ["C901"]  # _register_mock_backend_service (52)
"src/core/services/reasoning_config_applicator.py" = ["C901"]  # apply (52)
"src/core/app/controllers/models_controller.py" = ["C901"]  # _list_models_impl (52)

[tool.ruff.format]
# Disable formatting entirely - we only want linting
skip-magic-trailing-comma = true

[tool.mypy]
mypy_path = "src"
python_version = "3.10"
warn_return_any = true
warn_unused_configs = true
exclude = ["dev/"]
check_untyped_defs = false

[[tool.mypy.overrides]]
module = ["google.genai"]
ignore_missing_imports = true

[[tool.mypy.overrides]]
module = ["setuptools"]
ignore_missing_imports = true

[[tool.mypy.overrides]]
module = ["ping3"]
ignore_missing_imports = true
ignore_errors = true

[[tool.mypy.overrides]]
module = ["cachetools"]
ignore_missing_imports = true

# Performance optimizations
# Enable incremental mode with cache

# Reduce strictness for performance in tests
strict = false

[tool.coverage.run]
source = ["src"]
omit = [
    "*/tests/*",
    "*/test_*",
    "*/conftest.py",
    "*/__pycache__/*",
    "*/venv/*",
    "*/.venv/*",
]

[tool.coverage.report]
exclude_lines = [
    "pragma: no cover",
    "def __repr__",
    "raise AssertionError",
    "raise NotImplementedError",
    "if __name__ == .__main__.:",
    "if TYPE_CHECKING:",
    "@abstractmethod",
]
precision = 2
show_missing = true

[tool.coverage.xml]
output = "coverage.xml"

[tool.vulture]
# Vulture configuration for dead code detection suppressions
min_confidence = 80
verbose = false
sort_by_size = true
ignore_names = [
    # Names intentionally present but may appear unused in static scans
    "HEALTH_CHECK_SUPPORTED",
    "enable_health_check",
    "disable_health_check",
    "internal_health",
    "chat_completions_v1",
    "chat_completions_v2",
    "gemini_generate_content",
    "gemini_stream_generate_content",
    "anthropic_health",
    "OBJECT_TYPE_LIST",
    "OBJECT_TYPE_MODEL",
    "OBJECT_TYPE_CHAT_COMPLETION",
    "OBJECT_TYPE_CHAT_COMPLETION_CHUNK",
    "OBJECT_TYPE_MESSAGE",
    "FIELD_OBJECT",
    "FIELD_ID",
    "FIELD_MODEL",
    "FIELD_CONTENT",
    "FIELD_ROLE",
    "FIELD_CHOICES",
    "FIELD_MESSAGE",
    "FIELD_DELTA",
    "FIELD_FINISH_REASON",
    "FIELD_STOP_REASON",
    "FIELD_TYPE",
    "FIELD_NAME",
    "FIELD_TEXT",
    "FIELD_PARTS",
    "FIELD_INLINE_DATA",
    "FIELD_MIME_TYPE",
    "FIELD_DATA",
    "FIELD_SOURCE",
    "FIELD_USAGE",
    "FIELD_ERROR",
    "ROLE_USER",
    "ROLE_ASSISTANT",
    "ROLE_SYSTEM",
    "ROLE_MODEL",
    "FINISH_REASON_STOP",
    "FINISH_REASON_LENGTH",
    "FINISH_REASON_TOOL_CALLS",
    "FINISH_REASON_END_TURN",
    "FINISH_REASON_MAX_TOKENS",
    "FINISH_REASON_STOP_SEQUENCE",
    "FINISH_REASON_ERROR",
    "TOOL_CALL_TYPE_FUNCTION",
    "MODEL_PREFIX_OPENAI",
    "MODEL_PREFIX_ANTHROPIC",
    "MODEL_PREFIX_GEMINI",
    "MODEL_PREFIX_OPENROUTER",
    "BACKEND_OPENAI",
    "BACKEND_ANTHROPIC",
    "BACKEND_GEMINI",
    "BACKEND_OPENROUTER",
    "BACKEND_QWEN_OAUTH",
    "BACKEND_ZAI",
    "BACKEND_DISPLAY_OPENAI",
    "BACKEND_DISPLAY_ANTHROPIC",
    "BACKEND_DISPLAY_GEMINI",
    "BACKEND_DISPLAY_OPENROUTER",
    "build_development_app",
    "build_test_app",
    "validate_yaml_against_schema",
    "validate_static_yaml_configs",
    "_load_yaml_file",
    "_load_yaml_schema",
    # Kept for API compatibility in _normalize_tool_arguments
    "context_element",
    "tool_name"
]

[tool.testmon]
run_variant_expression = "','.join(sorted(str(v) for v in [sys.version_info[:2], sys.platform]))"
historian = "git"