chore: initial examples folder.

examples/test/CMakeLists.txt

@@ -0,0 +1,11 @@
+cmake_minimum_required(VERSION 3.10)
+
+project(test)
+
+set(CMAKE_BUILD_TYPE Debug)
+set(CMAKE_CXX_STANDARD 17)
+set(CMAKE_EXPORT_COMPILE_COMMANDS ON)
+
+find_package(argument_parser REQUIRED)
+add_executable(main main.cpp)
+target_link_libraries(main argument_parser)

examples/test/compile_commands.json

@@ -0,0 +1,8 @@
+[
+{
+  "directory": "/Users/killua/Projects/c++/argparser/argument-parser/examples/test/build",
+  "command": "/usr/bin/c++ -isystem /usr/local/include/argparse -isystem /usr/local/include/argparse/parser -isystem /usr/local/include/argparse/conventions -isystem /usr/local/include/argparse/conventions/implementations -isystem /usr/local/include/argparse/parser/platform_headers -isystem /usr/local/include/argparse/parser/parsing_traits -g -std=gnu++17 -arch arm64 -o CMakeFiles/main.dir/main.cpp.o -c /Users/killua/Projects/c++/argparser/argument-parser/examples/test/main.cpp",
+  "file": "/Users/killua/Projects/c++/argparser/argument-parser/examples/test/main.cpp",
+  "output": "/Users/killua/Projects/c++/argparser/argument-parser/examples/test/build/CMakeFiles/main.dir/main.cpp.o"
+}
+]

examples/test/main.cpp

@@ -0,0 +1,56 @@
+#include <argparse>
+#include <gnu_argument_convention.hpp>
+#include <parser_v3.hpp>
+#include <iostream>
+#include <regex>
+
+using argument = argument_parser::builder::argument<>;
+
+auto echo(std::string const& s) -> void {
+    std::cout << s << '\n';
+}
+
+auto main() -> int {
+    argument_parser::v2::parser parser(false);
+
+    argument::start()
+        .positional("count")
+        .position(0)
+        .help_text("How many times to repeat the action.")
+        .required()
+        .action<int>([](int const& count) {
+            std::cout << "count action configured for " << count << '\n';
+        })
+        .build(parser);
+
+    int captured_value = 0;
+    argument::start()
+        .long_argument("threshold")
+        .help_text("Store the parsed value through a reference.")
+        .reference(captured_value)
+        .build(parser);
+
+    argument::start()
+        .short_argument("q")
+        .help_text("Store a boolean flag.")
+        .build(parser);
+
+    argument::start()
+        .long_argument("output")
+        .help_text("Store a string value.")
+        .store<std::regex>()
+        .build(parser);
+
+    argument::start()
+        .short_argument("e")
+        .long_argument("echo")
+        .help_text("Echo the parsed value.")
+        .action(echo)
+        .build(parser);
+
+    parser.handle_arguments({
+        &argument_parser::conventions::gnu_argument_convention
+    });
+
+    return 0;
+}