Squashed 'libs/CommService/' content from commit 7ccc0fc

git-subtree-dir: libs/CommService
git-subtree-split: 7ccc0fce88bbc5969df060058cf0fb57abe3bcf9

libs/CLI11/examples/subcom_in_files/subcommand_a.cpp

@@ -0,0 +1,37 @@
+// Copyright (c) 2017-2022, University of Cincinnati, developed by Henry Schreiner
+// under NSF AWARD 1414736 and by the respective contributors.
+// All rights reserved.
+//
+// SPDX-License-Identifier: BSD-3-Clause
+
+#include "subcommand_a.hpp"
+#include <iostream>
+#include <memory>
+
+/// Set up a subcommand and capture a shared_ptr to a struct that holds all its options.
+/// The variables of the struct are bound to the CLI options.
+/// We use a shared ptr so that the addresses of the variables remain for binding,
+/// You could return the shared pointer if you wanted to access the values in main.
+void setup_subcommand_a(CLI::App &app) {
+    // Create the option and subcommand objects.
+    auto opt = std::make_shared<SubcommandAOptions>();
+    auto sub = app.add_subcommand("subcommand_a", "performs subcommand a");
+
+    // Add options to sub, binding them to opt.
+    sub->add_option("-f,--file", opt->file, "File name")->required();
+    sub->add_flag("--with-foo", opt->with_foo, "Counter");
+
+    // Set the run function as callback to be called when this subcommand is issued.
+    sub->callback([opt]() { run_subcommand_a(*opt); });
+}
+
+/// The function that runs our code.
+/// This could also simply be in the callback lambda itself,
+/// but having a separate function is cleaner.
+void run_subcommand_a(SubcommandAOptions const &opt) {
+    // Do stuff...
+    std::cout << "Working on file: " << opt.file << std::endl;
+    if(opt.with_foo) {
+        std::cout << "Using foo!" << std::endl;
+    }
+}