cli: improve command dispatch a bit

1 files changed, 31 insertions, 0 deletions

diff --git a/nihil.cli/dispatch_command.ccm b/nihil.cli/dispatch_command.ccm
new file mode 100644
index 0000000..1ba55bb
--- /dev/null
+++ b/nihil.cli/dispatch_command.ccm
@@ -0,0 +1,31 @@
+/*
+ * This source code is released into the public domain.
+ */
+
+module;
+
+#include <functional>
+#include <iostream>
+#include <map>
+#include <string>
+#include <utility>
+
+export module nihil.cli:dispatch_command;
+
+import nihil.util;
+import :command;
+import :usage_error;
+
+namespace nihil {
+
+/*
+ * Invoke a command (which must have been previously registered) using
+ * the provided argument vector.
+ *
+ * The caller should have already stripped the executable name from argv[0]
+ * so that the vector starts with the command name.  This is implicitly
+ * done if main() uses getopt().
+ */
+export [[nodiscard]] auto dispatch_command(int argc, char **argv) -> int;
+
+} // namespace nihil