As an Intermediate/Beginner Python developer you always wondered how to publish
your own python packages so you can share it with your friends and colleagues.
In this post I will be walk you through the process of publish your own packages
PyPi is Python Package Index. It's more like npm or homebrew where you can find different
packages such as Flask,Django,Tweepy and much more. Most of the packages are open sourced
and PyPi is itself open source and maintained by developers in there free time and that
makes PyPi great.
This is going to be a simple python package that will calculate square and cube of a number passed as a commandline arguement.
In order to get started we need.
- Python installed
pip install twinethis will allow us to connect to pypi and publish our package.
pip install docoptthis package will parse our arguements passed as commandline arguements.
Lets begin writing code.
"""calc Usage: calc.py square <num> calc.py cube <num> calc.py (-h | --help) Options: -h --help Show this screen. """ from docopt import docopt def square(num): print(num**2) def cube(num): print(num**3) if __name__ == '__main__': arguments = docopt(__doc__) if arguments['square']: square(int(arguments['<num>'])) elif arguments['cube']: cube(int(arguments['<num>']))
- so after writing our simple package we need to create a file named
setup.py. This file will allow us to install package and it is going to be used by PyPi.
Furthermore, We need to create a README file that will contain instructions regarding installion and usage of the package.
This is how our setup.py file is going to look like and this will contain details regarding our package.
import setuptools with open("README.md", "r") as fh: long_description = fh.read() setuptools.setup( name="Calculator", version="0.0.1", author="Your Name", author_email="Your Email", description="Description regarding the package", long_description=long_description, long_description_content_type="text/markdown", url="Project_url", packages=setuptools.find_packages(), classifiers=[ "Programming Language :: Python :: 3", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", ], )
- After creating a
setup.pynow we will run this command to generate our package
python3 setup.py sdist
- This is going to create a folder named
dist/which will contain our package and now we will upload our package using twine.
twine upload dist/ # This will prompt username and password for pypi
I hope you enjoyed this post if you think i missed any thing feel free to dm me on twitter
Feel to share it among your friends and colleagues.