MAINT: Use requirements

Use requirements in setup file
Replace versioneer with setuptools_scm
Small doc fixes

Author: bashtage

.codacy.yml

@@ -5,4 +5,3 @@ engines:
    python_version: 3
 exclude_paths:
   - '**/_version.py'
-  - 'versioneer.py'

.gitignore

@@ -15,6 +15,8 @@ docs/source/savefig
 docs/gettingstarted_0.png
 examples/executed
 
+#setuptools-scm generated version file
+statsmodels/_version.py
 # generated c source and built extensions
 *.c
 *.so

.travis.yml

@@ -98,8 +98,7 @@ before_install:
 
 # Install packages
 install:
-  # Bug in NumPy < 1.16.1 that raises ValueError on size mismatch
-  - if [[ ${NUMPY} != "1.15" ]]; then pip install -e .; else python setup.py develop; fi
+  - pip install -e .
 
 before_script:
   - if [[ ${DOCBUILD} = true ]]; then source tools/ci/docbuild_install.sh; fi;

INSTALL.txt

@@ -71,7 +71,7 @@ Installing
 
 To get the latest release using pip
 
-    pip install statsmodels --upgrade-strategy only-if-needed
+    python -m pip install statsmodels --upgrade-strategy only-if-needed
 
 The additional parameter pip --upgrade-strategy only-if-needed will ensure
 that dependencies, e.g. NumPy or pandas, are not upgraded unless required.
@@ -82,7 +82,7 @@ Ubuntu/Debian
 On Ubuntu you can get dependencies through:
 
     sudo apt-get install python python-dev python-setuptools python-numpy python-scipy
-    pip install cython pandas
+    python -m pip install cython pandas
 
 Alternatively, you can install from the NeuroDebian repository:
 
@@ -103,7 +103,7 @@ Or clone the bleeding edge code from our repository on github at
 
 In the statsmodels directory do (with proper permissions)
 
-    python setup.py install
+    python -m pip install .
 
 You will need a C compiler installed.
 

MANIFEST.in

@@ -1,4 +1,5 @@
 global-include *.csv *.py *.txt *.pyx *.pyx.in *.pxd *.pxi *.c *.h *.pkl
+include statsmodels/_version.py
 include MANIFEST.in
 include README.rst
 
@@ -25,5 +26,4 @@ recursive-include examples *
 prune */__pycache__
 
 global-exclude *~ *.swp  *.pyc *.pyo *.bak
-include versioneer.py
 include statsmodels/_version.py

appveyor.yml.bak

@@ -36,8 +36,8 @@ build_script:
   - If Defined PY_MAJOR_VER ( call tools\ci\appveyor_conda.bat ) else ( call tools\ci\appveyor_pip.bat )
   # Pin to 1.29 for now due to test discovery issues
   - python -m pip install --upgrade pip "setuptools<50.0"
-  - pip install pytest "pytest-xdist==1.29" pytest-randomly
-  - if Defined PYTEST_DIRECTIVES ( pip install -e . --no-build-isolation ) else ( pip install . )
+  - python -m pip install pytest "pytest-xdist==1.29" pytest-randomly
+  - if Defined PYTEST_DIRECTIVES ( python -m pip install -e . --no-build-isolation ) else ( pip install . )
 
 test_script:
   - call tools\ci\run_test.bat

docs/README.md

@@ -12,7 +12,7 @@ of these with
 
 ```bash
 
-   pip install -e .[docs]
+   python -m pip install -e .[docs]
 
 ```
 

docs/source/conf.py

@@ -13,7 +13,7 @@
 # serve to show the default.
 
 import contextlib
-from distutils.version import LooseVersion
+from packaging.version import parse
 import os
 from os.path import dirname, join
 import sys
@@ -98,13 +98,13 @@
 
 release = __version__
 
-lv = LooseVersion(release)
+parsed_version = parse(release)
 commit = ''
 full_version = short_version = version = release
-if '+' in lv.version:
-    short_version = lv.vstring[:lv.vstring.index('+')]
-    commit = lv.version[lv.version.index('+') + 1]
-    version = short_version + ' (+{0})'.format(commit)
+if parsed_version.is_devrelease:
+    short_version = parsed_version.base_version
+    commit = parsed_version.dev
+    version = short_version + f' (+{commit})'
 
 # Remove release to prevent it triggering a conf change
 del release

docs/source/dev/maintainer_notes.rst

@@ -174,7 +174,7 @@ Releasing
 
 5. Build a sdist to ensure that that the build is clean::
 
-    python setup.py sdist --formats=gztar
+    python -m build --sdist .
 
    It is important that the build on the tar.gz file is the same as the tag. It must not be **dirty**
 
@@ -238,7 +238,7 @@ Once any patches have been backported to a maintenance branch, the release steps
 
 5. Build a sdist to ensure that that the build is clean::
 
-    python setup.py sdist --formats=gztar
+    python -m build --sdist .
 
    It is important that the build on the tar.gz file is the same as the tag. It must not be **dirty**.
 

docs/source/dev/test_notes.rst

@@ -11,15 +11,15 @@ using a development install of statsmodels by running:
 
 .. code-block:: bash
 
-   pip install -e .
+   python -m pip install -e .
 
 from the root directory of the git repository. The flag ``-e`` is for editable.
 
 This command compiles the C code and add statsmodels to your activate python
 environment by creating links from your python environment's libraries
 to the statsmodels source code. Therefore, changes to pure python code will
 be immediately available to the user without a re-install. Changes to C code or
-Cython code require rerunning ``pip install -e .`` before these changes are
+Cython code require rerunning ``python -m pip install -e .`` before these changes are
 available.
 
 Test Driven Development
@@ -37,7 +37,7 @@ Like many packages, statsmodels uses the `pytest testing system <https://docs.py
 Running Tests
 -------------
 Test are run from the command line by calling ``pytest``. Directly running tests using
-pytest requires that statsmodels is installed using ``pip install -e .`` as described
+pytest requires that statsmodels is installed using ``python -m pip install -e .`` as described
 above.
 
 Tests can be run at different levels of granularity:
@@ -165,7 +165,7 @@ speed up runs of the full test suite when needed.
 
 .. code-block:: bash
 
-   pip install pytest-xdist
+   python -m pip install pytest-xdist
    export MKL_NUM_THREADS=1
    export OMP_NUM_THREADS=1
    pytest -n auto statsmodels