How to Publish Python package at PyPi using Twine module?
Python is so flexible and easy to use because of its available packages that are hosted on pypi.org, Let’s see how to publish your own package on PyPi using Twine module.
- You must have account of pypi.org, if don’t create an account
- The twine library is created to simplify uploading packages in pypi. To install twine library.
pip install twine
- Get your package ready.
Steps to publish package:
Step 1: Prepare and organize the package
- Create a folder name must be same as package name. (Ensure that the name of your package does not pre-exist in PyPi)
- Inside this create another folder with same name or same package name, inside that put all the .py files with a single compulsorily __init__.py file and all folders/programs must be imported in __init__.py .
- Now outside of programs folder and inside the root folder, Setup.py file, README.md file and License.txt file must be created. Below is the flow diagram of the hierarchy:
For the sub-folder akshaypawar-tut:
Step 2: Creating README.md file
The .md files are mark down files just as markup languages, it has it’s own syntax,it is used as a User-Friendly Readme file which will be displayed on home page.
Step3: Creating License.txt file
Your package must have license, If you don’t have any concern to sharing it all over world you may use License.txt. If your package has policies you may use any online license maker website like https://choosealicense.com/ .
Step 4: Create Setup.py File
Your package must have a Setup.py file as it’s one of binding component of package, It describes dependencies of the package and author version, etc.
Below is the code for general Setup.py . One needs to use their own credentials.
Step 5: Final Stage
Here you have to create account on pypi.org also we will be using twine library. The whole package is uploaded in the form of .dist file.
To create .dist file use command:
# Windows python setup.py bdist_wheel
# Linux/Mac python3 setup.py bdist_wheel
You will observe this message on Powershell when the above commands are executed.
Now our binary .dist file is created, now we need to upload it using the below command:
twine upload dist/*
Enter the required credentials regarding pypi.org account and the package will be uploaded.
After successful upload you will get a link of your project and all the details
Click here to see the uploaded package discussed in the article.