lets-plot 4.8.1rc1__cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl

lets_plot/frontend_context/_intellij_python_json_ctx.py

@@ -0,0 +1,38 @@
+#
+# Copyright (c) 2019. JetBrains s.r.o.
+# Use of this source code is governed by the MIT license that can be found in the LICENSE file.
+#
+
+from typing import Dict, Tuple
+
+from ._frontend_ctx import FrontendContext
+from ._mime_types import LETS_PLOT_JSON
+from .._type_utils import standardize_dict
+
+
+class IntellijPythonJsonContext(FrontendContext):
+
+    def configure(self, verbose: bool):
+        pass
+
+    def show(self, plot_spec: Dict) -> str:
+        plot_spec_std = standardize_dict(plot_spec)
+        data_object = DisplayDataObject(plot_spec_std)
+
+        # See intellij.python.helpers module in IDEA
+        from datalore.display import display
+        display(data_object)
+
+
+class DisplayDataObject():
+
+    def __init__(self, plot_spec: Dict) -> None:
+        super().__init__()
+        self.data_object = (LETS_PLOT_JSON, plot_spec)
+
+    def _repr_display_(self) -> Tuple[str, Dict]:
+        """
+        Special method discovered and invoked by datalore.display.display()
+        See: IDEA/community/python/helpers/pycharm_display/datalore/display/display_.py
+        """
+        return self.data_object

lets_plot/frontend_context/_isolated_webview_panel_ctx.py

@@ -0,0 +1,81 @@
+#
+# Copyright (c) 2025. JetBrains s.r.o.
+# Use of this source code is governed by the MIT license that can be found in the LICENSE file.
+#
+from typing import Dict
+
+from ._dynamic_configure_html import generate_dynamic_configure_html
+from ._frontend_ctx import FrontendContext
+from .. import _kbridge as kbr
+
+
+# noinspection PyPackageRequirements
+
+class IsolatedWebviewPanelContext(FrontendContext):
+
+    def __init__(self, offline: bool, *,
+                 width_mode: str = 'fit',
+                 height_mode: str = 'fit',
+                 width: float = None,
+                 height: float = None,
+                 responsive: bool = True,
+                 force_immediate_render: bool = False,
+                 height100pct: bool = True  # Set height to 100% the panel height
+                 ) -> None:
+        super().__init__()
+        self.connected = not offline
+        self.width_mode = width_mode
+        self.height_mode = height_mode
+        self.width = width
+        self.height = height
+        self.responsive = responsive
+        self.force_immediate_render = force_immediate_render
+        self.height100pct = height100pct
+
+    def configure(self, verbose: bool):
+        # Nothing here because everything is inside the WebView panel.
+        pass
+
+    def as_str(self, plot_spec: Dict) -> str:
+        # Build sizing_options
+        # Default to notebookCell sizing (MIN width, SCALED height) if not specified
+        if self.width_mode is not None and self.height_mode is not None:
+            # Use dev options
+            sizing_options = {
+                'width_mode': self.width_mode,
+                'height_mode': self.height_mode
+            }
+        else:
+            # Default to notebookCell sizing
+            sizing_options = {
+                'width_mode': 'min',
+                'height_mode': 'scaled'
+            }
+
+        # Add width and height if specified
+        if self.width is not None:
+            sizing_options['width'] = self.width
+        if self.height is not None:
+            sizing_options['height'] = self.height
+
+        # Generate dynamic configure HTML (verbose=False)
+        dynamic_configure_html = generate_dynamic_configure_html(
+            offline=not self.connected,
+            verbose=False
+        )
+
+        # Generate dynamic display HTML
+        dynamic_display_html = kbr._generate_display_html_for_raw_spec(
+            plot_spec,
+            sizing_options,
+            dynamic_script_loading=True,  # True for WebView panel
+            force_immediate_render=self.force_immediate_render,
+            responsive=self.responsive,
+            height100pct=self.height100pct
+        )
+
+        # Wrap both in a fixed position container
+        return f"""<div style="position: fixed; width: 100%; height: 100%;">
+{dynamic_configure_html}
+{dynamic_display_html}
+</div>"""

lets_plot/frontend_context/_json_contexts.py

