Python Modules: The Complete Guide

Python module refers to the file containing statements and definitions. Any file is a module file if that file contains the Python code and is saved as a .py extension.

Why use Python Modules?

Python modules are files containing the set of functions you want to include in your application. We will see how to create and import that module in Python. We use the modules to break down large codebase into small, manageable, organized files.

In addition to that, modules provide the reusability of code. 

We can define our most used functions in the module and import them instead of copying their definitions into different programs.

Code reusability is one of the great coding principles in any programming language.

Let’s create a module. Create a file called and add the following code.


def multiply(x, y):
    op = x * y
    return op

The above program returns the multiplication of two digits.

So, now is a module file. So, we can import that file into another file, use that multiply function, and get the result.

Create another file called and write the following code.


import mod

print(mod.multiply(21, 19))

So, we have created the in the same directory as, imported the inside the file, used the multiply function, passed the two parameters, and got the result.

See the output below.

Python Modules Tutorial Example

How to import modules in Python?

To import modules in Python use the import keyword. You can import the definitions inside the Python module to another Python module or Python file or the interactive interpreter in Python.

If we need to import our previously defined module, we type the following code in the file.

import mod

We can also import the direct multiply function from the mod module. See the following code.


from mod import multiply

print(multiply(21, 19))

It will also give us the same output.

Python has a ton of standard modules available.

You can check out the complete list of Python standard modules.

These files are in the Lib directory inside the location where you installed Python.

Standard modules can be imported the same way we import our user-defined modules. There is no difference.

Variables in Module

Python module can contain the functions, as already described, but variables of all types like lists, dictionaries, objects, etc.

Write the following code inside the file.


student = {
  'name': 'Krunal',
  'enno': 21,
  'college': 'vvp college'

Now, import the module inside the file.


from mod import student


See the output.

Variables in Module

Naming a Module in Python

You can name the module file but must have the file extension .py.

Import with renaming in Python

We can also give the alias to any Python module while importing that module. See the following example.


from mod import student as s


It will give you the same output as above. This is because we have renamed the module to and printed the variable from the file. So, that is how you can rename your module however you want.

Built-in modules in Python

Many built-in modules are available like math, random, datetime, etc.

Let’s import the math module and print the value of pi.


from math import pi as p


See the output.

Built-in modules in Python

We can also import the built-in platform module.


import platform

The output is Darwin, as I am using Macbook.

Using the dir() Function

There is a built-in function in Python to list all the function names or variable names in the module. That function name is dir(). See the following example of the dir() function in Python.


import math

m = dir(math)

The above code gives all the functions of the Math module.

See the output.

Using the dir() Function

That’s it for this tutorial.

Leave a Comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.