babelplot 2025.3__tar.gz → 2025.5__tar.gz

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

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: babelplot
-Version: 2025.3
+Version: 2025.5
 Summary: A Meta Plotting Library That Speaks Several Backends
 Home-page: https://src.koda.cnrs.fr/eric.debreuve/babelplot/
 Author: Eric Debreuve

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

@@ -17,10 +17,10 @@ else:
     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
+from babelplot.task.instantiation import NewFigure, NewPlot
+from babelplot.type.dimension import dim_e
 from babelplot.type.figure import ShowAllFigures
+from babelplot.type.plot_definition import plot_e
 from babelplot.version import __version__
 
 """

babelplot-2025.5/package/babelplot/api/backend.py

@@ -0,0 +1,54 @@
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2022
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+from babelplot.backend.helper.creation import PrintBackendDraft  # noqa
+from babelplot.backend.helper.validation import CheckBackend  # noqa
+
+"""
+COPYRIGHT NOTICE
+
+This software is governed by the CeCILL  license under French law and
+abiding by the rules of distribution of free software.  You can  use,
+modify and/ or redistribute the software under the terms of the CeCILL
+license as circulated by CEA, CNRS and INRIA at the following URL
+"http://www.cecill.info".
+
+As a counterpart to the access to the source code and  rights to copy,
+modify and redistribute granted by the license, users are provided only
+with a limited warranty  and the software's author,  the holder of the
+economic rights,  and the successive licensors  have only  limited
+liability.
+
+In this respect, the user's attention is drawn to the risks associated
+with loading,  using,  modifying and/or developing or reproducing the
+software by the user in light of its specific status of free software,
+that may mean  that it is complicated to manipulate,  and  that  also
+therefore means  that it is reserved for developers  and  experienced
+professionals having in-depth computer knowledge. Users are therefore
+encouraged to load and test the software's suitability as regards their
+requirements in conditions enabling the security of their systems and/or
+data to be ensured and,  more generally, to use and operate it in the
+same conditions as regards security.
+
+The fact that you are presently reading this means that you have had
+knowledge of the CeCILL license and that you accept its terms.
+
+SEE LICENCE NOTICE: file README-LICENCE-utf8.txt at project source root.
+
+This software is being developed by Eric Debreuve, a CNRS employee and
+member of team Morpheme.
+Team Morpheme is a joint team between Inria, CNRS, and UniCA.
+It is hosted by the Centre Inria d'Université Côte d'Azur, Laboratory
+I3S, and Laboratory iBV.
+
+CNRS: https://www.cnrs.fr/index.php/en
+Inria: https://www.inria.fr/en/
+UniCA: https://univ-cotedazur.eu/
+Centre Inria d'Université Côte d'Azur: https://www.inria.fr/en/centre/sophia/
+I3S: https://www.i3s.unice.fr/en/
+iBV: http://ibv.unice.fr/
+Team Morpheme: https://team.inria.fr/morpheme/
+"""

babelplot-2025.5/package/babelplot/api/definition.py

@@ -0,0 +1,54 @@
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2022
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+from babelplot.type.dimension import dim_e  # noqa
+from babelplot.type.plot_definition import plot_e  # noqa
+
+"""
+COPYRIGHT NOTICE
+
+This software is governed by the CeCILL  license under French law and
+abiding by the rules of distribution of free software.  You can  use,
+modify and/ or redistribute the software under the terms of the CeCILL
+license as circulated by CEA, CNRS and INRIA at the following URL
+"http://www.cecill.info".
+
+As a counterpart to the access to the source code and  rights to copy,
+modify and redistribute granted by the license, users are provided only
+with a limited warranty  and the software's author,  the holder of the
+economic rights,  and the successive licensors  have only  limited
+liability.
+
+In this respect, the user's attention is drawn to the risks associated
+with loading,  using,  modifying and/or developing or reproducing the
+software by the user in light of its specific status of free software,
+that may mean  that it is complicated to manipulate,  and  that  also
+therefore means  that it is reserved for developers  and  experienced
+professionals having in-depth computer knowledge. Users are therefore
+encouraged to load and test the software's suitability as regards their
+requirements in conditions enabling the security of their systems and/or
+data to be ensured and,  more generally, to use and operate it in the
+same conditions as regards security.
+
+The fact that you are presently reading this means that you have had
+knowledge of the CeCILL license and that you accept its terms.
+
+SEE LICENCE NOTICE: file README-LICENCE-utf8.txt at project source root.
+
+This software is being developed by Eric Debreuve, a CNRS employee and
+member of team Morpheme.
+Team Morpheme is a joint team between Inria, CNRS, and UniCA.
+It is hosted by the Centre Inria d'Université Côte d'Azur, Laboratory
+I3S, and Laboratory iBV.
+
+CNRS: https://www.cnrs.fr/index.php/en
+Inria: https://www.inria.fr/en/
+UniCA: https://univ-cotedazur.eu/
+Centre Inria d'Université Côte d'Azur: https://www.inria.fr/en/centre/sophia/
+I3S: https://www.i3s.unice.fr/en/
+iBV: http://ibv.unice.fr/
+Team Morpheme: https://team.inria.fr/morpheme/
+"""

babelplot-2025.5/package/babelplot/api/help.py

@@ -0,0 +1,54 @@
+"""
+Copyright CNRS/Inria/UniCA
+Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2022
+SEE COPYRIGHT NOTICE BELOW
+"""
+
+from babelplot.task.help import Main as PrintHelp  # noqa
+from babelplot.task.help import PrintUsage  # noqa
+
+"""
+COPYRIGHT NOTICE
+
+This software is governed by the CeCILL  license under French law and
+abiding by the rules of distribution of free software.  You can  use,
+modify and/ or redistribute the software under the terms of the CeCILL
+license as circulated by CEA, CNRS and INRIA at the following URL
+"http://www.cecill.info".
+
+As a counterpart to the access to the source code and  rights to copy,
+modify and redistribute granted by the license, users are provided only
+with a limited warranty  and the software's author,  the holder of the
+economic rights,  and the successive licensors  have only  limited
+liability.
+
+In this respect, the user's attention is drawn to the risks associated
+with loading,  using,  modifying and/or developing or reproducing the
+software by the user in light of its specific status of free software,
+that may mean  that it is complicated to manipulate,  and  that  also
+therefore means  that it is reserved for developers  and  experienced
+professionals having in-depth computer knowledge. Users are therefore
+encouraged to load and test the software's suitability as regards their
+requirements in conditions enabling the security of their systems and/or
+data to be ensured and,  more generally, to use and operate it in the
+same conditions as regards security.
+
+The fact that you are presently reading this means that you have had
+knowledge of the CeCILL license and that you accept its terms.
+
+SEE LICENCE NOTICE: file README-LICENCE-utf8.txt at project source root.
+
+This software is being developed by Eric Debreuve, a CNRS employee and
+member of team Morpheme.
+Team Morpheme is a joint team between Inria, CNRS, and UniCA.
+It is hosted by the Centre Inria d'Université Côte d'Azur, Laboratory
+I3S, and Laboratory iBV.
+
+CNRS: https://www.cnrs.fr/index.php/en
+Inria: https://www.inria.fr/en/
+UniCA: https://univ-cotedazur.eu/
+Centre Inria d'Université Côte d'Azur: https://www.inria.fr/en/centre/sophia/
+I3S: https://www.i3s.unice.fr/en/
+iBV: http://ibv.unice.fr/
+Team Morpheme: https://team.inria.fr/morpheme/
+"""

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

@@ -4,19 +4,16 @@ Contributor(s): Eric Debreuve (eric.debreuve@cnrs.fr) since 2022
 SEE COPYRIGHT NOTICE BELOW
 """
 
