Publishing a package on PyPi

First, create a ~/.pypirc like this. You don't need to (and shouldn't!) put your cleartext password in here, you will get a prompt when you actually register.

[distutils]
index-servers =
  pypi
  pypitest

[pypi]
repository=https://pypi.python.org/pypi
username=your_username

[pypitest]
repository=https://testpypi.python.org/pypi
username=your_username

Write your setup.py:

setup(
    name="mypackage",
    version="3.1.0",
    description="My description",
    license="Apache License, Version 2.0",
    url="https://github.com/myhomepage"

Make sure your version number and other info in your setup.py is correct and then test your package on the the test server by registering:

python setup.py register -r pypitest

Then build and upload your actual file content using twine. You can also use setup.py to upload, but this way you get to inspect the build tarball before it gets uploaded:

python setup.py sdist
twine upload -r pypitest dist/*

Check that it looks OK on the test site. And that you can install it:

pip install -i https://testpypi.python.org/pypi mypackage

Then register and upload it on the production pypi server:

python setup.py register -r pypi
twine upload -r pypi dist/*