Home Original page

importlib | Python Standard Library – Real Python

The importlib module provides a framework for the import statement, allowing for the importing of modules in Python. It also offers a programmatic way to interact with the import system, enabling dynamic imports and manipulation of the import process.

Here’s a quick example:

>>> import importlib
>>> math_module = importlib.import_module("math")
>>> math_module.sqrt(16)
4.0

Key Features

  • Imports modules programmatically
  • Reloads modules to reflect code changes without restarting the interpreter
  • Accesses and manipulates the underlying import system
  • Customizes module import behavior

Frequently Used Classes and Functions

Examples

Programmatically importing a module:

>>> import importlib
>>> random_module = importlib.import_module("random")
>>> random_module.randint(1, 10)

Reloading a custom module after making changes:

>>> import custom_module
>>> ## Make changes to custom_module...
>>> importlib.reload(custom_module)

Finding a module’s specification:

>>> importlib.util.find_spec("collections")
ModuleSpec(name='collections', ...)

Common Use Cases

  • Dynamically importing modules at runtime
  • Reloading modules to reflect changes without restarting the Python interpreter
  • Customizing or extending the import mechanism for special use cases
  • Accessing module specifications for introspection purposes

Real-World Example

Suppose you want to dynamically import and use a module based on user input. You can do this using importlib:

>>> import importlib
>>> module_name = input("Enter the module to import: ")
Enter the module to import: math

>>> module = importlib.import_module(module_name)
>>> module.sqrt(16)
4.0

In this example, the importlib module allows for dynamic importation of a module specified by the user, enabling flexible and customizable module usage within the application.

For additional information on related topics, take a look at the following resources: