babelplot 2025.1__tar.gz → 2025.3__tar.gz

{babelplot-2025.1 → babelplot-2025.3}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: babelplot
-Version: 2025.1
+Version: 2025.3
 Summary: A Meta Plotting Library That Speaks Several Backends
 Home-page: https://src.koda.cnrs.fr/eric.debreuve/babelplot/
 Author: Eric Debreuve
@@ -19,6 +19,18 @@ Description-Content-Type: text/x-rst
 Requires-Dist: numpy
 Requires-Dist: PyQt6
 Requires-Dist: scikit-image
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 ..
    Copyright CNRS/Inria/UniCA

{babelplot-2025.1 → babelplot-2025.3}/package/babelplot/__init__.py

@@ -4,6 +4,19 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2022
 SEE COPYRIGHT NOTICE BELOW
 """
 
+try:
+    from beartype.claw import beartype_this_package  # noqa
+except ModuleNotFoundError:
+    pass
+else:
+    import site
+    from pathlib import Path as path_t
+
+    paths = site.getsitepackages() + [site.getusersitepackages()]
+    folder = path_t(__file__).parent
+    if folder not in paths:
+        beartype_this_package()
+
 from babelplot.backend.specification.backend import backend_e
 from babelplot.main import NewFigure, NewPlot
 from babelplot.specification.plot import plot_e

{babelplot-2025.1 → babelplot-2025.3}/package/babelplot/backend/catalog/bokeh_.py

@@ -33,11 +33,16 @@ backend_frame_t = backend_figure_t
 def _NewPlot(
     frame: backend_frame_t,
     type_: plot_type_h | type[backend_plot_t],
-    plot_function: h.Callable | None,
+    plot_function: (
+        type[backend_plot_t] | h.Callable[..., backend_plot_t | h.Any] | None
+    ),
     *args,
     title: str | None = None,  # If _, then it is swallowed by kwargs!
     **kwargs,
-) -> tuple[backend_plot_t, type[backend_plot_t]]:
+) -> tuple[
+    backend_plot_t | h.Any,
+    type[backend_plot_t] | h.Callable[..., backend_plot_t | h.Any],
+]:
     """"""
     if plot_function is None:
         if hasattr(backend_frame_t, type_):
@@ -88,15 +93,15 @@ def _AsHTML(figure: figure_t, /) -> str:
 
 
 # noinspection PyTypeChecker
-plot_t: base_plot_t = type("plot_t", (base_plot_t,), {})
+plot_t: type[base_plot_t] = type("plot_t", (base_plot_t,), {})
 # noinspection PyTypeChecker
-frame_t: base_frame_t = type(
+frame_t: type[base_frame_t] = type(
     "frame_t",
     (base_frame_t,),
     {"plot_class": plot_t, "NewBackendPlot": staticmethod(_NewPlot)},
 )
 # noinspection PyTypeChecker
-figure_t: base_figure_t = type(
+figure_t: type[base_figure_t] = type(
     "figure_t",
     (base_figure_t,),
     {

{babelplot-2025.1 → babelplot-2025.3}/package/babelplot/backend/catalog/matplotlib_.py

@@ -18,7 +18,7 @@ from babelplot.type.base import backend_element_h, backend_plot_h
 from babelplot.type.figure import figure_t as base_figure_t
 from babelplot.type.frame import frame_t as base_frame_t
 from babelplot.type.plot import plot_t as base_plot_t
-from logger_36 import LOGGER
+from logger_36 import L
 from matplotlib.artist import Artist as backend_plot_t  # noqa
 from matplotlib.container import Container as backend_plots_t  # noqa
 from matplotlib.gridspec import GridSpec as grid_spec_t  # noqa
@@ -40,12 +40,17 @@ backend_frame_h = backend_frame_2d_t | backend_frame_3d_t
 
 def _NewPlot(
     frame: backend_frame_h,
-    type_: plot_type_h | type[backend_plot_h],
-    plot_function: h.Callable | None,
+    type_: plot_type_h | type[backend_plot_t],
+    plot_function: (
+        type[backend_plot_t] | h.Callable[..., backend_plot_t | h.Any] | None
+    ),
     *args,
     title: str | None = None,  # /!\ If _, then it is swallowed by kwargs!
     **kwargs,
-) -> tuple[h.Any, h.Callable]:
+) -> tuple[
+    backend_plot_t | h.Any,
+    type[backend_plot_t] | h.Callable[..., backend_plot_t | h.Any],
+]:
     """"""
     if plot_function is None:
         # Next, priority is given to 2-D plots... which might be a problem if a 2-D and
@@ -136,8 +141,19 @@ def _DefaultProperties(type_: h.Callable, /) -> dict[str, h.Any]:
     return {_key.replace(f"{name}.", ""): _vle for _key, _vle in properties.items()}
 
 
-def _SetProperty(element: backend_element_h, name: str, value: h.Any, /) -> None:
+def _SetProperty(
+    element: backend_element_h | h.Sequence[backend_element_h],
+    name: str,
+    value: h.Any,
+    /,
+) -> None:
     """"""
+    if isinstance(element, h.Sequence):
+        elements = element
+        for element in elements:
+            _SetProperty(element, name, value)
+        return
+
     if name == "marker":
         new_marker = marker_style_t(value)
         element.set_paths((new_marker.get_path(),))
@@ -146,18 +162,23 @@ def _SetProperty(element: backend_element_h, name: str, value: h.Any, /) -> None
         try:
             pypl.setp(element, **property_)
         except AttributeError:
-            LOGGER.error(
+            L.error(
                 f'Property "{name}": Invalid property for element of type "{type(element).__name__}"'
             )
 
 
-def _Property(element: backend_element_h, name: str, /) -> h.Any:
+def _Property(
+    element: backend_element_h | h.Sequence[backend_element_h], name: str, /
+) -> h.Any:
     """"""
+    if isinstance(element, h.Sequence):
+        return _Property(element[0], name)
+
     try:
         output = pypl.getp(element, property=name)
     except AttributeError:
         output = None
-        LOGGER.error(
+        L.error(
             f'Property "{name}": Invalid property for element of type "{type(element).__name__}"'
         )
 
@@ -165,7 +186,7 @@ def _Property(element: backend_element_h, name: str, /) -> h.Any:
 
 
 # noinspection PyTypeChecker
-plot_t: base_plot_t = type(
+plot_t: type[base_plot_t] = type(
     "plot_t",
     (base_plot_t,),
     {
@@ -175,7 +196,7 @@ plot_t: base_plot_t = type(
     },
 )
 # noinspection PyTypeChecker
-frame_t: base_frame_t = type(
+frame_t: type[base_frame_t] = type(
     "frame_t",
     (base_frame_t,),
     {
@@ -186,7 +207,7 @@ frame_t: base_frame_t = type(
     },
 )
 # noinspection PyTypeChecker
-figure_t: base_figure_t = type(
+figure_t: type[base_figure_t] = type(
     "figure_t",
     (base_figure_t,),
     {

{babelplot-2025.1 → babelplot-2025.3}/package/babelplot/backend/catalog/plotly_.py

@@ -47,11 +47,16 @@ _FIGURE_CONFIG = {
 def _NewPlot(
     _: backend_frame_h,
     type_: plot_type_h | type[backend_plot_t],
-    plot_function: h.Callable | None,
+    plot_function: (
+        type[backend_plot_t] | h.Callable[..., backend_plot_t | h.Any] | None
+    ),
     *args,
     title: str | None = None,  # If _, then it is swallowed by kwargs!
     **kwargs,
-) -> tuple[backend_plot_t, type[backend_plot_t]]:
+) -> tuple[
+    backend_plot_t | h.Any,
+    type[backend_plot_t] | h.Callable[..., backend_plot_t | h.Any],
+]:
     """"""
     if plot_function is None:
         if hasattr(plly, type_):
@@ -125,15 +130,15 @@ def _AsHTML(figure: figure_t, /) -> str:
 
 
 # noinspection PyTypeChecker
-plot_t: base_plot_t = type("plot_t", (base_plot_t,), {})
+plot_t: type[base_plot_t] = type("plot_t", (base_plot_t,), {})
 # noinspection PyTypeChecker
-frame_t: base_frame_t = type(
+frame_t: type[base_frame_t] = type(
     "frame_t",
     (base_frame_t,),
     {"plot_class": plot_t, "NewBackendPlot": staticmethod(_NewPlot)},
 )
 # noinspection PyTypeChecker
-figure_t: base_figure_t = type(
+figure_t: type[base_figure_t] = type(
     "figure_t",
     (base_figure_t,),
     {

{babelplot-2025.1 → babelplot-2025.3}/package/babelplot/backend/catalog/vedo_.py

@@ -30,11 +30,16 @@ backend_frame_t = backend_figure_t
 def _NewPlot(
     frame: backend_frame_t,
     type_: plot_type_h | type[backend_plot_h],
-    plot_function: h.Callable | None,
+    plot_function: (
+        type[backend_plot_h] | h.Callable[..., backend_plot_h | h.Any] | None
+    ),
     *args,
     title: str | None = None,  # If _, then it is swallowed by kwargs!
     **kwargs,
-) -> tuple[backend_plot_h, type[backend_plot_h]]:
+) -> tuple[
+    backend_plot_h | h.Any,
+    type[backend_plot_h] | h.Callable[..., backend_plot_h | h.Any],
+]:
     """"""
     if plot_function is None:
         if hasattr(vedo, type_):
@@ -70,15 +75,15 @@ def _Show(
 
 
 # noinspection PyTypeChecker
-plot_t: base_plot_t = type("plot_t", (base_plot_t,), {})
+plot_t: type[base_plot_t] = type("plot_t", (base_plot_t,), {})
 # noinspection PyTypeChecker
-frame_t: base_frame_t = type(
+frame_t: type[base_frame_t] = type(
     "frame_t",
     (base_frame_t,),
     {"plot_class": plot_t, "NewBackendPlot": staticmethod(_NewPlot)},
 )
 # noinspection PyTypeChecker
-figure_t: base_figure_t = type(
+figure_t: type[base_figure_t] = type(
     "figure_t",
     (base_figure_t,),
     {

{babelplot-2025.1 → babelplot-2025.3}/package/babelplot/backend/helper/validation.py

@@ -14,7 +14,7 @@ from types import FunctionType as function_type_t
 from types import ModuleType as module_type_t
 
 from babelplot.specification.plot import plot_e
-from logger_36 import LOGGER
+from logger_36 import L
 
 py_module_h = h.TypeVar("py_module_h", bound=str)  # E.g. module.submodule.
 module_path_t = str
@@ -73,7 +73,7 @@ def DefinedBackendMethods(
     output = {}
 
     if not hasattr(imported, target_class):
-        LOGGER.error(f'{module}: Does not define a "{target_class}" class')
+        L.error(f'{module}: Does not define a "{target_class}" class')
         return {}
 
     target_class = getattr(imported, target_class)

{babelplot-2025.1 → babelplot-2025.3}/package/babelplot/main.py

@@ -18,7 +18,7 @@ from babelplot.type.base import backend_plot_h
 from babelplot.type.figure import figure_t
 from babelplot.type.frame import frame_t
 from babelplot.type.plot import plot_t
-from logger_36 import LOGGER
+from logger_36 import L
 
 
 def NewFigure(
@@ -48,7 +48,7 @@ def NewFigure(
         try:
             module = mprt.import_module(f"{BACKEND_FOLDER_PY}.{pbe.value}_")
         except ModuleNotFoundError:
-            LOGGER.error(
+            L.error(
                 f"{pbe.value}: Unusable backend. "
                 f"Might be due to backend not being installed "
                 f"or implementation error in backend."

{babelplot-2025.1 → babelplot-2025.3}/package/babelplot/specification/plot.py

@@ -11,7 +11,12 @@ from operator import itemgetter as ItemAt
 
 from babelplot.extension.enum_ import EnumMembers, EnumValues
 
-UNAVAILABLE_for_this_DIM = None
+
+class _unavailable_for_this_dim:
+    pass
+
+
+UNAVAILABLE_for_this_DIM = _unavailable_for_this_dim()
 UNDEFINED_PARAMETER = "__UNDEFINED_PARAMETER__"
 
 
@@ -62,7 +67,7 @@ class plot_e(enum_t):
                     ):
                         for d_idx, for_dim in enumerate(value):
                             if isinstance(
-                                for_dim, (type(UNAVAILABLE_for_this_DIM), h.Callable)
+                                for_dim, (_unavailable_for_this_dim, h.Callable)
                             ):
                                 pass
                             else:
@@ -139,7 +144,8 @@ KNOWN_PLOT_TYPES = EnumValues(plot_e)
 
 
 plot_type_h = str | plot_e
-backend_plots_per_type_h = tuple[type[UNAVAILABLE_for_this_DIM] | h.Callable, ...]
+# List, and not tuple, to allow for population by backends.
+backend_plots_per_type_h = list[_unavailable_for_this_dim | h.Callable]
 backend_plots_h = dict[plot_e, backend_plots_per_type_h]
 
 
@@ -285,9 +291,7 @@ PLOT_DESCRIPTION = {
 }
 
 
-def PlotsFromTemplate() -> (
-    dict[plot_e, list[type[UNAVAILABLE_for_this_DIM] | h.Callable]]
-):
+def PlotsFromTemplate() -> dict[plot_e, list[_unavailable_for_this_dim | h.Callable]]:
     """"""
     return {_key: 3 * [UNAVAILABLE_for_this_DIM] for _key in PLOT_DESCRIPTION.keys()}
 

{babelplot-2025.1 → babelplot-2025.3}/package/babelplot/type/base.py

@@ -9,12 +9,12 @@ import typing as h
 
 from babelplot.backend.specification.runtime import BackendTranslations
 from babelplot.specification.plot import TranslatedArguments
-from logger_36 import LOGGER
+from logger_36 import L
 
 backend_figure_h = h.TypeVar("backend_figure_h")
 backend_frame_h = h.TypeVar("backend_frame_h")
 backend_plot_h = h.TypeVar("backend_plot_h")
-backend_element_h = backend_figure_h | backend_frame_h | backend_plot_h
+backend_element_h = backend_figure_h | backend_frame_h | backend_plot_h | h.Any
 
 
 @dtcl.dataclass(repr=False, eq=False)
@@ -25,6 +25,8 @@ class babelplot_element_t:
         they are stored here. E.g., how to retrieve the marker of a scatter plot in
         Matplotlib?
         /!\\ Do not forget to initialize it with kwargs during element instantiation.
+    backend: Certain plots of certain libraries might be composed of a list of plots,
+        not just a unique plot, or even richer outputs (e.g., with Matplotlib).
     """
 
     pbe: str | None = None
