8. Difference Between Modules and Packages in Python -

Both modules and packages are used to organize and structure Python code, especially in large projects.
However, they differ in scope and organization level.

Feature	Module	Package
Definition	A single Python file that contains code (functions, variables, classes).	A collection (directory) of modules organized together.
File Type	A single `.py` file.	A directory containing an `__init__.py` file (and possibly multiple modules/sub-packages).
Purpose	To logically organize and reuse code.	To structure multiple modules into a hierarchy.
Import Syntax	`import module_name`	`import package_name.module_name`
Example	`math.py`, `os.py`, or a custom `utils.py` file.	A folder like `numpy`, `pandas`, or `my_app/`.
Contains	Code definitions, variables, and functions.	Multiple modules and possibly other packages.

🧩 Example 1: Module Example

# File: calculator.py (This is a module)
def add(a, b):
    return a + b

def subtract(a, b):
    return a - b

# File: calculator.py (This is a module)
def add(a, b):
    return a + b

def subtract(a, b):
    return a - b

Usage:

import calculator

print(calculator.add(5, 3))
print(calculator.subtract(10, 4))

import calculator

print(calculator.add(5, 3))
print(calculator.subtract(10, 4))

Output:

8
6

8
6

🧩 Example 2: Package Example

my_package/
│
├── __init__.py
├── math_operations.py
└── string_operations.py

my_package/
│
├── __init__.py
├── math_operations.py
└── string_operations.py

# math_operations.py
def square(num):
    return num * num

# string_operations.py
def greet(name):
    return f"Hello, {name}!"

# math_operations.py
def square(num):
    return num * num

# string_operations.py
def greet(name):
    return f"Hello, {name}!"

Usage:

from my_package import math_operations, string_operations

print(math_operations.square(5))
print(string_operations.greet("Dheeraj"))

from my_package import math_operations, string_operations

print(math_operations.square(5))
print(string_operations.greet("Dheeraj"))

Output:

25
Hello, Dheeraj!

25
Hello, Dheeraj!

🧩 Example 3: Nested Package Structure

project/
│
├── __init__.py
├── utils/
│   ├── __init__.py
│   ├── file_utils.py
│   └── math_utils.py

project/
│
├── __init__.py
├── utils/
│   ├── __init__.py
│   ├── file_utils.py
│   └── math_utils.py

Usage:

from project.utils.math_utils import add_numbers

from project.utils.math_utils import add_numbers

In Summary:

A module is a single file of Python code.
A package is a collection of modules organized in a folder (with an __init__.py file).
Modules help organize code logically, while packages help organize modules hierarchically.

In Summary:

Related posts: