import-ready

A simple importable Python package


Keywords
import, package, huntsville, havoc, testpypi, travisci, pytest, codecov, codacy
License
MIT
Install
pip install import-ready==0.12.0

Documentation

import-ready

image image image image image image

This repository demonstrates steps needed to publish an importable Python package first to TestPyPI, and second to PyPI. If this demonstration deviates from best practice in any way, please submit an issue on GitHub.

Inside import-ready is a package called huntsville_havoc that divulges a couple of bona fide secrets that most diehard SPHL Huntsville Havoc fans don't know.

Prepare the Package

  1. Prepare your environment before installing Python packages.
  2. Update version in setup.py per semantic versioning guidance.

Test in Development Environment

Run as follows from the top level directory in a clean venv with pip-tools installed:

Publish to TestPyPI

  1. Git commit, tag, & push all desired edits for release.
  2. Create a new release in GitHub to mirror your new version.
  3. Generate distribution archives for your package.
  4. Upload your package to TestPyPI.

Test the TestPyPI Published Package

Run as follows from the tests directory in another clean venv with pip-tools installed:

Publish to PyPI

After completing the above steps, upload your package to PyPI.

Test the real deal

Test by importing import-ready itself back from PyPI. Run same as for the TestPyPI case (except this time with pub-requirements.in/.txt) from the tests directory in yet another clean venv with pip-tools installed.

Thanks

License

MIT