DEV Community

Cover image for What is if __name__ == "__main___", and how do I use it.
Waylon Walker
Waylon Walker

Posted on • Originally published at

What is if __name__ == "__main___", and how do I use it.

When a python module is called it is assigned the __name__ of __main__ otherwise if it's imported it will be assigned the __name__ of the module.

Concrete example

Let's create a module to play with __name__ a bit. We will call this module It is a module that we may want to run by itself or import and use in other modules.


if __name__ == "nodes": import sys import __main__

    print(f"you have imported me {__name__} from sys.modules['__main__'].__file__}")

if __name__ == "__main__":
   print("you are running me as main") 
Enter fullscreen mode Exit fullscreen mode

I have set this module up to execute one of two if statements based on whether the module itself is being run or if the module is being imported.

Note it is not common to have a if __name__ == "nodes": block, this is just for demnonstration purposes.

running python

Running a python script with the command python <> will execute your script top to bottom.

Enter fullscreen mode Exit fullscreen mode

This will print out you are running me as main

If you don't already have python installed try using miniconda or

running ./

You can also simply execute the script from bash if you first set the module to be executable.

chmod +x ./ 
Enter fullscreen mode Exit fullscreen mode

Note once you have set the file to be executable, it will remain executable chmod +x is only needed one time, even if you edit the file.

Let's create a second module and import the first module nodes and see what happens.

import nodes 
Enter fullscreen mode Exit fullscreen mode

Just like nodes, we can run pipeline either way if it's executable

# must run chmod +x first.
Enter fullscreen mode Exit fullscreen mode

Either way it will print out you have imported me nodes from ./


If we were to import nodes from the repl we would see an error in this case, due to the fact that there is no __main__ file since it's a repl session.

Use Cases

The main use case for if __name__ == "__main__": is flexibility. Simply importing a module should not execute any code, print anything to the screen, change your filesystem, or generally have any side effects in most cases. It is something that most python users would not expect. We can use this block to make it such that the module can be both imported and executed.


The rich library uses it to make examples of each module print to the screen if its executed. I personally think this is a fantastic idea.


In my world of data analysis, we often set up a script of functions that will behave as an ETL pipeline of sorts. Since we may want to reuse some of these functions in other scripts its common to hide the actual execution of these functions in an if __name__ == "__main__": block so that we don't start making changes to the data simply by importing the module.


Most cli applications will leverage if __name__ == "__main__": to run something when called as a script instead of being imported. This allows us to do things such as testing much easier.

Check out the example on the first page of the click framework's docs


if __name__ == "__main__": is not so cryptic or scary, it's just looking to see if this module was called as a script or imported from somewhere else, and executing some different behavior based on how it was called.

if __name__ == "__main__": 
   print("you are running me as main") 
Enter fullscreen mode Exit fullscreen mode

Related Links

Check Out These Related Posts

Top comments (2)

mccurcio profile image
Matt Curcio

Nice article, BUT what I really liked was installing miniconda by the command line. I will be using that next.

waylonwalker profile image
Waylon Walker • Edited

Thanks, for the feedback, glad you liked it. That is actually one of my best-performing articles.

Also posted on Dev.