From 720c5a33b6a49cf328fdd7611f49153cf8f60247 Mon Sep 17 00:00:00 2001
From: Karen Arutyunov <karen@codesynthesis.com>
Date: Wed, 8 Apr 2020 14:51:57 +0300
Subject: Separate tests and examples into individual packages

Also make cli module to be explicitly enabled via the config.cli configuration
variable.
---
 cli-examples/file/.gitignore  |  1 +
 cli-examples/file/README      | 38 ++++++++++++++++++++++++++++++++++++++
 cli-examples/file/buildfile   | 11 +++++++++++
 cli-examples/file/driver.cxx  | 35 +++++++++++++++++++++++++++++++++++
 cli-examples/file/options.cli |  7 +++++++
 cli-examples/file/test.ops    |  7 +++++++
 6 files changed, 99 insertions(+)
 create mode 100644 cli-examples/file/.gitignore
 create mode 100644 cli-examples/file/README
 create mode 100644 cli-examples/file/buildfile
 create mode 100644 cli-examples/file/driver.cxx
 create mode 100644 cli-examples/file/options.cli
 create mode 100644 cli-examples/file/test.ops

(limited to 'cli-examples/file')

diff --git a/cli-examples/file/.gitignore b/cli-examples/file/.gitignore
new file mode 100644
index 0000000..c6e608b
--- /dev/null
+++ b/cli-examples/file/.gitignore
@@ -0,0 +1 @@
+options.?xx
diff --git a/cli-examples/file/README b/cli-examples/file/README
new file mode 100644
index 0000000..289fc64
--- /dev/null
+++ b/cli-examples/file/README
@@ -0,0 +1,38 @@
+This example shows how to allow the users of your application to supply
+options in files in addition to the command line.
+
+The example consists of the following files:
+
+options.cli
+  Command line interface description in the CLI language.
+
+options.hxx
+options.ixx
+options.cxx
+  Command line interface implementation in C++. These files are generated 
+  by the CLI compiler from options.cli using the following command line:
+
+  cli --generate-file-scanner hello.cli
+
+  We use the --generate-file-scanner CLI compiler option to include the 
+  argv_file_scanner scanner implementation which provides support for 
+  reading options from files in addition to the command line.
+
+driver.cxx
+  Driver for the example. It first creates the argv_file_scanner object 
+  and indicates that the values for the --options-file option should be 
+  recognized as files containing additional options. It then passes this
+  scanner object to the option class which parses the command line. The
+  driver then prints the option values.
+
+test.ops
+  Sample options file.
+
+To run this example you can try the following command line:
+
+$ ./driver --verbose 2 --val 1 --options-file test.ops --val 4
+
+The output will be:
+
+verbosity: 5
+values: 1 2 3 4
diff --git a/cli-examples/file/buildfile b/cli-examples/file/buildfile
new file mode 100644
index 0000000..89675d8
--- /dev/null
+++ b/cli-examples/file/buildfile
@@ -0,0 +1,11 @@
+# file      : file/buildfile
+# license   : MIT; see accompanying LICENSE file
+
+exe{driver}: {hxx cxx}{* -options} cli.cxx{options} doc{README}
+exe{driver}: test.arguments = --options-file
+exe{driver}: file{test.ops}: test.input = true # Added after test.arguments.
+
+cxx.poptions =+ "-I$out_base"
+
+cli.cxx{options}: cli{options}
+cli.options = --generate-file-scanner
diff --git a/cli-examples/file/driver.cxx b/cli-examples/file/driver.cxx
new file mode 100644
index 0000000..b53574c
--- /dev/null
+++ b/cli-examples/file/driver.cxx
@@ -0,0 +1,35 @@
+// file      : file/driver.cxx
+// author    : Boris Kolpackov <boris@codesynthesis.com>
+// license   : MIT; see accompanying LICENSE file
+
+#include <iostream>
+#include <iterator>
+#include <algorithm>
+
+#include "options.hxx"
+
+using namespace std;
+
+int
+main (int argc, char* argv[])
+{
+  try
+  {
+    cli::argv_file_scanner s (argc, argv, "--options-file");
+    options o (s);
+
+    cout << "verbosity: " << o.verbose () << endl
+         << "values: ";
+
+    copy (o.val ().begin (),
+          o.val ().end (),
+          ostream_iterator<int> (cout, " "));
+
+    cerr << endl;
+  }
+  catch (const cli::exception& e)
+  {
+    cerr << e << endl;
+    return 1;
+  }
+}
diff --git a/cli-examples/file/options.cli b/cli-examples/file/options.cli
new file mode 100644
index 0000000..3e6db5a
--- /dev/null
+++ b/cli-examples/file/options.cli
@@ -0,0 +1,7 @@
+include <vector>;
+
+class options
+{
+  int --verbose;
+  std::vector<int> --val;
+};
diff --git a/cli-examples/file/test.ops b/cli-examples/file/test.ops
new file mode 100644
index 0000000..65fcf07
--- /dev/null
+++ b/cli-examples/file/test.ops
@@ -0,0 +1,7 @@
+# Sample options file. Empty lines and lines starting with '#' are
+# ignored.
+#
+--verbose 5
+
+--val 2
+--val=3
-- 
cgit v1.1