Giters

dwkerwin / pypi-howto

How to publish Python packages on PyPI.

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

PyPI howto

Executive summary

  • You need to create ~/.pypirc and a setup.py for your project (examples below).
  • You need to (pip) install twine
  • Check yourself before you wreck yourself: try first on https://test.pypi.org

Example ~/.pypirc

[distutils]
index-servers=
    pypi
    pypitest

[pypi]
username = ...
password = ...

[pypitest]
repository = https://test.pypi.org/legacy/
username = ...
password = ...

Upload to https://test.pypi.org

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

Once you are done with this step test to pip install from https://test.pypi.org:

$ pip install --index-url https://test.pypi.org/simple/ your-package

Upload to https://pypi.org

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

Including other files

Python files not located in a submodule (i.e. a directory with an __init__.py) or other files (not a .py file) can be included via a MANIFEST.in file with one of two directives:

  • include - used for single files or globbing files from a directory with *
  • recursive-include - used for recursively adding files under a directory

After creating MANIFEST.in in your package directory add include_package_data=True to the setup object in setup.py (see below).

Example MANIFEST.in

include doc/source/*rst
recursive-include project_name/data *

Example setup.py

from setuptools import setup
import os
import sys

_here = os.path.abspath(os.path.dirname(__file__))

if sys.version_info[0] < 3:
    with open(os.path.join(_here, 'README.rst')) as f:
        long_description = f.read()
else:
    with open(os.path.join(_here, 'README.rst'), encoding='utf-8') as f:
        long_description = f.read()

version = {}
with open(os.path.join(_here, 'numerov', 'version.py')) as f:
    exec(f.read(), version)

setup(
    name='numerov',
    version=version['__version__'],
    description=('Compute vibrational levels, wavefunctions, and expectation values using the Numerov-Cooley algorithm.'),
    long_description=long_description,
    author='Radovan Bast',
    author_email='radovan.bast@uit.no',
    url='https://github.com/bast/numerov',
    license='MPL-2.0',
    packages=['numerov'],
    install_requires=[
        'click==6.7',
        'numpy==1.13.1',
        'pyyaml==3.12',
    ],
    scripts=['bin/cooley'],
    include_package_data=True,
    classifiers=[
        'Development Status :: 3 - Alpha',
        'Intended Audience :: Science/Research',
        'Programming Language :: Python :: 2.7',
        'Programming Language :: Python :: 3.6'],
    )

You can use the setuptools function find_packages() to automatically detect all subpackages and submodules, so long as they contain and __init__.py file.

from setuptools import setup, find_pacakges

setup(
    #...
    packages=find_packages(),
)

Tips

  • For projects that you wish to distribute via PyPI use README.rst instead of README.md since PyPI does not natively render README.md.

  • For rendering .md files, you can use pandoc.

  • For automating the creation of setup.py files, see the documentation for setup.cfg.

Credits

Thanks to Ryan for showing me the ropes.

References

About

How to publish Python packages on PyPI.