MAINT: Improve setup, and other maintenance.

* In setup.py, use setup() from setuptools, and use more arguments in setup().
* Copy-edit README.md, and make similar changes in doc/index.rst.
* Remove an unused import of os from doc/source/conf.py.
* Add __init__.py in numpy_financial/tests/.

Author: WarrenWeckesser

README.md

@@ -1,6 +1,21 @@
 # NumPy Financial
 
-The `numpy-financial` package contains a collection of elementary financial functions.
-The original versions of these functions were in NumPy.
-The NumPy versions will be deprecated:
-see [NEP-32](https://numpy.org/neps/nep-0032-remove-financial-functions.html).
+The `numpy-financial` package contains a collection of elementary financial
+functions.
+
+The [financial functions in NumPy](https://numpy.org/doc/1.17/reference/routines.financial.html)
+are deprecated and eventually will be removed from NumPy; see
+[NEP-32](https://numpy.org/neps/nep-0032-remove-financial-functions.html)
+for more information.  This package is the replacement for the original
+NumPy financial functions.
+
+The source code for this package is available at https://github.com/numpy/numpy-financial.
+
+The importable name of the package is `numpy_financial`.  When giving the
+name a shortened alias, `npf` is recommended.  For example,
+
+```
+>>> import numpy_financial as npf
+>>> npf.irr([-250000, 100000, 150000, 200000, 250000, 300000])
+0.5672303344358536
+```

doc/source/conf.py

@@ -4,7 +4,6 @@
 # list see the documentation:
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 
-import os
 import numpy_financial
 
 # -- Path setup --------------------------------------------------------------

doc/source/index.rst

@@ -6,12 +6,25 @@
 numpy-financial |version|
 =========================
 
-Simple financial functions.
+The `numpy-financial` package contains a collection of elementary financial
+functions.
 
-The importable Python package name is ``numpy_financial``.
+The `financial functions in NumPy <https://numpy.org/doc/1.17/reference/routines.financial.html>`_
+are deprecated and eventually will be removed from NumPy; see
+`NEP-32 <https://numpy.org/neps/nep-0032-remove-financial-functions.html>`_
+for more information.  This package is the replacement for the deprecated
+NumPy financial functions.
 
 The source code for this package is available at https://github.com/numpy/numpy-financial.
 
+The importable name of the package is `numpy_financial`.  The recommended
+alias is `npf`.  For example,
+
+>>> import numpy_financial as npf
+>>> npf.irr([-250000, 100000, 150000, 200000, 250000, 300000])
+0.5672303344358536
+
+
 Functions
 ---------
 

numpy_financial/tests/__init__.py

@@ -1,5 +1,7 @@
 #!/usr/bin/env python
 
+from os import path
+
 
 def get_version():
     """
@@ -19,16 +21,40 @@ def get_version():
                 return s[1][1:-1]
 
 
-def configuration(parent_package='', top_path=None):
-    from numpy.distutils.misc_util import Configuration
-    config = Configuration(None, parent_package, top_path)
-    config.add_subpackage('numpy_financial')
-    return config
-
+CLASSIFIERS = """\
+Development Status :: 5 - Production/Stable
+Intended Audience :: Science/Research
+Intended Audience :: Developers
+License :: OSI Approved
+Programming Language :: Python
+Programming Language :: Python :: 3
+Programming Language :: Python :: 3.5
+Programming Language :: Python :: 3.6
+Programming Language :: Python :: 3.7
+Programming Language :: Python :: 3 :: Only
+Topic :: Software Development
+Topic :: Scientific/Engineering
+"""
+
+here = path.abspath(path.dirname(__file__))
+with open(path.join(here, 'README.md'), 'r') as f:
+    long_description = f.read()
 
 if __name__ == "__main__":
-    from numpy.distutils.core import setup
+    from setuptools import setup, find_packages
 
     setup(name='numpy-financial',
           version=get_version(),
-          configuration=configuration)
+          description='Simple financial functions',
+          long_description=long_description,
+          long_description_content_type='text/markdown',
+          packages=find_packages(exclude=['doc']),
+          author='Travis E. Oliphant et al.',
+          license='BSD',
+          python_requires='>=3.5',
+          classifiers=CLASSIFIERS.splitlines(),
+          project_urls={
+              "Bug Tracker": "https://github.com/numpy/numpy-financial/issues",
+              "Documentation": "https://numpy.org/numpy-financial/",
+              "Source Code": "https://github.com/numpy/numpy-financial",
+          })