feat: add dotplot variant

src/scanpy/plotting/__init__.py

@@ -15,6 +15,7 @@
     violin,
 )
 from ._dotplot import DotPlot, dotplot
+from ._easter_egg import dogplot
 from ._matrixplot import MatrixPlot, matrixplot
 from ._preprocessing import filter_genes_dispersion, highly_variable_genes
 from ._qc import highest_expr_genes
@@ -63,6 +64,7 @@
     "correlation_matrix",
     "dendrogram",
     "diffmap",
+    "dogplot",
     "dotplot",
     "dpt_groups_pseudotime",
     "dpt_timeseries",

src/scanpy/plotting/_easter_egg.py

@@ -0,0 +1,18 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+import matplotlib.pyplot as plt
+import numpy as np
+
+HERE = Path(__file__).parent
+
+
+def dogplot(*_, **__) -> None:
+    """Shows who's a good boy"""
+    pic = np.random.randint(1, 4)
+    pic_path = HERE / "dogplot_images" / f"doggo_{pic}.jpg"
+
+    img = plt.imread(pic_path)
+    plt.imshow(img)
+    plt.axis("off")

tests/test_plotting.py

@@ -1851,3 +1851,10 @@ def test_violin_scale_warning(monkeypatch):
     monkeypatch.setattr(sc.pl.StackedViolin, "DEFAULT_SCALE", "count", raising=False)
     with pytest.warns(FutureWarning, match="Don’t set DEFAULT_SCALE"):
         sc.pl.StackedViolin(adata, adata.var_names[:3], groupby="louvain")
+
+
+def test_dogplot():
+    # Test that the dogplot function runs without errors
+    sc.pl.dogplot()
+    # Test that parameters are ignored
+    sc.pl.dogplot("Good boy", woof=False)