parthtamu/rag-code-assistant
0
1<!DOCTYPE html>2 3<html lang="en" data-content_root="../">4 <head>5 <meta charset="utf-8" />6 <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />7<meta property="og:title" content="Internationalization" />8<meta property="og:type" content="website" />9<meta property="og:url" content="https://docs.python.org/3/library/i18n.html" />10<meta property="og:site_name" content="Python documentation" />11<meta property="og:description" content="The modules described in this chapter help you write software that is independent of language and locale by providing mechanisms for selecting a language to be used in program messages or by tailor..." />12<meta property="og:image:width" content="1146" />13<meta property="og:image:height" content="600" />14<meta property="og:image" content="https://docs.python.org/3.15/_images/social_previews/summary_library_i18n_3d6d1fc0.png" />15<meta property="og:image:alt" content="The modules described in this chapter help you write software that is independent of language and locale by providing mechanisms for selecting a language to be used in program messages or by tailor..." />16<meta name="description" content="The modules described in this chapter help you write software that is independent of language and locale by providing mechanisms for selecting a language to be used in program messages or by tailor..." />17<meta name="twitter:card" content="summary_large_image" />18<meta name="theme-color" content="#3776ab">19 20 <title>Internationalization — Python 3.15.0a6 documentation</title><meta name="viewport" content="width=device-width, initial-scale=1.0">21 22 <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=b86133f3" />23 <link rel="stylesheet" type="text/css" href="../_static/classic.css?v=234b1a7c" />24 <link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?v=89a2f22a" />25 <link rel="stylesheet" type="text/css" href="../_static/profiling-sampling-visualization.css?v=0c2600ae" />26 <link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="../_static/pygments_dark.css?v=5349f25f" />27 28 <script src="../_static/documentation_options.js?v=6b7c9ff5"></script>29 <script src="../_static/doctools.js?v=9bcbadda"></script>30 <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>31 <script src="../_static/profiling-sampling-visualization.js?v=9811ed04"></script>32 33 <script src="../_static/sidebar.js"></script>34 35 <link rel="search" type="application/opensearchdescription+xml"36 title="Search within Python 3.15.0a6 documentation"37 href="../_static/opensearch.xml"/>38 <link rel="author" title="About these documents" href="../about.html" />39 <link rel="index" title="Index" href="../genindex.html" />40 <link rel="search" title="Search" href="../search.html" />41 <link rel="copyright" title="Copyright" href="../copyright.html" />42 <link rel="next" title="gettext — Multilingual internationalization services" href="gettext.html" />43 <link rel="prev" title="colorsys — Conversions between color systems" href="colorsys.html" />44 45 46 <script defer file-types="bz2,epub,zip" data-domain="docs.python.org" src="https://analytics.python.org/js/script.file-downloads.outbound-links.js"></script>47 48 <link rel="canonical" href="https://docs.python.org/3/library/i18n.html">49 50 51 52 53 <style>54 @media only screen {55 table.full-width-table {56 width: 100%;57 }58 }59 </style>60<link rel="stylesheet" href="../_static/pydoctheme_dark.css" media="(prefers-color-scheme: dark)" id="pydoctheme_dark_css">61 <link rel="shortcut icon" type="image/png" href="../_static/py.svg">62 <script type="text/javascript" src="../_static/copybutton.js"></script>63 <script type="text/javascript" src="../_static/menu.js"></script>64 <script type="text/javascript" src="../_static/search-focus.js"></script>65 <script type="text/javascript" src="../_static/themetoggle.js"></script> 66 <script type="text/javascript" src="../_static/rtd_switcher.js"></script>67 <meta name="readthedocs-addons-api-version" content="1">68 69 </head>70<body>71<div class="mobile-nav">72 <input type="checkbox" id="menuToggler" class="toggler__input" aria-controls="navigation"73 aria-pressed="false" aria-expanded="false" role="button" aria-label="Menu">74 <nav class="nav-content" role="navigation">75 <label for="menuToggler" class="toggler__label">76 <span></span>77 </label>78 <span class="nav-items-wrapper">79 <a href="https://www.python.org/" class="nav-logo">80 <img src="../_static/py.svg" alt="Python logo">81 </a>82 <span class="version_switcher_placeholder"></span>83 <form role="search" class="search" action="../search.html" method="get">84 <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" class="search-icon">85 <path fill-rule="nonzero" fill="currentColor" d="M15.5 14h-.79l-.28-.27a6.5 6.5 0 001.48-5.34c-.47-2.78-2.79-5-5.59-5.34a6.505 6.505 0 00-7.27 7.27c.34 2.8 2.56 5.12 5.34 5.59a6.5 6.5 0 005.34-1.48l.27.28v.79l4.25 4.25c.41.41 1.08.41 1.49 0 .41-.41.41-1.08 0-1.49L15.5 14zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z"></path>86 </svg>87 <input placeholder="Quick search" aria-label="Quick search" type="search" name="q">88 <input type="submit" value="Go">89 </form>90 </span>91 </nav>92 <div class="menu-wrapper">93 <nav class="menu" role="navigation" aria-label="main navigation">94 <div class="language_switcher_placeholder"></div>95 96<label class="theme-selector-label">97 Theme98 <select class="theme-selector" oninput="activateTheme(this.value)">99 <option value="auto" selected>Auto</option>100 <option value="light">Light</option>101 <option value="dark">Dark</option>102 </select>103</label>104 <div>105 <h4>Previous topic</h4>106 <p class="topless"><a href="colorsys.html"107 title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">colorsys</span></code> — Conversions between color systems</a></p>108 </div>109 <div>110 <h4>Next topic</h4>111 <p class="topless"><a href="gettext.html"112 title="next chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">gettext</span></code> — Multilingual internationalization services</a></p>113 </div>114 <script>115 document.addEventListener('DOMContentLoaded', () => {116 const title = document.querySelector('meta[property="og:title"]').content;117 const elements = document.querySelectorAll('.improvepage');118 const pageurl = window.location.href.split('?')[0];119 elements.forEach(element => {120 const url = new URL(element.href.split('?')[0].replace("-nojs", ""));121 url.searchParams.set('pagetitle', title);122 url.searchParams.set('pageurl', pageurl);123 url.searchParams.set('pagesource', "library/i18n.rst");124 element.href = url.toString();125 });126 });127 </script>128 <div role="note" aria-label="source link">129 <h3>This page</h3>130 <ul class="this-page-menu">131 <li><a href="../bugs.html">Report a bug</a></li>132 <li><a class="improvepage" href="../improve-page-nojs.html">Improve this page</a></li>133 <li>134 <a href="https://github.com/python/cpython/blob/main/Doc/library/i18n.rst?plain=1"135 rel="nofollow">Show source136 </a>137 </li>138 139 </ul>140 </div>141 </nav>142 </div>143</div>144 145 146 <div class="related" role="navigation" aria-label="Related">147 <h3>Navigation</h3>148 <ul>149 <li class="right" style="margin-right: 10px">150 <a href="../genindex.html" title="General Index"151 accesskey="I">index</a></li>152 <li class="right" >153 <a href="../py-modindex.html" title="Python Module Index"154 >modules</a> |</li>155 <li class="right" >156 <a href="gettext.html" title="gettext — Multilingual internationalization services"157 accesskey="N">next</a> |</li>158 <li class="right" >159 <a href="colorsys.html" title="colorsys — Conversions between color systems"160 accesskey="P">previous</a> |</li>161 162 <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"></li>163 <li><a href="https://www.python.org/">Python</a> »</li>164 <li class="switchers">165 <div class="language_switcher_placeholder"></div>166 <div class="version_switcher_placeholder"></div>167 </li>168 <li>169 170 </li>171 <li id="cpython-language-and-version">172 <a href="../index.html">3.15.0a6 Documentation</a> »173 </li>174 175 <li class="nav-item nav-item-1"><a href="index.html" accesskey="U">The Python Standard Library</a> »</li>176 <li class="nav-item nav-item-this"><a href="">Internationalization</a></li>177 <li class="right">178 179 180 <div class="inline-search" role="search">181 <form class="inline-search" action="../search.html" method="get">182 <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box">183 <input type="submit" value="Go">184 </form>185 </div>186 |187 </li>188 <li class="right">189<label class="theme-selector-label">190 Theme191 <select class="theme-selector" oninput="activateTheme(this.value)">192 <option value="auto" selected>Auto</option>193 <option value="light">Light</option>194 <option value="dark">Dark</option>195 </select>196</label> |</li>197 198 </ul>199 </div> 200 201 <div class="document">202 <div class="documentwrapper">203 <div class="bodywrapper">204 <div class="body" role="main">205 206 <section id="internationalization">207<span id="i18n"></span><h1>Internationalization<a class="headerlink" href="#internationalization" title="Link to this heading">¶</a></h1>208<p>The modules described in this chapter help you write software that is209independent of language and locale by providing mechanisms for selecting a210language to be used in program messages or by tailoring output to match local211conventions.</p>212<p>The list of modules described in this chapter is:</p>213<div class="toctree-wrapper compound">214<ul>215<li class="toctree-l1"><a class="reference internal" href="gettext.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">gettext</span></code> — Multilingual internationalization services</a><ul>216<li class="toctree-l2"><a class="reference internal" href="gettext.html#gnu-gettext-api">GNU <strong class="program">gettext</strong> API</a></li>217<li class="toctree-l2"><a class="reference internal" href="gettext.html#class-based-api">Class-based API</a><ul>218<li class="toctree-l3"><a class="reference internal" href="gettext.html#the-nulltranslations-class">The <code class="xref py py-class docutils literal notranslate"><span class="pre">NullTranslations</span></code> class</a></li>219<li class="toctree-l3"><a class="reference internal" href="gettext.html#the-gnutranslations-class">The <code class="xref py py-class docutils literal notranslate"><span class="pre">GNUTranslations</span></code> class</a></li>220<li class="toctree-l3"><a class="reference internal" href="gettext.html#solaris-message-catalog-support">Solaris message catalog support</a></li>221<li class="toctree-l3"><a class="reference internal" href="gettext.html#the-catalog-constructor">The Catalog constructor</a></li>222</ul>223</li>224<li class="toctree-l2"><a class="reference internal" href="gettext.html#internationalizing-your-programs-and-modules">Internationalizing your programs and modules</a><ul>225<li class="toctree-l3"><a class="reference internal" href="gettext.html#localizing-your-module">Localizing your module</a></li>226<li class="toctree-l3"><a class="reference internal" href="gettext.html#localizing-your-application">Localizing your application</a></li>227<li class="toctree-l3"><a class="reference internal" href="gettext.html#changing-languages-on-the-fly">Changing languages on the fly</a></li>228<li class="toctree-l3"><a class="reference internal" href="gettext.html#deferred-translations">Deferred translations</a></li>229</ul>230</li>231<li class="toctree-l2"><a class="reference internal" href="gettext.html#acknowledgements">Acknowledgements</a></li>232</ul>233</li>234<li class="toctree-l1"><a class="reference internal" href="locale.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">locale</span></code> — Internationalization services</a><ul>235<li class="toctree-l2"><a class="reference internal" href="locale.html#background-details-hints-tips-and-caveats">Background, details, hints, tips and caveats</a></li>236<li class="toctree-l2"><a class="reference internal" href="locale.html#locale-names">Locale names</a></li>237<li class="toctree-l2"><a class="reference internal" href="locale.html#for-extension-writers-and-programs-that-embed-python">For extension writers and programs that embed Python</a></li>238<li class="toctree-l2"><a class="reference internal" href="locale.html#access-to-message-catalogs">Access to message catalogs</a></li>239</ul>240</li>241</ul>242</div>243</section>244 245 246 <div class="clearer"></div>247 </div>248 </div>249 </div>250 <div class="sphinxsidebar" role="navigation" aria-label="Main">251 <div class="sphinxsidebarwrapper">252 <div>253 <h4>Previous topic</h4>254 <p class="topless"><a href="colorsys.html"255 title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">colorsys</span></code> — Conversions between color systems</a></p>256 </div>257 <div>258 <h4>Next topic</h4>259 <p class="topless"><a href="gettext.html"260 title="next chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">gettext</span></code> — Multilingual internationalization services</a></p>261 </div>262 <script>263 document.addEventListener('DOMContentLoaded', () => {264 const title = document.querySelector('meta[property="og:title"]').content;265 const elements = document.querySelectorAll('.improvepage');266 const pageurl = window.location.href.split('?')[0];267 elements.forEach(element => {268 const url = new URL(element.href.split('?')[0].replace("-nojs", ""));269 url.searchParams.set('pagetitle', title);270 url.searchParams.set('pageurl', pageurl);271 url.searchParams.set('pagesource', "library/i18n.rst");272 element.href = url.toString();273 });274 });275 </script>276 <div role="note" aria-label="source link">277 <h3>This page</h3>278 <ul class="this-page-menu">279 <li><a href="../bugs.html">Report a bug</a></li>280 <li><a class="improvepage" href="../improve-page-nojs.html">Improve this page</a></li>281 <li>282 <a href="https://github.com/python/cpython/blob/main/Doc/library/i18n.rst?plain=1"283 rel="nofollow">Show source284 </a>285 </li>286 287 </ul>288 </div>289 </div>290<div id="sidebarbutton" title="Collapse sidebar">291<span>«</span>292</div>293 294 </div>295 <div class="clearer"></div>296 </div> 297 <div class="related" role="navigation" aria-label="Related">298 <h3>Navigation</h3>299 <ul>300 <li class="right" style="margin-right: 10px">301 <a href="../genindex.html" title="General Index"302 >index</a></li>303 <li class="right" >304 <a href="../py-modindex.html" title="Python Module Index"305 >modules</a> |</li>306 <li class="right" >307 <a href="gettext.html" title="gettext — Multilingual internationalization services"308 >next</a> |</li>309 <li class="right" >310 <a href="colorsys.html" title="colorsys — Conversions between color systems"311 >previous</a> |</li>312 313 <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"></li>314 <li><a href="https://www.python.org/">Python</a> »</li>315 <li class="switchers">316 <div class="language_switcher_placeholder"></div>317 <div class="version_switcher_placeholder"></div>318 </li>319 <li>320 321 </li>322 <li id="cpython-language-and-version">323 <a href="../index.html">3.15.0a6 Documentation</a> »324 </li>325 326 <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> »</li>327 <li class="nav-item nav-item-this"><a href="">Internationalization</a></li>328 <li class="right">329 330 331 <div class="inline-search" role="search">332 <form class="inline-search" action="../search.html" method="get">333 <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box">334 <input type="submit" value="Go">335 </form>336 </div>337 |338 </li>339 <li class="right">340<label class="theme-selector-label">341 Theme342 <select class="theme-selector" oninput="activateTheme(this.value)">343 <option value="auto" selected>Auto</option>344 <option value="light">Light</option>345 <option value="dark">Dark</option>346 </select>347</label> |</li>348 349 </ul>350 </div> 351 <div class="footer">352 © <a href="../copyright.html">Copyright</a> 2001 Python Software Foundation.353 <br>354 This page is licensed under the Python Software Foundation License Version 2.355 <br>356 Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.357 <br>358 359 See <a href="/license.html">History and License</a> for more information.<br>360 361 362 <br>363 364 The Python Software Foundation is a non-profit corporation.365<a href="https://www.python.org/psf/donations/">Please donate.</a>366<br>367 <br>368 Last updated on Mar 10, 2026 (08:58 UTC).369 370 <a href="/bugs.html">Found a bug</a>?371 372 <br>373 374 Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.375 </div>376 377 </body>378</html>