support seaborn figures

bored-charts/README.md

@@ -83,6 +83,7 @@ my-reports
 - [matplotlib](https://matplotlib.org/)
 - [plotly](https://plotly.com/python/)
 - [vega-altair](https://altair-viz.github.io/)
+- [seaborn](https://seaborn.pydata.org/)
 
 ## Extensibility
 

bored-charts/boredcharts/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.12.1"
+__version__ = "0.13.0"
 
 from boredcharts.router import FigureRouter
 from boredcharts.webapp import boredcharts

bored-charts/boredcharts/jinja.py

@@ -3,11 +3,12 @@
 import uuid
 from io import BytesIO
 from textwrap import dedent, indent
-from typing import Any, cast
+from typing import Any, TypeAlias, cast
 
 import altair as alt
 import markdown
 import matplotlib.figure as mplfig
+import seaborn as sns
 from fastapi import Request
 from jinja2 import Undefined, pass_context
 from jinja2.runtime import Context
@@ -22,7 +23,12 @@ def md_to_html(md: str) -> Markup:
     return Markup(markdown.markdown(md))
 
 
-def to_html(fig: Figure | mplfig.Figure | alt.typing.ChartType) -> Markup:
+SeabornGrid: TypeAlias = (
+    sns.FacetGrid | sns.PairGrid | sns.JointGrid
+)  # I think that's all of them
+
+
+def to_html(fig: Figure | mplfig.Figure | alt.typing.ChartType | SeabornGrid) -> Markup:
     """Renders a Figure to an HTML string."""
     match fig:
         case Figure():
@@ -34,6 +40,9 @@ def to_html(fig: Figure | mplfig.Figure | alt.typing.ChartType) -> Markup:
             return altair_to_html(fig)
         case mplfig.Figure():
             return mpl_to_html(fig)
+        case _ if isinstance(fig, SeabornGrid):
+            fig = cast(SeabornGrid, fig)
+            return sns_to_html(fig)
         case _:
             raise ValueError(
                 f"Input must be a Plotly/Matplotlib Figure, got {type(fig)}"
@@ -87,6 +96,11 @@ def mpl_to_html(fig: mplfig.Figure) -> Markup:
     return Markup(f"""<img src="data:image/png;base64,{png64}" alt="{title}">""")
 
 
+def sns_to_html(fig: SeabornGrid) -> Markup:
+    """Renders a Seaborn Chart as HTML."""
+    return mpl_to_html(fig.figure)
+
+
 @pass_context
 def figure(
     context: Context,

bored-charts/boredcharts/webapp.py

@@ -4,6 +4,7 @@
 from pathlib import Path
 from typing import NamedTuple
 
+import matplotlib
 from fastapi import FastAPI, Request
 from fastapi.responses import HTMLResponse
 from fastapi.staticfiles import StaticFiles
@@ -104,6 +105,7 @@ async def my_chart() -> go.Figure:
     async def healthz() -> dict[str, str]:
         return {"status": "ok"}
 
+    matplotlib.use("agg")  # force non-interactive
     return app
 
 

bored-charts/pyproject.toml

@@ -8,9 +8,10 @@ dependencies = [
     "jinja2>=3.1.4",
     "markdown>=3.6",
     "markupsafe>=2.1.5",
-    "plotly>=5.23.0",
     "matplotlib>=3.9.2",
+    "plotly>=5.23.0",
     "altair>=5.4.0",
+    "seaborn>=0.13.2",
 ]
 readme = "README.md"
 license = "MIT"

examples/full/README.md

@@ -15,11 +15,12 @@ Project structure:
 │   ├── cars.py
 │   ├── elasticity.py
 │   ├── medals.py
+│   ├── penguins.py
 │   ├── population.py
 │   └── ...                   <-- add more figures here
 ├── pages
-│   ├── more                  - note you can create nested paths:
-│   │   └── test.md             <- this will be at /more/test
+│   ├── the-arctic            - note you can create nested paths:
+│   │   └── pengiuns.md         <- this will be at /the-arctic/penguins
 │   ├── populations.md          <- this will be at /populations
 │   ├── price-elasticity.md
 │   ├── vega-lite-is-cool.md

examples/full/analysis/penguins.py

@@ -0,0 +1,10 @@
+import seaborn as sns
+from boredcharts.router import FigureRouter
+
+figures = FigureRouter()
+
+
+@figures.chart("penguins")
+def penguins() -> sns.PairGrid:
+    df = sns.load_dataset("penguins")
+    return sns.pairplot(df, hue="species")

examples/full/app.py

@@ -1,7 +1,7 @@
 import os
 from pathlib import Path
 
-from analysis import cars, elasticity, medals, population
+from analysis import cars, elasticity, medals, penguins, population
 from boredcharts import boredcharts
 
 pages = Path(__file__).parent / "pages"
@@ -12,6 +12,7 @@
         medals.figures,
         cars.figures,
         population.figures,
+        penguins.figures,
     ],
 )
 

examples/full/pages/the-arctic/penguins.md

@@ -0,0 +1,5 @@
+## Brr...
+
+This is a seaborn plot:
+
+{{ figure("penguins") }}

examples/full/pyproject.toml

@@ -7,8 +7,11 @@ requires-python = ">=3.12"
 dependencies = [
     "bored-charts",
     "uvicorn>=0.30.5",
+    "matplotlib>=3.9.2",
+    "plotly>=5.23.0",
     "altair[all]>=5.4.0",
     "vega-datasets>=0.9.0",
+    "seaborn>=0.13.2",
 ]
 
 [project.scripts]

pyproject.toml

@@ -27,7 +27,7 @@ strict = true
 exclude = ["^examples/_.*$"]
 
 [[tool.mypy.overrides]]
-module = ["plotly.*", "vega_datasets.*"]
+module = ["plotly.*", "seaborn.*", "vega_datasets.*"]
 ignore_missing_imports = true
 
 [tool.ruff.lint]