maint: add coverage testing script

Author: oscarbenjamin

.coveragerc

@@ -0,0 +1,2 @@
+[run]
+plugins = Cython.Coverage

.gitignore

@@ -12,3 +12,4 @@ MANIFEST
 .eggs
 .local
 *.egg-info
+.coverage

bin/activate

@@ -0,0 +1,4 @@
+export C_INCLUDE_PATH=$(pwd)/.local/include
+export LIBRARY_PATH=$(pwd)/.local/lib
+export LD_LIBRARY_PATH=$(pwd)/.local/lib
+export PYTHONPATH=$(pwd)/src

bin/coverage.sh

@@ -0,0 +1,38 @@
+#!/bin/bash
+#
+# Note: cython's Cython/Coverage.py fails for pyx files that are included in
+# other pyx files. This gives the following error:
+#
+#   $ coverage report -m
+#   Plugin 'Cython.Coverage.Plugin' did not provide a file reporter for
+#   '.../python-flint/src/flint/fmpz.pyx'.
+#
+# A patch to the file is needed:
+#
+#  --- Coverage.py.backup   2022-12-09 17:36:35.387690467 +0000
+#  +++ Coverage.py 2022-12-09 17:08:06.282516837 +0000
+#  @@ -172,7 +172,9 @@ class Plugin(CoveragePlugin):
+#          else:
+#              c_file, _ = self._find_source_files(filename)
+#              if not c_file:
+# -                return None
+# +                c_file = os.path.join(os.path.dirname(filename), 'pyflint.c')
+# +                if not os.path.exists(c_file):
+# +                    return None
+#              rel_file_path, code = self._read_source_lines(c_file, filename)
+#              if code is None:
+#                  return None  # no source found
+#
+#
+
+set -o errexit
+
+source bin/activate
+
+python setup.py build_ext --inplace
+
+
+coverage run test/test.py
+
+coverage report -m
+coverage html

setup.py

@@ -5,6 +5,7 @@
 from distutils.core import setup
 from distutils.extension import Extension
 from Cython.Distutils import build_ext
+from Cython.Build import cythonize
 from numpy.distutils.system_info import default_include_dirs, default_lib_dirs
 
 from distutils.sysconfig import get_config_vars
@@ -45,7 +46,9 @@
         "flint._flint", ["src/flint/pyflint.pyx"],
         libraries=libraries,
         library_dirs=default_lib_dirs,
-        include_dirs=default_include_dirs)
+        include_dirs=default_include_dirs,
+        define_macros=[('CYTHON_TRACE', 1)],
+        )
 ]
 
 for e in ext_modules:
@@ -54,7 +57,7 @@
 setup(
     name='python-flint',
     cmdclass={'build_ext': build_ext},
-    ext_modules=ext_modules,
+    ext_modules=cythonize(ext_modules, compiler_directives={'linetrace': True, 'language_level':2}),
     packages=['flint'],
     package_dir={'': 'src'},
     description='Bindings for FLINT and Arb',