Merge pull request #30 from navytux/r

Release gardening

- add `lint` target to tox as suggested by @bertjwregeer to verify that manifest is ok,
- add `RELEASING.txt` to document how to make a new release

/cc @jamadden, @azmeuk, @stevepiercy 
/reviewed-by @stevepiercy 
/reviewed-on https://github.com/Pylons/zodburi/pull/30

MANIFEST.in

@@ -3,6 +3,7 @@ prune docs/_build
 graft zodburi
 
 include README.rst
+include RELEASING.txt
 include CHANGES.rst
 include contributing.md
 include CONTRIBUTORS.txt

RELEASING.txt

+We use zest.releaser for release automation.
+
+https://pypi.org/project/zest.releaser/
+
+To make a new release, first prepare by adding any omitted entries to
+CHANGES.rst. Then use the following command, accepting all default options:
+
+    fullrelease
+
+It will go through to update version number, changelog, commit and tag those
+changes, upload the package to PyPI, and to further switch the source tree for
+the next development cycle.
+
+See zest.releaser documentation for details:
+
+https://zestreleaser.readthedocs.io/en/latest/overview.html#available-commands
+
+
+If/when needed, one could also manually make all release steps described above.
+See "Packaging Python Projects"
+
+https://packaging.python.org/tutorials/packaging-projects/
+
+and zodburi git history for details.

tox.ini

 [tox]
 envlist =
-    {py27,py35,py36,pypy,pypy3}-{zodb4,zodb5},{py37,py38}-zodb5,cover,docs
+    {py27,py35,py36,pypy,pypy3}-{zodb4,zodb5},
+    {py37,py38}-zodb5,
+    cover,docs,lint
 
 [testenv]
 commands =
@@ -37,3 +39,27 @@ commands =
 deps =
     Sphinx
     pylons-sphinx-themes
+
+
+[testenv:lint]
+skip_install = true
+commands =
+    check-manifest
+deps =
+    check-manifest
+
+[testenv:build]
+skip_install = true
+commands =
+    # clean up build/ and dist/ folders
+    python -c 'import shutil; shutil.rmtree("dist", ignore_errors=True)'
+    python setup.py clean --all
+    # build sdist
+    python setup.py sdist --dist-dir {toxinidir}/dist
+    # build wheel from sdist
+    pip wheel -v --no-deps --no-index --no-build-isolation --wheel-dir {toxinidir}/dist --find-links {toxinidir}/dist zodburi
+    twine check dist/*
+deps =
+    setuptools
+    twine
+    wheel