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 (a] python.org> 8 .. sectionauthor:: Brett Cannon <brett (a] 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 26 ``pkg.mod``). The specified module will be inserted into 27 :data:`sys.modules` and returned. 28