feat: gt_plt_donut()

.gitignore

@@ -124,3 +124,5 @@ sandbox.*
 possible_feats.*
 compare_themes.py
 compare_tables.html
+
+README_FILES/

docs/_quarto.yml

@@ -51,6 +51,7 @@ quartodoc:
         - gt_plt_bar_stack
         - gt_plt_bullet
         - gt_plt_conf_int
+        - gt_plt_donut
         - gt_plt_dot
         - gt_plt_dumbbell
         - gt_plt_summary

docs/examples/index.qmd

@@ -183,6 +183,11 @@ addEventListener('resize', setTableWidths);
 [gt_plt_conf_int](./with-code.html#gt_plt_conf_int){.embed-hover-overlay}
 :::
 
+:::{.masonry-item style="--width: 623;"}
+{{< embed with-code.qmd#gt_plt_donut >}}
+[gt_plt_donut](./with-code.html#gt_plt_donut){.embed-hover-overlay}
+:::
+
 :::{.masonry-item style="--width: 304;"}
 {{< embed with-code.qmd#gt_plt_dot >}}
 [gt_plt_dot](./with-code.html#gt_plt_dot){.embed-hover-overlay}

docs/examples/with-code.qmd

@@ -472,6 +472,35 @@ gt.pipe(
 ```
 {{< include ./_show-last.qmd >}}
 
+### [gt_plt_donut](https://posit-dev.github.io/gt-extras/reference/gt_plt_donut.html){title="Click for reference"}
+```{python}
+# | label: gt_plt_donut
+from great_tables import GT
+from great_tables.data import gtcars
+import gt_extras as gte
+
+gtcars_mini = gtcars.loc[
+    9:17,
+    ["model", "mfr", "year", "hp", "hp_rpm", "trq", "trq_rpm", "mpg_c", "mpg_h"]
+]
+
+gt = (
+    GT(gtcars_mini, rowname_col="model")
+    .tab_stubhead(label="Car")
+    .cols_align("center")
+    .cols_align("left", columns="mfr")
+)
+
+gt.pipe(
+    gte.gt_plt_donut,
+    columns=["hp", "hp_rpm", "trq", "trq_rpm", "mpg_c", "mpg_h"],
+    size=40,
+    fill="steelblue"
+)
+```
+{{< include ./_show-last.qmd >}}
+
+
 ### [gt_plt_dot](https://posit-dev.github.io/gt-extras/reference/gt_plt_dot.html){title="Click for reference"}
 ```{python}
 # | label: gt_plt_dot

gt_extras/__init__.py

@@ -16,6 +16,7 @@
     gt_plt_bar_stack,
     gt_plt_bullet,
     gt_plt_conf_int,
+    gt_plt_donut,
     gt_plt_dot,
     gt_plt_dumbbell,
     gt_plt_winloss,
@@ -56,6 +57,7 @@
     "gt_plt_dot",
     "gt_plt_conf_int",
     "gt_plt_dumbbell",
+    "gt_plt_donut",
     "gt_plt_winloss",
     "gt_plt_bar_stack",
     "with_hyperlink",