Added minimum dependency compatibility script

Author: seanlaw

min.py

@@ -0,0 +1,68 @@
+#!/usr/bin/env python
+
+import pandas as pd
+from packaging.specifiers import SpecifierSet
+from packaging.version import Version
+
+
+def check_compatibility(row, min_python, min_numpy):
+    """
+    Determines the Python and NumPy version compatibility
+    """
+    python_compatible = min_python in (row.MIN_PYTHON_SPEC & row.MAX_PYTHON_SPEC)
+    numpy_compatible = min_numpy in (row.MIN_NUMPY_SPEC & row.MAX_NUMPY_SPEC)
+    return python_compatible & numpy_compatible
+
+
+MIN_PYTHON = "3.8"  # Change this
+
+df = (
+    pd.read_html(
+        "https://numba.readthedocs.io/en/stable/user/installing.html#version-support-information"  # noqa
+    )[0]
+    .dropna()
+    .query(f'Python.str.startswith("{MIN_PYTHON}")', engine="python")
+    .pipe(lambda df: df.assign(NumPy=df.NumPy.str.split().str[0]))
+    .iloc[-1]
+)
+MIN_NUMBA = df.Numba
+MIN_NUMPY = df.NumPy
+
+df = (
+    pd.read_html("https://docs.scipy.org/doc/scipy/dev/toolchain.html#numpy")[1]
+    .replace({".x": ""}, regex=True)
+    .rename(columns=lambda x: x.replace(" ", "_"))
+    .query('`Python_versions`.str.contains("2.7") == False')
+    .pipe(
+        lambda df: df.assign(
+            MIN_PYTHON_SPEC=df.Python_versions.str.split(",").str[0].apply(SpecifierSet)
+        )
+    )
+    .pipe(
+        lambda df: df.assign(
+            MAX_PYTHON_SPEC=df.Python_versions.str.split(",").str[1].apply(SpecifierSet)
+        )
+    )
+    .pipe(
+        lambda df: df.assign(
+            MIN_NUMPY_SPEC=df.NumPy_versions.str.split(",").str[0].apply(SpecifierSet)
+        )
+    )
+    .pipe(
+        lambda df: df.assign(
+            MAX_NUMPY_SPEC=df.NumPy_versions.str.split(",").str[1].apply(SpecifierSet)
+        )
+    )
+    .assign(
+        COMPATIBLE=lambda row: row.apply(
+            check_compatibility, axis=1, args=(Version(MIN_PYTHON), Version(MIN_NUMPY))
+        )
+    )
+    .query("COMPATIBLE == True")
+    .iloc[-1]
+)
+MIN_SCIPY = df.SciPy_version
+
+print(
+    f"python: {MIN_PYTHON}\nnumba: {MIN_NUMBA}\nnumpy: {MIN_NUMPY}\nscipy: {MIN_SCIPY}"
+)

pypi.sh

@@ -3,10 +3,7 @@
 # 1. Update version number in setup.py
 # 2. Update CHANGELOG
 # 3. Update README with new features/functions/tutorials
-# 4. Determine minimum dependencies
-#    a) Find the minimum Python and NumPy version you want to support: https://numpy.org/neps/nep-0029-deprecation_policy.html#support-table
-#    b) Then find the SciPy version that has a "Python" version and "Minimum NumPy version" that is supported: https://docs.scipy.org/doc/scipy/dev/toolchain.html#numpyy
-#    c) Check Numba for mimumum Python and NumPy versions supported: https://numba.readthedocs.io/en/stable/user/installing.html#version-support-information
+# 4. Determine minimum dependencies with ./min.py
 # 5. Bump minimum dependencies
 #    a) setup.py
 #    b) requirements.txt

test.sh

@@ -107,7 +107,7 @@ test_custom()
     # ./test.sh custom 5 tests/test_stump.py
     # ./test.sh custom 5 tests/test_stump.py::test_stump_self_join
     #
-    # You may mimic coverag testing conditions by disable `numba` JIT
+    # You may mimic coverage testing conditions by disabling `numba` JIT
     # and enabling the `cuda` simulator by setting two environment
     # variables prior to calling `test.sh`:
     #
@@ -161,7 +161,7 @@ test_coverage()
         coverage run --append --source=. -m pytest -rsx -W ignore::RuntimeWarning -W ignore::DeprecationWarning -W ignore::UserWarning $testfile
         check_errs $?
     done
-    coverage report -m --fail-under=100 --skip-covered --omit=setup.py,docstring.py,stumpy/cache.py
+    coverage report -m --fail-under=100 --skip-covered --omit=setup.py,docstring.py,min.py,stumpy/cache.py
 }
 
 check_links()