feat: command-line argument to choose digest to write.

scriv.d/20230127_164615_nedbat_partial_33.rst

@@ -0,0 +1,5 @@
+Added
+.....
+
+- Now you can additionally specify digests on the command line to write, which
+  will choose just those digests from the configuration file.

src/dinghy/cli.py

@@ -43,17 +43,21 @@ def main_run(coro):
 @click_log.simple_verbosity_option(logger)
 @click.version_option()
 @click.argument("_input", metavar="[INPUT]", default="dinghy.yaml")
-def cli(_input):
+@click.argument("digests", metavar="[DIGEST ...]", nargs=-1)
+def cli(_input, digests):
     """
     Generate HTML digests of GitHub activity.
 
     INPUT is a dinghy YAML configuration file (default: dinghy.yaml), or a
     GitHub repo URL.
 
+    DIGEST(s) are the file names of digests from the configuration file to
+    create.  If none are specified, all of the digests are written.
+
     """
     if "://" in _input:
         coro = make_digest([_input])
     else:
-        coro = make_digests_from_config(_input)
+        coro = make_digests_from_config(_input, digests or None)
 
     main_run(coro)

src/dinghy/digest.py

@@ -544,7 +544,7 @@ async def make_digest(items, since="1 week", digest="digest.html", **options):
     logger.info(f"Wrote digest: {digest}")
 
 
-async def make_digests_from_config(conf_file):
+async def make_digests_from_config(conf_file, digests=None):
     """
     Make all the digests specified by a configuration file.
 
@@ -562,6 +562,8 @@ async def make_digests_from_config(conf_file):
     coros = []
     for spec in config.get("digests", []):
         args = {**defaults, **spec}
+        if digests is not None and args["digest"] not in digests:
+            continue
         coros.append(make_digest(**args))
     await asyncio.gather(*coros)