syd 1.2.5__py3-none-any.whl → 1.2.6__py3-none-any.whl

syd/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "1.2.5"
+__version__ = "1.2.6"
 
 from .viewer import make_viewer, Viewer
 from .support import show_open_servers, close_servers

syd/flask_deployment/deployer.py

@@ -396,49 +396,14 @@ class FlaskDeployer:
                 "Flask app not built. Call build_layout() before display()."
             )
 
+        print(self.port, self.host)
+
         # Find an available port if none is specified
-        self.port = port or _find_available_port()
         self.host = host or socket.gethostbyname(socket.gethostname())
+        self.port = port or _find_available_port(address=self.host)
         self.url = f"http://{self.host}:{self.port}"
         print(f" * Syd Flask server running on {self.url}")
 
-        # if open_browser:
-
-        #     def wait_until_responsive(url, timeout=self.timeout_threshold):
-        #         start_time = time.time()
-        #         while time.time() - start_time < timeout:
-        #             try:
-        #                 r = requests.get(url, timeout=0.5)
-        #                 if r.status_code == 200:
-        #                     return True
-        #             except requests.exceptions.RequestException:
-        #                 pass
-        #             time.sleep(0.1)
-        #         return False
-
-        #     def open_browser_tab_when_ready():
-        #         if wait_until_responsive(self.url):
-        #             out = webbrowser.open(self.url, new=1, autoraise=True)
-        #         else:
-        #             print(
-        #                 f"Could not open browser: server at {self.url} not responding."
-        #                 f"Increase the timeout_threshold to fix this! It's set to {self.timeout_threshold} seconds."
-        #                 "You can do this from viewer.show(timeout_threshold=...) or in the FlaskDeployer constructor."
-        #                 "Also, this is unexpected so please report this issue on GitHub."
-        #             )
-
-        #     threading.Thread(target=open_browser_tab_when_ready, daemon=True).start()
-
-        # # Run the Flask server using Werkzeug's run_simple
-        # # Pass debug status to run_simple for auto-reloading
-        # run_simple(
-        #     self.host,
-        #     self.port,
-        #     self.app,
-        #     use_reloader=False,
-        #     use_debugger=self.debug,
-        # )
-
         # 1) Spin up the server thread
         srv_thread = ServerThread(self.host, self.port, self.app, debug=self.debug)
         srv_thread.start()
@@ -460,7 +425,7 @@ class FlaskDeployer:
         """
         Deploy the viewer using Flask.
 
-        Builds components (no-op), layout (Flask app/routes),
+        Builds components, layout (Flask app/routes),
         and then starts the server.
         """
         # build_layout creates the Flask app and routes
@@ -704,14 +669,15 @@ class FlaskDeployer:
             )
 
 
-def _find_available_port(start_port=5000, max_attempts=1000):
+def _find_available_port(
+    start_port=5000,
+    max_attempts=1000,
+    address: str = "127.0.0.1",
+):
     """
     Find an available port starting from start_port.
-    (Identical to original)
     """
     for port in range(start_port, start_port + max_attempts):
-        # Use localhost address explicitly
-        address = "127.0.0.1"
         try:
             with socket.socket(socket.AF_INET, socket.SOCK_STREAM) as s:
                 # Check if the port is usable

syd/viewer.py

@@ -209,7 +209,7 @@ class Viewer:
     def plot(self, state: Dict[str, Any]) -> Figure:
         """Create and return a matplotlib figure.
 
-        This is a placeholder. You must either:
+        Hello user! This is a placeholder that raises a NotImplementedError. You must either:
 
         1. Call set_plot() with your plotting function
         This will look like this:
@@ -249,7 +249,19 @@ class Viewer:
         )
 
     def set_plot(self, func: Callable) -> None:
-        """Set the plot method for the viewer"""
+        """Set the plot method for the viewer.
+
+        For viewers created with make_viewer(), this function is used to set the plot method.
+        The input must be a callable function that takes a state dictionary and returns a matplotlib figure.
+
+        Examples
+        --------
+        >>> def plot(state):
+        >>>     ... generate figure, plot stuff ...
+        >>>     return fig
+        >>> viewer = make_viewer()
+        >>> viewer.set_plot(plot)
+        """
         self.plot = self._prepare_function(func, context="Setting plot:")
 
     def show(
@@ -259,9 +271,25 @@ class Viewer:
         suppress_warnings: bool = True,
         update_threshold: float = 1.0,
     ):
-        """Show the viewer in a notebook
+        """
+        Show the viewer locally in a notebook.
 
-        Same as deploy(env="notebook") except it doesn't return the viewer object.
+        This method displays the viewer in a Jupyter notebook environment with interactive controls.
+
+        Parameters
+        ----------
+        controls_position : {'left', 'top', 'right', 'bottom'}, optional
+            Position of the controls relative to the plot (default is 'left').
+        controls_width_percent : int, optional
+            Width of the controls as a percentage of the total viewer width (default is 20).
+        suppress_warnings : bool, optional
+            If True, suppress warnings during deployment (default is True).
+        update_threshold : float, optional
+            Minimum time in seconds between updates to the viewer (default is 1.0).
+
+        Notes
+        -----
+        This method is equivalent to calling `deploy(env="notebook")` but does not return the viewer object.
         """
         _ = self.deploy(
             env="notebook",
@@ -285,9 +313,37 @@ class Viewer:
         update_threshold: float = 1.0,
         timeout_threshold: float = 10.0,
     ):
