PyPI - staticdash - Versions diffs - 2026.3__tar.gz → 2026.5__tar.gz - Mend

staticdash 2026.3tar.gz → 2026.5tar.gz

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 (25) hide show

{staticdash-2026.3 → staticdash-2026.5}/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: staticdash
-Version: 2026.3
+Version: 2026.5
 Summary: A lightweight static HTML dashboard generator with Plotly and pandas support.
 Author-email: Brian Day <brian.day1@gmail.com>
 License: CC0-1.0

{staticdash-2026.3 → staticdash-2026.5}/pyproject.toml RENAMED Viewed

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 [project]
 name = "staticdash"
-version = "2026.3"
+version = "2026.5"
 description = "A lightweight static HTML dashboard generator with Plotly and pandas support."
 authors = [
     { name = "Brian Day", email = "brian.day1@gmail.com" }

{staticdash-2026.3 → staticdash-2026.5}/staticdash/dashboard.py RENAMED Viewed

@@ -54,8 +54,15 @@ class AbstractPage:
     def add_text(self, text, width=None):
         self.elements.append(("text", text, width))
-    def add_plot(self, plot, width=None):
-        self.elements.append(("plot", plot, width))
+    def add_plot(self, plot, el_width=None, height=None, width=None, align="center"):
+        # `el_width` is the fractional width (0..1) used for layout columns.
+        # `height` and `width` are pixel dimensions for the rendered figure/image.
+        # `align` controls horizontal alignment: 'left', 'center' (default), or 'right'.
+        # We store a tuple (plot, height, width, align) and keep `el_width` as
+        # the element-level fractional width for compatibility with page layout.
+        specified_height = height
+        specified_width = width
+        self.elements.append(("plot", (plot, specified_height, specified_width, align), el_width))
     def add_table(self, df, table_id=None, sortable=True, width=None):
         self.elements.append(("table", df, width))
@@ -151,7 +158,23 @@ class Page(AbstractPage):
                 header_tag = {1: h1, 2: h2, 3: h3, 4: h4}[level]
                 elem = header_tag(text)
             elif kind == "plot":
-                fig = content
+                # content may be stored as (figure, height), (figure, height, width)
+                # or (figure, height, width, align)
+                specified_height = None
+                specified_width = None
+                specified_align = "center"
+                if isinstance(content, (list, tuple)):
+                    if len(content) == 4:
+                        fig, specified_height, specified_width, specified_align = content
+                    elif len(content) == 3:
+                        fig, specified_height, specified_width = content
+                    elif len(content) == 2:
+                        fig, specified_height = content
+                    else:
+                        fig = content
+                else:
+                    fig = content
                 if hasattr(fig, "to_html"):
                     # Use local Plotly loaded in <head>
                     # Ensure the figure uses a robust font family so minus signs and other
@@ -165,26 +188,127 @@ class Page(AbstractPage):
                     except Exception:
                         # Be defensive: don't fail rendering if layout manipulation isn't available
                         pass
-                    # Render Plotly HTML and replace Unicode minus (U+2212) with ASCII hyphen-minus
-                    # to avoid rendering issues when a user's font lacks the U+2212 glyph.
                     try:
+                        # Temporarily set layout height/width if specified (pixels)
+                        orig_height = None
+                        orig_width = None
+                        try:
+                            orig_height = getattr(fig.layout, 'height', None)
+                        except Exception:
+                            orig_height = None
+                        try:
+                            orig_width = getattr(fig.layout, 'width', None)
+                        except Exception:
+                            orig_width = None
+                        try:
+                            if specified_height is not None:
+                                fig.update_layout(height=specified_height)
+                            if specified_width is not None:
+                                fig.update_layout(width=specified_width)
+                        except Exception:
+                            pass
+                        # If a local vendored Plotly exists, rely on the head script.
+                        # Otherwise include Plotly from CDN so the inline newPlot call works.
+                        # Always rely on the page-level Plotly include (head). Avoid
+                        # embedding another Plotly bundle inside each fragment which
+                        # can lead to multiple conflicting versions in the same page.
                         plotly_html = fig.to_html(full_html=False, include_plotlyjs=False, config={'responsive': True})
-                        elem = div(raw_util(plotly_html))
+                        # Wrap the Plotly HTML in a container with explicit pixel sizing
+                        container_style = "width:100%;"
+                        if specified_width is not None:
+                            container_style = f"width:{specified_width}px;"
+                        if specified_height is not None:
+                            container_style = container_style + f" height:{specified_height}px;"
+                        plot_wrapped = f'<div style="{container_style}">{plotly_html}</div>'
+                        # Apply alignment wrapper
+                        if specified_align not in ("left", "right", "center"):
+                            specified_align = "center"
+                        if specified_align == "center":
+                            align_style = "display:flex; justify-content:center; align-items:center;"
+                        elif specified_align == "left":
+                            align_style = "display:flex; justify-content:flex-start; align-items:center;"
+                        else:
+                            align_style = "display:flex; justify-content:flex-end; align-items:center;"
+                        outer = f'<div style="{align_style}">{plot_wrapped}</div>'
+                        elem = div(raw_util(outer))
+                        # restore original height/width if we changed them
+                        try:
+                            if specified_height is not None:
+                                fig.update_layout(height=orig_height)
+                            if specified_width is not None:
+                                fig.update_layout(width=orig_width)
+                        except Exception:
+                            pass
                     except Exception as e:
                         elem = div(f"Plotly figure could not be rendered: {e}")
                 else:
+                    # Robust Matplotlib -> PNG path. Ensure `buf` exists and is closed.
+                    buf = io.BytesIO()
                     try:
+                        # If pixel width/height specified, attempt to adjust figure size
+                        orig_size = None
+                        try:
+                            dpi = fig.get_dpi()
+                        except Exception:
+                            dpi = None
+                        try:
+                            if dpi is not None and (specified_height is not None or specified_width is not None):
+                                orig_size = fig.get_size_inches()
+                                new_w = orig_size[0]
+                                new_h = orig_size[1]
+                                if specified_width is not None:
+                                    new_w = specified_width / dpi
+                                if specified_height is not None:
+                                    new_h = specified_height / dpi
+                                fig.set_size_inches(new_w, new_h)
+                        except Exception:
+                            orig_size = None
                         with rc_context({"axes.unicode_minus": False}):
                             fig.savefig(buf, format="png", bbox_inches="tight")
+                        # restore original size if changed
+                        try:
+                            if orig_size is not None:
+                                fig.set_size_inches(orig_size)
+                        except Exception:
+                            pass
                         buf.seek(0)
                         img_base64 = base64.b64encode(buf.read()).decode("utf-8")
-                        buf.close()
+                        img_style = "max-width:100%;"
+                        if specified_height is not None:
+                            img_style = img_style + f" height:{specified_height}px;"
+                        if specified_width is not None:
+                            img_style = img_style + f" width:{specified_width}px;"
+                        if specified_align not in ("left", "right", "center"):
+                            specified_align = "center"
+                        if specified_align == "center":
+                            align_style = "display:flex; justify-content:center; align-items:center;"
+                        elif specified_align == "left":
+                            align_style = "display:flex; justify-content:flex-start; align-items:center;"
+                        else:
+                            align_style = "display:flex; justify-content:flex-end; align-items:center;"
                         elem = div(
-                            raw_util(f'<img src="data:image/png;base64,{img_base64}" style="max-width:100%;">'),
-                            style="display: flex; justify-content: center; align-items: center;"
+                            raw_util(f'<img src="data:image/png;base64,{img_base64}" style="{img_style}">'),
+                            style=align_style
                         )
                     except Exception as e:
                         elem = div(f"Matplotlib figure could not be rendered: {e}")
+                    finally:
+                        try:
+                            buf.close()
+                        except Exception:
+                            pass
             elif kind == "table":
                 df = content
                 try:
@@ -255,7 +379,22 @@ class MiniPage(AbstractPage):
                 header_tag = {1: h1, 2: h2, 3: h3, 4: h4}[level]
                 elem = header_tag(text)
             elif kind == "plot":
-                fig = content
+                # content may be stored as (figure, height, width, align)
+                specified_height = None
+                specified_width = None
+                specified_align = "center"
+                if isinstance(content, (list, tuple)):
+                    if len(content) == 4:
+                        fig, specified_height, specified_width, specified_align = content
+                    elif len(content) == 3:
+                        fig, specified_height, specified_width = content
+                    elif len(content) == 2:
+                        fig, specified_height = content
+                    else:
+                        fig = content
+                else:
+                    fig = content
                 if hasattr(fig, "to_html"):
                     # Use local Plotly loaded in <head>
                     # Ensure the figure uses a robust font family so minus signs and other
@@ -269,25 +408,114 @@ class MiniPage(AbstractPage):
                     except Exception:
                         pass
                     try:
+                        orig_height = None
+                        orig_width = None
+                        try:
+                            orig_height = getattr(fig.layout, 'height', None)
+                        except Exception:
+                            orig_height = None
+                        try:
+                            orig_width = getattr(fig.layout, 'width', None)
+                        except Exception:
+                            orig_width = None
+                        try:
+                            if specified_height is not None:
+                                fig.update_layout(height=specified_height)
+                            if specified_width is not None:
+                                fig.update_layout(width=specified_width)
+                        except Exception:
+                            pass
+                        # Always rely on the page-level Plotly include (head). Avoid
+                        # embedding another Plotly bundle inside each fragment which
+                        # can lead to multiple conflicting versions in the same page.
                         plotly_html = fig.to_html(full_html=False, include_plotlyjs=False, config={'responsive': True})
-                        elem = div(raw_util(plotly_html))
+                        container_style = "width:100%;"
+                        if specified_width is not None:
+                            container_style = f"width:{specified_width}px;"
+                        if specified_height is not None:
+                            container_style = container_style + f" height:{specified_height}px;"
+                        plot_wrapped = f'<div style="{container_style}">{plotly_html}</div>'
+                        if specified_align not in ("left", "right", "center"):
+                            specified_align = "center"
+                        if specified_align == "center":
+                            align_style = "display:flex; justify-content:center; align-items:center;"
+                        elif specified_align == "left":
+                            align_style = "display:flex; justify-content:flex-start; align-items:center;"
+                        else:
+                            align_style = "display:flex; justify-content:flex-end; align-items:center;"
+                        outer = f'<div style="{align_style}">{plot_wrapped}</div>'
+                        elem = div(raw_util(outer))
+                        try:
+                            if specified_height is not None:
+                                fig.update_layout(height=orig_height)
+                            if specified_width is not None:
+                                fig.update_layout(width=orig_width)
+                        except Exception:
+                            pass
                     except Exception as e:
                         elem = div(f"Plotly figure could not be rendered: {e}")
                 else:
+                    # Robust Matplotlib -> PNG path. Ensure `buf` exists and is closed.
+                    buf = io.BytesIO()
                     try:
-                        buf = io.BytesIO()
-                        # Matplotlib may not be installed in minimal installs; import lazily
+                        # If pixel width/height specified, attempt to adjust figure size
+                        orig_size = None
+                        try:
+                            dpi = fig.get_dpi()
+                        except Exception:
+                            dpi = None
+                        try:
+                            if dpi is not None and (specified_height is not None or specified_width is not None):
+                                orig_size = fig.get_size_inches()
+                                new_w = orig_size[0]
+                                new_h = orig_size[1]
+                                if specified_width is not None:
+                                    new_w = specified_width / dpi
+                                if specified_height is not None:
+                                    new_h = specified_height / dpi
+                                fig.set_size_inches(new_w, new_h)
+                        except Exception:
+                            orig_size = None
                         with rc_context({"axes.unicode_minus": False}):
                             fig.savefig(buf, format="png", bbox_inches="tight")
+                        # restore original size if changed
+                        try:
+                            if orig_size is not None:
+                                fig.set_size_inches(orig_size)
+                        except Exception:
+                            pass
                         buf.seek(0)
                         img_base64 = base64.b64encode(buf.read()).decode("utf-8")
-                        buf.close()
+                        img_style = "max-width:100%;"
+                        if specified_height is not None:
+                            img_style = img_style + f" height:{specified_height}px;"
+                        if specified_width is not None:
+                            img_style = img_style + f" width:{specified_width}px;"
+                        if specified_align not in ("left", "right", "center"):
+                            specified_align = "center"
+                        if specified_align == "center":
+                            align_style = "display:flex; justify-content:center; align-items:center;"
+                        elif specified_align == "left":
+                            align_style = "display:flex; justify-content:flex-start; align-items:center;"
+                        else:
+                            align_style = "display:flex; justify-content:flex-end; align-items:center;"
                         elem = div(
-                            raw_util(f'<img src="data:image/png;base64,{img_base64}" style="max-width:100%;">'),
-                            style="display: flex; justify-content: center; align-items: center;"
+                            raw_util(f'<img src="data:image/png;base64,{img_base64}" style="{img_style}">'),
+                            style=align_style
                         )
                     except Exception as e:
                         elem = div(f"Matplotlib figure could not be rendered: {e}")
+                    finally:
+                        try:
+                            buf.close()
+                        except Exception:
+                            pass
             elif kind == "table":
                 df = content
                 html_table = df.to_html(classes="table-hover table-striped", index=False, border=0, table_id=f"table-{index}", escape=False)

{staticdash-2026.3 → staticdash-2026.5}/staticdash.egg-info/PKG-INFO RENAMED Viewed

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: staticdash
-Version: 2026.3
+Version: 2026.5
 Summary: A lightweight static HTML dashboard generator with Plotly and pandas support.
 Author-email: Brian Day <brian.day1@gmail.com>
 License: CC0-1.0