PyPI - syd - Versions diffs - 0.1.7__py3-none-any.whl → 0.2.0__py3-none-any.whl - Mend

syd 0.1.7py3-none-any.whl → 0.2.0py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (28) hide show

syd/__init__.py +1 -1
syd/flask_deployment/__init__.py +7 -1
syd/flask_deployment/deployer.py +548 -209
syd/flask_deployment/static/__init__.py +1 -0
syd/flask_deployment/static/css/styles.css +246 -0
syd/flask_deployment/static/js/viewer.js +710 -140
syd/flask_deployment/templates/__init__.py +1 -0
syd/flask_deployment/templates/index.html +34 -0
syd/flask_deployment/testing_principles.md +4 -4
syd/notebook_deployment/deployer.py +15 -5
syd/notebook_deployment/widgets.py +76 -58
syd/parameters.py +239 -250
syd/support.py +168 -0
syd/viewer.py +305 -346
syd-0.2.0.dist-info/METADATA +126 -0
syd-0.2.0.dist-info/RECORD +19 -0
syd/flask_deployment/components.py +0 -510
syd/flask_deployment/static/css/viewer.css +0 -82
syd/flask_deployment/templates/base.html +0 -29
syd/flask_deployment/templates/viewer.html +0 -51
syd/notebook_deployment/_ipympl_deployer.py +0 -258
syd/plotly_deployment/__init__.py +0 -1
syd/plotly_deployment/components.py +0 -531
syd/plotly_deployment/deployer.py +0 -376
syd-0.1.7.dist-info/METADATA +0 -120
syd-0.1.7.dist-info/RECORD +0 -22
{syd-0.1.7.dist-info → syd-0.2.0.dist-info}/WHEEL +0 -0
{syd-0.1.7.dist-info → syd-0.2.0.dist-info}/licenses/LICENSE +0 -0

syd/flask_deployment/templates/__init__.py ADDED Viewed

	@@ -0,0 +1 @@
1	+ # This file exists to make the directory a proper Python package

syd/flask_deployment/templates/index.html ADDED Viewed

@@ -0,0 +1,34 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <title>Syd Viewer</title>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <link rel="stylesheet" href="{{ url_for('static', filename='css/styles.css') }}">
+</head>
+<body>
+    <div class="viewer-container" data-controls-position="{{ config.controls_position }}">
+        <div class="controls-container" data-width-percent="{{ config.controls_width_percent }}"
+             {% if config.is_horizontal %}style="width: {{ config.controls_width_percent }}%;"{% else %}style="height: {{ config.controls_width_percent }}%;"{% endif %}>
+            <div id="controls-container">
+                <!-- Controls will be dynamically generated via JavaScript -->
+            </div>
+        </div>
+        <div class="plot-container"
+             {% if config.is_horizontal %}style="width: calc(100% - {{ config.controls_width_percent }}%);"{% else %}style="height: calc(100% - {{ config.controls_width_percent }}%);"{% endif %}>
+            <img id="plot-image" width="100%" height="100%">
+        </div>
+    </div>
+    <!-- Store config as data attributes for JS to access -->
+    <div id="viewer-config"
+         data-figure-width="{{ config.figure_width }}"
+         data-figure-height="{{ config.figure_height }}"
+         data-controls-position="{{ config.controls_position }}"
+         data-controls-width-percent="{{ config.controls_width_percent }}"
+         style="display:none;"></div>
+    <script src="{{ url_for('static', filename='js/viewer.js') }}"></script>
+</body>
+</html>

syd/flask_deployment/testing_principles.md CHANGED Viewed

@@ -57,7 +57,7 @@ class TestFlaskDeployerComponents(unittest.TestCase):
 def test_parameter_update_state_sync():
     # Create real viewer with test parameters
     viewer = Viewer()
-    viewer.add_float('test_param', value=1.0, min_value=0, max_value=10)
+    viewer.add_float('test_param', value=1.0, min=0, max=10)
     # Create deployer with this viewer
     deployer = FlaskDeployer(viewer)