@@ -36,14 +38,14 @@ class babelplot_element_t:
         element: backend_element_h, name: str, value: h.Any, /
     ) -> None:
         """"""
-        LOGGER.warning(
+        L.warning(
             f"{babelplot_element_t.BackendSetProperty.__name__}: Not provided by backend."
         )
 
     @staticmethod
     def BackendProperty(element: backend_element_h, name: str, /) -> h.Any:
         """"""
-        LOGGER.warning(
+        L.warning(
             f"{babelplot_element_t.BackendProperty.__name__}: Not provided by backend."
         )
 
@@ -55,7 +57,7 @@ class babelplot_element_t:
 
         if (n_properties := args.__len__()) > 0:
             if (n_properties % 2) > 0:
-                LOGGER.error(
+                L.error(
                     f"N. argument(s)={n_properties}: Properties not passed in matching key-value pairs. "
                     f"Expected=Even number."
                 )

{babelplot-2025.1 → babelplot-2025.3}/package/babelplot/type/figure.py

@@ -15,7 +15,7 @@ from babelplot.specification.plot import TranslatedArguments
 from babelplot.type.base import babelplot_element_t as base_figure_t
 from babelplot.type.base import backend_figure_h, backend_frame_h
 from babelplot.type.frame import frame_t
-from logger_36 import LOGGER
+from logger_36 import L
 
 _un_shown_figures = []
 _shown_figures = []
@@ -57,10 +57,10 @@ class figure_t(base_figure_t):
             dim = dim_e.NewFromName(dim)
 
         if (where := (row, col)) in self.locations:
-            LOGGER.error(f"{where}: Frame grid cell already filled")
+            L.error(f"{where}: Frame grid cell already filled")
             return None
         if (row < 0) and (col < 0):
-            LOGGER.error(f"{where}: Grid coordinates cannot be both negative")
+            L.error(f"{where}: Grid coordinates cannot be both negative")
             return None
         if row < 0:
             row = self.shape[0]
@@ -89,7 +89,7 @@ class figure_t(base_figure_t):
     def LocationOfFrame(self, frame: frame_t, /) -> tuple[int, int] | None:
         """"""
         if frame not in self.frames:
-            LOGGER.error(f"{frame}: Not a frame of the figure.")
+            L.error(f"{frame}: Not a frame of the figure.")
             return None
 
         where = self.frames.index(frame)

{babelplot-2025.1 → babelplot-2025.3}/package/babelplot/type/frame.py

@@ -10,7 +10,11 @@ import typing as h
 
 from babelplot.backend.specification.runtime import BackendPlots, BackendTranslations
 from babelplot.specification.dimension import FRAME_DIM_FOR_DATA_DIM, dim_e
-from babelplot.specification.plot import KNOWN_PLOT_TYPES, TranslatedArguments, plot_type_h
+from babelplot.specification.plot import (
+    KNOWN_PLOT_TYPES,
+    TranslatedArguments,
+    plot_type_h,
+)
 from babelplot.type.base import babelplot_element_t as base_frame_t
 from babelplot.type.base import backend_frame_h, backend_plot_h
 from babelplot.type.plot import BackendPlotFromAny, plot_t
@@ -85,12 +89,18 @@ class frame_t(base_frame_t):
 
     def NewBackendPlot(
         self,
+        _: backend_frame_h,
         type_: plot_type_w_pbe_h,
-        plot_function: h.Callable | None,
+        plot_function: (
+            type[backend_plot_h] | h.Callable[..., backend_plot_h | h.Any] | None
+        ),
         *args,
         title: str | None = None,
         **kwargs,
-    ) -> tuple[h.Any, type[backend_plot_h]]:
+    ) -> tuple[
+        backend_plot_h | h.Any,
+        type[backend_plot_h] | h.Callable[..., backend_plot_h | h.Any],
+    ]:
         """
         The returned object should be backend_plot_h. However, some backends might not
         have a specific class for each plot type. For example, Matplotlib returns an

{babelplot-2025.1 → babelplot-2025.3}/package/babelplot/version.py

@@ -4,7 +4,7 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2022
 SEE COPYRIGHT NOTICE BELOW
 """
 
-__version__ = "2025.1"
+__version__ = "2025.3"
 
 """
 COPYRIGHT NOTICE

{babelplot-2025.1 → babelplot-2025.3}/package/babelplot.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: babelplot
-Version: 2025.1
+Version: 2025.3
 Summary: A Meta Plotting Library That Speaks Several Backends
 Home-page: https://src.koda.cnrs.fr/eric.debreuve/babelplot/
 Author: Eric Debreuve
@@ -19,6 +19,18 @@ Description-Content-Type: text/x-rst
 Requires-Dist: numpy
 Requires-Dist: PyQt6
 Requires-Dist: scikit-image
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: project-url
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
 
 ..
    Copyright CNRS/Inria/UniCA