@@ -0,0 +1,39 @@
+#  Copyright (c) 2020. JetBrains s.r.o.
+#  Use of this source code is governed by the MIT license that can be found in the LICENSE file.
+
+import os
+
+from ._frontend_ctx import FrontendContext
+from ._intellij_python_json_ctx import IntellijPythonJsonContext
+
+
+def _create_json_frontend_context() -> FrontendContext:
+    """
+    Configures Lets-Plot JSON output.
+
+    Such context requires a Lets-Plot JSON interpreter plugged in to the frontend env (like PyCharm)
+    """
+
+    if _is_Intellij_Python_Lets_Plot_Plugin():
+        return IntellijPythonJsonContext()
+
+    # ToDo: GenericJsonFrontendContext
+    raise RuntimeError("Couldn't detect Intellij Python environment")
+
+
+def _is_Intellij_Python_Lets_Plot_Plugin() -> bool:
+    try:
+        # An empty marker module defined by Intellij Lets-Plot plugin
+        # import lets_plot_intellij_python_plugin  <---- the old way.
+
+
+        # The check above is not working with PyCharm remote interpreter: https://github.com/JetBrains/lets-plot/issues/348
+
+        # 1) The "datalore.display" is present in both PyCharm and Datalore env.
+        #    See `intellij.python.helpers` module in IDEA.
+        from datalore.display import display
+
+        # 2) The "DATALORE_HOME" is only present in Datalore env but not in PyCharm env.
+        return "DATALORE_HOME" not in os.environ
+    except ImportError:
+        return False

lets_plot/frontend_context/_jupyter_notebook_ctx.py

@@ -0,0 +1,82 @@
+#
+# Copyright (c) 2019. JetBrains s.r.o.
+# Use of this source code is governed by the MIT license that can be found in the LICENSE file.
+#
+from typing import Dict
+
+try:
+    from IPython.display import display_html
+except ImportError:
+    display_html = None
+
+from ._frontend_ctx import FrontendContext
+from ._dynamic_configure_html import generate_dynamic_configure_html
+from .. import _kbridge as kbr
+
+
+class JupyterNotebookContext(FrontendContext):
+
+    requires_configure = True
+
+    def __init__(self, offline: bool, *,
+                 width_mode: str = 'min',
+                 height_mode: str = 'scaled',
+                 width: float = None,
+                 height: float = None,
+                 responsive: bool = False,
+                 force_immediate_render: bool = False,
+                 height100pct: bool = False
+                 ) -> None:
+        super().__init__()
+        self.connected = not offline
+        self.width_mode = width_mode
+        self.height_mode = height_mode
+        self.width = width
+        self.height = height
+        self.responsive = responsive
+        self.force_immediate_render = force_immediate_render
+        self.height100pct = height100pct
+
+    def configure(self, verbose: bool):
+        html = generate_dynamic_configure_html(offline=not self.connected, verbose=verbose)
+        # noinspection PyTypeChecker
+        display_html(html, raw=True)
+
+    def as_str(self, plot_spec: Dict) -> str:
+        # Old implementation (deprecated):
+        # return kbr._generate_dynamic_display_html(plot_spec)
+
+        # Build sizing_options
+        # Default to notebookCell sizing (MIN width, SCALED height) if not specified
+        # if self.width_mode is not None and self.height_mode is not None:
+        #     # Use dev options
+        #     sizing_options = {
+        #         'width_mode': self.width_mode,
+        #         'height_mode': self.height_mode
+        #     }
+        # else:
+        #     # Default to notebookCell sizing
+        #     sizing_options = {
+        #         'width_mode': 'min',
+        #         'height_mode': 'scaled'
+        #     }
+
+        sizing_options = {
+            'width_mode': self.width_mode,
+            'height_mode': self.height_mode
+        }
+
+        # Add width and height if specified
+        if self.width is not None:
+            sizing_options['width'] = self.width
+        if self.height is not None:
+            sizing_options['height'] = self.height
+
+        return kbr._generate_display_html_for_raw_spec(
+            plot_spec,
+            sizing_options,
+            dynamic_script_loading=True,  # True for Jupyter Notebook, JupyterLab
+            force_immediate_render=self.force_immediate_render,
+            responsive=self.responsive,
+            height100pct=self.height100pct
+        )

lets_plot/frontend_context/_mime_types.py

@@ -0,0 +1,7 @@
+#  Copyright (c) 2020. JetBrains s.r.o.
+#  Use of this source code is governed by the MIT license that can be found in the LICENSE file.
+
+# Supported MIME types
+TEXT_HTML = "text/html"
+LETS_PLOT_JSON = "application/vnd.lets-plot.v1+json"
+

lets_plot/frontend_context/_static_html_page_ctx.py

