build: bump python to 3.14 and update Docker image

Author: sdn4z

Dockerfile

@@ -1,4 +1,4 @@
-ARG PYTHON_IMAGE=3.13-slim@sha256:1020ca463dc51c26bbad49de85dbb2986d93b71050102f3fa2a7f0fc4c2ea81e
+ARG PYTHON_IMAGE=3.14-slim@sha256:4ed33101ee7ec299041cc41dd268dae17031184be94384b1ce7936dc4e5dead3
 
 # --------------- `base` stage --------------- 
 FROM python:${PYTHON_IMAGE} AS base

eval/classifier.py

@@ -1,8 +1,8 @@
 import logging
 import time
 from concurrent.futures import ThreadPoolExecutor
+from typing import TYPE_CHECKING
 
-from lightman_ai.ai.base.agent import BaseAgent
 from lightman_ai.ai.gemini.agent import GeminiAgent
 from lightman_ai.ai.openai.agent import OpenAIAgent
 from lightman_ai.article.models import Article, ArticlesList, SelectedArticle, SelectedArticlesList
@@ -11,6 +11,9 @@
 from eval.constants import MAX_WORKERS, MISSED_ARTICLE_REASON, MISSED_ARTICLE_RELEVANCE_SCORE
 from eval.utils import ClassifiedArticleResults
 
+if TYPE_CHECKING:
+    from lightman_ai.ai.base.agent import BaseAgent
+
 logger = logging.getLogger("eval")
 
 

eval/evaluator.py

@@ -1,12 +1,15 @@
 import logging
+from typing import TYPE_CHECKING
 
 from lightman_ai.ai.utils import get_agent_class_from_agent_name
-from lightman_ai.article.models import Article
 
 from eval.classifier import Classifier
 from eval.templates import ResultsFileBuilder
 from eval.utils import ResultsMetrics
 
+if TYPE_CHECKING:
+    from lightman_ai.article.models import Article
+
 logger = logging.getLogger("eval")
 
 

eval/templates.py

@@ -1,9 +1,12 @@
 import logging
 from datetime import date
-from decimal import Decimal
 from pathlib import Path
+from typing import TYPE_CHECKING
 
-from eval.utils import ClassifiedArticleResults, ResultsMetrics
+if TYPE_CHECKING:
+    from decimal import Decimal
+
+    from eval.utils import ClassifiedArticleResults, ResultsMetrics
 
 RESULTS_DIR = "eval/results/"
 

eval/utils.py

@@ -1,13 +1,16 @@
 import inspect
-from collections.abc import Iterable
 from dataclasses import dataclass
 from decimal import Decimal
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
-from lightman_ai.article.models import SelectedArticle
 from lightman_ai.core.config import FileConfig, FinalConfig
 from lightman_ai.core.settings import Settings
-from pydantic import PositiveInt
+from pydantic import PositiveInt  # noqa: TC002
+
+if TYPE_CHECKING:
+    from collections.abc import Iterable
+
+    from lightman_ai.article.models import SelectedArticle
 
 
 class EvalSettings(Settings):

justfile

@@ -1,6 +1,6 @@
 # VARIABLE DEFINITIONS
 venv := ".venv"
-python_version :="3.13"
+python_version :="3.14"
 run := "uv run"
 eval_path := "eval/cli.py"
 

pyproject.toml

@@ -4,7 +4,7 @@ authors = [
     {name = "sdn4z", email = "[email protected]"},
     {name = "scastlara", email = "[email protected]"}
 ]
-requires-python = "<4,>=3.13"
+requires-python = "==3.14.*"
 dependencies = [
     "httpx<1.0.0,>=0.28.0",
     "python-dotenv<2.0.0,>=1.1.1",
@@ -60,7 +60,7 @@ asyncio_default_fixture_loop_scope = "session"
 
 
 [tool.ruff]
-target-version = "py312"
+target-version = "py314"
 line-length = 120
 src = ["src", "tests"]
 

src/lightman_ai/ai/base/agent.py

@@ -1,22 +1,22 @@
 import logging
 from abc import ABC, abstractmethod
-from typing import Never
+from typing import TYPE_CHECKING
 
 from lightman_ai.article.models import SelectedArticlesList
 from pydantic_ai import Agent
-from pydantic_ai.models.google import GoogleModel
-from pydantic_ai.models.openai import OpenAIModel
+
+if TYPE_CHECKING:
+    from pydantic_ai.models.google import GoogleModel
+    from pydantic_ai.models.openai import OpenAIChatModel
 
 
 class BaseAgent(ABC):
-    _class: type[OpenAIModel] | type[GoogleModel]
+    _class: type[OpenAIChatModel] | type[GoogleModel]
     _default_model_name: str
 
     def __init__(self, system_prompt: str, model: str | None = None, logger: logging.Logger | None = None) -> None:
         agent_model = self._class(model or self._default_model_name)
-        self.agent: Agent[Never, SelectedArticlesList] = Agent(
-            model=agent_model, output_type=SelectedArticlesList, system_prompt=system_prompt
-        )
+        self.agent = Agent(model=agent_model, output_type=SelectedArticlesList, system_prompt=system_prompt)
         self.logger = logger or logging.getLogger("lightman")
 
     def get_prompt_result(self, prompt: str) -> SelectedArticlesList:

src/lightman_ai/ai/gemini/agent.py

@@ -1,10 +1,12 @@
-from typing import override
+from typing import TYPE_CHECKING, override
 
 from lightman_ai.ai.base.agent import BaseAgent
 from lightman_ai.ai.gemini.exceptions import map_gemini_exceptions
-from lightman_ai.article.models import SelectedArticlesList
 from pydantic_ai.models.google import GoogleModel
 
+if TYPE_CHECKING:
+    from lightman_ai.article.models import SelectedArticlesList
+
 
 class GeminiAgent(BaseAgent):
     """Class that provides an interface to operate with the Gemini model."""

src/lightman_ai/ai/gemini/exceptions.py

@@ -1,9 +1,11 @@
-from collections.abc import Generator
 from contextlib import contextmanager
-from typing import Any
+from typing import TYPE_CHECKING, Any
 
 from lightman_ai.core.exceptions import BaseLightmanError
 
+if TYPE_CHECKING:
+    from collections.abc import Generator
+
 
 class BaseGeminiError(BaseLightmanError): ...