PyPI - mindroot - Versions diffs - 9.10.0__py3-none-any.whl → 9.12.0__py3-none-any.whl - Mend - Supply Chain Defender

mindroot 9.10.0py3-none-any.whl → 9.12.0py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Potentially problematic release.

This version of mindroot might be problematic. Click here for more details.

Files changed (418) hide show

mindroot/docs/_build/html/_modules/mindroot/coreplugins/l8n/mod.html ADDED Viewed

@@ -0,0 +1,393 @@
+<!DOCTYPE html>
+<html class="writer-html5" lang="en" data-content_root="../../../../">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title>mindroot.coreplugins.l8n.mod &mdash; MindRoot 9.10.0 documentation</title>
+      <link rel="stylesheet" type="text/css" href="../../../../_static/pygments.css?v=b86133f3" />
+      <link rel="stylesheet" type="text/css" href="../../../../_static/css/theme.css?v=e59714d7" />
+      <script src="../../../../_static/jquery.js?v=5d32c60e"></script>
+      <script src="../../../../_static/_sphinx_javascript_frameworks_compat.js?v=2cd50e6c"></script>
+      <script src="../../../../_static/documentation_options.js?v=3c16008f"></script>
+      <script src="../../../../_static/doctools.js?v=9bcbadda"></script>
+      <script src="../../../../_static/sphinx_highlight.js?v=dc90522c"></script>
+    <script src="../../../../_static/js/theme.js"></script>
+    <link rel="index" title="Index" href="../../../../genindex.html" />
+    <link rel="search" title="Search" href="../../../../search.html" />
+</head>
+<body class="wy-body-for-nav">
+  <div class="wy-grid-for-nav">
+    <nav data-toggle="wy-nav-shift" class="wy-nav-side">
+      <div class="wy-side-scroll">
+        <div class="wy-side-nav-search"  style="background: #343131" >
+          <a href="../../../../index.html" class="icon icon-home">
+            MindRoot
+          </a>
+<div role="search">
+  <form id="rtd-search-form" class="wy-form" action="../../../../search.html" method="get">
+    <input type="text" name="q" placeholder="Search docs" aria-label="Search docs" />
+    <input type="hidden" name="check_keywords" value="yes" />
+    <input type="hidden" name="area" value="default" />
+  </form>
+</div>
+        </div><div class="wy-menu wy-menu-vertical" data-spy="affix" role="navigation" aria-label="Navigation menu">
+              <!-- Local TOC -->
+              <div class="local-toc"></div>
+        </div>
+      </div>
+    </nav>
+    <section data-toggle="wy-nav-shift" class="wy-nav-content-wrap"><nav class="wy-nav-top" aria-label="Mobile navigation menu"  style="background: #343131" >
+          <i data-toggle="wy-nav-top" class="fa fa-bars"></i>
+          <a href="../../../../index.html">MindRoot</a>
+      </nav>
+      <div class="wy-nav-content">
+        <div class="rst-content">
+          <div role="navigation" aria-label="Page navigation">
+  <ul class="wy-breadcrumbs">
+      <li><a href="../../../../index.html" class="icon icon-home" aria-label="Home"></a></li>
+          <li class="breadcrumb-item"><a href="../../../index.html">Module code</a></li>
+      <li class="breadcrumb-item active">mindroot.coreplugins.l8n.mod</li>
+      <li class="wy-breadcrumbs-aside">
+      </li>
+  </ul>
+  <hr/>
+</div>
+          <div role="main" class="document" itemscope="itemscope" itemtype="http://schema.org/Article">
+           <div itemprop="articleBody">
+  <h1>Source code for mindroot.coreplugins.l8n.mod</h1><div class="highlight"><pre>
+<span></span><span class="kn">import</span><span class="w"> </span><span class="nn">os</span>
+<span class="kn">import</span><span class="w"> </span><span class="nn">re</span>
+<span class="kn">import</span><span class="w"> </span><span class="nn">json</span>
+<span class="kn">from</span><span class="w"> </span><span class="nn">pathlib</span><span class="w"> </span><span class="kn">import</span> <span class="n">Path</span>
+<span class="c1"># Try to import from lib first (for same instance), fallback to mindroot.lib</span>
+<span class="k">try</span><span class="p">:</span>
+    <span class="kn">from</span><span class="w"> </span><span class="nn">lib.providers.commands</span><span class="w"> </span><span class="kn">import</span> <span class="n">command</span><span class="p">,</span> <span class="n">command_manager</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;l8n: Using lib.providers.commands (same instance)&quot;</span><span class="p">)</span>
+<span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
+    <span class="kn">from</span><span class="w"> </span><span class="nn">mindroot.lib.providers.commands</span><span class="w"> </span><span class="kn">import</span> <span class="n">command</span><span class="p">,</span> <span class="n">command_manager</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;l8n: Using mindroot.lib.providers.commands (fallback)&quot;</span><span class="p">)</span>
+<span class="kn">from</span><span class="w"> </span><span class="nn">.utils</span><span class="w"> </span><span class="kn">import</span> <span class="n">extract_plugin_root</span><span class="p">,</span> <span class="n">get_localized_file_path</span><span class="p">,</span> <span class="n">load_plugin_translations</span><span class="p">,</span> <span class="n">get_plugin_translations_path</span>
+<span class="kn">from</span><span class="w"> </span><span class="nn">mindroot.lib.utils.debug</span><span class="w"> </span><span class="kn">import</span> <span class="n">debug_box</span>
+<span class="n">debug_box</span><span class="p">(</span><span class="s2">&quot;l8n: Top of mod.py&quot;</span><span class="p">)</span>
+<span class="kn">from</span><span class="w"> </span><span class="nn">.l8n_constants</span><span class="w"> </span><span class="kn">import</span> <span class="o">*</span>
+<div class="viewcode-block" id="save_plugin_translations">
+<a class="viewcode-back" href="../../../../source/mindroot.coreplugins.l8n.html#mindroot.coreplugins.l8n.mod.save_plugin_translations">[docs]</a>
+<span class="k">def</span><span class="w"> </span><span class="nf">save_plugin_translations</span><span class="p">(</span><span class="n">plugin_path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">translations</span><span class="p">:</span> <span class="nb">dict</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;Save translations for a specific plugin to disk.&quot;&quot;&quot;</span>
+    <span class="n">translations_file</span> <span class="o">=</span> <span class="n">get_plugin_translations_path</span><span class="p">(</span><span class="n">plugin_path</span><span class="p">)</span>
+    <span class="k">try</span><span class="p">:</span>
+        <span class="c1"># Ensure directory exists</span>
+        <span class="n">translations_file</span><span class="o">.</span><span class="n">parent</span><span class="o">.</span><span class="n">mkdir</span><span class="p">(</span><span class="n">parents</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+        <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">translations_file</span><span class="p">,</span> <span class="s1">&#39;w&#39;</span><span class="p">,</span> <span class="n">encoding</span><span class="o">=</span><span class="s1">&#39;utf-8&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+            <span class="n">json</span><span class="o">.</span><span class="n">dump</span><span class="p">(</span><span class="n">translations</span><span class="p">,</span> <span class="n">f</span><span class="p">,</span> <span class="n">indent</span><span class="o">=</span><span class="mi">2</span><span class="p">,</span> <span class="n">ensure_ascii</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+        <span class="k">return</span> <span class="kc">True</span>
+    <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;Warning: Could not save translations to </span><span class="si">{</span><span class="n">translations_file</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">e</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+        <span class="k">return</span> <span class="kc">False</span></div>
+<span class="n">debug_box</span><span class="p">(</span><span class="s2">&quot;l8n: defining command&quot;</span><span class="p">)</span>
+<span class="c1"># Debug: Check if command_manager has functions</span>
+<span class="n">debug_box</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;l8n: command_manager has </span><span class="si">{</span><span class="nb">len</span><span class="p">(</span><span class="n">command_manager</span><span class="o">.</span><span class="n">functions</span><span class="p">)</span><span class="si">}</span><span class="s2"> functions before registration&quot;</span><span class="p">)</span>
+<span class="n">debug_box</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;l8n: command_manager instance ID: </span><span class="si">{</span><span class="nb">id</span><span class="p">(</span><span class="n">command_manager</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<div class="viewcode-block" id="write_localized_file">
+<a class="viewcode-back" href="../../../../source/mindroot.coreplugins.l8n.html#mindroot.coreplugins.l8n.mod.write_localized_file">[docs]</a>
+<span class="nd">@command</span><span class="p">()</span>
+<span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">write_localized_file</span><span class="p">(</span><span class="n">original_path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">content</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">context</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Write a localized version of a file with static placeholders.</span>
+<span class="sd">    </span>
+<span class="sd">    This command creates a localized version of a template or source file</span>
+<span class="sd">    with __TRANSLATE_key__ placeholders that will be replaced with actual</span>
+<span class="sd">    translations when the file is loaded.</span>
+<span class="sd">    </span>
+<span class="sd">    PLACEHOLDER FORMAT RULES:</span>
+<span class="sd">    - Always use the exact format: __TRANSLATE_key_name__</span>
+<span class="sd">    - Must start with __TRANSLATE_ and end with __</span>
+<span class="sd">    - Use lowercase letters, numbers, and underscores only for the key name</span>
+<span class="sd">    - Use descriptive, hierarchical key names like section_element or buttons_save</span>
+<span class="sd">    - NO spaces, hyphens, or special characters in key names</span>
+<span class="sd">    </span>
+<span class="sd">    Args:</span>
+<span class="sd">        original_path: Absolute path to the original file</span>
+<span class="sd">        content: File content with __TRANSLATE_key__ placeholders</span>
+<span class="sd">        context: Command context (optional)</span>
+<span class="sd">    </span>
+<span class="sd">    Examples:</span>
+<span class="sd">        await write_localized_file(</span>
+<span class="sd">            &quot;/files/mindroot/src/mindroot/coreplugins/chat/templates/chat.jinja2&quot;,</span>
+<span class="sd">            &quot;&lt;h1&gt;__TRANSLATE_chat_title__&lt;/h1&gt;&lt;button&gt;__TRANSLATE_buttons_send__&lt;/button&gt;&quot;</span>
+<span class="sd">        )</span>
+<span class="sd">        </span>
+<span class="sd">        await write_localized_file(</span>
+<span class="sd">            &quot;/some/path/src/my_plugin/templates/dashboard.jinja2&quot;,</span>
+<span class="sd">            &quot;&lt;div&gt;__TRANSLATE_dashboard_welcome__&lt;/div&gt;&quot;</span>
+<span class="sd">        )</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">try</span><span class="p">:</span>
+        <span class="n">localized_path</span> <span class="o">=</span> <span class="n">get_localized_file_path</span><span class="p">(</span><span class="n">original_path</span><span class="p">)</span>
+        <span class="c1"># Create directory if it doesn&#39;t exist</span>
+        <span class="n">localized_path</span><span class="o">.</span><span class="n">parent</span><span class="o">.</span><span class="n">mkdir</span><span class="p">(</span><span class="n">parents</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+        <span class="c1"># Write the content</span>
+        <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">localized_path</span><span class="p">,</span> <span class="s1">&#39;w&#39;</span><span class="p">,</span> <span class="n">encoding</span><span class="o">=</span><span class="s1">&#39;utf-8&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+            <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">content</span><span class="p">)</span>
+        <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;Localized file written to: </span><span class="si">{</span><span class="n">localized_path</span><span class="si">}</span><span class="s2">&quot;</span>
+    <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+        <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;Error writing localized file: </span><span class="si">{</span><span class="nb">str</span><span class="p">(</span><span class="n">e</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span></div>
+<div class="viewcode-block" id="append_localized_file">
+<a class="viewcode-back" href="../../../../source/mindroot.coreplugins.l8n.html#mindroot.coreplugins.l8n.mod.append_localized_file">[docs]</a>
+<span class="nd">@command</span><span class="p">()</span>
+<span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">append_localized_file</span><span class="p">(</span><span class="n">original_path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">content</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">context</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Append content to an existing localized file.</span>
+<span class="sd">    </span>
+<span class="sd">    Use this for large files that need to be built incrementally.</span>
+<span class="sd">    Follow the same placeholder format rules as write_localized_file.</span>
+<span class="sd">    </span>
+<span class="sd">    Args:</span>
+<span class="sd">        original_path: Absolute path to the original file</span>
+<span class="sd">        content: Content to append with __TRANSLATE_key__ placeholders</span>
+<span class="sd">        context: Command context (optional)</span>
+<span class="sd">    </span>
+<span class="sd">    Example:</span>
+<span class="sd">        # First write the beginning</span>
+<span class="sd">        await write_localized_file(</span>
+<span class="sd">            &quot;/path/to/large_template.jinja2&quot;,</span>
+<span class="sd">            &quot;&lt;html&gt;&lt;head&gt;&lt;title&gt;__TRANSLATE_page_title__&lt;/title&gt;&lt;/head&gt;&quot;</span>
+<span class="sd">        )</span>
+<span class="sd">        </span>
+<span class="sd">        # Then append more sections</span>
+<span class="sd">        await append_localized_file(</span>
+<span class="sd">            &quot;/path/to/large_template.jinja2&quot;,</span>
+<span class="sd">            &quot;&lt;body&gt;&lt;h1&gt;__TRANSLATE_main_heading__&lt;/h1&gt;&lt;/body&gt;&lt;/html&gt;&quot;</span>
+<span class="sd">        )</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">try</span><span class="p">:</span>
+        <span class="n">localized_path</span> <span class="o">=</span> <span class="n">get_localized_file_path</span><span class="p">(</span><span class="n">original_path</span><span class="p">)</span>
+        <span class="c1"># Create directory if it doesn&#39;t exist</span>
+        <span class="n">localized_path</span><span class="o">.</span><span class="n">parent</span><span class="o">.</span><span class="n">mkdir</span><span class="p">(</span><span class="n">parents</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">exist_ok</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+        <span class="c1"># Append the content</span>
+        <span class="k">with</span> <span class="nb">open</span><span class="p">(</span><span class="n">localized_path</span><span class="p">,</span> <span class="s1">&#39;a&#39;</span><span class="p">,</span> <span class="n">encoding</span><span class="o">=</span><span class="s1">&#39;utf-8&#39;</span><span class="p">)</span> <span class="k">as</span> <span class="n">f</span><span class="p">:</span>
+            <span class="n">f</span><span class="o">.</span><span class="n">write</span><span class="p">(</span><span class="n">content</span><span class="p">)</span>
+        <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;Content appended to: </span><span class="si">{</span><span class="n">localized_path</span><span class="si">}</span><span class="s2">&quot;</span>
+    <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+        <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;Error appending to localized file: </span><span class="si">{</span><span class="nb">str</span><span class="p">(</span><span class="n">e</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span></div>
+<div class="viewcode-block" id="set_translations">
+<a class="viewcode-back" href="../../../../source/mindroot.coreplugins.l8n.html#mindroot.coreplugins.l8n.mod.set_translations">[docs]</a>
+<span class="nd">@command</span><span class="p">()</span>
+<span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">set_translations</span><span class="p">(</span><span class="n">original_path</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">language</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">translations</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span> <span class="n">context</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Set translations for a specific language and plugin.</span>
+<span class="sd">    </span>
+<span class="sd">    This command stores the translation mappings that will be used to replace</span>
+<span class="sd">    __TRANSLATE_key__ placeholders in localized files. Translations are stored</span>
+<span class="sd">    per plugin based on the provided file path.</span>
+<span class="sd">    </span>
+<span class="sd">    Args:</span>
+<span class="sd">        original_path: Absolute path to a file in the plugin (used to identify the plugin)</span>
+<span class="sd">        language: Language code (e.g., &#39;en&#39;, &#39;es&#39;, &#39;fr&#39;, &#39;de&#39;)</span>
+<span class="sd">        translations: Dictionary mapping translation keys to translated text</span>
+<span class="sd">        context: Command context (optional)</span>
+<span class="sd">    </span>
+<span class="sd">    Examples:</span>
+<span class="sd">        await set_translations(</span>
+<span class="sd">            &quot;/files/mindroot/src/mindroot/coreplugins/chat/templates/chat.jinja2&quot;,</span>
+<span class="sd">            &#39;es&#39;, </span>
+<span class="sd">            {</span>
+<span class="sd">                &#39;chat_title&#39;: &#39;Interfaz de Chat&#39;,</span>
+<span class="sd">                &#39;buttons_send&#39;: &#39;Enviar Mensaje&#39;,</span>
+<span class="sd">                &#39;nav_home&#39;: &#39;Inicio&#39;,</span>
+<span class="sd">                &#39;error_connection_failed&#39;: &#39;Error de conexión&#39;</span>
+<span class="sd">            }</span>
+<span class="sd">        )</span>
+<span class="sd">        </span>
+<span class="sd">        await set_translations(</span>
+<span class="sd">            &quot;/some/path/src/my_plugin/templates/dashboard.jinja2&quot;,</span>
+<span class="sd">            &#39;fr&#39;, </span>
+<span class="sd">            {</span>
+<span class="sd">                &#39;dashboard_welcome&#39;: &#39;Bienvenue au Tableau de Bord&#39;,</span>
+<span class="sd">                &#39;buttons_save&#39;: &#39;Enregistrer&#39;,</span>
+<span class="sd">                &#39;nav_home&#39;: &#39;Accueil&#39;</span>
+<span class="sd">            }</span>
+<span class="sd">        )</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">try</span><span class="p">:</span>
+        <span class="k">if</span> <span class="ow">not</span> <span class="nb">isinstance</span><span class="p">(</span><span class="n">translations</span><span class="p">,</span> <span class="nb">dict</span><span class="p">):</span>
+            <span class="k">return</span> <span class="s2">&quot;Error: translations must be a dictionary&quot;</span>
+        <span class="c1"># Get the plugin-specific translations path</span>
+        <span class="n">plugin_key</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">get_plugin_translations_path</span><span class="p">(</span><span class="n">original_path</span><span class="p">))</span>
+        <span class="c1"># Load existing translations for this plugin</span>
+        <span class="n">plugin_translations</span> <span class="o">=</span> <span class="n">load_plugin_translations</span><span class="p">(</span><span class="n">original_path</span><span class="p">)</span>
+        <span class="c1"># Validate translation keys (should match placeholder format)</span>
+        <span class="n">invalid_keys</span> <span class="o">=</span> <span class="p">[]</span>
+        <span class="k">for</span> <span class="n">key</span> <span class="ow">in</span> <span class="n">translations</span><span class="o">.</span><span class="n">keys</span><span class="p">():</span>
+            <span class="k">if</span> <span class="ow">not</span> <span class="n">re</span><span class="o">.</span><span class="n">match</span><span class="p">(</span><span class="sa">r</span><span class="s1">&#39;^[a-z0-9_]+$&#39;</span><span class="p">,</span> <span class="n">key</span><span class="p">):</span>
+                <span class="n">invalid_keys</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">key</span><span class="p">)</span>
+        <span class="k">if</span> <span class="n">invalid_keys</span><span class="p">:</span>
+            <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;Error: Invalid translation keys (use lowercase, numbers, underscores only): </span><span class="si">{</span><span class="n">invalid_keys</span><span class="si">}</span><span class="s2">&quot;</span>
+        <span class="c1"># Update translations for this language</span>
+        <span class="k">if</span> <span class="n">language</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">plugin_translations</span><span class="p">:</span>
+            <span class="n">plugin_translations</span><span class="p">[</span><span class="n">language</span><span class="p">]</span> <span class="o">=</span> <span class="p">{}</span>
+        <span class="n">plugin_translations</span><span class="p">[</span><span class="n">language</span><span class="p">]</span><span class="o">.</span><span class="n">update</span><span class="p">(</span><span class="n">translations</span><span class="p">)</span>
+        <span class="c1"># Save translations to disk</span>
+        <span class="k">if</span> <span class="n">save_plugin_translations</span><span class="p">(</span><span class="n">original_path</span><span class="p">,</span> <span class="n">plugin_translations</span><span class="p">):</span>
+            <span class="c1"># Update cache</span>
+            <span class="n">TRANSLATIONS</span><span class="p">[</span><span class="n">plugin_key</span><span class="p">]</span> <span class="o">=</span> <span class="n">plugin_translations</span>
+            <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;Set </span><span class="si">{</span><span class="nb">len</span><span class="p">(</span><span class="n">translations</span><span class="p">)</span><span class="si">}</span><span class="s2"> translations for language &#39;</span><span class="si">{</span><span class="n">language</span><span class="si">}</span><span class="s2">&#39; in </span><span class="si">{</span><span class="n">Path</span><span class="p">(</span><span class="n">plugin_key</span><span class="p">)</span><span class="o">.</span><span class="n">parent</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2"> plugin&quot;</span>
+        <span class="k">else</span><span class="p">:</span>
+            <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;Error: Could not save translations&quot;</span>
+    <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+        <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;Error setting translations: </span><span class="si">{</span><span class="nb">str</span><span class="p">(</span><span class="n">e</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span></div>
+<div class="viewcode-block" id="get_translations">
+<a class="viewcode-back" href="../../../../source/mindroot.coreplugins.l8n.html#mindroot.coreplugins.l8n.mod.get_translations">[docs]</a>
+<span class="nd">@command</span><span class="p">()</span>
+<span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">get_translations</span><span class="p">(</span><span class="n">original_path</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">language</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span> <span class="n">context</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Get translations for a specific plugin and language.</span>
+<span class="sd">    </span>
+<span class="sd">    Args:</span>
+<span class="sd">        original_path: Absolute path to a file in the plugin (optional)</span>
+<span class="sd">                      If not provided, returns all cached translations</span>
+<span class="sd">        language: Language code to get translations for (optional)</span>
+<span class="sd">        context: Command context (optional)</span>
+<span class="sd">    </span>
+<span class="sd">    Returns:</span>
+<span class="sd">        Dictionary of translations</span>
+<span class="sd">    </span>
+<span class="sd">    Examples:</span>
+<span class="sd">        # Get all translations for a plugin</span>
+<span class="sd">        translations = await get_translations(</span>
+<span class="sd">            &quot;/files/mindroot/src/mindroot/coreplugins/chat/templates/chat.jinja2&quot;</span>
+<span class="sd">        )</span>
+<span class="sd">        </span>
+<span class="sd">        # Get Spanish translations for a plugin</span>
+<span class="sd">        spanish = await get_translations(</span>
+<span class="sd">            &quot;/files/mindroot/src/mindroot/coreplugins/chat/templates/chat.jinja2&quot;,</span>
+<span class="sd">            &#39;es&#39;</span>
+<span class="sd">        )</span>
+<span class="sd">        </span>
+<span class="sd">        # Get all cached translations</span>
+<span class="sd">        all_cached = await get_translations()</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">try</span><span class="p">:</span>
+        <span class="k">if</span> <span class="n">original_path</span><span class="p">:</span>
+            <span class="c1"># Load translations for specific plugin</span>
+            <span class="n">plugin_translations</span> <span class="o">=</span> <span class="n">load_plugin_translations</span><span class="p">(</span><span class="n">original_path</span><span class="p">)</span>
+            <span class="c1"># Update cache</span>
+            <span class="n">plugin_key</span> <span class="o">=</span> <span class="nb">str</span><span class="p">(</span><span class="n">get_plugin_translations_path</span><span class="p">(</span><span class="n">original_path</span><span class="p">))</span>
+            <span class="n">TRANSLATIONS</span><span class="p">[</span><span class="n">plugin_key</span><span class="p">]</span> <span class="o">=</span> <span class="n">plugin_translations</span>
+            <span class="k">if</span> <span class="n">language</span><span class="p">:</span>
+                <span class="k">return</span> <span class="n">plugin_translations</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">language</span><span class="p">,</span> <span class="p">{})</span>
+            <span class="k">else</span><span class="p">:</span>
+                <span class="k">return</span> <span class="n">plugin_translations</span>
+        <span class="k">else</span><span class="p">:</span>
+            <span class="c1"># Return all cached translations</span>
+            <span class="k">return</span> <span class="n">TRANSLATIONS</span>
+    <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+        <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;Error getting translations: </span><span class="si">{</span><span class="nb">str</span><span class="p">(</span><span class="n">e</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span></div>
+<div class="viewcode-block" id="list_localized_files">
+<a class="viewcode-back" href="../../../../source/mindroot.coreplugins.l8n.html#mindroot.coreplugins.l8n.mod.list_localized_files">[docs]</a>
+<span class="nd">@command</span><span class="p">()</span>
+<span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">list_localized_files</span><span class="p">(</span><span class="n">context</span><span class="o">=</span><span class="kc">None</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    List all localized files that have been created.</span>
+<span class="sd">    </span>
+<span class="sd">    Returns:</span>
+<span class="sd">        List of paths to localized files</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">try</span><span class="p">:</span>
+        <span class="n">localized_files</span> <span class="o">=</span> <span class="p">[]</span>
+        <span class="k">if</span> <span class="n">LOCALIZED_FILES_DIR</span><span class="o">.</span><span class="n">exists</span><span class="p">():</span>
+            <span class="k">for</span> <span class="n">file_path</span> <span class="ow">in</span> <span class="n">LOCALIZED_FILES_DIR</span><span class="o">.</span><span class="n">rglob</span><span class="p">(</span><span class="s2">&quot;*.i18n.*&quot;</span><span class="p">):</span>
+                <span class="n">localized_files</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">file_path</span><span class="o">.</span><span class="n">relative_to</span><span class="p">(</span><span class="n">LOCALIZED_FILES_DIR</span><span class="p">)))</span>
+        <span class="k">return</span> <span class="p">{</span>
+            <span class="s2">&quot;count&quot;</span><span class="p">:</span> <span class="nb">len</span><span class="p">(</span><span class="n">localized_files</span><span class="p">),</span>
+            <span class="s2">&quot;files&quot;</span><span class="p">:</span> <span class="nb">sorted</span><span class="p">(</span><span class="n">localized_files</span><span class="p">)</span>
+        <span class="p">}</span>
+    <span class="k">except</span> <span class="ne">Exception</span> <span class="k">as</span> <span class="n">e</span><span class="p">:</span>
+        <span class="k">return</span> <span class="sa">f</span><span class="s2">&quot;Error listing localized files: </span><span class="si">{</span><span class="nb">str</span><span class="p">(</span><span class="n">e</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span></div>
+<span class="n">debug_box</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;l8n: command_manager has </span><span class="si">{</span><span class="nb">len</span><span class="p">(</span><span class="n">command_manager</span><span class="o">.</span><span class="n">functions</span><span class="p">)</span><span class="si">}</span><span class="s2"> functions after registration&quot;</span><span class="p">)</span>
+<span class="n">debug_box</span><span class="p">(</span><span class="s2">&quot;l8n: End of mod.py&quot;</span><span class="p">)</span>
+</pre></div>
+           </div>
+          </div>
+          <footer>
+  <hr/>
+  <div role="contentinfo">
+    <p>&#169; Copyright 2025, Jason Livesay.</p>
+  </div>
+  Built with <a href="https://www.sphinx-doc.org/">Sphinx</a> using a
+    <a href="https://github.com/readthedocs/sphinx_rtd_theme">theme</a>
+    provided by <a href="https://readthedocs.org">Read the Docs</a>.
+</footer>
+        </div>
+      </div>
+    </section>
+  </div>
+  <script>
+      jQuery(function () {
+          SphinxRtdTheme.Navigation.enable(true);
+      });
+  </script>
+</body>
+</html>