Use pytest plugin mechanism to conditionally skip tests requiring Julia runtime

.gitignore

@@ -40,9 +40,6 @@ nosetests.xml
 # PyCharm
 .idea/*
 
-# Test files
-*test.py
-
 # created by distutils during build process
 MANIFEST
 

README.md

@@ -394,7 +394,7 @@ $ tox
 The full syntax for invoking `tox` is
 
 ```shell
-[PYJULIA_TEST_REBUILD=yes] [JULIA_EXE=<julia>] tox [options] [-- pytest options]
+[PYJULIA_TEST_REBUILD=yes] [PYJULIA_TEST_RUNTIME=<julia>] tox [options] [-- pytest options]
 ```
 
 * `PYJULIA_TEST_REBUILD`: *Be careful using this environment
@@ -405,14 +405,14 @@ The full syntax for invoking `tox` is
   also that it does not work if you unconditionally set `PYTHON`
   environment variable in your Julia startup file.
 
-* `JULIA_EXE`: `julia` executable to be used for testing.
+* `PYJULIA_TEST_RUNTIME`: `julia` executable to be used for testing.
 
 * Positional arguments after `--` are passed to `pytest`.
 
 For example,
 
 ```console
-$ PYJULIA_TEST_REBUILD=yes JULIA_EXE=~/julia/julia tox -e py37 -- -s
+$ PYJULIA_TEST_REBUILD=yes PYJULIA_TEST_RUNTIME=~/julia/julia tox -e py37 -- -s
 ```
 
 means to execute tests with

julia/core.py

@@ -530,18 +530,22 @@ class LibJulia(BaseLibJulia):
 
     An easy way to create a `LibJulia` object is `LibJulia.load`:
 
-    >>> api = LibJulia.load()
+    >>> api = LibJulia.load()                              # doctest: +SKIP
 
     Or, equivalently,
 
-    >>> api = LibJulia.load(julia="julia")
-    >>> api = LibJulia.from_juliainfo(JuliaInfo.load())
+    >>> api = LibJulia.load(julia="julia")                 # doctest: +SKIP
+    >>> api = LibJulia.from_juliainfo(JuliaInfo.load())    # doctest: +SKIP
 
     You can pass a path to the Julia executable using `julia` keyword
     argument:
 
     >>> api = LibJulia.load(julia="PATH/TO/CUSTOM/julia")  # doctest: +SKIP
 
+    .. Do not run doctest with non-default libjulia.so.
+       >>> _ = getfixture("julia")
+       >>> api = get_libjulia()
+
     Path to the system image can be configured before initializing Julia:
 
     >>> api.image_file                                     # doctest: +SKIP

julia/pytestplugin.py

@@ -0,0 +1,34 @@
+from __future__ import print_function, absolute_import
+
+import pytest
+
+
+def pytest_addoption(parser):
+    import os
+
+    parser.addoption(
+        "--no-julia",
+        action="store_false",
+        dest="julia",
+        help="Skip tests that require julia.",
+    )
+    parser.addoption(
+        "--julia-runtime",
+        help="""
+        Julia executable to be used.  Defaults to environment variable
+        `$PYJULIA_TEST_RUNTIME`.
+        """,
+        default=os.getenv("PYJULIA_TEST_RUNTIME", "julia"),
+    )
+
+
+@pytest.fixture(scope="session")
+def julia(request):
+    """ pytest fixture for providing a `Julia` instance. """
+    if not request.config.getoption("julia"):
+        pytest.skip("--no-julia is given.")
+
+    from julia.core import Julia
+
+    jl = Julia(runtime=request.config.getoption("julia_runtime"), debug=True)
+    return jl

julia/with_rebuilt.py

@@ -104,10 +104,10 @@ def main(args=None):
         variable in your Julia startup file.
         """)
     parser.add_argument(
-        '--julia', default=os.getenv('JULIA_EXE', 'julia'),
+        '--julia', default=os.getenv('PYJULIA_TEST_RUNTIME', 'julia'),
         help="""
         Julia executable to be used.
-        Default to the value of environment variable JULIA_EXE if set.
+        Default to the value of environment variable PYJULIA_TEST_RUNTIME if set.
         """)
     parser.add_argument(
         'command', nargs='+',

setup.py

@@ -70,6 +70,9 @@ def pyload(path):
           "console_scripts": [
               "python-jl = julia.python_jl:main",
           ],
+          "pytest11": [
+              "pyjulia = julia.pytestplugin",
+          ],
       },
       # We bundle Julia scripts etc. inside `julia` directory.  Thus,
       # this directory must exist in the file system (not in a zip

test/conftest.py

@@ -0,0 +1,9 @@
+import pytest
+
+
+@pytest.fixture(scope="session")
+def Main(julia):
+    """ pytest fixture for providing a Julia `Main` name space. """
+    from julia import Main
+
+    return Main

test/test_compatible_exe.py

@@ -118,8 +118,7 @@ def is_dynamically_linked(executable):
 
 
 @pytest.mark.parametrize("python", incompatible_pythons)
-def test_incompatible_python(python):
-    from .test_core import julia
+def test_incompatible_python(python, julia):
 
     if julia.eval("(VERSION.major, VERSION.minor)") == (0, 6):
         # Julia 0.6 implements mixed version
@@ -131,7 +130,7 @@ def test_incompatible_python(python):
         """
         import os
         from julia import Julia
-        Julia(runtime=os.getenv("JULIA_EXE"), debug=True)
+        Julia(runtime=os.getenv("PYJULIA_TEST_RUNTIME"), debug=True)
         """,
     )