How to Create a Python Package

  • google plus

In Brief...

Python packages are very easy to create, but not so easy to design. A Python package is just a group of files (and possibly subfolders) stored in a directory that includes a file named


To create a package in Python:

  1. Create a new folder.
  2. Add a file to the folder. It does not need to contain any code. For example, the file within Lib/idlelib (the package for the IDLE editor) looks like this:
    # Dummy file to make this a package.
  3. You can include code in the file that will initialize the package.
  4. You can also (but do not have to) set a global __all__ variable, which should contain a list of files to be imported when a file imports your package using
    from package_name import *
    If you do not set the __all__ variable, then that form of import will not be allowed, which may be just fine.

As you see, the steps involved in creating modules and packages for import is relatively straightforward. However, designing useful and easy-to-use modules and packages takes a lot of planning and thought.

Author: Nat Dunn

Nat Dunn founded Webucator in 2003 to combine his passion for web development with his business expertise and to help companies benefit from both.