`importlib`

The importlib package provides the implementation of the import statement in pure Python, and exposes the components of the import system for importing modules programmatically or building custom importers. That access also supports dynamic imports and manipulation of the import process at runtime.

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
Reads distribution metadata and package data files through importlib.metadata and importlib.resources

Frequently Used Classes and Functions

Object	Type	Description
`importlib.import_module()`	Function	Imports a module programmatically using its name
`importlib.reload()`	Function	Reloads a previously imported module
`importlib.util.find_spec()`	Function	Finds the module specification for a given module name
`importlib.metadata.version()`	Function	Returns the installed version of a distribution package
`importlib.resources.files()`	Function	Returns a traversable object for a package’s non-code resources

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:

>>> import importlib.util

>>> 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.

Tutorial

Python import: Advanced Techniques and Tips

The Python import system is as powerful as it is useful. In this in-depth tutorial, you'll learn how to harness this power to improve the structure and maintainability of your code.

intermediate python stdlib

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