spyre2 0.1.0__tar.gz

spyre2-0.1.0/.claude/settings.json

@@ -0,0 +1,33 @@
+{
+  "permissions": {
+    "allow": [
+      "Read(//Users/adam/dev/spyre/**)",
+      "Bash(find /Users/adam/dev/spyre/tests -type f -name *.py)",
+      "WebFetch(domain:raw.githubusercontent.com)",
+      "WebFetch(domain:github.com)",
+      "Bash(curl -sL \"https://cdn.jsdelivr.net/npm/alpinejs@3.13.10/dist/cdn.min.js\" -o /Users/adam/dev/spyre2/spyre2/static/alpine.min.js)",
+      "Bash(pip install:*)",
+      "Bash(python -c \"import spyre2; print\\(''import OK''\\); a = spyre2.App\\(\\); print\\(''App\\(\\) OK''\\)\")",
+      "Bash(python -c \":*)",
+      "Bash(MPLBACKEND=Agg python -c \":*)",
+      "Bash(.venv/bin/python -c \"import vegafusion\")",
+      "Bash(.venv/bin/python -c \":*)",
+      "Bash(.venv/bin/python -c \"import altair; print\\(altair.__version__\\)\")",
+      "Bash(curl -s \"https://cdn.jsdelivr.net/npm/vega-embed@6/package.json\")",
+      "Bash(python3 -c \"import sys,json; d=json.load\\(sys.stdin\\); print\\(''''vega-embed:'''', d[''''version'''']\\); print\\(''''peerDeps:'''', d.get\\(''''peerDependencies'''',{}\\)\\)\")",
+      "Bash(open /tmp/unemp_test.html)",
+      "Read(//private/tmp/**)",
+      "Read(//Users/adam/dev/apps/huggingface/spyre-demo/**)",
+      "Read(//Users/adam/dev/apps/huggingface/**)",
+      "Bash(chmod +x ~/dev/apps/huggingface/sync_spyre2.sh)",
+      "Bash(~/dev/apps/huggingface/sync_spyre2.sh)",
+      "Bash(pip show:*)",
+      "Bash(python -m build)"
+    ],
+    "additionalDirectories": [
+      "/Users/adam/dev/apps/huggingface/spyre-demo-heatmaps",
+      "/Users/adam/dev/apps/huggingface/spyre-demo-sliders",
+      "/Users/adam/dev/apps/huggingface"
+    ]
+  }
+}

spyre2-0.1.0/PKG-INFO

