Scanner-based parsing with support for element erasing

Also implement argv_file_scanner which provides support for reading command
line arguments from the argv array as well as files specified with command
line options. New examples: file. New tests: ctor, erase, file.

3 files changed, 151 insertions, 0 deletions

diff --git a/tests/ctor/driver.cxx b/tests/ctor/driver.cxx
new file mode 100644
index 0000000..c923ec1
--- /dev/null
+++ b/tests/ctor/driver.cxx
@@ -0,0 +1,69 @@
+// file      : tests/ctor/driver.cxx
+// author    : Boris Kolpackov <boris@codesynthesis.com>
+// copyright : Copyright (c) 2009 Code Synthesis Tools CC
+// license   : MIT; see accompanying LICENSE file
+
+#include "test.hxx"
+
+int
+main (int argc, char* argv[])
+{
+  // Test that we can call all the c-tors unambiguously.
+  //
+  {
+    options o1 (argc, argv);
+    options o2 (argc, argv,
+                cli::unknown_mode::fail);
+    options o3 (argc, argv,
+                cli::unknown_mode::fail,
+                cli::unknown_mode::stop);
+    options o4 (argc, argv, true,
+                cli::unknown_mode::fail,
+                cli::unknown_mode::stop);
+  }
+
+  {
+    options o1 (1, argc, argv);
+    options o2 (1, argc, argv,
+                cli::unknown_mode::fail);
+    options o3 (1, argc, argv,
+                cli::unknown_mode::fail,
+                cli::unknown_mode::stop);
+    options o4 (1, argc, argv, true,
+                cli::unknown_mode::fail,
+                cli::unknown_mode::stop);
+  }
+
+  {
+    int end;
+    options o1 (argc, argv, end);
+    options o2 (argc, argv, end,
+                cli::unknown_mode::fail);
+    options o3 (argc, argv, end,
+                cli::unknown_mode::fail,
+                cli::unknown_mode::stop);
+    options o4 (argc, argv, end, true,
+                cli::unknown_mode::fail,
+                cli::unknown_mode::stop);
+  }
+
+  {
+    int end;
+    options o1 (1, argc, argv, end);
+    options o2 (1, argc, argv, end,
+                cli::unknown_mode::fail);
+    options o3 (1, argc, argv, end,
+                cli::unknown_mode::fail,
+                cli::unknown_mode::stop);
+    options o4 (1, argc, argv, end, true,
+                cli::unknown_mode::fail,
+                cli::unknown_mode::stop);
+  }
+
+  {
+    cli::argv_scanner s (argc, argv);
+    options o1 (s);
+    options o2 (s, cli::unknown_mode::fail);
+    options o3 (s, cli::unknown_mode::fail, cli::unknown_mode::stop);
+  }
+}
diff --git a/tests/ctor/makefile b/tests/ctor/makefile
new file mode 100644
index 0000000..93d832a
--- /dev/null
+++ b/tests/ctor/makefile
@@ -0,0 +1,73 @@
+# file      : tests/ctor/makefile
+# author    : Boris Kolpackov <boris@codesynthesis.com>
+# copyright : Copyright (c) 2009 Code Synthesis Tools CC
+# license   : MIT; see accompanying LICENSE file
+
+include $(dir $(lastword $(MAKEFILE_LIST)))../../build/bootstrap.make
+
+cxx_tun := driver.cxx
+cli_tun := test.cli
+
+#
+#
+cxx_obj  := $(addprefix $(out_base)/,$(cxx_tun:.cxx=.o) $(cli_tun:.cli=.o))
+cxx_od   := $(cxx_obj:.o=.o.d)
+
+driver   := $(out_base)/driver
+test     := $(out_base)/.test
+clean    := $(out_base)/.clean
+
+# Build.
+#
+$(driver): $(cxx_obj)
+$(cxx_obj) $(cxx_od): cpp_options := -I$(out_base)
+
+genf := $(cli_tun:.cli=.hxx) $(cli_tun:.cli=.ixx) $(cli_tun:.cli=.cxx)
+gen  := $(addprefix $(out_base)/,$(genf))
+
+$(gen): $(out_root)/cli/cli
+$(gen): cli := $(out_root)/cli/cli
+$(gen): cli_options :=
+
+$(call include-dep,$(cxx_od),$(cxx_obj),$(gen))
+
+# Alias for default target.
+#
+$(out_base)/: $(driver)
+
+# Test.
+#
+$(test): driver := $(driver)
+$(test): $(driver)
+	$(call message,test $$1,$$1,$(driver))
+
+# Clean.
+#
+$(clean):                            \
+  $(driver).o.clean                  \
+  $(addsuffix .cxx.clean,$(cxx_obj)) \
+  $(addsuffix .cxx.clean,$(cxx_od))  \
+  $(addprefix $(out_base)/,$(cli_tun:.cli=.cxx.cli.clean))
+
+# Generated .gitignore.
+#
+ifeq ($(out_base),$(src_base))
+$(driver): | $(out_base)/.gitignore
+
+$(out_base)/.gitignore: files := driver $(genf)
+$(clean): $(out_base)/.gitignore.clean
+
+$(call include,$(bld_root)/git/gitignore.make)
+endif
+
+# How to.
+#
+$(call include,$(bld_root)/cxx/o-e.make)
+$(call include,$(bld_root)/cxx/cxx-o.make)
+$(call include,$(bld_root)/cxx/cxx-d.make)
+$(call include,$(scf_root)/cli/cli-cxx.make)
+
+# Dependencies.
+#
+$(call import,$(src_root)/cli/makefile)
+
diff --git a/tests/ctor/test.cli b/tests/ctor/test.cli
new file mode 100644
index 0000000..f85ad98
--- /dev/null
+++ b/tests/ctor/test.cli
@@ -0,0 +1,9 @@
+// file      : tests/ctor/test.cli
+// author    : Boris Kolpackov <boris@codesynthesis.com>
+// copyright : Copyright (c) 2009 Code Synthesis Tools CC
+// license   : MIT; see accompanying LICENSE file
+
+class options
+{
+  bool --help;
+};