codex-bot 0.2.1__tar.gz → 0.3.0__tar.gz

{codex_bot-0.2.1 → codex_bot-0.3.0}/.gitignore

@@ -69,5 +69,6 @@ dmypy.json
 .claude/
 # Sandbox for template E2E testing
 sandbox/
-# Temporary files from LocalesCompiler (if they leak into root)
-bot_locales_*
+# Agent instructions (local-only, points to local knowledge graph)
+AGENTS.md
+CLAUDE.md

{codex_bot-0.2.1 → codex_bot-0.3.0}/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.3.0] - 2026-04-23
+
+### Changed
+
+- **Aiogram Stack**: Raised the core `aiogram` dependency contract to `>=3.27.0,<4.0` and the optional i18n extra to `aiogram-i18n[runtime]>=1.5,<2.0`.
+- **Project Templates**: Updated generated project dependencies to use the same modern aiogram and aiogram-i18n ranges.
+
+### Fixed
+
+- **I18n Manager Initialization**: Updated `FSMContextI18nManager` to initialize `aiogram-i18n`'s `BaseManager`, restoring `locale_getter` and `locale_setter` for `I18nMiddleware`.
+
 ## [0.2.1] - 2026-04-18
 
 ### Fixed

{codex_bot-0.2.1 → codex_bot-0.3.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codex-bot
-Version: 0.2.1
+Version: 0.3.0
 Summary: Feature-based Aiogram framework library — reusable infrastructure for Telegram bots
 Project-URL: Homepage, https://github.com/codexdlc/codex-bot
 Project-URL: Documentation, https://codexdlc.github.io/codex-bot/
@@ -21,7 +21,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Communications :: Chat
 Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
 Requires-Python: >=3.12
-Requires-Dist: aiogram<4.0,>=3.13.0
+Requires-Dist: aiogram<4.0,>=3.27.0
 Requires-Dist: aiohttp>=3.13.4
 Requires-Dist: jinja2>=3.1.0
 Requires-Dist: pydantic-settings>=2.0
@@ -29,7 +29,7 @@ Requires-Dist: pydantic<3.0,>=2.0
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: questionary>=2.0.0
 Provides-Extra: all
-Requires-Dist: aiogram-i18n>=1.4; extra == 'all'
+Requires-Dist: aiogram-i18n[runtime]<2.0,>=1.5; extra == 'all'
 Requires-Dist: aiosqlite>=0.19.0; extra == 'all'
 Requires-Dist: alembic>=1.13.0; extra == 'all'
 Requires-Dist: arq>=0.25; extra == 'all'
@@ -49,7 +49,7 @@ Requires-Dist: alembic>=1.13.0; extra == 'db'
 Requires-Dist: asyncpg>=0.29.0; extra == 'db'
 Requires-Dist: sqlalchemy>=2.0; extra == 'db'
 Provides-Extra: dev
-Requires-Dist: aiogram-i18n>=1.4; extra == 'dev'
+Requires-Dist: aiogram-i18n[runtime]<2.0,>=1.5; extra == 'dev'
 Requires-Dist: aiosqlite>=0.19.0; extra == 'dev'
 Requires-Dist: alembic>=1.13.0; extra == 'dev'
 Requires-Dist: arq>=0.25; extra == 'dev'
@@ -62,7 +62,7 @@ Requires-Dist: loguru>=0.7.0; extra == 'dev'
 Requires-Dist: mypy>=1.10; extra == 'dev'
 Requires-Dist: pip-audit>=2.7; extra == 'dev'
 Requires-Dist: pre-commit>=3.0; extra == 'dev'
-Requires-Dist: pygments>=2.20.0; extra == 'dev'
+Requires-Dist: pygments==2.19.1; extra == 'dev'
 Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
 Requires-Dist: pytest-cov; extra == 'dev'
 Requires-Dist: pytest>=9.0.3; extra == 'dev'
@@ -78,7 +78,7 @@ Requires-Dist: mkdocstrings[python]>=0.24; extra == 'docs'
 Provides-Extra: http
 Requires-Dist: httpx<1.0,>=0.27; extra == 'http'
 Provides-Extra: i18n
-Requires-Dist: aiogram-i18n>=1.4; extra == 'i18n'
+Requires-Dist: aiogram-i18n[runtime]<2.0,>=1.5; extra == 'i18n'
 Provides-Extra: postgres
 Requires-Dist: asyncpg>=0.29.0; extra == 'postgres'
 Provides-Extra: redis

{codex_bot-0.2.1 → codex_bot-0.3.0}/pyproject.toml

@@ -22,7 +22,7 @@ classifiers = [
     "Topic :: Software Development :: Libraries :: Application Frameworks",
 ]
 dependencies = [
-    "aiogram>=3.13.0,<4.0",
+    "aiogram>=3.27.0,<4.0",
     "aiohttp>=3.13.4",
     "pydantic>=2.0,<3.0",
     "pydantic-settings>=2.0",
@@ -47,7 +47,7 @@ redis = [
     "codex-platform",
 ]
 arq = ["arq>=0.25"]
-i18n = ["aiogram-i18n>=1.4"]
+i18n = ["aiogram-i18n[runtime]>=1.5,<2.0"]
 http = ["httpx>=0.27,<1.0"]
 sqlite = ["aiosqlite>=0.19.0"]
 postgres = ["asyncpg>=0.29.0"]
@@ -58,7 +58,7 @@ all = [
 dev = [
     "codex-bot[all]",
     "pytest>=9.0.3",
-    "pygments>=2.20.0",
+    "pygments==2.19.1",
     "pytest-asyncio>=0.23",
     "pytest-cov",
     "ruff>=0.4",

{codex_bot-0.2.1 → codex_bot-0.3.0}/src/codex_bot/engine/middlewares/i18n.py

@@ -51,8 +51,8 @@ class FSMContextI18nManager(BaseManager):
         allowed_locales: list[str] | None = None,
         default_locale: str = "en",
     ) -> None:
+        super().__init__(default_locale=default_locale)
         self.allowed_locales: list[str] = allowed_locales or []
-        self.default_locale: str = default_locale
 
     async def get_locale(self, event_from_user: User | None = None, **kwargs: Any) -> str:
         """

{codex_bot-0.2.1 → codex_bot-0.3.0}/src/codex_bot/templates/project/root/pyproject.toml.j2

@@ -9,14 +9,14 @@ description = "Telegram Bot generated via codex-bot"
 readme = "README.md"
 requires-python = ">=3.12"
 dependencies = [
-    "aiogram>=3.4",
+    "aiogram>=3.27.0,<4.0",
     "pydantic-settings>=2.0",
     "codex-bot",
     {% if use_loguru %}
     "loguru>=0.7.0",
     {% endif %}
     {% if use_i18n %}
-    "aiogram-i18n>=1.4",
+    "aiogram-i18n[runtime]>=1.5,<2.0",
     {% endif %}
     {% if use_redis %}
     "redis[asyncio]>=5.0",

codex_bot-0.3.0/tests/engine/middlewares/test_i18n.py

@@ -0,0 +1,91 @@
+from pathlib import Path
+from unittest.mock import AsyncMock
+
+import pytest
+from aiogram.types import TelegramObject, User
+
+from codex_bot.engine.middlewares.i18n import FSMContextI18nManager
+
+
+@pytest.fixture
+def state():
+    fsm_state = AsyncMock()
+    fsm_state.get_data = AsyncMock(return_value={})
+    fsm_state.set_data = AsyncMock()
+    return fsm_state
+
+
+def test_manager_initialization():
+    manager = FSMContextI18nManager(default_locale="de")
+
+    assert hasattr(manager, "locale_getter") is True
+    assert hasattr(manager, "locale_setter") is True
+    assert manager.default_locale == "de"
+
+
+async def test_get_locale_prefers_fsm_locale(state):
+    state.get_data.return_value = {"locale": "ru"}
+    manager = FSMContextI18nManager(allowed_locales=["de"], default_locale="de")
+
+    locale = await manager.get_locale(state=state)
+
+    assert locale == "ru"
+
+
+async def test_get_locale_uses_allowed_telegram_language(state):
+    user = User(id=1, is_bot=False, first_name="Test", language_code="ru")
+    manager = FSMContextI18nManager(allowed_locales=["ru", "de"], default_locale="de")
+
+    locale = await manager.get_locale(event_from_user=user, state=state)
+
+    assert locale == "ru"
+
+
+async def test_get_locale_falls_back_for_disallowed_language(state):
+    user = User(id=1, is_bot=False, first_name="Test", language_code="en")
+    manager = FSMContextI18nManager(allowed_locales=["ru", "de"], default_locale="de")
+
+    locale = await manager.get_locale(event_from_user=user, state=state)
+
+    assert locale == "de"
+
+
+async def test_get_locale_uses_default_without_state_or_user():
+    manager = FSMContextI18nManager(default_locale="de")
+
+    locale = await manager.get_locale()
+
+    assert locale == "de"
+
+
+async def test_set_locale_writes_to_fsm_storage(state):
+    state.get_data.return_value = {}
+    manager = FSMContextI18nManager(default_locale="de")
+
+    await manager.set_locale("ru", state=state)
+
+    state.set_data.assert_called_once_with({"locale": "ru"})
+
+
+async def test_aiogram_i18n_middleware_uses_manager_locale_getter(tmp_path: Path, state):
+    from aiogram_i18n import I18nMiddleware
+    from aiogram_i18n.cores import FluentRuntimeCore
+
+    locale_dir = tmp_path / "de"
+    locale_dir.mkdir()
+    (locale_dir / "messages.ftl").write_text("hello = Hallo\n", encoding="utf-8")
+
+    manager = FSMContextI18nManager(default_locale="de")
+    middleware = I18nMiddleware(
+        core=FluentRuntimeCore(path=tmp_path / "{locale}"),
+        manager=manager,
+        default_locale="de",
+    )
+
+    event = TelegramObject()
+    handler = AsyncMock(return_value="ok")
+
+    result = await middleware(handler, event, {"state": state})
+
+    assert result == "ok"
+    handler.assert_awaited_once()

{codex_bot-0.2.1 → codex_bot-0.3.0}/uv.lock

@@ -13,7 +13,7 @@ wheels = [
 
 [[package]]
 name = "aiogram"
-version = "3.26.0"
+version = "3.27.0"
 source = { registry = "https://pypi.org/simple" }
 dependencies = [
     { name = "aiofiles" },
@@ -23,9 +23,9 @@ dependencies = [
     { name = "pydantic" },
     { name = "typing-extensions" },
 ]
-sdist = { url = "https://files.pythonhosted.org/packages/dd/2b/11709d58a7c47a773cd47239c7b5db258f02f31d784265bddeb562f3e9f9/aiogram-3.26.0.tar.gz", hash = "sha256:12fa1bce9c8cee0f1214f5e3f91bb631586c4503854d6138dacbdd7e7dc1020c", size = 1729985, upload-time = "2026-03-02T23:29:20.843Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/b5/09/4bfeb0314b4d78739fc7c3cdcaa77eacaeb089312d9c16f3eb538d0f0f97/aiogram-3.27.0.tar.gz", hash = "sha256:ed5fd6b40d80a6cdb215ab162c9bd9d9b7892fb2710b45e3b762a98c21119297", size = 1753647, upload-time = "2026-04-03T22:57:00.39Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/da/48/8504168e7a3ede9577a2d8aa0ed3f13471ef2db6431f506105b94f284d05/aiogram-3.26.0-py3-none-any.whl", hash = "sha256:dd8ea7feb2409953ad1424564355926207af90bb2204e37be7373fe6de201016", size = 716388, upload-time = "2026-03-02T23:29:19.076Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/1f/64c4a9428d15ccea5aa7b204fd53061b94407640d6b075cd61c38899dd53/aiogram-3.27.0-py3-none-any.whl", hash = "sha256:26a091b6266d87db514e02703072035e7c17feebef480f927083bcfb22f634a3", size = 727326, upload-time = "2026-04-03T22:56:58.427Z" },
 ]
 
 [[package]]
@@ -41,6 +41,11 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/d4/09/a5ffedd5fca4e623a3e59ca39e88efe3671415eaaf9189b932d7b43b92d4/aiogram_i18n-1.5-py3-none-any.whl", hash = "sha256:6ce55978d32c8d1008d59f029c300506c6de48a18c8c346de3f666bd78013779", size = 33851, upload-time = "2026-03-07T23:36:16.374Z" },
 ]
 
+[package.optional-dependencies]
+runtime = [
+    { name = "fluent-runtime" },
+]
+
 [[package]]
 name = "aiohappyeyeballs"
 version = "2.6.1"
@@ -447,7 +452,7 @@ dependencies = [
 
 [package.optional-dependencies]
 all = [
-    { name = "aiogram-i18n" },
+    { name = "aiogram-i18n", extra = ["runtime"] },
     { name = "aiosqlite" },
     { name = "alembic" },
     { name = "arq" },
@@ -471,7 +476,7 @@ db = [
     { name = "sqlalchemy" },
 ]
 dev = [
-    { name = "aiogram-i18n" },
+    { name = "aiogram-i18n", extra = ["runtime"] },
     { name = "aiosqlite" },
     { name = "alembic" },
     { name = "arq" },
@@ -503,7 +508,7 @@ http = [
     { name = "httpx" },
 ]
 i18n = [
-    { name = "aiogram-i18n" },
+    { name = "aiogram-i18n", extra = ["runtime"] },
 ]
 postgres = [
     { name = "asyncpg" },
@@ -518,10 +523,10 @@ sqlite = [
 
 [package.metadata]
 requires-dist = [
-    { name = "aiogram", specifier = ">=3.13.0,<4.0" },
-    { name = "aiogram-i18n", marker = "extra == 'all'", specifier = ">=1.4" },
-    { name = "aiogram-i18n", marker = "extra == 'dev'", specifier = ">=1.4" },
-    { name = "aiogram-i18n", marker = "extra == 'i18n'", specifier = ">=1.4" },
+    { name = "aiogram", specifier = ">=3.27.0,<4.0" },
+    { name = "aiogram-i18n", extras = ["runtime"], marker = "extra == 'all'", specifier = ">=1.5,<2.0" },
+    { name = "aiogram-i18n", extras = ["runtime"], marker = "extra == 'dev'", specifier = ">=1.5,<2.0" },
+    { name = "aiogram-i18n", extras = ["runtime"], marker = "extra == 'i18n'", specifier = ">=1.5,<2.0" },
     { name = "aiohttp", specifier = ">=3.13.4" },
     { name = "aiosqlite", marker = "extra == 'all'", specifier = ">=0.19.0" },
     { name = "aiosqlite", marker = "extra == 'db'", specifier = ">=0.19.0" },
@@ -559,7 +564,7 @@ requires-dist = [
     { name = "pre-commit", marker = "extra == 'dev'", specifier = ">=3.0" },
     { name = "pydantic", specifier = ">=2.0,<3.0" },
     { name = "pydantic-settings", specifier = ">=2.0" },
-    { name = "pygments", marker = "extra == 'dev'", specifier = ">=2.20.0" },
+    { name = "pygments", marker = "extra == 'dev'", specifier = "==2.19.1" },
     { name = "pytest", marker = "extra == 'dev'", specifier = ">=9.0.3" },
     { name = "pytest-asyncio", marker = "extra == 'dev'", specifier = ">=0.23" },
     { name = "pytest-cov", marker = "extra == 'dev'" },
@@ -750,6 +755,34 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/a4/a5/842ae8f0c08b61d6484b52f99a03510a3a72d23141942d216ebe81fefbce/filelock-3.25.2-py3-none-any.whl", hash = "sha256:ca8afb0da15f229774c9ad1b455ed96e85a81373065fb10446672f64444ddf70", size = 26759, upload-time = "2026-03-11T20:45:37.437Z" },
 ]
 
+[[package]]
+name = "fluent-runtime"
+version = "0.4.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "attrs" },
+    { name = "babel" },
+    { name = "fluent-syntax" },
+    { name = "pytz" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/dc/54/94bbd857443565a5776027165fe1e2634d836681d7d9c8992a2fd0ce8302/fluent.runtime-0.4.0.tar.gz", hash = "sha256:cb5ef96a58a3f67acaaca046d1201d202a1ebf2823e5e664370f359bae20574d", size = 17591, upload-time = "2023-03-16T11:10:35.165Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e5/89/a19b0bdfc74977b44aca2ad2e0600fd89c778184fcbb7fc44ba1002cc7b5/fluent.runtime-0.4.0-py2.py3-none-any.whl", hash = "sha256:51fd02582c2363e1106d7051642967a1b7f406dd9c317bd4600a73ede40c5146", size = 15627, upload-time = "2023-03-16T11:10:33.43Z" },
+]
+
+[[package]]
+name = "fluent-syntax"
+version = "0.19.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/51/52/de75f2faf499ed5a089acff2ab8bda5fc3b8db8a3f1615428ef9ccbf1917/fluent.syntax-0.19.0.tar.gz", hash = "sha256:920326d7f46864b9758f0044e9968e3112198bc826acee16ddd8f11d359004fd", size = 15039, upload-time = "2023-03-16T11:03:24.023Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/28/475734afb670bf7932caa1828183a4687cac51111950b9fb633c4f976afc/fluent.syntax-0.19.0-py2.py3-none-any.whl", hash = "sha256:b352b3475fac6c6ed5f06527921f432aac073d764445508ee5218aeccc7cc5c4", size = 16432, upload-time = "2023-03-16T11:03:21.934Z" },
+]
+
 [[package]]
 name = "frozenlist"
 version = "1.8.0"
@@ -1921,11 +1954,11 @@ wheels = [
 
 [[package]]
 name = "pygments"
-version = "2.20.0"
+version = "2.19.1"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/c3/b2/bc9c9196916376152d655522fdcebac55e66de6603a76a02bca1b6414f6c/pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f", size = 4955991, upload-time = "2026-03-29T13:29:33.898Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/7c/2d/c3338d48ea6cc0feb8446d8e6937e1408088a72a39937982cc6111d17f84/pygments-2.19.1.tar.gz", hash = "sha256:61c16d2a8576dc0649d9f39e089b5f02bcd27fba10d8fb4dcc28173f7a45151f", size = 4968581, upload-time = "2025-01-06T17:26:30.443Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/f4/7e/a72dd26f3b0f4f2bf1dd8923c85f7ceb43172af56d63c7383eb62b332364/pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176", size = 1231151, upload-time = "2026-03-29T13:29:30.038Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/0b/9fcc47d19c48b59121088dd6da2488a49d5f72dacf8262e2790a1d2c7d15/pygments-2.19.1-py3-none-any.whl", hash = "sha256:9ea1544ad55cecf4b8242fab6dd35a93bbce657034b0611ee383099054ab6d8c", size = 1225293, upload-time = "2025-01-06T17:26:25.553Z" },
 ]
 
 [[package]]
@@ -2036,6 +2069,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/0b/d7/1959b9648791274998a9c3526f6d0ec8fd2233e4d4acce81bbae76b44b2a/python_dotenv-1.2.2-py3-none-any.whl", hash = "sha256:1d8214789a24de455a8b8bd8ae6fe3c6b69a5e3d64aa8a8e5d68e694bbcb285a", size = 22101, upload-time = "2026-03-01T16:00:25.09Z" },
 ]
 
+[[package]]
+name = "pytz"
+version = "2026.1.post1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/56/db/b8721d71d945e6a8ac63c0fc900b2067181dbb50805958d4d4661cf7d277/pytz-2026.1.post1.tar.gz", hash = "sha256:3378dde6a0c3d26719182142c56e60c7f9af7e968076f31aae569d72a0358ee1", size = 321088, upload-time = "2026-03-03T07:47:50.683Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/10/99/781fe0c827be2742bcc775efefccb3b048a3a9c6ce9aec0cbf4a101677e5/pytz-2026.1.post1-py2.py3-none-any.whl", hash = "sha256:f2fd16142fda348286a75e1a524be810bb05d444e5a081f37f7affc635035f7a", size = 510489, upload-time = "2026-03-03T07:47:49.167Z" },
+]
+
 [[package]]
 name = "pyyaml"
 version = "6.0.3"