Altcademy - a Forbes magazine logo Best Coding Bootcamp 2023

What is a module in Python

Understanding Modules in Python

When you start learning Python, or any programming language, you quickly realize that writing all your code in one giant file is like trying to build a house with all your materials mixed in one big pile. It's confusing, messy, and finding what you need is a nightmare. This is where the concept of 'modules' comes into play, and understanding them is like learning how to organize your construction materials into well-labeled boxes, making your coding life a whole lot easier.

What Exactly is a Module?

Imagine you're writing a story. Instead of putting everything into one long document, you decide to create separate chapters. Each chapter has a specific theme and content. In the world of Python, a module is like one of those chapters. It's a file containing Python definitions, functions, and statements that you can reuse in other Python scripts. This means you can write code once and use it in multiple programs, which is a huge time-saver.

Why Use Modules?

Modules help you to:

  • Organize your code: You can group related code into a module, making it easier to understand and use.
  • Reuse code: Once you've written and tested a module, you can reuse it in other programs.
  • Avoid conflicts: Modules can have their own private variables and functions, which are not accessible from other modules. This helps prevent parts of your program from interfering with each other.

How to Create a Module

Creating a module is as simple as saving some code into a file with a .py extension. For example, let's say you have a collection of functions that perform mathematical operations. You could put them into a file called


def add(a, b):
    return a + b

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

def multiply(a, b):
    return a * b

def divide(a, b):
    if b != 0:
        return a / b
        return "Error: Cannot divide by zero."

Now you have a module named math_tools that you can use in other Python scripts.

Importing Modules

To use the functions in your math_tools module, you need to 'import' it into your script. Think of this as telling your story's readers that they should refer to a specific chapter to understand the context.

Here's how you would import and use the math_tools module:


import math_tools

result = math_tools.add(1, 2)
print(result)  # Output: 3

When you run, it will output 3 because it uses the add function from the math_tools module.

Importing Specific Functions

What if you only need one function from a module? Importing the whole module might feel like carrying the entire toolbox when you just need a screwdriver. Fortunately, Python allows you to import specific functions.

from math_tools import add

result = add(3, 4)
print(result)  # Output: 7

Now you're only importing the add function and can use it directly without the math_tools. prefix.

Renaming Modules and Functions

Sometimes module or function names can be long or conflict with names in your current script. Python lets you rename them during import, like giving a nickname to a friend for convenience.

import math_tools as mt

result = mt.multiply(2, 5)
print(result)  # Output: 10

Here, math_tools is renamed to mt, making it quicker to type.

Built-in Modules

Python comes with a treasure trove of built-in modules that you can use without having to write any additional code. These are like the default chapters in your story that every reader has access to. One popular built-in module is random, which lets you generate random numbers.

import random

number = random.randint(1, 10)
print(number)  # Output: A random number between 1 and 10

Creating a Package

When your story gets really long, you start organizing chapters into parts or volumes. In Python, a package is like a volume, a directory that holds a bunch of related modules (chapters). To make a directory a package, you need to include a special file named

Let's say you have two modules: and You can organize them into a package like this:


Now you can import modules from my_package just like they were simple modules.

Conclusion: The Power of Modularity

As you venture further into the world of programming, the elegance of modularity will become ever clearer. Modules are like the individual gears in a watch, each one crafted to perform its role perfectly, and when combined, they create a system far greater than the sum of its parts. By mastering the use of modules, you'll be able to build more complex, efficient, and manageable Python programs. They allow you to stand on the shoulders of giants, incorporating powerful functionalities that others have developed, and focus on what makes your code unique. So, embrace the simplicity and power of Python modules, and watch as your code transforms from a tangled web of confusion into a well-oiled machine of clarity and precision.