Python - Packages

InPython, the module is a Python script with a.pyextension and contains objects such as classes,functions, etc.Packages in Pythonextend the concept of the modular approach further. The package is a folder containing one or more module files; additionally, a special file”init.py”file may be empty but may contain the package list.

Create a Python Package

Let us create aPython packagewith the namemypackage. Follow the steps given below −

• Create an outer folder to hold the contents of mypackage. Let its name bepackagedemo.
• Inside it, create another foldermypackage. This will be thePython packagewe are going to construct. Two Python modules areafunctions.py and mathfunctions.py will be created insidemypackage.
• Create an empty”.init.py”file insidemypackagefolder.
• Inside the outer folder, we shall later store a Python scriptexample.pyto test our package.

Thefile/folder structureshould be as shown below −

Using your favorite code editor, save the following twoPython modulesinmypackagefolder.

Example to Create a Python Package

# mathfunctions.py
def sum(x,y):
   val = x+y
   return val
   
def average(x,y):
   val = (x+y)/2
   return val

def power(x,y):
   val = x**y
   return val

Create another Python script −

# areafunctions.py
def rectangle(w,h):
   area = w*h
   return area
   
def circle(r):
   import math
   area = math.pi*math.pow(r,2)
   return area

Let us now test themyexamplepackage with the help of a Python script above this package folder. Refer to the folder structure above.

#example.py
from mypackage.areafunctions import rectangle
print ("Area :", rectangle(10,20))

from mypackage.mathsfunctions import average
print ("average:", average(10,20))

This program imports functions frommypackage. If the above script is executed, you should get followingoutput−

Area : 200
average: 15.0

Define Package List

You can put selected functions or any other resources from the package in the “init.py” file. Let us put the following code in it.

from .areafunctions import circle
from .mathsfunctions import sum, power

To import the available functions from this package, save the following script as testpackage.py, above the package folder as before.

Example to Define a Package List

#testpackage.py
from mypackage import power, circle

print ("Area of circle:", circle(5))
print ("10 raised to 2:", power(10,2))

It will produce the followingoutput−

Area of circle: 78.53981633974483
10 raised to 2: 100

Package Installation

Right now, we are able to access the package resources from a script just above the package folder. To be able to use the package anywhere in the file system, you need to install it using the PIP utility.

First of all, save the following script in the parent folder, at the level of package folder.

#setup.py
from setuptools import setup
setup(name='mypackage',
version='0.1',
description='Package setup script',
url='#',
author='anonymous',
author_email='test@gmail.com',
license='MIT',
packages=['mypackage'],
zip_safe=False)

Run the PIP utility from command prompt, while remaining in the parent folder.

C:\Users\user\packagedemo>pip3 install .
Processing c:\users\user\packagedemo
 Preparing metadata (setup.py) ... done
Installing collected packages: mypackage
 Running setup.py install for mypackage ... done
Successfully installed mypackage-0.1

You should now be able to import the contents of thepackagein any environment.

C:\Users>python
Python 3.11.2 (tags/v3.11.2:878ead1, Feb 7 2023, 16:38:35) [MSC v.1934 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> import mypackage
>>> mypackage.circle(5)
78.53981633974483