From 0bd0efef2954a0eac7083cf94581e1b173919608 Mon Sep 17 00:00:00 2001 From: tsudol-plaid Date: Fri, 30 Oct 2026 15:23:46 -0700 Subject: [PATCH 1/4] Add Python version marker to importlib-metadata dependency `importlib.metadata` was stabilized in Python 3.10: https://docs.python.org/3/library/importlib.metadata.html This makes the `importlib-metadata` backport package only required when `litellm` runs on Python 3.9 or earlier. `litellm` only uses `importlib.metadata.version`, which (as far as I can tell) is not affected by any changes from Python 3.10 - Python 3.15. --- pyproject.toml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/pyproject.toml b/pyproject.toml index 5c23a64ebb3..02d92e0feaf 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -21,7 +21,7 @@ dependencies = [ "python-dotenv>=1.0.0,<2.0", "pyyaml>=6.0.3,<7.0", "packaging>=24.0", - "importlib-metadata>=8.0.0,<9.0", + "importlib-metadata>=8.0.0,<9.0; python_version < '3.10'", "tiktoken>=0.8.0,<1.0; python_version < '3.14'", "tiktoken>=0.12.0,<1.0; python_version == '3.14'", "tiktoken>=0.14.0,<1.0; python_version >= '3.15'", From ae677f3ef5d9554e684f96d96c1a2c7857218406 Mon Sep 17 00:00:00 2001 From: ishaan-j-berri Date: Fri, 30 Oct 2026 17:11:00 -0700 Subject: [PATCH 2/4] fix(deps): use stdlib metadata for installed versions --- litellm/_version.py | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/litellm/_version.py b/litellm/_version.py index 140adcb66cf..9e30e590cf2 100644 --- a/litellm/_version.py +++ b/litellm/_version.py @@ -1,11 +1,10 @@ +import importlib.metadata from typing import Final -import importlib_metadata - def _installed_version(distribution: str) -> str | None: try: - return importlib_metadata.version(distribution) + return importlib.metadata.version(distribution) except Exception: return None From 876d18bff0c288097dbb1f5bf1439eed0b5960a7 Mon Sep 17 00:00:00 2001 From: ishaan-j-berri Date: Fri, 30 Oct 2026 17:12:04 -0700 Subject: [PATCH 3/4] test: cover version lookup without the metadata backport --- tests/unit/test_version.py | 21 ++++++++++++++++----- 1 file changed, 16 insertions(+), 5 deletions(-) diff --git a/tests/unit/test_version.py b/tests/unit/test_version.py index 30b1f259f1e..3176c6e4034 100644 --- a/tests/unit/test_version.py +++ b/tests/unit/test_version.py @@ -1,9 +1,10 @@ +import importlib.metadata import runpy +import sys from pathlib import Path from typing import Final from unittest.mock import patch -import importlib_metadata import pytest @@ -18,10 +19,10 @@ import pytest def test_version_uses_installed_distribution(installed: dict[str, str], expected: str) -> None: def lookup(name: str) -> str: if name not in installed: - raise importlib_metadata.PackageNotFoundError(name) + raise importlib.metadata.PackageNotFoundError(name) return installed[name] - with patch("importlib_metadata.version", side_effect=lookup): + with patch("importlib.metadata.version", side_effect=lookup): result: Final = runpy.run_path(str(Path(__file__).resolve().parents[2] / "litellm/_version.py")) assert result["version"] == expected @@ -29,12 +30,22 @@ def test_version_uses_installed_distribution(installed: dict[str, str], expected @pytest.mark.parametrize("core_version", ["1.2.3", "2.3.4"]) def test_version_rejects_overlapping_distributions(core_version: str) -> None: installed: Final = {"litellm": "1.2.3", "litellm-core": core_version} - with patch("importlib_metadata.version", side_effect=installed.__getitem__): + with patch("importlib.metadata.version", side_effect=installed.__getitem__): with pytest.raises(RuntimeError, match=r"litellm and litellm-core.*separate environments"): runpy.run_path(str(Path(__file__).resolve().parents[2] / "litellm/_version.py")) def test_version_handles_unreadable_metadata() -> None: - with patch("importlib_metadata.version", side_effect=ValueError("Invalid metadata")): + with patch("importlib.metadata.version", side_effect=ValueError("Invalid metadata")): result: Final = runpy.run_path(str(Path(__file__).resolve().parents[2] / "litellm/_version.py")) assert result["version"] == "unknown" + + +def test_version_loads_without_importlib_metadata_backport() -> None: + with patch.dict(sys.modules, {"importlib_metadata": None}): + with patch( + "importlib.metadata.version", + side_effect=importlib.metadata.PackageNotFoundError, + ): + result: Final = runpy.run_path(str(Path(__file__).resolve().parents[2] / "litellm/_version.py")) + assert result["version"] == "unknown" From b009871bd5e5e07ddb4ea8f9a61395af124e6ce1 Mon Sep 17 00:00:00 2001 From: Teddy Sudol Date: Sun, 1 Nov 2026 13:23:14 -0800 Subject: [PATCH 4/4] fixup! test: cover version lookup without the metadata backport --- uv.lock | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/uv.lock b/uv.lock index 19d3a1ffd4f..0acb9af59e3 100644 --- a/uv.lock +++ b/uv.lock @@ -4967,7 +4967,6 @@ dependencies = [ { name = "filelock" }, { name = "httpx", extra = ["http2"] }, { name = "huggingface-hub" }, - { name = "importlib-metadata" }, { name = "jinja2" }, { name = "jsonschema" }, { name = "openai" }, @@ -5263,7 +5262,7 @@ requires-dist = [ { name = "httpx2", marker = "extra == 'mcp'", specifier = ">=2.10.0,<3" }, { name = "httpx2", marker = "extra == 'proxy'", specifier = ">=2.10.0,<3" }, { name = "huggingface-hub", specifier = ">=0.34.0,<2.0" }, - { name = "importlib-metadata", specifier = ">=8.0.0,<9.0" }, + { name = "importlib-metadata", marker = "python_full_version < '3.10'", specifier = ">=8.0.0,<9.0" }, { name = "inquirerpy", marker = "extra == 'cli'", specifier = ">=0.3.4,<1.0" }, { name = "inquirerpy", marker = "extra == 'proxy'", specifier = ">=0.3.4,<1.0" }, { name = "jinja2", specifier = ">=3.1.6,<4.0" },