Unify package metadata and tool configuration

Executable `setup.py` configuration has generally fallen out of favor,
with declarative project configuration files like `setup.cfg` and
`pyproject.toml` becoming more popular.

The following files are subsumed by this change:

* `.coveragerc`
* `MANIFEST.in`
* `apiron/VERSION` (thanks in part to `importlib_metadata`!)
* `pytest.ini`
* `requirements.txt`
* `tox.ini`

It also reduces `setup.py` to its minimal form.

I think I would've preferred to cut over to `pyproject.toml` if we
could, but [coverage does not yet support
it](nedbat/coveragepy#699). This also means the
configuration for `black` still sits in `pyproject.toml`, because _it_
doesn't support `setup.cfg`. Fortunately, the content of `setup.cfg`
should be relatively portable to `pyproject.toml` when the time comes.

Author: daneah

.coveragerc

@@ -35,9 +35,9 @@ To test `apiron`, check out the repository and:
 ```
 $ cd /path/to/apiron/
 $ pyenv virtualenv 3.7.3 apiron  # pick your favorite virtual environment tool
-$ pyenv local apiron:3.7.3:3.6.8:3.5.7:3.4.3  # use any Python versions you want to test
-(apiron:3.7.3:3.6.8:3.5.7:3.4.3) $ pip install -r dev-requirements.txt
-(apiron:3.7.3:3.6.8:3.5.7:3.4.3) $ python -m tox
+$ pyenv local apiron:3.8-dev:3.7.3:3.6.8:3.5.7:3.4.3  # use any Python versions you want to test
+(apiron:3.8-dev:3.7.3:3.6.8:3.5.7:3.4.3) $ pip install -r dev-requirements.txt
+(apiron:3.8-dev:3.7.3:3.6.8:3.5.7:3.4.3) $ python -m tox
 ```
 
 ## Code formatting

.github/CONTRIBUTING.md

@@ -30,7 +30,6 @@ jobs:
     - stage: lint
       install:
         - pip install -r dev-requirements.txt
-        - pip install black pyflakes
       script:
         - pyflakes apiron tests
         - black --check apiron tests

.travis.yml

@@ -1,5 +1,5 @@
--r requirements.txt
-
+black==19.3b0
+pyflakes==2.1.1
 pytest==4.2.0
 pytest-cov==2.6.1
 sphinx==1.7.6

MANIFEST.in

@@ -13,6 +13,7 @@
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 #
 import datetime
+import importlib_metadata
 import os
 import sys
 
@@ -28,10 +29,7 @@
 copyright = '{} {}'.format(CURRENT_YEAR, ORG)
 author = ORG
 
-VERSION_FILEPATH = os.path.join(REPO, 'apiron', 'VERSION')
-
-with open(VERSION_FILEPATH) as version_file:
-    RELEASE_VERSION = version_file.readlines()[0].strip()
+RELEASE_VERSION = importlib_metadata.version('apiron')
 
 # The short X.Y version
 version = RELEASE_VERSION

apiron/VERSION

@@ -0,0 +1,73 @@
+[metadata]
+name = apiron
+version = 3.0.0
+description = apiron helps you cook a tasty client for RESTful APIs. Just don't wash it with SOAP.
+author = Ithaka Harbors, Inc.
+author_email = [email protected]
+url = https://github.com/ithaka/apiron
+license = MIT
+license_file = LICENSE
+long_description = file: README.md
+long_description_content_type = text/markdown
+classifiers =
+    Development Status :: 5 - Production/Stable
+    Intended Audience :: Developers
+    Topic :: Internet :: WWW/HTTP
+    Topic :: Software Development :: Libraries :: Python Modules
+    Programming Language :: Python
+    Programming Language :: Python :: 3.4
+    Programming Language :: Python :: 3.5
+    Programming Language :: Python :: 3.6
+    Programming Language :: Python :: 3.7
+    Programming Language :: Python :: 3.8
+    Programming Language :: Python :: 3
+    Programming Language :: Python :: 3 :: Only
+    License :: OSI Approved :: MIT License
+
+[options]
+packages = find:
+install_requires =
+    requests>=2.11.1,<3
+
+[options.packages.find]
+exclude =
+    tests*
+
+######################
+# Tool configuration #
+######################
+
+[coverage:run]
+branch = True
+source = .
+omit =
+    */tests/*
+    setup.py
+
+[coverage:report]
+show_missing = True
+skip_covered = True
+
+
+[tool:pytest]
+norecursedirs =
+    apiron
+    apiron.egg-info
+    build
+    dist
+    docs
+    .git
+    .github
+    .idea
+    .tox
+    .pytest_cache
+
+addopts = -ra -q --cov=apiron --cov-config=.coveragerc
+
+[tox:tox]
+envlist = py34,py35,py36,py37,py38
+
+[testenv]
+deps = -rdev-requirements.txt
+commands =
+    pytest

dev-requirements.txt

@@ -1,47 +1,2 @@
-import os
-from setuptools import setup, find_packages
-
-with open('README.md') as readme_file:
-    README = readme_file.read()
-
-with open('requirements.txt') as requirements_file:
-    REQUIREMENTS = [line.rstrip() for line in requirements_file if line != '\n']
-
-with open('apiron/VERSION') as version_file:
-    VERSION = version_file.readlines()[0].strip()
-
-os.chdir(os.path.normpath(os.path.join(os.path.abspath(__file__), os.pardir)))
-
-setup(
-    name='apiron',
-    version=VERSION,
-    author='Ithaka Harbors, Inc.',
-    author_email='[email protected]',
-    url='https://github.com/ithaka/apiron',
-    license='MIT',
-
-    description='apiron helps you cook a tasty client for RESTful APIs. Just don\'t wash it with SOAP.',
-    long_description=README,
-    long_description_content_type='text/markdown',
-
-    packages=find_packages(),
-    include_package_data=True,
-
-    install_requires=REQUIREMENTS,
-
-    classifiers=[
-        'Development Status :: 5 - Production/Stable',
-        'Intended Audience :: Developers',
-        'Topic :: Internet :: WWW/HTTP',
-        'Topic :: Software Development :: Libraries :: Python Modules',
-        'Programming Language :: Python',
-        'Programming Language :: Python :: 3.4',
-        'Programming Language :: Python :: 3.5',
-        'Programming Language :: Python :: 3.6',
-        'Programming Language :: Python :: 3.7',
-        'Programming Language :: Python :: 3.8',
-        'Programming Language :: Python :: 3',
-        'Programming Language :: Python :: 3 :: Only',
-        'License :: OSI Approved :: MIT License',
-    ],
-)
+from setuptools import setup
+setup()