YT-CPPAP-61: Add subparsers support

- Extended the `argument_parser` class with members and functions allowing users to manage subparsers
- Aligned the argument parsing functionality:
   - A parser tries to match the first argument from its input argument range to a subparser
   - If a match is found, the corresponding subparser is invoked with the remaining arguments
   - If no match is found, the current parser finalizes parsing arguments
- Aligned the argument parsing functionality to allow forward ranges only
- Added the `name` and `program_name` attribute accessor functions in `argument_parser`
- Restricted the creation of positional arguments to using only one argument name
- Added the possibility to bind positional arguments to argument groups
- Added an `is_used(arg_name)` method for checking the usage status of an argument
- Added an `o_version` default argument which prints the parser's version info
- Renamed the `argument_descriptor` class to `help_builder`
- Fixed an error where the requirements of all arguments within a mutually exclusive group were verified, which caused unexpected exceptions
- Added the `logging_mode` and `ap_git` demo projects

Author: SpectraL519

CMakeLists.txt

@@ -7,7 +7,7 @@ else()
 endif()
 
 project(cpp-ap
-    VERSION 3.0.0.7
+    VERSION 3.0.0.8
     DESCRIPTION "Command-line argument parser for C++20"
     HOMEPAGE_URL "https://github.com/SpectraL519/cpp-ap"
     LANGUAGES CXX

Doxyfile

@@ -48,7 +48,7 @@ PROJECT_NAME           = CPP-AP
 # could be handy for archiving the generated documentation or if some version
 # control system is used.
 
-PROJECT_NUMBER         = 3.0.0.7
+PROJECT_NUMBER         = 3.0.0.8
 
 # Using the PROJECT_BRIEF tag one can provide an optional one line description
 # for a project that appears at the top of each page and should give viewer a

MODULE.bazel

@@ -1,4 +1,4 @@
 module(
     name = "cpp-ap",
-    version = "3.0.0.7",
+    version = "3.0.0.8",
 )

README.md

@@ -53,6 +53,10 @@ Command-line argument parser for C++20
     - [Downloading the Library](/docs/tutorial.md#downloading-the-library)
   - [The Parser Class](/docs/tutorial.md#the-parser-class)
   - [Adding Arguments](/docs/tutorial.md#adding-arguments)
+    - [Syntax](/docs/tutorial.md#syntax)
+    - [Names](/docs/tutorial.md#names)
+    - [Value Types](/docs/tutorial.md#value-types)
+    - [Boolean Flags](/docs/tutorial.md#boolean-flags)
   - [Argument Parameters](/docs/tutorial.md#argument-parameters)
     - [Common Parameters](/docs/tutorial.md#common-parameters)
     - [Parameters Specific for Optional Arguments](/docs/tutorial.md#parameters-specific-for-optional-arguments)
@@ -63,6 +67,11 @@ Command-line argument parser for C++20
     - [Compound Arguments](/docs/tutorial.md#compound-arguments)
     - [Parsing Known Arguments](/docs/tutorial.md#parsing-known-arguments)
   - [Retrieving Argument Values](/docs/tutorial.md#retrieving-argument-values)
+  - [Subparsers](/docs/tutorial.md#subparsers)
+    - [Creating Subparsers](/docs/tutorial.md#creating-subparsers)
+    - [Using Multiple Subparsers](/docs/tutorial.md#using-multiple-subparsers)
+    - [Parsing Arguments with Subparsers](/docs/tutorial.md#parsing-arguments-with-subparsers)
+    - [Tracking Parser State](/docs/tutorial.md#tracking-parser-state)
   - [Examples](/docs/tutorial.md#examples)
   - [Common Utility](/docs/tutorial.md#common-utility)
 - [Dev notes](/docs/dev_notes.md#dev-notes)