chore: migrate project to Python 3.13 (#116)

JacobCoffee · claude · web-flow · commit 6da403df9db9 · 2025-11-23T00:04:45.000-06:00
Co-authored-by: Claude &lt;noreply@anthropic.com&gt;
diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
@@ -20,7 +20,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: "pyproject.toml"
+          python-version-file: ".python-version"
 
       - name: Create virtual environment
         run: uv sync --all-extras --dev
@@ -62,7 +62,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: "pyproject.toml"
+          python-version-file: ".python-version"
 
       - name: Create virtual environment
         run: uv sync --all-extras --dev
@@ -92,7 +92,7 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v6
         with:
-          python-version-file: "pyproject.toml"
+          python-version-file: ".python-version"
 
       - name: Create virtual environment
         run: uv sync --all-extras --dev
diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
@@ -24,7 +24,7 @@ jobs:
         uses: astral-sh/setup-uv@v3
 
       - name: Set up Python
-        run: uv python install 3.12
+        run: uv python install 3.13
 
       - name: Install dependencies
         run: uv sync --all-extras --dev
diff --git a/.pre-commit-config.yaml b/.pre-commit-config.yaml
@@ -1,5 +1,5 @@
 default_language_version:
-  python: "3.12"
+  python: "3.13"
 default_install_hook_types: [commit-msg, pre-commit]
 repos:
   - repo: https://github.com/compilerla/conventional-pre-commit
diff --git a/.python-version b/.python-version
@@ -1 +1 @@
-3.12
+3.13
diff --git a/.sourcery.yaml b/.sourcery.yaml
@@ -15,7 +15,7 @@ rule_settings:
     - refactoring
     - suggestion
     - comment
-  python_version: "3.12"
+  python_version: "3.13"
 
 rules: []
 
diff --git a/.tool-versions b/.tool-versions
@@ -1 +1 @@
-python 3.12
+python 3.13
diff --git a/packages/byte-common/README.md b/packages/byte-common/README.md
@@ -19,7 +19,7 @@ The package will include:
 
 ## Technology Stack
 
-- Python 3.12+
+- Python 3.13+
 - Pydantic for models
 - Pydantic Settings for configuration
 - Advanced Alchemy for database models
diff --git a/packages/byte-common/pyproject.toml b/packages/byte-common/pyproject.toml
@@ -13,7 +13,7 @@ dependencies = [
     "githubkit[auth-app] @ git+https://github.com/yanyongyu/githubkit.git",
     "python-dotenv>=1.0.0",
 ]
-requires-python = ">=3.12,<4.0"
+requires-python = ">=3.13,<4.0"
 readme = "README.md"
 license = { text = "MIT" }
 
diff --git a/pyproject.toml b/pyproject.toml
@@ -125,7 +125,7 @@ strict-imports = false
 [tool.ruff]
 line-length = 120
 src = ["packages/byte-common/src", "services/api/src", "services/bot/src", "tests"]
-target-version = "py311"
+target-version = "py313"
 
 [tool.ruff.lint]
 select = ["ALL"]
diff --git a/services/api/Dockerfile b/services/api/Dockerfile
@@ -3,7 +3,7 @@
 # ============================================================================
 # Builder Stage: Install dependencies and build virtual environment
 # ============================================================================
-FROM python:3.12-slim AS builder
+FROM python:3.13-slim AS builder
 
 # Set working directory
 WORKDIR /app
@@ -38,7 +38,7 @@ RUN uv sync --frozen --no-dev --no-editable
 # ============================================================================
 # Runtime Stage: Minimal production image
 # ============================================================================
-FROM python:3.12-slim
+FROM python:3.13-slim
 
 # Set working directory
 WORKDIR /app
diff --git a/services/api/README.md b/services/api/README.md
@@ -1,6 +1,6 @@
 # Byte API Service
 
-> **Version**: 0.2.0 **Python**: 3.12+ **Framework**: Litestar 2.4.3+
+> **Version**: 0.2.0 **Python**: 3.13+ **Framework**: Litestar 2.4.3+
 
 ## Overview
 
@@ -231,7 +231,7 @@ Deploy as a standalone service with PostgreSQL database plugin attached.
 
 - Install dependencies: `uv sync`
 - Verify `byte-common` is installed in same environment
-- Check Python version: `python --version` (should be 3.12+)
+- Check Python version: `python --version` (should be 3.13+)
 
 ## Additional Resources
 
diff --git a/services/api/pyproject.toml b/services/api/pyproject.toml
@@ -18,7 +18,7 @@ dependencies = [
     "python-dotenv>=1.0.0",
     "PyJWT>=2.8.0",
 ]
-requires-python = ">=3.12,<4.0"
+requires-python = ">=3.13,<4.0"
 license = { text = "MIT" }
 
 [build-system]
diff --git a/services/api/src/byte_api/domain/guilds/dependencies.py b/services/api/src/byte_api/domain/guilds/dependencies.py
@@ -33,7 +33,7 @@
 logger = log.get_logger()
 
 
-async def provides_guilds_service(db_session: AsyncSession) -> AsyncGenerator[GuildsService, None]:
+async def provides_guilds_service(db_session: AsyncSession) -> AsyncGenerator[GuildsService]:
     """Construct Guilds-based repository and service objects for the request.
 
     Args:
@@ -67,7 +67,7 @@ async def provides_guilds_service(db_session: AsyncSession) -> AsyncGenerator[Gu
             ...
 
 
-async def provides_github_config_service(db_session: AsyncSession) -> AsyncGenerator[GitHubConfigService, None]:  # type: ignore[misc]
+async def provides_github_config_service(db_session: AsyncSession) -> AsyncGenerator[GitHubConfigService]:  # type: ignore[misc]
     """Construct GitHubConfig-based repository and service objects for the request.
 
     Args:
@@ -98,7 +98,7 @@ async def provides_github_config_service(db_session: AsyncSession) -> AsyncGener
             ...
 
 
-async def provides_sotags_config_service(db_session: AsyncSession) -> AsyncGenerator[SOTagsConfigService, None]:
+async def provides_sotags_config_service(db_session: AsyncSession) -> AsyncGenerator[SOTagsConfigService]:
     """Construct SOTagsConfig-based repository and service objects for the request.
 
     Args:
@@ -123,7 +123,7 @@ async def provides_sotags_config_service(db_session: AsyncSession) -> AsyncGener
 
 async def provides_allowed_users_config_service(
     db_session: AsyncSession,
-) -> AsyncGenerator[AllowedUsersConfigService, None]:
+) -> AsyncGenerator[AllowedUsersConfigService]:
     """Construct AllowedUsersConfig-based repository and service objects for the request.
 
     Args:
@@ -146,7 +146,7 @@ async def provides_allowed_users_config_service(
             ...
 
 
-async def provides_forum_config_service(db_session: AsyncSession) -> AsyncGenerator[ForumConfigService, None]:
+async def provides_forum_config_service(db_session: AsyncSession) -> AsyncGenerator[ForumConfigService]:
     """Construct ForumConfig-based repository and service objects for the request.
 
     Args:
diff --git a/services/api/src/byte_api/lib/types.py b/services/api/src/byte_api/lib/types.py
@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import TYPE_CHECKING, Any, Literal, TypeAlias, TypeVar
+from typing import TYPE_CHECKING, Any, Literal, TypeVar
 
 from advanced_alchemy.extensions.litestar import SQLAlchemyDTO
 from advanced_alchemy.filters import FilterTypes
@@ -21,7 +21,7 @@
 """Type variable for SQLAlchemy async repository services."""
 DataclassModelT = TypeVar("DataclassModelT", bound=DataclassProtocol)
 """Type variable for dataclass models."""
-ModelT: TypeAlias = SQLAlchemyModelT | DataclassModelT
+type ModelT[SQLAlchemyModelT: DeclarativeBase, DataclassModelT: DataclassProtocol] = SQLAlchemyModelT | DataclassModelT
 """Type alias for models."""
 FilterTypeT = TypeVar("FilterTypeT", bound=FilterTypes)
 """Type variable for filter types."""
@@ -33,11 +33,13 @@
 """Type variable for DTOs."""
 DTOFactoryT = TypeVar("DTOFactoryT", bound=DataclassDTO | SQLAlchemyDTO)
 """Type variable for DTO factories."""
-ModelDictDTOT: TypeAlias = dict[str, Any] | ModelT | DTOData
+type ModelDictDTOT = dict[str, Any] | ModelT | DTOData
 """Type alias for model or dict DTOs."""
-ModelDictListDTOT: TypeAlias = list[SQLAlchemyModelT | DataclassModelT | dict[str, Any]] | DTOData
+type ModelDictListDTOT[SQLAlchemyModelT: DeclarativeBase, DataclassModelT: DataclassProtocol] = (
+    list[SQLAlchemyModelT | DataclassModelT | dict[str, Any]] | DTOData
+)
 """Type alias for list of models, dicts, or DTOData."""
 
 # -- App Types
-Status: TypeAlias = Literal["online", "offline", "degraded"]
+type Status = Literal["online", "offline", "degraded"]
 """Type alias for health check status."""
diff --git a/services/bot/Dockerfile b/services/bot/Dockerfile
@@ -3,7 +3,7 @@
 # ============================================================================
 # Builder Stage: Install dependencies and build virtual environment
 # ============================================================================
-FROM python:3.12-slim AS builder
+FROM python:3.13-slim AS builder
 
 # Set working directory
 WORKDIR /app
@@ -37,7 +37,7 @@ RUN uv sync --frozen --no-dev --no-editable
 # ============================================================================
 # Runtime Stage: Minimal production image
 # ============================================================================
-FROM python:3.12-slim
+FROM python:3.13-slim
 
 # Set working directory
 WORKDIR /app
diff --git a/services/bot/README.md b/services/bot/README.md
@@ -14,7 +14,7 @@ This service handles all Discord-related functionality including:
 
 ## Technology Stack
 
-- **Python**: 3.12+
+- **Python**: 3.13+
 - **Discord.py**: v2.3.2+
 - **HTTP Client**: httpx (for API calls)
 - **Settings**: pydantic-settings
@@ -62,7 +62,7 @@ services/bot/
 
 ### Prerequisites
 
-- Python 3.12+
+- Python 3.13+
 - uv package manager
 - Discord bot token (from Discord Developer Portal)
 - Access to Byte API (or run locally)
diff --git a/services/bot/pyproject.toml b/services/bot/pyproject.toml
@@ -15,7 +15,7 @@ dependencies = [
     "python-dotenv>=1.0.0",
     "anyio>=4.1.0",
 ]
-requires-python = ">=3.12,<4.0"
+requires-python = ">=3.13,<4.0"
 license = { text = "MIT" }
 
 [project.scripts]
diff --git a/services/bot/src/byte_bot/lib/utils.py b/services/bot/src/byte_bot/lib/utils.py
@@ -8,7 +8,7 @@
 import subprocess
 from datetime import UTC, datetime
 from itertools import islice
-from typing import TYPE_CHECKING, TypeVar
+from typing import TYPE_CHECKING
 
 import httpx
 from anyio import run_process
@@ -39,8 +39,6 @@
     "run_ruff_format",
 )
 
-_T = TypeVar("_T")
-
 
 def linker(title: str, link: str, show_embed: bool = False) -> str:
     """Create a Markdown link, optionally with an embed.
@@ -140,15 +138,15 @@ async def paste(code: str) -> str:
         return paste_link or "Failed to upload formatted code."
 
 
-def chunk_sequence(sequence: Iterable[_T], size: int) -> Iterable[tuple[_T, ...]]:
+def chunk_sequence[T](sequence: Iterable[T], size: int) -> Iterable[tuple[T, ...]]:
     """Naïve chunking of an iterable.
 
     Args:
-        sequence (Iterable[_T]): Iterable to chunk
+        sequence (Iterable[T]): Iterable to chunk
         size (int): Size of chunk
 
     Yields:
-        Iterable[tuple[_T, ...]]: An n-tuple that contains chunked data
+        Iterable[tuple[T, ...]]: An n-tuple that contains chunked data
     """
     _sequence = iter(sequence)
     while chunk := tuple(islice(_sequence, size)):
diff --git a/services/worker/README.md b/services/worker/README.md
@@ -13,7 +13,7 @@ This service handles asynchronous background tasks including:
 
 ## Technology Stack
 
-- Python 3.12+
+- Python 3.13+
 - Task queue framework (TBD: SAQ, Celery, or similar)
 - Shared code from `byte-common` package
 
diff --git a/sonar-project.properties b/sonar-project.properties
@@ -4,7 +4,7 @@ sonar.coverage.exclusions=**/__init__.py, **/*.js,
 sonar.cpd.exclusions=
 sonar.exclusions=docs/**/*, tests/**/*
 sonar.python.coverage.reportPaths=coverage.xml
-sonar.python.version=3.12
+sonar.python.version=3.13
 sonar.sourceEncoding=UTF-8
 sonar.sources=byte_bot
 sonar.test.inclusions=tests/test_*.py
diff --git a/tests/conftest.py b/tests/conftest.py
@@ -34,7 +34,7 @@
 
 
 @pytest.fixture(scope="function")
-async def async_engine() -> AsyncGenerator[AsyncEngine, None]:
+async def async_engine() -> AsyncGenerator[AsyncEngine]:
     """Create an async SQLite engine for testing.
 
     Uses in-memory SQLite database that's created fresh for each test.
@@ -68,7 +68,7 @@ def set_sqlite_pragma(dbapi_conn, connection_record):
 
 
 @pytest.fixture(scope="function")
-async def async_session(async_engine: AsyncEngine) -> AsyncGenerator[async_sessionmaker[AsyncSession], None]:
+async def async_session(async_engine: AsyncEngine) -> AsyncGenerator[async_sessionmaker[AsyncSession]]:
     """Create an async session factory for testing."""
     session_factory = async_sessionmaker(
         bind=async_engine,
@@ -79,7 +79,7 @@ async def async_session(async_engine: AsyncEngine) -> AsyncGenerator[async_sessi
 
 
 @pytest.fixture(scope="function")
-async def db_session(async_session: async_sessionmaker[AsyncSession]) -> AsyncGenerator[AsyncSession, None]:
+async def db_session(async_session: async_sessionmaker[AsyncSession]) -> AsyncGenerator[AsyncSession]:
     """Create a database session for testing.
 
     Automatically rolls back after each test.
diff --git a/uv.lock b/uv.lock

Original file line number	Diff line number	Diff line change
`@@ -13,7 +13,7 @@ dependencies = [`
`13`	`13`	`"githubkit[auth-app] @ git+https://github.com/yanyongyu/githubkit.git",`
`14`	`14`	`"python-dotenv>=1.0.0",`
`15`	`15`	`]`
`16`		`-requires-python = ">=3.12,<4.0"`
	`16`	`+requires-python = ">=3.13,<4.0"`
`17`	`17`	`readme = "README.md"`
`18`	`18`	`license = { text = "MIT" }`
`19`	`19`