Understanding Python Modules and Packages

In Python, modules and packages are essential tools for organizing code. They allow splitting logic into separate files, improving readability, maintainability, and reusability. This article introduces the concepts, usage methods, and related tips.

1. Modules

1.1 What is a module?

A module is a file containing Python code with a .py extension. It can include functions, classes, variables, and other code elements.

1.2 Importing a module

To use code from a module, use the import statement.

import math  # import math module

print(math.pi)  # use pi constant from math module

1.3 Importing specific elements from a module

You can import specific elements using the from ... import ... statement.

from math import pi  # import pi constant from math module

print(pi)  # use pi directly

1.4 Giving a module an alias

You can give a module an alias with the as keyword for convenience.

import math as m  # alias math as m

print(m.pi)  # access pi via alias m

1.5 Module search path

The Python interpreter searches for modules in a specific order; the search path can be inspected via sys.path .

import sys

print(sys.path)  # print module search paths

2. Packages

2.1 What is a package?

A package is a directory containing multiple modules and must include an __init__.py file (which can be empty) to be recognized as a package.

2.2 Importing a module from a package

You can import a module from a package using the dot . notation.

import package.module  # import module from package

package.module.function()  # call function from module

2.3 Importing a specific module from a package

Use from ... import ... to import a specific module.

from package import module  # import module from package

module.function()  # call function from module

2.4 Relative imports

Within a package, you can use relative imports to import other modules.

from . import module  # import module from current package

from .. import module  # import module from parent package

3. Common Tips

Use if __name__ == "__main__": to place test code in a module, preventing execution on import.

Use dir() to list all names defined in a module or package.

Use help() to view help information for functions, classes, etc., in a module or package.

4. Summary

Modules and packages are key tools for organizing code in Python; mastering their usage enables writing clearer, more maintainable code. This article aims to help you better understand and use Python modules and packages.