From cf42b060eb6a2234ff4241917becb3ce09c86341 Mon Sep 17 00:00:00 2001
From: "Soren I. Bjornstad" <contact@sorenbjornstad.com>
Date: Fri, 10 Sep 2021 11:31:42 -0500
Subject: [PATCH] add delete_tiddlers builder

It deletes tiddlers. Yep.
---
 tzk/builders.py | 19 ++++++++++++++++++-
 1 file changed, 18 insertions(+), 1 deletion(-)

diff --git a/tzk/builders.py b/tzk/builders.py
index 583e670..2190238 100644
--- a/tzk/builders.py
+++ b/tzk/builders.py
@@ -436,7 +436,7 @@ def set_tiddler_values(mappings: Dict[str, str]) -> None:
             '$__config_sib_CurrentEditionPublicity.tid': 'public',
         })
 
-    :param mappings: A dictionary whose keys are tiddler names
+    :param mappings: A dictionary whose keys are tiddler filenames
                      and whose values are the values to be inserted
                      in those tiddlers' ``text`` fields.
     """
@@ -463,6 +463,23 @@ def set_tiddler_values(mappings: Dict[str, str]) -> None:
             f.write(new_text)
 
 
+@tzk_builder
+def delete_tiddlers(tiddlers: Sequence[str]) -> None:
+    """
+    Delete selected tiddlers from the output.
+
+    This is hopefully self-explanatory.
+
+    .. code-block:: python
+
+    :param mappings: A list of filenames of tiddlers to delete.
+    """
+    assert 'public_wiki_folder' in build_state
+    for tiddler in tiddlers:
+        tiddler_path = (Path(build_state['public_wiki_folder']) / "tiddlers" / tiddler)
+        tiddler_path.unlink()
+
+
 @tzk_builder
 def publish_wiki_to_github(
         output_folder: str = "output/public_site/",