Software designed for simplifying PyPI Python package setups
Python 3 must be installed before pypimaker can be installed.
To install pypimaker, open a terminal window and run the following command:
pip install pypimaker
(Note that the pip3
command may be required instead of pip
for some Python installations.)
To generate the files needed for your PyPI package, run the following command:
pypimaker generate
This will launch a graphical user interface that looks like the following:
Inputting the information for your project will generate all of the files needed for uploading it to PyPI (LICENSE
, README.me
, requirements.txt
, and setup.py
). This can be re-run at any time to re-generate these files.
If you don't yet have an account on PyPI, register for one. Once you've set up your account and you're ready to upload your package to PyPI (e.g., after you have updated the generated template README.md
file to your liking), run the following command:
pypimaker upload
You will be asked to enter your PyPI username and password (which you've registered previously) in the terminal. Your project will then be uploaded to PyPI, and others can download it using the following command:
pip install <PROJECT_NAME>
(Here, <PROJECT_NAME> is the name you selected when running pypimaker generate
)
At any time, all of the files generated by PyPI Maker can be removed with the following command:
pypimaker reset
To make changes and update your project, simply re-run pypimaker upload
. Follow the steps in the terminal to incremement your version number and your update will be pushed to PyPI.
Note: the extraneous +[CATransaction synchronize]
output in the terminal window is a known bug in macOS that will not affect your project.
Brian Davis
- 1.0.5
- Bug fixes
- 1.0.0
- Initial Release
This project is licensed under the MIT License. See the LICENSE file for details.
Tests for PyPI Maker use Python's built-in unittest framework, and are stored in the tests
folder. To run tests, navigate to the top level of PyPI Maker's folder structure and run the following command:
python -m unittest
The same test framework can optionally be added to your own project: If there is not yet a folder named tests
in the top level of your project's directory structure, then a dialog window will pop up asking if you would like to include template unit tests in your project when running pypimaker generate
. Confirming this selection will create a tests
folder with individual unit tests inside, corresponding to each of the Python files in your project. Of course, until writing test cases within each of these test files, they won't actually test anything.
To report a bug, visit the issues page. New feature requests are also welcome!