@@ -82,7 +82,7 @@ def test_parameter_update_state_sync():
 ```python
 def test_update_parameter_endpoint():
     viewer = Viewer()
-    viewer.add_float('test_param', value=1.0, min_value=0, max_value=10)
+    viewer.add_float('test_param', value=1.0, min=0, max=10)
     deployer = FlaskDeployer(viewer)
     app = deployer.app
@@ -218,8 +218,8 @@ def standard_test_viewer():
         return fig
     viewer.set_plot(plot)
-    viewer.add_float('amplitude', value=1.0, min_value=0, max_value=2)
-    viewer.add_float('frequency', value=1.0, min_value=0.1, max_value=5)
+    viewer.add_float('amplitude', value=1.0, min=0, max=2)
+    viewer.add_float('frequency', value=1.0, min=0.1, max=5)
     return viewer

syd/notebook_deployment/deployer.py CHANGED Viewed

@@ -67,7 +67,7 @@ class LayoutConfig:
     controls_position: str = "left"  # Options are: 'left', 'top', 'right', 'bottom'
     figure_width: float = 8.0
     figure_height: float = 6.0
-    controls_width_percent: int = 30
+    controls_width_percent: int = 20
     def __post_init__(self):
         valid_positions = ["left", "top", "right", "bottom"]
@@ -93,7 +93,7 @@ class NotebookDeployer:
         controls_position: str = "left",
         figure_width: float = 8.0,
         figure_height: float = 6.0,
-        controls_width_percent: int = 30,
+        controls_width_percent: int = 20,
         continuous: bool = False,
         suppress_warnings: bool = False,
     ):
@@ -111,7 +111,7 @@ class NotebookDeployer:
         self.backend_type = get_backend_type()
         if self.backend_type not in ["inline", "widget"]:
             warnings.warn(
-                "The current backend is not supported. Please use %matplotlib widget or %matplotlib inline.\n"
+                f"The current backend ({self.backend_type}) is not supported. Please use %matplotlib widget or %matplotlib inline.\n"
                 "The behavior of the viewer will almost definitely not work as expected."
             )
         self.parameter_widgets: Dict[str, BaseWidget] = {}
@@ -134,8 +134,8 @@ class NotebookDeployer:
         if self.config.is_horizontal:
             controls["controls_width"] = widgets.IntSlider(
                 value=self.config.controls_width_percent,
-                min=20,
-                max=80,
+                min=10,
+                max=50,
                 description="Controls Width %",
                 continuous=True,
                 layout=widgets.Layout(width="95%"),
@@ -227,6 +227,9 @@ class NotebookDeployer:
         with _plot_context():
             figure = self.viewer.plot(state)
+        # Update widgets if plot function updated a parameter
+        self._sync_widgets_with_state()
         # Close the last figure if it exists to keep matplotlib clean
         # (just moved this from after clear_output.... noting!)
         if self._last_figure is not None:
@@ -269,6 +272,13 @@ class NotebookDeployer:
                 + list(self.layout_widgets.values()),
                 layout=widgets.Layout(margin="10px 0px"),
             )
+            # Register the controls_width slider's observer
+            if "controls_width" in self.layout_widgets:
+                self.layout_widgets["controls_width"].observe(
+                    self._handle_container_width_change, names="value"
+                )
             widgets_elements = [param_box, layout_box]
         else:
             widgets_elements = [param_box]

syd/notebook_deployment/widgets.py CHANGED Viewed

@@ -240,30 +240,33 @@ class IntegerWidget(BaseWidget[IntegerParameter, widgets.IntSlider]):
         margin: str = "3px 0px",
         description_width: str = "initial",
     ) -> widgets.IntSlider:
+        """Create the integer slider widget."""
         return widgets.IntSlider(
             value=parameter.value,
-            min=parameter.min_value,
-            max=parameter.max_value,
+            min=parameter.min,
+            max=parameter.max,
+            step=1,
             description=parameter.name,
-            continuous=continuous,
-            layout=widgets.Layout(width=width, margin=margin),
+            continuous_update=continuous,
             style={"description_width": description_width},
+            layout=widgets.Layout(width=width, margin=margin),
         )
     def matches_parameter(self, parameter: IntegerParameter) -> bool:
-        """Check if the widget matches the parameter."""
+        """Check if the widget values match the parameter."""
         return (
-            self.value == parameter.value
-            and self._widget.min == parameter.min_value
-            and self._widget.max == parameter.max_value
+            self._widget.description == parameter.name
+            and self._widget.value == parameter.value
+            and self._widget.min == parameter.min
+            and self._widget.max == parameter.max
         )
     def extra_updates_from_parameter(self, parameter: IntegerParameter) -> None:
-        """Extra updates from the parameter."""
+        """Update the widget attributes from the parameter."""
         current_value = self._widget.value
-        self._widget.min = parameter.min_value
-        self._widget.max = parameter.max_value
-        self.value = max(parameter.min_value, min(parameter.max_value, current_value))
+        self._widget.min = parameter.min
+        self._widget.max = parameter.max
+        self.value = max(parameter.min, min(parameter.max, current_value))
 class FloatWidget(BaseWidget[FloatParameter, widgets.FloatSlider]):
@@ -277,32 +280,35 @@ class FloatWidget(BaseWidget[FloatParameter, widgets.FloatSlider]):
         margin: str = "3px 0px",
         description_width: str = "initial",
     ) -> widgets.FloatSlider:
+        """Create the float slider widget."""
         return widgets.FloatSlider(
             value=parameter.value,
-            min=parameter.min_value,
-            max=parameter.max_value,
+            min=parameter.min,
+            max=parameter.max,
             step=parameter.step,
             description=parameter.name,
-            continuous=continuous,
-            layout=widgets.Layout(width=width, margin=margin),
+            continuous_update=continuous,
             style={"description_width": description_width},
+            layout=widgets.Layout(width=width, margin=margin),
         )
     def matches_parameter(self, parameter: FloatParameter) -> bool:
-        """Check if the widget matches the parameter."""
+        """Check if the widget values match the parameter."""
         return (
-            self.value == parameter.value
-            and self._widget.min == parameter.min_value
-            and self._widget.max == parameter.max_value
+            self._widget.description == parameter.name
+            and self._widget.value == parameter.value
+            and self._widget.min == parameter.min
+            and self._widget.max == parameter.max
+            and self._widget.step == parameter.step
         )
     def extra_updates_from_parameter(self, parameter: FloatParameter) -> None:
-        """Extra updates from the parameter."""
+        """Update the widget attributes from the parameter."""
         current_value = self._widget.value
-        self._widget.min = parameter.min_value
-        self._widget.max = parameter.max_value
+        self._widget.min = parameter.min
+        self._widget.max = parameter.max
         self._widget.step = parameter.step
-        self.value = max(parameter.min_value, min(parameter.max_value, current_value))
+        self.value = max(parameter.min, min(parameter.max, current_value))
 class IntegerRangeWidget(BaseWidget[IntegerRangeParameter, widgets.IntRangeSlider]):
@@ -316,33 +322,39 @@ class IntegerRangeWidget(BaseWidget[IntegerRangeParameter, widgets.IntRangeSlide
         margin: str = "3px 0px",
         description_width: str = "initial",
     ) -> widgets.IntRangeSlider:
+        """Create the integer range slider widget."""
+        low, high = parameter.value
         return widgets.IntRangeSlider(
-            value=parameter.value,
-            min=parameter.min_value,
-            max=parameter.max_value,
+            value=[low, high],
+            min=parameter.min,
+            max=parameter.max,
+            step=1,
             description=parameter.name,
-            continuous=continuous,
-            layout=widgets.Layout(width=width, margin=margin),
+            continuous_update=continuous,
             style={"description_width": description_width},
+            layout=widgets.Layout(width=width, margin=margin),
         )
     def matches_parameter(self, parameter: IntegerRangeParameter) -> bool:
-        """Check if the widget matches the parameter."""
+        """Check if the widget values match the parameter."""
+        low, high = parameter.value
         return (
-            self.value == parameter.value
-            and self._widget.min == parameter.min_value
-            and self._widget.max == parameter.max_value
+            self._widget.description == parameter.name
+            and self._widget.value[0] == low
+            and self._widget.value[1] == high
+            and self._widget.min == parameter.min
+            and self._widget.max == parameter.max
         )
     def extra_updates_from_parameter(self, parameter: IntegerRangeParameter) -> None:
-        """Extra updates from the parameter."""
-        current_value = self._widget.value
-        self._widget.min = parameter.min_value
-        self._widget.max = parameter.max_value
-        low, high = current_value
-        low = max(parameter.min_value, min(parameter.max_value, low))
-        high = max(parameter.min_value, min(parameter.max_value, high))
-        self.value = (low, high)
+        """Update the widget attributes from the parameter."""
+        low, high = self._widget.value
+        self._widget.min = parameter.min
+        self._widget.max = parameter.max
+        # Ensure values stay within bounds
+        low = max(parameter.min, min(parameter.max, low))
+        high = max(parameter.min, min(parameter.max, high))
+        self.value = [low, high]
 class FloatRangeWidget(BaseWidget[FloatRangeParameter, widgets.FloatRangeSlider]):
@@ -356,35 +368,41 @@ class FloatRangeWidget(BaseWidget[FloatRangeParameter, widgets.FloatRangeSlider]
         margin: str = "3px 0px",
         description_width: str = "initial",
     ) -> widgets.FloatRangeSlider:
+        """Create the float range slider widget."""
+        low, high = parameter.value
         return widgets.FloatRangeSlider(
-            value=parameter.value,
-            min=parameter.min_value,
-            max=parameter.max_value,
+            value=[low, high],
+            min=parameter.min,
+            max=parameter.max,
             step=parameter.step,
             description=parameter.name,
-            continuous=continuous,
-            layout=widgets.Layout(width=width, margin=margin),
+            continuous_update=continuous,
             style={"description_width": description_width},
+            layout=widgets.Layout(width=width, margin=margin),
         )
     def matches_parameter(self, parameter: FloatRangeParameter) -> bool:
-        """Check if the widget matches the parameter."""
+        """Check if the widget values match the parameter."""
+        low, high = parameter.value
         return (
-            self.value == parameter.value
-            and self._widget.min == parameter.min_value
-            and self._widget.max == parameter.max_value
+            self._widget.description == parameter.name
+            and self._widget.value[0] == low
+            and self._widget.value[1] == high
+            and self._widget.min == parameter.min
+            and self._widget.max == parameter.max
+            and self._widget.step == parameter.step
         )
     def extra_updates_from_parameter(self, parameter: FloatRangeParameter) -> None:
-        """Extra updates from the parameter."""
-        current_value = self._widget.value
-        self._widget.min = parameter.min_value
-        self._widget.max = parameter.max_value
+        """Update the widget attributes from the parameter."""
+        low, high = self._widget.value
+        self._widget.min = parameter.min
+        self._widget.max = parameter.max
         self._widget.step = parameter.step
-        low, high = current_value
-        low = max(parameter.min_value, min(parameter.max_value, low))
-        high = max(parameter.min_value, min(parameter.max_value, high))
-        self.value = (low, high)
+        # Ensure values stay within bounds
+        low = max(parameter.min, min(parameter.max, low))
+        high = max(parameter.min, min(parameter.max, high))
+        self.value = [low, high]
 class UnboundedIntegerWidget(BaseWidget[UnboundedIntegerParameter, widgets.IntText]):

syd 0.1.7__py3-none-any.whl → 0.2.0__py3-none-any.whl

syd 0.1.7py3-none-any.whl → 0.2.0py3-none-any.whl