Add PyInstaller tests

Author: bwoodsend

.gitignore

@@ -29,7 +29,6 @@ MANIFEST
 #  Usually these files are written by a python script from a template
 #  before PyInstaller builds the exe, so as to inject date/other infos into it.
 *.manifest
-*.spec
 
 # Installer logs
 pip-log.txt

tests/PyInstaller/test.py

@@ -0,0 +1,29 @@
+# -*- coding: utf-8 -*-
+# =============================================================================
+# Created on 22:54
+#
+# @author: Brénainn
+#
+#
+# test.py
+# Copyright (C) 2019-2020  Brénainn Woodsend
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <https://www.gnu.org/licenses/>.
+# =============================================================================
+"""
+"""
+import vtkplotlib
+
+import pytest
+pytest.main()

tests/PyInstaller/test.spec

@@ -0,0 +1,41 @@
+# -*- mode: python ; coding: utf-8 -*-
+
+block_cipher = None
+
+from PyInstaller.utils.hooks import collect_data_files
+
+
+a = Analysis(['test.py'],
+             pathex=[SPECPATH],
+             binaries=[],
+             # I seriously doubt anyone actually will want the rabbit in their packages so it is excluded by
+             # default (in hook-vtkplotlib.py). But it is needed for testing so include it here.
+             datas=collect_data_files("vtkplotlib", "**.*.stl"),
+             hiddenimports=["vtkplotlib"],
+             hookspath=[],
+             runtime_hooks=[],
+             excludes=["matplotlib.pylab", "matplotlib.backends", "matplotlib.pyplot", 'vtkmodules.all', 'scipy'],
+             win_no_prefer_redirects=False,
+             win_private_assemblies=False,
+             cipher=block_cipher,
+             noarchive=False)
+pyz = PYZ(a.pure, a.zipped_data,
+             cipher=block_cipher)
+exe = EXE(pyz,
+          a.scripts,
+          [],
+          exclude_binaries=True,
+          name='test',
+          debug=False,
+          bootloader_ignore_signals=False,
+          strip=False,
+          upx=False,
+          console=True )
+coll = COLLECT(exe,
+               a.binaries,
+               a.zipfiles,
+               a.datas,
+               strip=False,
+               upx=False,
+               upx_exclude=[],
+               name='test')

tests/README.md

@@ -0,0 +1,76 @@
+# Welcome to the vtkplotlib test suite!
+
+This guide explains how to run the test suite.
+
+## Test requirements
+
+Some tests for features requiring extra optional dependencies are conditionally skipped if that library isn't installed. To install only the basics use (in the root of this repository):
+
+```shell
+pip install .[test_minimal]
+```
+
+Or to get everything:
+
+```shell
+pip install .[test_full]
+```
+
+In either case you may use the `-e` parameter.
+
+## Run the tests
+
+The test-suite is a `pytest` one. Use (in the root of this repository):
+
+```shell
+pytest tests
+```
+
+Or, if your working directory is not the root of this repo:
+
+```shell
+pytest /full/or/relative/path/to/tests
+```
+
+It's not particularly well automated. You still have to click and close through each window. I have made a few attempts to improve this but not with much success.
+
+Be sure to test on Python 2.7 and 3.5 as well as your go-to version.
+
+## Testing with PyInstaller
+
+### Setup
+
+To do this requires a PyInstaller that is recent enough to allow libraries to provide their own hooks:
+
+``` shell
+pip install "PyInstaller>=4.0"
+```
+
+And make sure your `matplotlib` is older than `3.3.0`.
+
+```shell
+pip install "matplotlib<3.3"
+```
+
+### Build
+
+Next `cd` into the `./tests/PyInstaller/` directory and run:
+
+```shell
+PyInstaller --clean --noconfirm test.spec
+```
+
+The `--noconfirm` is optional. And `--clean` is only necessary if you have changed the *vtkplotlib* source code.
+
+This creates an executable at `./dist/test/test` (or `dist\test\test.exe` on Windows). 
+
+### Test
+
+This executable is just `pytest.main()` with *vtkplotlib* installed in it. The tests themselves are excluded. Run it as you would run `pytest`. Assuming the working directory is still `./tests/PyInstaller/` use:
+
+```shell
+dist/test/test ../
+```
+
+Avoid running it with the root of this repo as the current working directory. Otherwise you may unintentionally use the original source *vtkplotlib* rather than the bundled one.
+