PackageChecklist

Release checklist for diffpy.SomeThing package.

See the trunk directory https://github.com/diffpy/diffpy.srreal for reference examples (so far in progress)

Source Files

1. all Python sources start with a hash-bang line '#!/usr/bin/env python'
2. executable bit is set only for source files that are intended to be run as a script
3. No trailing spaces, no Windows CRLF line ends, no TAB characters at all.

README.txt

First line is the package full name with a few-word description. This is followed by a paragraph with more detailed description of package functionality and with a URL of the user manual at http://diffpy.github.io/diffpy.FixMe/

REQUIREMENTS section lists the dependencies needed to install the package, the sudo apt-get install command for Linux and port install command for MacPorts.

INSTALLATION section gives installation command-lines for python setup.py install and easy_install diffpy.FixMe. FIXME{If easy_install GitHubURL works, include it as well.}

CONTRIBUTION section should give the project GitHub URL, show how to install the package in a developer mode, encourage contributors to fork it and send us pull requests.

CONTACTS section gives package GitHub URL, the main project URL at www.diffpy.org and Simon as the main contact person.

AUTHORS.txt

The file lists package authors one per line ordered by their contributions. Simon is included in the list.

LICENSE.txt

Make sure it is up to date or open a ticket on the package GitHub repository to fix the license once its text is ready.

setup.py

1. File docstring gives full Python name of the package, brief description of its functionality, and lists executable scripts that get installed if any.
2. version is extracted from git data, python setup.py egg_info updates diffpy/FixMe/version.cfg and sets it to right values.
3. install_requires entry is up-to-date
4. dependency_links is set to ['http://www.diffpy.org/packages/']
5. author is set to the package main author. author_email is working.
6. maintainter and maintainer_email` are set if different from the author
7. license is set to "BSD, see LICENSE.txt"
8. keywords are set and meaningful
9. data_files include all files in .../tests/testdata/ directory, diffpy/FixMe/version.cfg, any other data files needed by the package
10. test_suite is diffpy.FixMe.tests.run, python setup.py test works
11. zip_safe is False
12. classifiers are up-to-date and include anything relevant from https://pypi.python.org/pypi?%3Aaction=list_classifiers

MANIFEST.in

1. includes all sources, package data files, txt files, version.cfg
2. excludes build, dist, doc directories, MANIFEST.in, any non-essential temporary or development related files.

Tests

1. check that a source bundle from python setup.py sdist --keep-temp contains correct files.
2. test installation from a source bundle to virtual Python environment works and passes all tests. Example:

   virtualenv --system-site-packages /tmp/tenv1
   source /tmp/tenv1/activate
   easy_install TheSourceTarBall
   
   # verify location and version of the installed package
   pywhichmodule -gv diffpy.FixMe
   
   # execute package unit tests
   python -m diffpy.FixMe.tests.run

3. Check that python setup.py install run from the git repository produces working installation (reuse the virtualenv and test commands from above)
4. Check that python test run in the git repo executes unit tests and they all pass.

Footnotes

• pywhichmodule script
• pypath script can be also useful