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

mindroot 9.11.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 (415) hide show

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

@@ -0,0 +1,296 @@
+<!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.language_detection &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.language_detection</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.language_detection</h1><div class="highlight"><pre>
+<span></span><span class="kn">import</span><span class="w"> </span><span class="nn">os</span>
+<span class="kn">from</span><span class="w"> </span><span class="nn">typing</span><span class="w"> </span><span class="kn">import</span> <span class="n">Optional</span>
+<div class="viewcode-block" id="get_current_language_from_request">
+<a class="viewcode-back" href="../../../../source/mindroot.coreplugins.l8n.html#mindroot.coreplugins.l8n.language_detection.get_current_language_from_request">[docs]</a>
+<span class="k">def</span><span class="w"> </span><span class="nf">get_current_language_from_request</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Get the current language from various request sources.</span>
+<span class="sd">    </span>
+<span class="sd">    This function checks multiple sources in order of priority:</span>
+<span class="sd">    1. Environment variable MINDROOT_LANGUAGE</span>
+<span class="sd">    2. FastAPI request context (if available)</span>
+<span class="sd">    3. HTTP Accept-Language header</span>
+<span class="sd">    4. URL parameters (?lang=es)</span>
+<span class="sd">    5. Cookie values</span>
+<span class="sd">    6. User preferences from database/session</span>
+<span class="sd">    </span>
+<span class="sd">    Returns:</span>
+<span class="sd">        Language code (e.g., &#39;en&#39;, &#39;es&#39;, &#39;fr&#39;)</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="c1"># 1. Check environment variable first (for testing/override)</span>
+    <span class="n">env_lang</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;MINDROOT_LANGUAGE&#39;</span><span class="p">)</span>
+    <span class="k">if</span> <span class="n">env_lang</span><span class="p">:</span>
+        <span class="k">return</span> <span class="n">env_lang</span>
+    <span class="c1"># 2. Try to get language from FastAPI request context</span>
+    <span class="k">try</span><span class="p">:</span>
+        <span class="kn">from</span><span class="w"> </span><span class="nn">contextvars</span><span class="w"> </span><span class="kn">import</span> <span class="n">ContextVar</span>
+        <span class="kn">import</span><span class="w"> </span><span class="nn">contextvars</span>
+        <span class="c1"># Try to find request context</span>
+        <span class="n">request_lang</span> <span class="o">=</span> <span class="n">_get_language_from_fastapi_context</span><span class="p">()</span>
+        <span class="k">if</span> <span class="n">request_lang</span><span class="p">:</span>
+            <span class="k">return</span> <span class="n">request_lang</span>
+    <span class="k">except</span> <span class="p">(</span><span class="ne">ImportError</span><span class="p">,</span> <span class="ne">Exception</span><span class="p">):</span>
+        <span class="k">pass</span>
+    <span class="c1"># 3. Fallback to default language</span>
+    <span class="k">return</span> <span class="s1">&#39;en&#39;</span></div>
+<span class="k">def</span><span class="w"> </span><span class="nf">_get_language_from_fastapi_context</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="n">Optional</span><span class="p">[</span><span class="nb">str</span><span class="p">]:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Extract language from FastAPI request context.</span>
+<span class="sd">    </span>
+<span class="sd">    This function attempts to access the current FastAPI request</span>
+<span class="sd">    and extract language information from various sources.</span>
+<span class="sd">    </span>
+<span class="sd">    Returns:</span>
+<span class="sd">        Language code if found, None otherwise</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">try</span><span class="p">:</span>
+        <span class="c1"># Try to get the current request from FastAPI context</span>
+        <span class="kn">from</span><span class="w"> </span><span class="nn">starlette.requests</span><span class="w"> </span><span class="kn">import</span> <span class="n">Request</span>
+        <span class="kn">import</span><span class="w"> </span><span class="nn">contextvars</span>
+        <span class="c1"># This is a placeholder - in a real implementation, we would need</span>
+        <span class="c1"># to access the actual request context that MindRoot uses</span>
+        <span class="c1"># For now, we&#39;ll implement the detection logic structure</span>
+        <span class="c1"># Check if there&#39;s a way to get the current request</span>
+        <span class="c1"># This would need to be integrated with MindRoot&#39;s request handling</span>
+        <span class="k">return</span> <span class="kc">None</span>  <span class="c1"># Placeholder</span>
+    <span class="k">except</span> <span class="p">(</span><span class="ne">ImportError</span><span class="p">,</span> <span class="ne">Exception</span><span class="p">):</span>
+        <span class="k">return</span> <span class="kc">None</span>
+<span class="k">def</span><span class="w"> </span><span class="nf">_parse_accept_language_header</span><span class="p">(</span><span class="n">accept_language</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Parse the Accept-Language header and return the preferred language.</span>
+<span class="sd">    </span>
+<span class="sd">    Args:</span>
+<span class="sd">        accept_language: Accept-Language header value</span>
+<span class="sd">        </span>
+<span class="sd">    Returns:</span>
+<span class="sd">        Preferred language code</span>
+<span class="sd">        </span>
+<span class="sd">    Example:</span>
+<span class="sd">        &#39;en-US,en;q=0.9,es;q=0.8,fr;q=0.7&#39; -&gt; &#39;en&#39;</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">if</span> <span class="ow">not</span> <span class="n">accept_language</span><span class="p">:</span>
+        <span class="k">return</span> <span class="s1">&#39;en&#39;</span>
+    <span class="c1"># Parse the Accept-Language header</span>
+    <span class="n">languages</span> <span class="o">=</span> <span class="p">[]</span>
+    <span class="k">for</span> <span class="n">lang_range</span> <span class="ow">in</span> <span class="n">accept_language</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;,&#39;</span><span class="p">):</span>
+        <span class="n">lang_range</span> <span class="o">=</span> <span class="n">lang_range</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span>
+        <span class="k">if</span> <span class="s1">&#39;;q=&#39;</span> <span class="ow">in</span> <span class="n">lang_range</span><span class="p">:</span>
+            <span class="n">lang</span><span class="p">,</span> <span class="n">quality</span> <span class="o">=</span> <span class="n">lang_range</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;;q=&#39;</span><span class="p">,</span> <span class="mi">1</span><span class="p">)</span>
+            <span class="k">try</span><span class="p">:</span>
+                <span class="n">quality</span> <span class="o">=</span> <span class="nb">float</span><span class="p">(</span><span class="n">quality</span><span class="p">)</span>
+            <span class="k">except</span> <span class="ne">ValueError</span><span class="p">:</span>
+                <span class="n">quality</span> <span class="o">=</span> <span class="mf">1.0</span>
+        <span class="k">else</span><span class="p">:</span>
+            <span class="n">lang</span> <span class="o">=</span> <span class="n">lang_range</span>
+            <span class="n">quality</span> <span class="o">=</span> <span class="mf">1.0</span>
+        <span class="c1"># Extract just the language code (e.g., &#39;en&#39; from &#39;en-US&#39;)</span>
+        <span class="n">lang_code</span> <span class="o">=</span> <span class="n">lang</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;-&#39;</span><span class="p">)[</span><span class="mi">0</span><span class="p">]</span><span class="o">.</span><span class="n">lower</span><span class="p">()</span>
+        <span class="n">languages</span><span class="o">.</span><span class="n">append</span><span class="p">((</span><span class="n">lang_code</span><span class="p">,</span> <span class="n">quality</span><span class="p">))</span>
+    <span class="c1"># Sort by quality (highest first)</span>
+    <span class="n">languages</span><span class="o">.</span><span class="n">sort</span><span class="p">(</span><span class="n">key</span><span class="o">=</span><span class="k">lambda</span> <span class="n">x</span><span class="p">:</span> <span class="n">x</span><span class="p">[</span><span class="mi">1</span><span class="p">],</span> <span class="n">reverse</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+    <span class="c1"># Return the highest quality language</span>
+    <span class="k">if</span> <span class="n">languages</span><span class="p">:</span>
+        <span class="k">return</span> <span class="n">languages</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="mi">0</span><span class="p">]</span>
+    <span class="k">return</span> <span class="s1">&#39;en&#39;</span>
+<div class="viewcode-block" id="set_language_for_request">
+<a class="viewcode-back" href="../../../../source/mindroot.coreplugins.l8n.html#mindroot.coreplugins.l8n.language_detection.set_language_for_request">[docs]</a>
+<span class="k">def</span><span class="w"> </span><span class="nf">set_language_for_request</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="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Set the language for the current request context.</span>
+<span class="sd">    </span>
+<span class="sd">    This function would be called by middleware or route handlers</span>
+<span class="sd">    to set the language for the current request.</span>
+<span class="sd">    </span>
+<span class="sd">    Args:</span>
+<span class="sd">        language: Language code to set</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="c1"># Set environment variable as a simple implementation</span>
+    <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="p">[</span><span class="s1">&#39;MINDROOT_LANGUAGE&#39;</span><span class="p">]</span> <span class="o">=</span> <span class="n">language</span></div>
+    <span class="c1"># In a real implementation, this would set the language</span>
+    <span class="c1"># in the request context or thread-local storage</span>
+<div class="viewcode-block" id="get_supported_languages">
+<a class="viewcode-back" href="../../../../source/mindroot.coreplugins.l8n.html#mindroot.coreplugins.l8n.language_detection.get_supported_languages">[docs]</a>
+<span class="k">def</span><span class="w"> </span><span class="nf">get_supported_languages</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">list</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Get the list of supported languages.</span>
+<span class="sd">    </span>
+<span class="sd">    Returns:</span>
+<span class="sd">        List of supported language codes</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="c1"># This could be configured via environment variables or config files</span>
+    <span class="n">supported</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;MINDROOT_SUPPORTED_LANGUAGES&#39;</span><span class="p">,</span> <span class="s1">&#39;en,es,fr,de,it,pt,ru,zh,ja,ko&#39;</span><span class="p">)</span>
+    <span class="k">return</span> <span class="p">[</span><span class="n">lang</span><span class="o">.</span><span class="n">strip</span><span class="p">()</span> <span class="k">for</span> <span class="n">lang</span> <span class="ow">in</span> <span class="n">supported</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s1">&#39;,&#39;</span><span class="p">)]</span></div>
+<div class="viewcode-block" id="is_language_supported">
+<a class="viewcode-back" href="../../../../source/mindroot.coreplugins.l8n.html#mindroot.coreplugins.l8n.language_detection.is_language_supported">[docs]</a>
+<span class="k">def</span><span class="w"> </span><span class="nf">is_language_supported</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="o">-&gt;</span> <span class="nb">bool</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Check if a language is supported.</span>
+<span class="sd">    </span>
+<span class="sd">    Args:</span>
+<span class="sd">        language: Language code to check</span>
+<span class="sd">        </span>
+<span class="sd">    Returns:</span>
+<span class="sd">        True if language is supported, False otherwise</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">return</span> <span class="n">language</span> <span class="ow">in</span> <span class="n">get_supported_languages</span><span class="p">()</span></div>
+<div class="viewcode-block" id="get_fallback_language">
+<a class="viewcode-back" href="../../../../source/mindroot.coreplugins.l8n.html#mindroot.coreplugins.l8n.language_detection.get_fallback_language">[docs]</a>
+<span class="k">def</span><span class="w"> </span><span class="nf">get_fallback_language</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="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Get a fallback language if the requested language is not supported.</span>
+<span class="sd">    </span>
+<span class="sd">    Args:</span>
+<span class="sd">        language: Requested language code</span>
+<span class="sd">        </span>
+<span class="sd">    Returns:</span>
+<span class="sd">        Fallback language code</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">if</span> <span class="n">is_language_supported</span><span class="p">(</span><span class="n">language</span><span class="p">):</span>
+        <span class="k">return</span> <span class="n">language</span>
+    <span class="c1"># Language family fallbacks</span>
+    <span class="n">fallbacks</span> <span class="o">=</span> <span class="p">{</span>
+        <span class="s1">&#39;en-us&#39;</span><span class="p">:</span> <span class="s1">&#39;en&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;en-gb&#39;</span><span class="p">:</span> <span class="s1">&#39;en&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;es-es&#39;</span><span class="p">:</span> <span class="s1">&#39;es&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;es-mx&#39;</span><span class="p">:</span> <span class="s1">&#39;es&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;fr-fr&#39;</span><span class="p">:</span> <span class="s1">&#39;fr&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;fr-ca&#39;</span><span class="p">:</span> <span class="s1">&#39;fr&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;de-de&#39;</span><span class="p">:</span> <span class="s1">&#39;de&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;de-at&#39;</span><span class="p">:</span> <span class="s1">&#39;de&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;pt-br&#39;</span><span class="p">:</span> <span class="s1">&#39;pt&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;pt-pt&#39;</span><span class="p">:</span> <span class="s1">&#39;pt&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;zh-cn&#39;</span><span class="p">:</span> <span class="s1">&#39;zh&#39;</span><span class="p">,</span>
+        <span class="s1">&#39;zh-tw&#39;</span><span class="p">:</span> <span class="s1">&#39;zh&#39;</span><span class="p">,</span>
+    <span class="p">}</span>
+    <span class="c1"># Try fallback</span>
+    <span class="n">fallback</span> <span class="o">=</span> <span class="n">fallbacks</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">language</span><span class="o">.</span><span class="n">lower</span><span class="p">())</span>
+    <span class="k">if</span> <span class="n">fallback</span> <span class="ow">and</span> <span class="n">is_language_supported</span><span class="p">(</span><span class="n">fallback</span><span class="p">):</span>
+        <span class="k">return</span> <span class="n">fallback</span>
+    <span class="c1"># Default to English</span>
+    <span class="k">return</span> <span class="s1">&#39;en&#39;</span></div>
+</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>

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

@@ -0,0 +1,258 @@
+<!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.middleware &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.middleware</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.middleware</h1><div class="highlight"><pre>
+<span></span><span class="kn">from</span><span class="w"> </span><span class="nn">fastapi</span><span class="w"> </span><span class="kn">import</span> <span class="n">Request</span>
+<span class="k">try</span><span class="p">:</span>
+    <span class="kn">from</span><span class="w"> </span><span class="nn">.language_detection</span><span class="w"> </span><span class="kn">import</span> <span class="p">(</span>
+        <span class="n">_parse_accept_language_header</span><span class="p">,</span>
+        <span class="n">get_fallback_language</span><span class="p">,</span>
+        <span class="n">set_language_for_request</span>
+    <span class="p">)</span>
+<span class="k">except</span> <span class="ne">ImportError</span><span class="p">:</span>
+    <span class="c1"># For standalone testing</span>
+    <span class="kn">from</span><span class="w"> </span><span class="nn">language_detection</span><span class="w"> </span><span class="kn">import</span> <span class="p">(</span>
+        <span class="n">_parse_accept_language_header</span><span class="p">,</span>
+        <span class="n">get_fallback_language</span><span class="p">,</span>
+        <span class="n">set_language_for_request</span>
+    <span class="p">)</span>
+<span class="kn">import</span><span class="w"> </span><span class="nn">os</span>
+<span class="c1"># Global variable to store the current request language</span>
+<span class="c1"># This will be set by the middleware for each request</span>
+<span class="n">_current_request_language</span> <span class="o">=</span> <span class="kc">None</span>
+<div class="viewcode-block" id="get_request_language">
+<a class="viewcode-back" href="../../../../source/mindroot.coreplugins.l8n.html#mindroot.coreplugins.l8n.middleware.get_request_language">[docs]</a>
+<span class="k">def</span><span class="w"> </span><span class="nf">get_request_language</span><span class="p">()</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Get the language that was detected for the current request.</span>
+<span class="sd">    </span>
+<span class="sd">    This function is called by the monkey patch system to get the</span>
+<span class="sd">    language for template translation.</span>
+<span class="sd">    </span>
+<span class="sd">    Returns:</span>
+<span class="sd">        Language code for the current request</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">global</span> <span class="n">_current_request_language</span>
+    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;L8n: Current request language is &#39;</span><span class="si">{</span><span class="n">_current_request_language</span><span class="si">}</span><span class="s2">&#39;&quot;</span><span class="p">)</span>
+    <span class="c1"># If we have a request-specific language, use it</span>
+    <span class="k">if</span> <span class="n">_current_request_language</span><span class="p">:</span>
+        <span class="k">return</span> <span class="n">_current_request_language</span>
+    <span class="c1"># Fallback to environment variable or default</span>
+    <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;L8n: No request language set, falling back to environment variable or default&quot;</span><span class="p">)</span>
+    <span class="k">return</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;MINDROOT_LANGUAGE&#39;</span><span class="p">,</span> <span class="s1">&#39;en&#39;</span><span class="p">)</span></div>
+<div class="viewcode-block" id="detect_language_from_request">
+<a class="viewcode-back" href="../../../../source/mindroot.coreplugins.l8n.html#mindroot.coreplugins.l8n.middleware.detect_language_from_request">[docs]</a>
+<span class="k">def</span><span class="w"> </span><span class="nf">detect_language_from_request</span><span class="p">(</span><span class="n">request</span><span class="p">:</span> <span class="n">Request</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="nb">str</span><span class="p">:</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    Detect the preferred language from a FastAPI request.</span>
+<span class="sd">    </span>
+<span class="sd">    Checks multiple sources in order of priority:</span>
+<span class="sd">    1. URL parameter (?lang=es)</span>
+<span class="sd">    2. Cookie value (mindroot_language)</span>
+<span class="sd">    3. Accept-Language header</span>
+<span class="sd">    4. Environment variable</span>
+<span class="sd">    5. Default to &#39;en&#39;</span>
+<span class="sd">    </span>
+<span class="sd">    Args:</span>
+<span class="sd">        request: FastAPI Request object</span>
+<span class="sd">        </span>
+<span class="sd">    Returns:</span>
+<span class="sd">        Detected language code</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="c1"># 1. Check URL parameter first (highest priority)</span>
+    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;L8n: Checking URL parameters for language: </span><span class="si">{</span><span class="n">request</span><span class="o">.</span><span class="n">query_params</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+    <span class="n">url_lang</span> <span class="o">=</span> <span class="n">request</span><span class="o">.</span><span class="n">query_params</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;lang&#39;</span><span class="p">)</span>
+    <span class="k">if</span> <span class="n">url_lang</span><span class="p">:</span>
+        <span class="k">return</span> <span class="n">get_fallback_language</span><span class="p">(</span><span class="n">url_lang</span><span class="o">.</span><span class="n">lower</span><span class="p">())</span>
+    <span class="c1"># 2. Check cookie value</span>
+    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;L8n: Checking cookies for language: </span><span class="si">{</span><span class="n">request</span><span class="o">.</span><span class="n">cookies</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+    <span class="n">cookie_lang</span> <span class="o">=</span> <span class="n">request</span><span class="o">.</span><span class="n">cookies</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;mindroot_language&#39;</span><span class="p">)</span>
+    <span class="k">if</span> <span class="n">cookie_lang</span><span class="p">:</span>
+        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;L8n: Found language in cookie: </span><span class="si">{</span><span class="n">cookie_lang</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+        <span class="k">return</span> <span class="n">get_fallback_language</span><span class="p">(</span><span class="n">cookie_lang</span><span class="o">.</span><span class="n">lower</span><span class="p">())</span>
+    <span class="c1"># 3. Check Accept-Language header</span>
+    <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;L8n: Accept-Language header: </span><span class="si">{</span><span class="n">request</span><span class="o">.</span><span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;accept-language&#39;</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+    <span class="n">accept_language</span> <span class="o">=</span> <span class="n">request</span><span class="o">.</span><span class="n">headers</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;accept-language&#39;</span><span class="p">)</span>
+    <span class="k">if</span> <span class="n">accept_language</span><span class="p">:</span>
+        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;L8n: Parsing Accept-Language header: </span><span class="si">{</span><span class="n">accept_language</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+        <span class="n">parsed_lang</span> <span class="o">=</span> <span class="n">_parse_accept_language_header</span><span class="p">(</span><span class="n">accept_language</span><span class="p">)</span>
+        <span class="k">if</span> <span class="n">parsed_lang</span><span class="p">:</span>
+            <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;L8n: Parsed language from header: </span><span class="si">{</span><span class="n">parsed_lang</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+            <span class="k">return</span> <span class="n">get_fallback_language</span><span class="p">(</span><span class="n">parsed_lang</span><span class="p">)</span>
+    <span class="c1"># 4. Check environment variable</span>
+    <span class="n">env_lang</span> <span class="o">=</span> <span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;MINDROOT_LANGUAGE&#39;</span><span class="p">)</span>
+    <span class="k">if</span> <span class="n">env_lang</span><span class="p">:</span>
+        <span class="k">return</span> <span class="n">get_fallback_language</span><span class="p">(</span><span class="n">env_lang</span><span class="o">.</span><span class="n">lower</span><span class="p">())</span>
+    <span class="c1"># 5. Default to English</span>
+    <span class="k">return</span> <span class="s1">&#39;en&#39;</span></div>
+<div class="viewcode-block" id="middleware">
+<a class="viewcode-back" href="../../../../source/mindroot.coreplugins.l8n.html#mindroot.coreplugins.l8n.middleware.middleware">[docs]</a>
+<span class="k">async</span> <span class="k">def</span><span class="w"> </span><span class="nf">middleware</span><span class="p">(</span><span class="n">request</span><span class="p">:</span> <span class="n">Request</span><span class="p">,</span> <span class="n">call_next</span><span class="p">):</span>
+<span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<span class="sd">    L8n middleware for language detection and setting.</span>
+<span class="sd">    </span>
+<span class="sd">    This middleware runs early in the request pipeline to:</span>
+<span class="sd">    1. Detect the preferred language for the request</span>
+<span class="sd">    2. Store it globally for use by the template system</span>
+<span class="sd">    3. Set it in the request state for other components</span>
+<span class="sd">    </span>
+<span class="sd">    Args:</span>
+<span class="sd">        request: FastAPI Request object</span>
+<span class="sd">        call_next: Next middleware/handler in the chain</span>
+<span class="sd">        </span>
+<span class="sd">    Returns:</span>
+<span class="sd">        Response from the next handler</span>
+<span class="sd">    &quot;&quot;&quot;</span>
+    <span class="k">global</span> <span class="n">_current_request_language</span>
+    <span class="k">try</span><span class="p">:</span>
+        <span class="nb">print</span><span class="p">(</span><span class="s2">&quot;L8n middleware: Starting language detection&quot;</span><span class="p">)</span>
+        <span class="c1"># Detect the language for this request</span>
+        <span class="n">detected_language</span> <span class="o">=</span> <span class="n">detect_language_from_request</span><span class="p">(</span><span class="n">request</span><span class="p">)</span>
+        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;L8n: Detected language &#39;</span><span class="si">{</span><span class="n">detected_language</span><span class="si">}</span><span class="s2">&#39; for </span><span class="si">{</span><span class="n">request</span><span class="o">.</span><span class="n">url</span><span class="o">.</span><span class="n">path</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+        <span class="c1"># Store it globally for the template system</span>
+        <span class="n">_current_request_language</span> <span class="o">=</span> <span class="n">detected_language</span>
+        <span class="c1"># Also store it in request state for other components</span>
+        <span class="n">request</span><span class="o">.</span><span class="n">state</span><span class="o">.</span><span class="n">language</span> <span class="o">=</span> <span class="n">detected_language</span>
+        <span class="c1"># Set it using the language detection system</span>
+        <span class="n">set_language_for_request</span><span class="p">(</span><span class="n">detected_language</span><span class="p">)</span>
+        <span class="c1"># Debug logging (can be removed in production)</span>
+        <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;L8n: Detected language &#39;</span><span class="si">{</span><span class="n">detected_language</span><span class="si">}</span><span class="s2">&#39; for </span><span class="si">{</span><span class="n">request</span><span class="o">.</span><span class="n">url</span><span class="o">.</span><span class="n">path</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+        <span class="c1"># Process the request</span>
+        <span class="n">response</span> <span class="o">=</span> <span class="k">await</span> <span class="n">call_next</span><span class="p">(</span><span class="n">request</span><span class="p">)</span>
+        <span class="c1"># Optionally set a cookie to remember the language preference</span>
+        <span class="c1"># Only set if it was explicitly requested via URL parameter</span>
+        <span class="k">if</span> <span class="n">request</span><span class="o">.</span><span class="n">query_params</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">&#39;lang&#39;</span><span class="p">):</span>
+            <span class="n">response</span><span class="o">.</span><span class="n">set_cookie</span><span class="p">(</span>
+                <span class="n">key</span><span class="o">=</span><span class="s2">&quot;mindroot_language&quot;</span><span class="p">,</span>
+                <span class="n">value</span><span class="o">=</span><span class="n">detected_language</span><span class="p">,</span>
+                <span class="n">max_age</span><span class="o">=</span><span class="mi">30</span> <span class="o">*</span> <span class="mi">24</span> <span class="o">*</span> <span class="mi">60</span> <span class="o">*</span> <span class="mi">60</span><span class="p">,</span>  <span class="c1"># 30 days</span>
+                <span class="n">httponly</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span>
+                <span class="n">samesite</span><span class="o">=</span><span class="s2">&quot;lax&quot;</span>
+            <span class="p">)</span>
+        <span class="k">return</span> <span class="n">response</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;L8n middleware error: </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="c1"># If there&#39;s an error, continue with default language</span>
+        <span class="n">_current_request_language</span> <span class="o">=</span> <span class="s1">&#39;en&#39;</span>
+        <span class="n">request</span><span class="o">.</span><span class="n">state</span><span class="o">.</span><span class="n">language</span> <span class="o">=</span> <span class="s1">&#39;en&#39;</span>
+        <span class="k">return</span> <span class="k">await</span> <span class="n">call_next</span><span class="p">(</span><span class="n">request</span><span class="p">)</span>
+    <span class="k">finally</span><span class="p">:</span>
+        <span class="c1"># Clean up the global variable after the request</span>
+        <span class="n">_current_request_language</span> <span class="o">=</span> <span class="kc">None</span></div>
+</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>