@@ -0,0 +1,76 @@
+#
+# Copyright (c) 2019. JetBrains s.r.o.
+# Use of this source code is governed by the MIT license that can be found in the LICENSE file.
+#
+from typing import Dict
+
+from ._frontend_ctx import FrontendContext
+from .. import _kbridge as kbr
+
+
+# noinspection PyPackageRequirements
+
+
+class StaticHtmlPageContext(FrontendContext):
+
+    def __init__(self, offline: bool, *,
+                 width_mode: str = 'min',
+                 height_mode: str = 'scaled',
+                 width: float = None,
+                 height: float = None,
+                 responsive: bool = False,
+                 force_immediate_render: bool = False,
+                 height100pct: bool = False,
+                 ) -> None:
+        super().__init__()
+        self.connected = not offline
+        self.width_mode = width_mode
+        self.height_mode = height_mode
+        self.width = width
+        self.height = height
+        self.responsive = responsive
+        self.force_immediate_render = force_immediate_render
+        self.height100pct = height100pct
+
+    def configure(self, verbose: bool):
+        # Nothing here because the complete HTML page is created per each cell output.
+        if not self.connected:
+            print("WARN: Embedding Lets-Plot JS library for offline usage is not supported.")
+
+    def as_str(self, plot_spec: Dict) -> str:
+        # Old implementation (uses static HTML page generator):
+        # return kbr._generate_static_html_page(plot_spec, iframe=False)
+
+        # Build sizing_options
+        # Default to notebookCell sizing (MIN width, SCALED height) if not specified
+        # if self.width_mode is not None and self.height_mode is not None:
+        #     # Use dev options
+        #     sizing_options = {
+        #         'width_mode': self.width_mode,
+        #         'height_mode': self.height_mode
+        #     }
+        # else:
+        #     # Default to notebookCell sizing
+        #     sizing_options = {
+        #         'width_mode': 'min',
+        #         'height_mode': 'scaled'
+        #     }
+        sizing_options = {
+            'width_mode': self.width_mode,
+            'height_mode': self.height_mode
+        }
+
+        # Add width and height if specified
+        if self.width is not None:
+            sizing_options['width'] = self.width
+        if self.height is not None:
+            sizing_options['height'] = self.height
+
+        return kbr._generate_static_html_page_for_raw_spec(
+            plot_spec,
+            sizing_options,
+            dynamic_script_loading=False,  # False for static HTML pages
+            force_immediate_render=self.force_immediate_render,
+            responsive=self.responsive,
+            height100pct=self.height100pct
+        )

lets_plot/frontend_context/_static_svg_ctx.py

@@ -0,0 +1,26 @@
+#
+# Copyright (c) 2020. JetBrains s.r.o.
+# Use of this source code is governed by the MIT license that can be found in the LICENSE file.
+#
+from typing import Dict
+
+from ._frontend_ctx import FrontendContext
+from .. import _kbridge as kbr
+from .._version import __version__
+
+
+class StaticSvgImageContext(FrontendContext):
+
+    def configure(self, verbose: bool):
+        if verbose:
+            message = '<div style="color:darkblue;">Lets-Plot v{}: static SVG output configured.</div>'.format(
+                __version__)
+            try:
+                from IPython.display import display_html
+                display_html(message, raw=True)
+            except ImportError:
+                pass
+                print(message)
+
+    def as_str(self, plot_spec: Dict) -> str:
+        return kbr._generate_svg(plot_spec)

lets_plot/frontend_context/_webbr_html_page_ctx.py

@@ -0,0 +1,29 @@
+#
+# Copyright (c) 2019. JetBrains s.r.o.
+# Use of this source code is governed by the MIT license that can be found in the LICENSE file.
+#
+import io
+import webbrowser
+import tempfile
+from typing import Dict
+
+from ._frontend_ctx import FrontendContext
+from .. import _kbridge as kbr
+
+
+class WebBrHtmlPageContext(FrontendContext):
+
+    def __init__(self, exec: str, new: bool) -> None:
+        super().__init__()
+        self.exec = exec
+        self.new = new
+
+    def show(self, plot_spec: Dict) -> str:
+        html_page = kbr._generate_static_html_page(plot_spec, iframe=False)
+
+        path = tempfile.NamedTemporaryFile(mode='w+t', suffix=".html", delete=False)
+        try:
+            io.open(path.name, 'w+t').write(html_page)
+            webbrowser.get(self.exec).open('file://' + path.name, new=1 if self.new else 2)
+        finally:
+            path.close()

lets_plot/frontend_context/sandbox.py

@@ -0,0 +1,5 @@
+#
+# Copyright (c) 2019. JetBrains s.r.o.
+# Use of this source code is governed by the MIT license that can be found in the LICENSE file.
+#
+

lets_plot/geo_data/__init__.py

@@ -0,0 +1,19 @@
+try:
+    import geopandas
+except ImportError:
+    print("geopandas is required for using the geo_data package")
+    raise
+
+from .core import *
+from .geocoder import *
+from .geocodes import *
+
+__all__ = core.__all__
+
+#  Use geo_data package only for executing geocoding requests.
+#  For accessing variuous checks, contants, types etc use package geo_data_internals
+#  as it won't cause the OSM attribution to appear.
+
+# print on the package import
+print("The geodata is provided by © OpenStreetMap contributors"
+      " and is made available here under the Open Database License (ODbL).")