| Brett Cannon | 93881c6 | 2009-01-26 01:16:50 +0000 | [diff] [blame] | 1 | :mod:`importlib` -- Convenience wrappers for :func:`__import__` |
| 2 | =============================================================== |
| 3 | |
| 4 | .. module:: importlib |
| 5 | :synopsis: Convenience wrappers for __import__ |
| 6 | |
| 7 | .. moduleauthor:: Brett Cannon <brett@python.org> |
| 8 | .. sectionauthor:: Brett Cannon <brett@python.org> |
| 9 | |
| 10 | .. versionadded:: 2.7 |
| 11 | |
| 12 | This module is a minor subset of what is available in the more full-featured |
| 13 | package of the same name from Python 3.1 that provides a complete |
| 14 | implementation of :keyword:`import`. What is here has been provided to |
| 15 | help ease in transitioning from 2.7 to 3.1. |
| 16 | |
| 17 | |
| 18 | .. function:: import_module(name, package=None) |
| 19 | |
| 20 | Import a module. The *name* argument specifies what module to |
| 21 | import in absolute or relative terms |
| 22 | (e.g. either ``pkg.mod`` or ``..mod``). If the name is |
| 23 | specified in relative terms, then the *package* argument must be |
| 24 | specified to the package which is to act as the anchor for resolving the |
| 25 | package name (e.g. ``import_module('..mod', 'pkg.subpkg')`` will import |
| Georg Brandl | 0930228 | 2010-10-06 09:32:48 +0000 | [diff] [blame] | 26 | ``pkg.mod``). The specified module will be inserted into |
| Brett Cannon | 93881c6 | 2009-01-26 01:16:50 +0000 | [diff] [blame] | 27 | :data:`sys.modules` and returned. |