@@ -0,0 +1,226 @@
+Metadata-Version: 2.4
+Name: spyre2
+Version: 0.1.0
+Summary: Build interactive data web apps in pure Python
+Project-URL: Homepage, https://github.com/adamhajari/spyre2
+Project-URL: Repository, https://github.com/adamhajari/spyre2
+Project-URL: Issues, https://github.com/adamhajari/spyre2/issues
+Author-email: Adam Hajari <adamhajari@gmail.com>
+License: MIT
+Keywords: dashboard,data,interactive,visualization,web
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Scientific/Engineering :: Visualization
+Requires-Python: >=3.10
+Requires-Dist: fastapi>=0.110.0
+Requires-Dist: jinja2>=3.1.0
+Requires-Dist: numpy>=1.23.0
+Requires-Dist: pandas>=1.5.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: uvicorn[standard]>=0.29.0
+Provides-Extra: all
+Requires-Dist: altair>=5.0.0; extra == 'all'
+Requires-Dist: matplotlib>=3.6.0; extra == 'all'
+Requires-Dist: plotly>=5.0.0; extra == 'all'
+Provides-Extra: altair
+Requires-Dist: altair>=5.0.0; extra == 'altair'
+Provides-Extra: matplotlib
+Requires-Dist: matplotlib>=3.6.0; extra == 'matplotlib'
+Provides-Extra: plotly
+Requires-Dist: plotly>=5.0.0; extra == 'plotly'
+Description-Content-Type: text/markdown
+
+# spyre2
+
+Build interactive data web apps in pure Python — no HTML, CSS, or JavaScript required.
+
+Spyre2 is a ground-up rewrite of [spyre](https://github.com/adamhajari/spyre) using a modern stack: **FastAPI**, **Alpine.js**, and native support for **matplotlib**, **Plotly**, and **Altair**.
+
+---
+
+## Install
+
+```bash
+pip install spyre2
+pip install spyre2[matplotlib]   # + matplotlib
+pip install spyre2[plotly]        # + plotly
+pip install spyre2[all]           # everything
+```
+
+---
+
+## Quickstart
+
+```python
+import numpy as np
+import matplotlib.pyplot as plt
+import spyre2
+
+class SineApp(spyre2.App):
+    title = "Sine Wave"
+
+    inputs = [
+        spyre2.Slider("frequency", label="Frequency", min=1, max=20, default=5),
+        spyre2.Dropdown("color", label="Color",
+                        options=["steelblue", "crimson", "seagreen"]),
+    ]
+
+    outputs = [
+        spyre2.Plot("sine_plot"),
+    ]
+
+    def sine_plot(self, frequency, color):
+        fig, ax = plt.subplots(figsize=(8, 4))
+        x = np.linspace(0, 2 * np.pi, 500)
+        ax.plot(x, np.sin(frequency * x), color=color)
+        return fig
+
+SineApp().launch()
+```
+
+Open `http://127.0.0.1:8000`.
+
+---
+
+## Inputs
+
+| Class | Description |
+|---|---|
+| `Slider(id, min, max, step, default)` | Numeric range slider |
+| `Dropdown(id, options, default)` | Select dropdown |
+| `RadioButtons(id, options, default)` | Radio button group |
+| `CheckboxGroup(id, options, default)` | Multi-select checkboxes |
+| `TextInput(id, default, placeholder)` | Free-text input |
+| `FileUpload(id, accept)` | File picker |
+
+All inputs accept a `label` keyword argument. If omitted, the label is inferred from the `id`.
+
+---
+
+## Outputs
+
+| Class | Handler return type |
+|---|---|
+| `Plot(id)` | `matplotlib.figure.Figure` or `plotly.Figure` or `altair.Chart` |
+| `Table(id)` | `pandas.DataFrame` |
+| `HTML(id)` | `str` (HTML) |
+| `Download(id)` | `(filename: str, content: str \| bytes)` |
+
+The handler method name must match the output `id`:
+
+```python
+outputs = [spyre2.Plot("my_plot")]
+
+def my_plot(self, **kwargs):   # method name = output id
+    ...
+    return fig
+```
+
+---
+
+## Layouts
+
+### Sidebar (default)
+
+Controls on the left, outputs stacked on the right. No configuration needed.
+
+### Grid
+
+```python
+from spyre2 import Layout
+
+class MyApp(spyre2.App):
+    layout = Layout.grid([
+        ["controls",  "controls"  ],
+        ["plot_a",    "plot_b"    ],
+        ["big_table", "big_table" ],
+    ])
+```
+
+Repeat an ID across adjacent cells to span columns. `"controls"` is a reserved name for the input panel.
+
+### Tabs
+
+```python
+layout = Layout.tabs({
+    "Overview": ["trend_plot"],
+    "Detail":   ["data_table", "bar_chart"],
+})
+```
+
+---
+
+## Multiple chart libraries
+
+The chart library is detected automatically from the return type — no configuration needed.
+
+```python
+# matplotlib
+def my_plot(self, x):
+    fig, ax = plt.subplots()
+    ax.plot(...)
+    return fig              # → rendered as SVG
+
+# Plotly
+import plotly.express as px
+def my_plot(self, x):
+    return px.scatter(df, x="a", y="b")   # → rendered via Plotly.js
+
+# Altair
+import altair as alt
+def my_plot(self, x):
+    return alt.Chart(df).mark_line()...   # → rendered via Vega-Embed
+```
+
+---
+
+## Jupyter notebooks
+
+`app.launch()` detects when it's running inside a Jupyter kernel and automatically starts the server in a background thread and displays an inline `IFrame`.
+
+```python
+SineApp().launch(port=8765)   # displays inline in the notebook
+```
+
+---
+
+## Migrating from spyre v1
+
+Use the included CLI tool to mechanically convert a v1 app:
+
+```bash
+spyre2-migrate myapp.py              # preview conversion
+spyre2-migrate myapp.py -o new.py    # write to new file
+spyre2-migrate myapp.py --in-place   # overwrite (creates .bak backup)
+```
+
+The tool converts imports, `inputs`/`outputs` list-of-dicts, and renames `getPlot`/`getTable` etc., leaving `# TODO` comments where manual cleanup is needed.
+
+**What changes:**
+
+| spyre v1 | spyre2 |
+|---|---|
+| `from spyre import server` | `import spyre2` |
+| `class App(server.App)` | `class App(spyre2.App)` |
+| `inputs = [{"type": "slider", "key": "x", ...}]` | `inputs = [spyre2.Slider("x", ...)]` |
+| `def getPlot(self, params): x = params["freq"]` | `def my_plot(self, freq):` |
+| CherryPy on port 9093 | uvicorn on port 8000 |
+
+For apps that can't be fully migrated yet, `spyre2.compat.App` accepts the old dict-based syntax (deprecated, will be removed in a future release).
+
+---
+
+## Examples
+
+| File | Demonstrates |
+|---|---|
+| `examples/sine_example.py` | Sidebar layout, matplotlib, slider + dropdown |
+| `examples/grid_example.py` | Grid layout, matplotlib, multiple outputs + table |
+| `examples/plotly_example.py` | Tabs layout, Plotly, scatter + histogram |

spyre2-0.1.0/README.md

@@ -0,0 +1,187 @@
+# spyre2
+
+Build interactive data web apps in pure Python — no HTML, CSS, or JavaScript required.
+
+Spyre2 is a ground-up rewrite of [spyre](https://github.com/adamhajari/spyre) using a modern stack: **FastAPI**, **Alpine.js**, and native support for **matplotlib**, **Plotly**, and **Altair**.
+
+---
+
+## Install
+
+```bash
+pip install spyre2
+pip install spyre2[matplotlib]   # + matplotlib
+pip install spyre2[plotly]        # + plotly
+pip install spyre2[all]           # everything
+```
+
+---
+
+## Quickstart
+
+```python
+import numpy as np
+import matplotlib.pyplot as plt
+import spyre2
+
+class SineApp(spyre2.App):
+    title = "Sine Wave"
+
+    inputs = [
+        spyre2.Slider("frequency", label="Frequency", min=1, max=20, default=5),
+        spyre2.Dropdown("color", label="Color",
+                        options=["steelblue", "crimson", "seagreen"]),
+    ]
+
+    outputs = [
+        spyre2.Plot("sine_plot"),
+    ]
+
+    def sine_plot(self, frequency, color):
+        fig, ax = plt.subplots(figsize=(8, 4))
+        x = np.linspace(0, 2 * np.pi, 500)
+        ax.plot(x, np.sin(frequency * x), color=color)
+        return fig
+
+SineApp().launch()
+```
+
+Open `http://127.0.0.1:8000`.
+
+---
+
+## Inputs
+
+| Class | Description |
+|---|---|
+| `Slider(id, min, max, step, default)` | Numeric range slider |
+| `Dropdown(id, options, default)` | Select dropdown |
+| `RadioButtons(id, options, default)` | Radio button group |
+| `CheckboxGroup(id, options, default)` | Multi-select checkboxes |
+| `TextInput(id, default, placeholder)` | Free-text input |
+| `FileUpload(id, accept)` | File picker |
+
+All inputs accept a `label` keyword argument. If omitted, the label is inferred from the `id`.
+
+---
+
+## Outputs
+
+| Class | Handler return type |
+|---|---|
+| `Plot(id)` | `matplotlib.figure.Figure` or `plotly.Figure` or `altair.Chart` |
+| `Table(id)` | `pandas.DataFrame` |
+| `HTML(id)` | `str` (HTML) |
+| `Download(id)` | `(filename: str, content: str \| bytes)` |
+
+The handler method name must match the output `id`:
+
+```python
+outputs = [spyre2.Plot("my_plot")]
+
+def my_plot(self, **kwargs):   # method name = output id
+    ...
+    return fig
+```
+
+---
+
+## Layouts
+
+### Sidebar (default)
+
+Controls on the left, outputs stacked on the right. No configuration needed.
+
+### Grid
+
+```python
+from spyre2 import Layout
+
+class MyApp(spyre2.App):
+    layout = Layout.grid([
+        ["controls",  "controls"  ],
+        ["plot_a",    "plot_b"    ],
+        ["big_table", "big_table" ],
+    ])
+```
+
+Repeat an ID across adjacent cells to span columns. `"controls"` is a reserved name for the input panel.
+
+### Tabs
+
+```python
+layout = Layout.tabs({
+    "Overview": ["trend_plot"],
+    "Detail":   ["data_table", "bar_chart"],
+})
+```
+
+---
+
+## Multiple chart libraries
+
+The chart library is detected automatically from the return type — no configuration needed.
+
+```python
+# matplotlib
+def my_plot(self, x):
+    fig, ax = plt.subplots()
+    ax.plot(...)
+    return fig              # → rendered as SVG
+
+# Plotly
+import plotly.express as px
+def my_plot(self, x):
+    return px.scatter(df, x="a", y="b")   # → rendered via Plotly.js
+
+# Altair
+import altair as alt
+def my_plot(self, x):
+    return alt.Chart(df).mark_line()...   # → rendered via Vega-Embed
+```
+
+---
+
+## Jupyter notebooks
+
+`app.launch()` detects when it's running inside a Jupyter kernel and automatically starts the server in a background thread and displays an inline `IFrame`.
+
+```python
+SineApp().launch(port=8765)   # displays inline in the notebook
+```
+
+---
+
+## Migrating from spyre v1
+
+Use the included CLI tool to mechanically convert a v1 app:
+
+```bash
+spyre2-migrate myapp.py              # preview conversion
+spyre2-migrate myapp.py -o new.py    # write to new file
+spyre2-migrate myapp.py --in-place   # overwrite (creates .bak backup)
+```
+
+The tool converts imports, `inputs`/`outputs` list-of-dicts, and renames `getPlot`/`getTable` etc., leaving `# TODO` comments where manual cleanup is needed.
+
+**What changes:**
+
+| spyre v1 | spyre2 |
+|---|---|
+| `from spyre import server` | `import spyre2` |
+| `class App(server.App)` | `class App(spyre2.App)` |
+| `inputs = [{"type": "slider", "key": "x", ...}]` | `inputs = [spyre2.Slider("x", ...)]` |
+| `def getPlot(self, params): x = params["freq"]` | `def my_plot(self, freq):` |
+| CherryPy on port 9093 | uvicorn on port 8000 |
+
+For apps that can't be fully migrated yet, `spyre2.compat.App` accepts the old dict-based syntax (deprecated, will be removed in a future release).
+
+---
+
+## Examples
+
+| File | Demonstrates |
+|---|---|
+| `examples/sine_example.py` | Sidebar layout, matplotlib, slider + dropdown |
+| `examples/grid_example.py` | Grid layout, matplotlib, multiple outputs + table |
+| `examples/plotly_example.py` | Tabs layout, Plotly, scatter + histogram |

spyre2-0.1.0/examples/grid_example.py

@@ -0,0 +1,72 @@
+"""
+Grid layout example: two plots side-by-side + a data table below.
+Demonstrates Layout.grid() and returning a pandas DataFrame from a Table output.
+"""
+import numpy as np
+import pandas as pd
+import matplotlib.pyplot as plt
+import sys
+sys.path.insert(0, "/Users/adam/dev/spyre2")
+
+import spyre2
+from spyre2.layout import Layout
+
+
+class WaveApp(spyre2.App):
+    title = "Wave Comparison"
+
+    layout = Layout.grid([
+        ["controls",  "controls"  ],
+        ["sine_plot", "cos_plot"  ],
+        ["data_table","data_table"],
+    ])
+
+    inputs = [
+        spyre2.Slider("frequency", label="Frequency", min=1, max=10, default=3),
+        spyre2.Slider("points", label="Sample Points", min=10, max=200, default=100),
+        spyre2.Dropdown("style", label="Line Style",
+                        options=["solid", "dashed", "dotted"], default="solid"),
+    ]
+
+    outputs = [
+        spyre2.Plot("sine_plot", label="Sine"),
+        spyre2.Plot("cos_plot", label="Cosine"),
+        spyre2.Table("data_table", label="Sample Data"),
+    ]
+
+    def _data(self, frequency, points):
+        x = np.linspace(0, 2 * np.pi, int(points))
+        return x, np.sin(float(frequency) * x), np.cos(float(frequency) * x)
+
+    def sine_plot(self, frequency, points, style):
+        x, y, _ = self._data(frequency, points)
+        fig, ax = plt.subplots(figsize=(5, 3))
+        ls = {"solid": "-", "dashed": "--", "dotted": ":"}[style]
+        ax.plot(x, y, ls, color="steelblue", linewidth=2)
+        ax.set_title(f"sin({frequency}x)")
+        ax.grid(True, alpha=0.3)
+        fig.tight_layout()
+        return fig
+
+    def cos_plot(self, frequency, points, style):
+        x, _, y = self._data(frequency, points)
+        fig, ax = plt.subplots(figsize=(5, 3))
+        ls = {"solid": "-", "dashed": "--", "dotted": ":"}[style]
+        ax.plot(x, y, ls, color="crimson", linewidth=2)
+        ax.set_title(f"cos({frequency}x)")
+        ax.grid(True, alpha=0.3)
+        fig.tight_layout()
+        return fig
+
+    def data_table(self, frequency, points, style):
+        x, s, c = self._data(frequency, points)
+        step = max(1, int(points) // 10)
+        return pd.DataFrame({
+            "x": x[::step].round(3),
+            "sin": s[::step].round(4),
+            "cos": c[::step].round(4),
+        })
+
+
+if __name__ == "__main__":
+    WaveApp().launch()

spyre2-0.1.0/examples/plotly_example.py

@@ -0,0 +1,63 @@
+"""
+Plotly example: interactive scatter + histogram using tabs layout.
+Demonstrates that returning a plotly Figure is handled automatically.
+"""
+import numpy as np
+import pandas as pd
+import sys
+sys.path.insert(0, "/Users/adam/dev/spyre2")
+
+import spyre2
+from spyre2.layout import Layout
+
+try:
+    import plotly.express as px
+except ImportError:
+    raise SystemExit("Install plotly first:  pip install plotly")
+
+
+class ScatterApp(spyre2.App):
+    title = "Plotly Demo"
+
+    layout = Layout.tabs({
+        "Scatter": ["scatter_plot"],
+        "Distribution": ["hist_plot", "summary_table"],
+    })
+
+    inputs = [
+        spyre2.Slider("n_points", label="Points", min=50, max=500, default=200),
+        spyre2.Slider("noise", label="Noise", min=0.1, max=3.0, step=0.1, default=1.0),
+        spyre2.Dropdown("color_scale", label="Color Scale",
+                        options=["viridis", "plasma", "blues"], default="viridis"),
+    ]
+
+    outputs = [
+        spyre2.Plot("scatter_plot", label="Scatter"),
+        spyre2.Plot("hist_plot", label="Distribution"),
+        spyre2.Table("summary_table", label="Stats"),
+    ]
+
+    def _make_df(self, n_points, noise):
+        rng = np.random.default_rng(42)
+        n = int(n_points)
+        x = rng.uniform(0, 10, n)
+        y = 2 * x + rng.normal(0, float(noise), n)
+        return pd.DataFrame({"x": x.round(3), "y": y.round(3)})
+
+    def scatter_plot(self, n_points, noise, color_scale):
+        df = self._make_df(n_points, noise)
+        return px.scatter(df, x="x", y="y", color="y",
+                          color_continuous_scale=color_scale,
+                          title=f"y = 2x + noise (σ={noise})")
+
+    def hist_plot(self, n_points, noise, color_scale):
+        df = self._make_df(n_points, noise)
+        return px.histogram(df, x="y", nbins=30, title="Distribution of y")
+
+    def summary_table(self, n_points, noise, color_scale):
+        df = self._make_df(n_points, noise)
+        return df.describe().reset_index().rename(columns={"index": "stat"})
+
+
+if __name__ == "__main__":
+    ScatterApp().launch()

spyre2-0.1.0/examples/sine_example.py

@@ -0,0 +1,36 @@
+import numpy as np
+import matplotlib.pyplot as plt
+import sys
+sys.path.insert(0, "/Users/adam/dev/spyre2")
+
+import spyre2
+
+
+class SineApp(spyre2.App):
+    title = "Sine Wave Explorer"
+
+    inputs = [
+        spyre2.Slider("frequency", label="Frequency", min=1, max=20, default=5),
+        spyre2.Slider("amplitude", label="Amplitude", min=0.1, max=5.0, step=0.1, default=1.0),
+        spyre2.Dropdown("color", label="Line Color",
+                        options=["steelblue", "crimson", "seagreen"], default="steelblue"),
+    ]
+
+    outputs = [
+        spyre2.Plot("sine_plot"),
+    ]
+
+    def sine_plot(self, frequency, amplitude, color):
+        fig, ax = plt.subplots(figsize=(8, 4))
+        x = np.linspace(0, 2 * np.pi, 500)
+        ax.plot(x, amplitude * np.sin(float(frequency) * x), color=color, linewidth=2)
+        ax.set_xlabel("x")
+        ax.set_ylabel("y")
+        ax.set_title(f"y = {amplitude} · sin({frequency}x)")
+        ax.grid(True, alpha=0.3)
+        fig.tight_layout()
+        return fig
+
+
+if __name__ == "__main__":
+    SineApp().launch()

spyre2-0.1.0/examples/site_example.py

@@ -0,0 +1,22 @@
+"""
+Multi-app site example: serves all spyre2 examples under one server.
+"""
+import sys
+sys.path.insert(0, "/Users/adam/dev/spyre2")
+
+from sine_example import SineApp
+from grid_example import WaveApp
+from plotly_example import ScatterApp
+from us_heatmap_example import USHeatmap
+
+import spyre2
+
+site = spyre2.Site(
+    (SineApp,    "/sine",   "Sine Wave"),
+    (WaveApp,    "/waves",  "Wave Comparison"),
+    (ScatterApp, "/scatter","Scatter / Distribution"),
+    (USHeatmap,  "/map",    "US Heatmap"),
+)
+
+if __name__ == "__main__":
+    site.launch()

spyre2-0.1.0/examples/slider_examples/slider_site.py

@@ -0,0 +1,19 @@
+"""
+Multi-app site example: serves all spyre2 examples under one server.
+"""
+# import sys
+# sys.path.insert(0, "/Users/adam/dev/spyre2")
+
+from sliders_altair import SlidersApp as SlidersAppAltair
+from sliders_migrate_from_spyre1 import SlidersApp as SlidersAppMigrated
+from sliders_plotly import SlidersApp as SlidersAppPlotly
+import spyre2
+
+site = spyre2.Site(
+    (SlidersAppAltair,    "/altair",   "Example Using Altair"),
+    (SlidersAppPlotly,    "/plotly",  "Example Using Plotly"),
+    (SlidersAppMigrated, "/migrated_from_spyre_1","Example Migrated from Spyre1"),
+)
+
+if __name__ == "__main__":
+    site.launch()