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="Importing Modules" />8<meta property="og:type" content="website" />9<meta property="og:url" content="https://docs.python.org/3/library/modules.html" />10<meta property="og:site_name" content="Python documentation" />11<meta property="og:description" content="The modules described in this chapter provide new ways to import other Python modules and hooks for customizing the import process. The full list of modules described in this chapter is: zipimport ..." />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_modules_020803c3.png" />15<meta property="og:image:alt" content="The modules described in this chapter provide new ways to import other Python modules and hooks for customizing the import process. The full list of modules described in this chapter is: zipimport ..." />16<meta name="description" content="The modules described in this chapter provide new ways to import other Python modules and hooks for customizing the import process. The full list of modules described in this chapter is: zipimport ..." />17<meta name="twitter:card" content="summary_large_image" />18<meta name="theme-color" content="#3776ab">19 20 <title>Importing Modules — 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="zipimport — Import modules from Zip archives" href="zipimport.html" />43 <link rel="prev" title="codeop — Compile Python code" href="codeop.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/modules.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="codeop.html"107 title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">codeop</span></code> — Compile Python code</a></p>108 </div>109 <div>110 <h4>Next topic</h4>111 <p class="topless"><a href="zipimport.html"112 title="next chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">zipimport</span></code> — Import modules from Zip archives</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/modules.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/modules.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="zipimport.html" title="zipimport — Import modules from Zip archives"157 accesskey="N">next</a> |</li>158 <li class="right" >159 <a href="codeop.html" title="codeop — Compile Python code"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="">Importing Modules</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="importing-modules">207<span id="modules"></span><h1>Importing Modules<a class="headerlink" href="#importing-modules" title="Link to this heading">¶</a></h1>208<p>The modules described in this chapter provide new ways to import other Python209modules and hooks for customizing the import process.</p>210<p>The full list of modules described in this chapter is:</p>211<div class="toctree-wrapper compound">212<ul>213<li class="toctree-l1"><a class="reference internal" href="zipimport.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">zipimport</span></code> — Import modules from Zip archives</a><ul>214<li class="toctree-l2"><a class="reference internal" href="zipimport.html#zipimporter-objects">zipimporter Objects</a></li>215<li class="toctree-l2"><a class="reference internal" href="zipimport.html#examples">Examples</a></li>216</ul>217</li>218<li class="toctree-l1"><a class="reference internal" href="pkgutil.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">pkgutil</span></code> — Package extension utility</a></li>219<li class="toctree-l1"><a class="reference internal" href="modulefinder.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">modulefinder</span></code> — Find modules used by a script</a><ul>220<li class="toctree-l2"><a class="reference internal" href="modulefinder.html#example-usage-of-modulefinder">Example usage of <code class="xref py py-class docutils literal notranslate"><span class="pre">ModuleFinder</span></code></a></li>221</ul>222</li>223<li class="toctree-l1"><a class="reference internal" href="runpy.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">runpy</span></code> — Locating and executing Python modules</a></li>224<li class="toctree-l1"><a class="reference internal" href="importlib.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">importlib</span></code> — The implementation of <code class="xref std std-keyword docutils literal notranslate"><span class="pre">import</span></code></a><ul>225<li class="toctree-l2"><a class="reference internal" href="importlib.html#introduction">Introduction</a></li>226<li class="toctree-l2"><a class="reference internal" href="importlib.html#functions">Functions</a></li>227<li class="toctree-l2"><a class="reference internal" href="importlib.html#module-importlib.abc"><code class="xref py py-mod docutils literal notranslate"><span class="pre">importlib.abc</span></code> – Abstract base classes related to import</a></li>228<li class="toctree-l2"><a class="reference internal" href="importlib.html#module-importlib.machinery"><code class="xref py py-mod docutils literal notranslate"><span class="pre">importlib.machinery</span></code> – Importers and path hooks</a></li>229<li class="toctree-l2"><a class="reference internal" href="importlib.html#module-importlib.util"><code class="xref py py-mod docutils literal notranslate"><span class="pre">importlib.util</span></code> – Utility code for importers</a></li>230<li class="toctree-l2"><a class="reference internal" href="importlib.html#examples">Examples</a><ul>231<li class="toctree-l3"><a class="reference internal" href="importlib.html#importing-programmatically">Importing programmatically</a></li>232<li class="toctree-l3"><a class="reference internal" href="importlib.html#checking-if-a-module-can-be-imported">Checking if a module can be imported</a></li>233<li class="toctree-l3"><a class="reference internal" href="importlib.html#importing-a-source-file-directly">Importing a source file directly</a></li>234<li class="toctree-l3"><a class="reference internal" href="importlib.html#implementing-lazy-imports">Implementing lazy imports</a></li>235<li class="toctree-l3"><a class="reference internal" href="importlib.html#setting-up-an-importer">Setting up an importer</a></li>236<li class="toctree-l3"><a class="reference internal" href="importlib.html#approximating-importlib-import-module">Approximating <code class="xref py py-func docutils literal notranslate"><span class="pre">importlib.import_module()</span></code></a></li>237</ul>238</li>239</ul>240</li>241<li class="toctree-l1"><a class="reference internal" href="importlib.resources.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">importlib.resources</span></code> – Package resource reading, opening and access</a><ul>242<li class="toctree-l2"><a class="reference internal" href="importlib.resources.html#functional-api">Functional API</a></li>243</ul>244</li>245<li class="toctree-l1"><a class="reference internal" href="importlib.resources.abc.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">importlib.resources.abc</span></code> – Abstract base classes for resources</a></li>246<li class="toctree-l1"><a class="reference internal" href="importlib.metadata.html"><code class="xref py py-mod docutils literal notranslate"><span class="pre">importlib.metadata</span></code> – Accessing package metadata</a><ul>247<li class="toctree-l2"><a class="reference internal" href="importlib.metadata.html#overview">Overview</a></li>248<li class="toctree-l2"><a class="reference internal" href="importlib.metadata.html#functional-api">Functional API</a><ul>249<li class="toctree-l3"><a class="reference internal" href="importlib.metadata.html#entry-points">Entry points</a></li>250<li class="toctree-l3"><a class="reference internal" href="importlib.metadata.html#distribution-metadata">Distribution metadata</a></li>251<li class="toctree-l3"><a class="reference internal" href="importlib.metadata.html#distribution-versions">Distribution versions</a></li>252<li class="toctree-l3"><a class="reference internal" href="importlib.metadata.html#distribution-files">Distribution files</a></li>253<li class="toctree-l3"><a class="reference internal" href="importlib.metadata.html#distribution-requirements">Distribution requirements</a></li>254<li class="toctree-l3"><a class="reference internal" href="importlib.metadata.html#mapping-import-to-distribution-packages">Mapping import to distribution packages</a></li>255</ul>256</li>257<li class="toctree-l2"><a class="reference internal" href="importlib.metadata.html#distributions">Distributions</a></li>258<li class="toctree-l2"><a class="reference internal" href="importlib.metadata.html#distribution-discovery">Distribution Discovery</a></li>259<li class="toctree-l2"><a class="reference internal" href="importlib.metadata.html#implementing-custom-providers">Implementing Custom Providers</a><ul>260<li class="toctree-l3"><a class="reference internal" href="importlib.metadata.html#example">Example</a></li>261</ul>262</li>263</ul>264</li>265<li class="toctree-l1"><a class="reference internal" href="sys_path_init.html">The initialization of the <code class="xref py py-data docutils literal notranslate"><span class="pre">sys.path</span></code> module search path</a><ul>266<li class="toctree-l2"><a class="reference internal" href="sys_path_init.html#virtual-environments">Virtual Environments</a></li>267<li class="toctree-l2"><a class="reference internal" href="sys_path_init.html#pth-files">_pth files</a></li>268<li class="toctree-l2"><a class="reference internal" href="sys_path_init.html#embedded-python">Embedded Python</a></li>269</ul>270</li>271</ul>272</div>273</section>274 275 276 <div class="clearer"></div>277 </div>278 </div>279 </div>280 <div class="sphinxsidebar" role="navigation" aria-label="Main">281 <div class="sphinxsidebarwrapper">282 <div>283 <h4>Previous topic</h4>284 <p class="topless"><a href="codeop.html"285 title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">codeop</span></code> — Compile Python code</a></p>286 </div>287 <div>288 <h4>Next topic</h4>289 <p class="topless"><a href="zipimport.html"290 title="next chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">zipimport</span></code> — Import modules from Zip archives</a></p>291 </div>292 <script>293 document.addEventListener('DOMContentLoaded', () => {294 const title = document.querySelector('meta[property="og:title"]').content;295 const elements = document.querySelectorAll('.improvepage');296 const pageurl = window.location.href.split('?')[0];297 elements.forEach(element => {298 const url = new URL(element.href.split('?')[0].replace("-nojs", ""));299 url.searchParams.set('pagetitle', title);300 url.searchParams.set('pageurl', pageurl);301 url.searchParams.set('pagesource', "library/modules.rst");302 element.href = url.toString();303 });304 });305 </script>306 <div role="note" aria-label="source link">307 <h3>This page</h3>308 <ul class="this-page-menu">309 <li><a href="../bugs.html">Report a bug</a></li>310 <li><a class="improvepage" href="../improve-page-nojs.html">Improve this page</a></li>311 <li>312 <a href="https://github.com/python/cpython/blob/main/Doc/library/modules.rst?plain=1"313 rel="nofollow">Show source314 </a>315 </li>316 317 </ul>318 </div>319 </div>320<div id="sidebarbutton" title="Collapse sidebar">321<span>«</span>322</div>323 324 </div>325 <div class="clearer"></div>326 </div> 327 <div class="related" role="navigation" aria-label="Related">328 <h3>Navigation</h3>329 <ul>330 <li class="right" style="margin-right: 10px">331 <a href="../genindex.html" title="General Index"332 >index</a></li>333 <li class="right" >334 <a href="../py-modindex.html" title="Python Module Index"335 >modules</a> |</li>336 <li class="right" >337 <a href="zipimport.html" title="zipimport — Import modules from Zip archives"338 >next</a> |</li>339 <li class="right" >340 <a href="codeop.html" title="codeop — Compile Python code"341 >previous</a> |</li>342 343 <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"></li>344 <li><a href="https://www.python.org/">Python</a> »</li>345 <li class="switchers">346 <div class="language_switcher_placeholder"></div>347 <div class="version_switcher_placeholder"></div>348 </li>349 <li>350 351 </li>352 <li id="cpython-language-and-version">353 <a href="../index.html">3.15.0a6 Documentation</a> »354 </li>355 356 <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> »</li>357 <li class="nav-item nav-item-this"><a href="">Importing Modules</a></li>358 <li class="right">359 360 361 <div class="inline-search" role="search">362 <form class="inline-search" action="../search.html" method="get">363 <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box">364 <input type="submit" value="Go">365 </form>366 </div>367 |368 </li>369 <li class="right">370<label class="theme-selector-label">371 Theme372 <select class="theme-selector" oninput="activateTheme(this.value)">373 <option value="auto" selected>Auto</option>374 <option value="light">Light</option>375 <option value="dark">Dark</option>376 </select>377</label> |</li>378 379 </ul>380 </div> 381 <div class="footer">382 © <a href="../copyright.html">Copyright</a> 2001 Python Software Foundation.383 <br>384 This page is licensed under the Python Software Foundation License Version 2.385 <br>386 Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.387 <br>388 389 See <a href="/license.html">History and License</a> for more information.<br>390 391 392 <br>393 394 The Python Software Foundation is a non-profit corporation.395<a href="https://www.python.org/psf/donations/">Please donate.</a>396<br>397 <br>398 Last updated on Mar 10, 2026 (08:58 UTC).399 400 <a href="/bugs.html">Found a bug</a>?401 402 <br>403 404 Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 8.2.3.405 </div>406 407 </body>408</html>