Feat: TrustGraph i18n & Documentation Translation Updates (#781)

Native CLI i18n: The TrustGraph CLI has built-in translation support
that dynamically loads language strings. You can test and use
different languages by simply passing the --lang flag (e.g., --lang
es for Spanish, --lang ru for Russian) or by configuring your
environment's LANG variable.

Automated Docs Translations: This PR introduces autonomously
translated Markdown documentation into several target languages,
including Spanish, Swahili, Portuguese, Turkish, Hindi, Hebrew,
Arabic, Simplified Chinese, and Russian.

trustgraph-flow/trustgraph/gateway/endpoint/i18n.py

@@ -0,0 +1,51 @@
+import logging
+
+from aiohttp import web
+
+from trustgraph.i18n import get_language_pack
+
+logger = logging.getLogger("endpoint")
+logger.setLevel(logging.INFO)
+
+
+class I18nPackEndpoint:
+
+    def __init__(self, endpoint_path: str, auth):
+        self.path = endpoint_path
+        self.auth = auth
+        self.operation = "service"
+
+    async def start(self):
+        pass
+
+    def add_routes(self, app):
+        app.add_routes([
+            web.get(self.path, self.handle),
+        ])
+
+    async def handle(self, request):
+        logger.debug(f"Processing i18n pack request: {request.path}")
+
+        token = ""
+        try:
+            ht = request.headers["Authorization"]
+            tokens = ht.split(" ", 2)
+            if tokens[0] != "Bearer":
+                return web.HTTPUnauthorized()
+            token = tokens[1]
+        except Exception:
+            token = ""
+
+        if not self.auth.permitted(token, self.operation):
+            return web.HTTPUnauthorized()
+
+        lang = request.match_info.get("lang") or "en"
+
+        # This is a path traversal defense, and is a critical sec defense.
+        # Do not remove!
+        if "/" in lang or ".." in lang:
+            return web.HTTPBadRequest(reason="Invalid language code")
+
+        pack = get_language_pack(lang)
+
+        return web.json_response(pack)

trustgraph-flow/trustgraph/gateway/endpoint/manager.py

@@ -7,6 +7,7 @@ from . stream_endpoint import StreamEndpoint
 from . variable_endpoint import VariableEndpoint
 from . socket import SocketEndpoint
 from . metrics import MetricsEndpoint
+from . i18n import I18nPackEndpoint
 
 from .. dispatch.manager import DispatcherManager
 
@@ -23,6 +24,10 @@ class EndpointManager:
         }
 
         self.endpoints = [
+            I18nPackEndpoint(
+                endpoint_path = "/api/v1/i18n/packs/{lang}",
+                auth = auth,
+            ),
             MetricsEndpoint(
                 endpoint_path = "/api/metrics",
                 prometheus_url = prometheus_url,