chore: update examples to latest API conventions

- Remove redundant config params (read from gt.config.json)
- Simplify load_translations helpers
- Fix Flask eager loading bug: use resolved_locales instead of locales param
- Clean up docstrings and imports
- All four examples tested and working

Author: moss-bryophyta

examples/fastapi-eager/app.py

@@ -1,7 +1,7 @@
 """FastAPI example with eager translation loading.
 
-Translations are stored in _gt/<locale>.json and loaded at startup.
-Configuration is read automatically from gt.config.json in the CWD.
+Translations are loaded from _gt/<locale>.json at startup.
+Configuration is read from gt.config.json.
 Run: uv run uvicorn app:app --port 8000
 """
 
@@ -17,19 +17,14 @@
 
 
 def load_translations(locale: str) -> dict[str, str]:
-    """Load translations from _gt/<locale>.json."""
     path = GT_DIR / f"{locale}.json"
     if path.exists():
         with open(path) as f:
             return json.load(f)
     return {}
 
 
-initialize_gt(
-    app,
-    load_translations=load_translations,
-    eager_loading=True,
-)
+initialize_gt(app, load_translations=load_translations)
 
 
 @app.get("/")

examples/fastapi-lazy/app.py

@@ -1,7 +1,7 @@
 """FastAPI example with lazy translation loading.
 
-Translations are stored in _gt/<locale>.json and loaded on first request per locale.
-Configuration is read automatically from gt.config.json in the CWD.
+Translations are loaded from _gt/<locale>.json on first request per locale.
+Configuration is read from gt.config.json.
 Run: uv run uvicorn app:app --port 8001
 """
 
@@ -17,34 +17,24 @@
 
 
 async def load_translations(locale: str) -> dict[str, str]:
-    """Load translations from _gt/<locale>.json."""
     path = GT_DIR / f"{locale}.json"
     if path.exists():
         with open(path) as f:
             return json.load(f)
     return {}
 
 
-manager = initialize_gt(
-    app,
-    load_translations=load_translations,
-    eager_loading=False,
-)
+manager = initialize_gt(app, load_translations=load_translations, eager_loading=False)
 
 
-async def _ensure_translations(request: Request) -> None:
-    """Load translations for the current locale if not already cached.
-
-    t() only reads from cache (get_translations_sync), so we must
-    explicitly trigger a load for the current locale before t() runs.
-    """
+async def ensure_translations(request: Request) -> None:
+    """Load translations for the request locale before t() runs."""
     locale = manager.get_locale()
     if manager.requires_translation(locale):
         await manager.get_translations(locale)
 
 
-# Add dependency to all routes — runs inside route context after middleware
-app.router.dependencies = [Depends(_ensure_translations)]
+app.router.dependencies = [Depends(ensure_translations)]
 
 
 @app.get("/")

examples/flask-eager/app.py

@@ -1,14 +1,14 @@
 """Flask example with eager translation loading.
 
-Translations are stored in _gt/<locale>.json and loaded at startup.
-Configuration is read automatically from gt.config.json in the CWD.
+Translations are loaded from _gt/<locale>.json at startup.
+Configuration is read from gt.config.json.
 Run: uv run python app.py  (serves on port 5050)
 """
 
 import json
 from pathlib import Path
 
-from flask import Flask
+from flask import Flask, request
 from gt_flask import initialize_gt, t
 
 app = Flask(__name__)
@@ -17,19 +17,14 @@
 
 
 def load_translations(locale: str) -> dict[str, str]:
-    """Load translations from _gt/<locale>.json."""
     path = GT_DIR / f"{locale}.json"
     if path.exists():
         with open(path) as f:
             return json.load(f)
     return {}
 
 
-initialize_gt(
-    app,
-    load_translations=load_translations,
-    eager_loading=True,
-)
+initialize_gt(app, load_translations=load_translations)
 
 
 @app.get("/")
@@ -39,8 +34,6 @@ def index() -> dict[str, str]:
 
 @app.get("/greet")
 def greet() -> dict[str, str]:
-    from flask import request
-
     name = request.args.get("name", "World")
     return {"message": t("Hello, {name}!", name=name)}
 

examples/flask-lazy/app.py

@@ -1,15 +1,15 @@
 """Flask example with lazy translation loading.
 
-Translations are stored in _gt/<locale>.json and loaded on first request per locale.
-Configuration is read automatically from gt.config.json in the CWD.
+Translations are loaded from _gt/<locale>.json on first request per locale.
+Configuration is read from gt.config.json.
 Run: uv run python app.py  (serves on port 5051)
 """
 
 import asyncio
 import json
 from pathlib import Path
 
-from flask import Flask
+from flask import Flask, request
 from gt_flask import initialize_gt, t
 
 app = Flask(__name__)
@@ -18,29 +18,19 @@
 
 
 def load_translations(locale: str) -> dict[str, str]:
-    """Load translations from _gt/<locale>.json."""
     path = GT_DIR / f"{locale}.json"
     if path.exists():
         with open(path) as f:
             return json.load(f)
     return {}
 
 
-manager = initialize_gt(
-    app,
-    load_translations=load_translations,
-    eager_loading=False,
-)
+manager = initialize_gt(app, load_translations=load_translations, eager_loading=False)
 
 
 @app.before_request
-def _ensure_translations() -> None:
-    """Load translations for the current locale if not already cached.
-
-    Registered after initialize_gt(), so this runs after the locale is set.
-    t() only reads from cache (get_translations_sync), so we must
-    explicitly trigger a load for the current locale before t() runs.
-    """
+def ensure_translations() -> None:
+    """Load translations for the request locale before t() runs."""
     locale = manager.get_locale()
     if manager.requires_translation(locale):
         asyncio.run(manager.get_translations(locale))
@@ -53,8 +43,6 @@ def index() -> dict[str, str]:
 
 @app.get("/greet")
 def greet() -> dict[str, str]:
-    from flask import request
-
     name = request.args.get("name", "World")
     return {"message": t("Hello, {name}!", name=name)}
 

packages/gt-flask/src/gt_flask/_setup.py

@@ -71,7 +71,7 @@ def initialize_gt(
     )
     set_i18n_manager(manager)
 
-    if eager_loading and locales:
+    if eager_loading and resolved_locales:
         asyncio.run(manager.load_all_translations())
 
     @app.before_request