-from __future__ import annotations
-
+import dataclasses as d
 import typing as h
 
-from babelplot.backend.specification.backend import backend_e
-from babelplot.specification.dimension import dim_e
-from babelplot.specification.plot import PlotsFromTemplate, plot_e, plot_type_h
 from babelplot.task.show_pyqt6 import Show
+from babelplot.type.dimension import dim_e
 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 babelplot.type.plot_definition import PlotsFromTemplate, plot_e, plot_type_h
 from bokeh.embed import file_html as HTMLofBackendContent  # noqa
-from bokeh.layouts import LayoutDOM as backend_content_t  # noqa
 from bokeh.layouts import column as NewBackendColLayout  # noqa
 from bokeh.layouts import grid as NewBackendGridLayout  # noqa
 from bokeh.layouts import row as NewBackendRowLayout  # noqa
@@ -24,96 +21,99 @@ from bokeh.models.renderers import GlyphRenderer as backend_plot_t  # noqa
 from bokeh.plotting import figure as backend_figure_t  # noqa
 from bokeh.resources import INLINE  # noqa
 
-NAME = backend_e.BOKEH.value
+# from bokeh.layouts import LayoutDOM as backend_content_t  # noqa
+
+NAME = "bokeh"
 
 
 backend_frame_t = backend_figure_t
 
 
