File: test_utilities_namespace.py

package info (click to toggle)
python-pyvista 0.46.4-4
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 176,968 kB
  • sloc: python: 94,346; sh: 216; makefile: 70
file content (100 lines) | stat: -rw-r--r-- 3,707 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
from __future__ import annotations

import importlib
from pathlib import Path

import pytest

from pyvista.core.errors import PyVistaDeprecationWarning

namespace_data = Path(__file__).parent / 'namespace-utilities.txt'
with namespace_data.open() as f:
    namespace = f.read().splitlines()
    # ignore commented data
    namespace = [n.split(', ')[0] for n in namespace if not n.startswith('#')]


@pytest.mark.parametrize('name', namespace)
def test_utilities_namespace(name):
    import pyvista.utilities as utilities  # noqa: PLR0402

    with pytest.warns(PyVistaDeprecationWarning):
        assert hasattr(utilities, name)


@pytest.mark.parametrize(
    'name',
    [
        'algorithms',
        'arrays',
        'cell_type_helper',
        'cells',
        'common',
        'docs',
        'errors',
        'features',
        'fileio',
        'geometric_objects',
        'helpers',
        'misc',
        'parametric_objects',
        'reader',
        'regression',
        'sphinx_gallery',
        'transformations',
        'wrappers',
        'xvfb',
    ],
)
def test_utilities_modules(name):
    # Smoke test to make sure same modules still exist
    importlib.import_module(f'pyvista.utilities.{name}')


def _import_all_utilities():
    """Import all utilities to test deprecated namespace imports."""
    import pyvista.utilities  # noqa: F401

    # Import specific items to ensure they exist
    from pyvista.utilities import NORMALS  # noqa: F401
    from pyvista.utilities import abstract_class  # noqa: F401
    from pyvista.utilities import assert_empty_kwargs  # noqa: F401
    from pyvista.utilities import conditional_decorator  # noqa: F401
    from pyvista.utilities import convert_string_array  # noqa: F401
    from pyvista.utilities import generate_plane  # noqa: F401
    from pyvista.utilities import get_array  # noqa: F401
    from pyvista.utilities import get_array_association  # noqa: F401
    from pyvista.utilities import get_vtk_type  # noqa: F401
    from pyvista.utilities import threaded  # noqa: F401
    from pyvista.utilities import try_callback  # noqa: F401
    from pyvista.utilities import xvfb  # noqa: F401
    from pyvista.utilities.algorithms import add_ids_algorithm  # noqa: F401
    from pyvista.utilities.algorithms import algorithm_to_mesh_handler  # noqa: F401
    from pyvista.utilities.algorithms import crinkle_algorithm  # noqa: F401
    from pyvista.utilities.algorithms import outline_algorithm  # noqa: F401
    from pyvista.utilities.algorithms import pointset_to_polydata_algorithm  # noqa: F401
    from pyvista.utilities.algorithms import set_algorithm_input  # noqa: F401
    from pyvista.utilities.errors import GPUInfo  # noqa: F401
    from pyvista.utilities.geometric_objects import Arrow  # noqa: F401
    from pyvista.utilities.geometric_objects import Cylinder  # noqa: F401
    from pyvista.utilities.geometric_objects import PlatonicSolid  # noqa: F401
    from pyvista.utilities.helpers import vtk_id_list_to_array  # noqa: F401
    from pyvista.utilities.sphinx_gallery import _get_sg_image_scraper  # noqa: F401
    from pyvista.utilities.xvfb import start_xvfb  # noqa: F401


def test_common_utilities_import_paths():
    # These are `pyvista.utilities` imports found via search on GitHub
    # across multiple public repositories
    with pytest.warns(PyVistaDeprecationWarning):
        _import_all_utilities()


def test_failure_to_find():
    module = importlib.import_module('pyvista.utilities')
    with pytest.raises(
        AttributeError,
        match=r'Module `pyvista\.utilities` has been deprecated '
        r'and we could not automatically find',
    ):
        _ = module.this_does_not_exist