-        """Share the viewer on a web browser using Flask
+        """
+        Share the viewer on a web browser using Flask.
 
-        Same as deploy(env="browser") except it doesn't return the viewer object.
+        Parameters
+        ----------
+        controls_position : str, optional
+            Position of the controls relative to the plot (default is 'left').
+        fig_dpi : int, optional
+            Dots per inch for the figure resolution (default is 300).
+        controls_width_percent : int, optional
+            Width of the controls as a percentage of the total viewer width (default is 20).
+        plot_margin_percent : float, optional
+            Margin around the plot as a percentage of the plot size (default is 2.5).
+        suppress_warnings : bool, optional
+            If True, suppress warnings during deployment (default is True).
+        debug : bool, optional
+            If True, run the server in debug mode (default is False).
+        host : str, optional
+            Hostname to use for the server (default is None, which uses 'localhost').
+        port : int, optional
+            Port number to use for the server (default is None, which selects the first available port).
+        open_browser : bool, optional
+            If True, automatically open the web browser to the viewer (default is True).
+        update_threshold : float, optional
+            Minimum time in seconds between updates to the viewer (default is 1.0).
+        timeout_threshold : float, optional
+            Maximum time in seconds to wait for a response before timing out (default is 10.0).
+
+        Notes
+        -----
+        This method is equivalent to calling `deploy(env="browser")` but does not return the viewer object.
         """
         _ = self.deploy(
             env="browser",

{syd-1.2.5.dist-info → syd-1.2.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: syd
-Version: 1.2.5
+Version: 1.2.6
 Summary: A Python package for making GUIs for data science easy.
 Project-URL: Homepage, https://github.com/landoskape/syd
 Author-email: Andrew Landau <andrew+tyler+landau+getridofthisanddtheplusses@gmail.com>
@@ -60,7 +60,7 @@ pip install syd
 The full documentation is available [here](https://shareyourdata.readthedocs.io/). It includes a quick start guide, a comprehensive tutorial, and an API reference for the different elements of Syd. If you have any questions or want to suggest improvements to the docs, please let us know on the [github issues page](https://github.com/landoskape/syd/issues)!
 
 ## Quick Start
-This is an example of a sine wave viewer which is about as simple as it gets. You can choose which env to use - if you use ``env="notebook"`` then the GUI will deploy as the output of a jupyter cell (this only works in jupyter!). If you use ``env="browser"`` then the GUI will open a page in your default web browser and you can interact with the data there (works in jupyter notebooks and also from python scripts!).
+This is an example of a sine wave viewer which is about as simple as it gets. You can choose where you want to display the viewer. If you use ``viewer.show()`` then the GUI will deploy as the output of a jupyter cell (this only works in jupyter or colab!). If you use ``viewer.share()`` then the GUI will open a page in your default web browser and you can interact with the data there (works in jupyter notebooks and also from python scripts!).
 
 ```python
 import numpy as np
@@ -95,7 +95,9 @@ We have several examples of more complex viewers with detailed explanations in t
 | [Making a Viewer Class](examples/2b-subclass_example.ipynb) | Rewrites the comprehensive example as a class, which is useful when you have complex data processing or callbacks. | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/landoskape/syd/blob/main/examples/2b-subclass_example.ipynb) |
 | [Data Loading](examples/3-data_loading.ipynb) | Showcases different ways to get your data into a Syd viewer. | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/landoskape/syd/blob/main/examples/3-data_loading.ipynb) |
 | [Hierarchical Callbacks](examples/4-hierarchical_callbacks.ipynb) | Demonstrates how to handle complicated callback situations. | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/landoskape/syd/blob/main/examples/4-hierarchical_callbacks.ipynb) |
-
+| [Interactive plots with Seaborn](examples/5-interactive-with-seaborn.ipynb) | Showcases how to use Syd with Seaborn. | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/landoskape/syd/blob/main/examples/5-interactive-with-seaborn.ipynb) |
+| [Histology Viewer](examples/6-histology-viewer.ipynb) | Showcases how to use Syd to create a histology viewer for viewing histology slides on the fly. | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/landoskape/syd/blob/main/examples/6-histology-viewer.ipynb) |
+| [Image Labeler](examples/7-image-labeler.ipynb) | Showcases how to use Syd to create an image labeler for annotating images (like ROIs). | [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/landoskape/syd/blob/main/examples/7-image-labeler.ipynb) |
 
 ### Data loading
 Thinking about how to get data into a Syd viewer can be non-intuitive. For some examples that showcase different ways to get your data into a Syd viewer, check out the [data loading example](examples/3-data_loading.ipynb). Or, if you just want a quick and fast example, check this one out:

{syd-1.2.5.dist-info → syd-1.2.6.dist-info}/RECORD

@@ -1,9 +1,9 @@
-syd/__init__.py,sha256=vegsqm4zQ_sfa0BFitwk_n8yT_Fka5mN7gs_0yrMNPs,117
+syd/__init__.py,sha256=Yt5zZh7xZGBEthWRjdA1_BKGx0v12I5uwmbtltY6WXs,117
 syd/parameters.py,sha256=lzCHSMGYEdQ_FMbcXnntdPF1XvCm7fybB6CNy3TFn04,43543
 syd/support.py,sha256=LoHOsTN0byyDxk9uibjM0BKnI-vAJ4aU-tWILMCXz1Y,6783
-syd/viewer.py,sha256=yKycDAFfyKu8WEp-VUtHVG1Ad4flQtQ3bHqPaQ4JWVM,52699
+syd/viewer.py,sha256=U0TzAKDyORZ3KkNIq5HTCJqLJkD1hP7ua3Cr8KYZUOg,55383
 syd/flask_deployment/__init__.py,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
-syd/flask_deployment/deployer.py,sha256=TKlf4jtRN4t67cuHypcVZe2c8-P3zkXovO5EpXKW2LQ,29827
+syd/flask_deployment/deployer.py,sha256=bRfR0YDScCWn5-1OQZVlDs_xWfL-6Ck_8a5dRs3zsow,28182
 syd/flask_deployment/testing_principles.md,sha256=GyULM97sDeie8h3tSPoduOckdMNGyWuwm1RdHo5jzK0,10130
 syd/flask_deployment/static/__init__.py,sha256=ieWE8NKR-APw7h4Ge0ooZGk6wZrneSSs_1cMyTPbQSA,65
 syd/flask_deployment/static/css/styles.css,sha256=GQgIPbWMdfTgU-HN80FCObA8bd1FPiwa1Dq0yRANsPc,5944
@@ -22,7 +22,7 @@ syd/flask_deployment/templates/index.html,sha256=KDMR-KTMpdQa1PS8py71-NSoGMAWE3q
 syd/notebook_deployment/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 syd/notebook_deployment/deployer.py,sha256=ovuFvj5_qXB5WToNhCxrEHmPuKYypIeLqrUg0KjovQs,12706
 syd/notebook_deployment/widgets.py,sha256=ptys7exVA6NCF4eCRZMTPJblT0ZbtPdN4o2A0Yh5Cfc,20781
-syd-1.2.5.dist-info/METADATA,sha256=U4bMgpT10LCsQyI476ZO0l8PciUnOiOfdq2UEDzFyYo,15340
-syd-1.2.5.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-syd-1.2.5.dist-info/licenses/LICENSE,sha256=YF6QR6Vjxcg5b_sYIyqkME7FZYau5TfEUGTG-0JeRK0,35129
-syd-1.2.5.dist-info/RECORD,,
+syd-1.2.6.dist-info/METADATA,sha256=lpnEeFJAEkn-mhdHmSXYLEUuQX9liGydartk_bqpwJw,16329
+syd-1.2.6.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+syd-1.2.6.dist-info/licenses/LICENSE,sha256=YF6QR6Vjxcg5b_sYIyqkME7FZYau5TfEUGTG-0JeRK0,35129
+syd-1.2.6.dist-info/RECORD,,