init

2026-02-12 23:22:11 +08:00
parent 7b09eb3d89
commit 89660bba4e
5988 changed files with 2517516 additions and 0 deletions
@@ -0,0 +1,82 @@
+"""Deprecated utilities subpackage."""
+
+from __future__ import annotations
+
+import importlib
+import inspect
+import warnings
+
+# Places to look for the utility
+_MODULES = [
+    'pyvista.core.utilities',
+    'pyvista.core.errors',
+    'pyvista.core',
+    'pyvista.plotting.utilities',
+    'pyvista.plotting.errors',
+    'pyvista.plotting.texture',
+    'pyvista.plotting',
+    'pyvista.report',
+    'pyvista.plotting.themes',
+]
+
+
+def _try_import(module, name):
+    """Attempt to import a module."""
+    _module = importlib.import_module(module)
+    try:
+        feature = inspect.getattr_static(_module, name)
+        import_path = f'from {module} import {name}'
+    except AttributeError:
+        return None, None
+    return feature, import_path
+
+
+def __getattr__(name):
+    """Fetch an attribute ``name`` from ``globals()`` and warn if it's from a deprecated module.
+
+    Note that ``__getattr__()`` only gets called when ``name`` is missing
+    from the module's globals. The trick is that we want to import this
+    function into other deprecated modules, and we want to carry this
+    subpackage's globals along to prevent some spurious warnings.
+
+    Raises
+    ------
+    AttributeError
+        If the attribute is not found in ``globals()`` and also could not be
+        imported from the modules in ``_MODULES``.
+
+    PyVistaDeprecationWarning
+        If the attribute has been found via importing from the modules in
+        ``_MODULES``, as this implies that the feature has been moved from
+        pyvista.utilities.
+
+    """
+    try:
+        return globals()[name]
+    except KeyError:
+        pass
+
+    for module in _MODULES:
+        feature, import_path = _try_import(module, name)
+        if feature is not None:
+            break
+    else:
+        msg = (
+            f'Module `pyvista.utilities` has been deprecated and we could not automatically '
+            f'find `{name}`. This feature has moved.'
+        )
+        raise AttributeError(msg) from None
+
+    message = (
+        f'The `pyvista.utilities` module has been deprecated. `{name}` is now imported '
+        f'as: `{import_path}`.'
+    )
+
+    from pyvista.core.errors import PyVistaDeprecationWarning  # noqa: PLC0415
+
+    warnings.warn(
+        message,
+        PyVistaDeprecationWarning,
+    )
+
+    return feature
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__
@@ -0,0 +1,5 @@
+"""Deprecated module."""
+
+from __future__ import annotations
+
+from . import __getattr__