When you have used Python a lot you'll notice that you will use tools such as
pip install package_name you are installing some python code in a way that can be imported in your project. This guide will show you how you can make your own package installable.
The code that is used in this article is hosted up on GitHub in the CustomProgrammingSolutions/setup.py-intro repository.
In this example we are turning a relatively simple file called
greeting.py into an installable package. This file is just the following:
def hello_world(): print("HELLO WORLD")
Which we want to then be able to use via an installed pacakge via
from hello_world.greeting import hello_world.
From the docs the way
pip install works is as follows:
- Identify the base requirements. The user supplied arguments are processed here.
- Resolve dependencies. What will be installed is determined here.
- Build wheels. All the dependencies that can be are built into wheels.
- Install the packages (and uninstall anything being upgraded/replaced).
When you issue a command such as
pip install path/to/package pip will go to that path and will resolve the dependencies found there. If the package dependencies are successfully installed
pip will then it will attempt to install your package into the site-pacakges directory.
How it installs this is determined by the contents of the
setup.py file you will need to specify a function called
setup that will define how your package is installed.
For tools such as pip to work you need to follow some filesystem conventions, specifically this is what the sample repository includes:
$ tree . . ├── hello_world │ ├── greeting.py │ └── __init__.py ├── README.MD └── setup.py
In this structure
setup.py must be found at the top level as pip will look here for how to install your package. It will then execute this
setup.py file to install your package.
The anatomy of setup.py
The setup.py file in this example includes the following:
from setuptools import setup setup(name='hello_world', version='0.0.1', description='Shows how to use setup.py', url='https://www.customprogrammingsolutions.com', author='Janis Lesinskis', license='GPLv3', packages=['hello_world'], classifiers = [ 'Development Status :: 4 - Beta', 'Intended Audience :: Developers', 'Programming Language :: Python', 'Programming Language :: Python :: 3.5', 'Programming Language :: Python :: 3.6', ], keywords='tutorial', include_package_data = True, )
The most important arguments to
setup are the following:
namewhich will be the directory your package is installed in.
versionof your package, semantic versioning is a good choice for this.
packageswhich specifies the directories that the installed packages reside in. in this case
hello_worldis the directory where our code resides in.