-def _NewPlot(
-    frame: backend_frame_t,
-    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[
-    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_):
-            plot_function = getattr(backend_frame_t, type_)
-        else:
-            raise ValueError(f"{type_}: Unknown {NAME} graph object.")
-
-    return plot_function(frame, *args, **kwargs), plot_function
-
-
-def _NewFrame(
-    _: backend_figure_t,
-    __: int,
-    ___: int,
-    *args,
-    title: str | None = None,
-    dim: dim_e = dim_e.XY,  # If _, then it is swallowed by kwargs!
-    **kwargs,
-) -> backend_frame_t:
-    """"""
-    return backend_frame_t(*args, title=title, **kwargs)
-
-
-def _AdjustLayout(figure: figure_t, /) -> None:
-    """"""
-    n_rows, n_cols = figure.shape
-    arranged_frames = [n_cols * [None] for _ in range(n_rows)]
-    for frame, (row, col) in zip(figure.frames, figure.locations):
-        arranged_frames[row][col] = frame.backend
-    arranged_frames: list[list[backend_frame_t]]
-
-    if n_rows > 1:
-        if n_cols > 1:
-            layout = NewBackendGridLayout(arranged_frames)
+@d.dataclass(slots=True, repr=False, eq=False)
+class plot_t(base_plot_t): ...
+
+
+@d.dataclass(slots=True, repr=False, eq=False)
+class frame_t(base_frame_t):
+
+    def _NewPlot(
+        self,
+        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,
+    ) -> plot_t:
+        """"""
+        output = plot_t(
+            title=title,
+            property=kwargs.copy(),
+            backend_name=self.backend_name,
+        )
+
+        if plot_function is None:
+            if hasattr(backend_frame_t, type_):
+                plot_function = getattr(backend_frame_t, type_)
+            else:
+                raise ValueError(f"{type_}: Unknown {NAME} graph object.")
+
+        output.backend_type = plot_function
+        output.raw = plot_function(self.raw, *args, **kwargs)
+
+        return output
+
+
+@d.dataclass(slots=True, repr=False, eq=False)
+class figure_t(base_figure_t):
+    layout: h.Any = None
+
+    _NewBackendFigure = backend_figure_t
+    _BackendShow = Show
+
+    def _NewFrame(
+        self,
+        row: int,
+        col: int,
+        *args,
+        title: str | None = None,
+        dim: dim_e = dim_e.XY,  # If _, then it is swallowed by kwargs!
+        **kwargs,
+    ) -> frame_t:
+        """"""
+        output = frame_t(
+            title=title,
+            dim=dim,
+            backend_name=self.backend_name,
+        )
+
+        output.raw = backend_frame_t(*args, title=title, **kwargs)
+
+        return output
+
+    def AdjustLayout(self) -> None:
+        """"""
+        n_rows, n_cols = self.shape
+        arranged_frames = [n_cols * [None] for _ in range(n_rows)]
+        for frame, (row, col) in zip(self.frames, self.locations):
+            arranged_frames[row][col] = frame.raw
+        arranged_frames: list[list[backend_frame_t]]
+
+        if n_rows > 1:
+            if n_cols > 1:
+                layout = NewBackendGridLayout(arranged_frames)
+            else:
+                column = [_row[0] for _row in arranged_frames]
+                layout = NewBackendColLayout(column)
         else:
-            column = [_row[0] for _row in arranged_frames]
-            layout = NewBackendColLayout(column)
-    else:
-        layout = NewBackendRowLayout(arranged_frames[0])
-
-    figure.layout = layout
-
-
-def _AsHTML(figure: figure_t, /) -> str:
-    """"""
-
-    return HTMLofBackendContent(figure.layout, INLINE)
-
-
-# noinspection PyTypeChecker
-plot_t: type[base_plot_t] = type("plot_t", (base_plot_t,), {})
-# noinspection PyTypeChecker
-frame_t: type[base_frame_t] = type(
-    "frame_t",
-    (base_frame_t,),
-    {"plot_class": plot_t, "NewBackendPlot": staticmethod(_NewPlot)},
-)
-# noinspection PyTypeChecker
-figure_t: type[base_figure_t] = type(
-    "figure_t",
-    (base_figure_t,),
-    {
-        "frame_class": frame_t,
-        "NewBackendFigure": backend_figure_t,
-        "NewBackendFrame": staticmethod(_NewFrame),
-        "AdjustLayout": _AdjustLayout,
-        "BackendShow": Show,
-        "layout": None,
-        "AsHTML": _AsHTML,
-    },
-)
+            layout = NewBackendRowLayout(arranged_frames[0])
+
+        self.layout = layout
+
+    def AsHTML(self) -> str:
+        """"""
+        return HTMLofBackendContent(self.layout, INLINE)
 
 
 PLOTS = PlotsFromTemplate()