feat: add initial parser v2 and example CLI parsing results

data/results/dev_tools/ansible-doc-latest.json

@@ -0,0 +1,108 @@
+{
+  "subcommands": [],
+  "options": [
+    {
+      "option": "--metadata-dump",
+      "shortcut": null,
+      "description": "For internal use only. Dump json metadata for all entries, ignores other options.",
+      "value": null,
+      "default": null
+    },
+    {
+      "option": "--no-fail-on-errors",
+      "shortcut": null,
+      "description": "For internal use only. Only used for --metadata-dump. Do not fail on errors. Report the error message in the JSON instead.",
+      "value": null,
+      "default": null
+    },
+    {
+      "option": "--playbook-dir",
+      "shortcut": null,
+      "description": "Since this tool does not use playbooks, use this as a substitute playbook directory. This sets the relative path for many features including roles/ group_vars/ etc.",
+      "value": "BASEDIR",
+      "default": null
+    },
+    {
+      "option": "--version",
+      "shortcut": null,
+      "description": "Show program's version number, config file location, configured module search path, module location, executable location and exit.",
+      "value": null,
+      "default": null
+    },
+    {
+      "option": "-F",
+      "shortcut": "--list_files",
+      "description": "Show plugin names and their source files without summaries (implies --list). A supplied argument will be used for filtering, can be a namespace or full collection name.",
+      "value": null,
+      "default": null
+    },
+    {
+      "option": "-M",
+      "shortcut": "--module-path",
+      "description": "Prepend colon-separated path(s) to module library (default={{ ANSIBLE_HOME ~ \"/plugins/modules:/usr/share/ansible/plugins/modules\" }}). This argument may be specified multiple times.",
+      "value": "MODULE_PATH",
+      "default": null
+    },
+    {
+      "option": "-e",
+      "shortcut": "--entry-point",
+      "description": "Select the entry point for role(s).",
+      "value": "ENTRY_POINT",
+      "default": null
+    },
+    {
+      "option": "-h",
+      "shortcut": "--help",
+      "description": "Show this help message and exit.",
+      "value": null,
+      "default": null
+    },
+    {
+      "option": "-j",
+      "shortcut": "--json",
+      "description": "Change output into json format.",
+      "value": null,
+      "default": null
+    },
+    {
+      "option": "-l",
+      "shortcut": "--list",
+      "description": "List available plugins. A supplied argument will be used for filtering, can be a namespace or full collection name.",
+      "value": null,
+      "default": null
+    },
+    {
+      "option": "-r",
+      "shortcut": "--roles-path",
+      "description": "The path to the directory containing your roles. This argument may be specified multiple times.",
+      "value": "ROLES_PATH",
+      "default": null
+    },
+    {
+      "option": "-s",
+      "shortcut": "--snippet",
+      "description": "Show playbook snippet for these plugin types: inventory, lookup, module.",
+      "value": null,
+      "default": null
+    },
+    {
+      "option": "-t",
+      "shortcut": "--type",
+      "description": "Choose which plugin type (defaults to 'module'). Available plugin types are: ('become', 'cache', 'callback', 'cliconf', 'connection', 'httpapi', 'inventory', 'lookup', 'netconf', 'shell', 'vars', 'module', 'strategy', 'test', 'filter', 'role', 'keyword').",
+      "value": "{become,cache,callback,cliconf,connection,httpapi,inventory,lookup,netconf,shell,vars,module,strategy,test,filter,role,keyword}",
+      "default": null
+    },
+    {
+      "option": "-v",
+      "shortcut": "--verbose",
+      "description": "Causes Ansible to print more debug messages. Adding multiple -v will increase the verbosity, the builtin plugins currently evaluate up to -vvvvvv. A reasonable level to start is -vvv, connection debugging might require -vvvv. This argument may be specified multiple times.",
+      "value": null,
+      "default": null
+    }
+  ],
+  "name": "ansible-doc",
+  "raw_help_text": "usage: ansible-doc [-h] [--version] [-v] [-M MODULE_PATH]\n                   [--playbook-dir BASEDIR]\n                   [-t {become,cache,callback,cliconf,connection,httpapi,inventory,lookup,netconf,shell,vars,module,strategy,test,filter,role,keyword}]\n                   [-j] [-r ROLES_PATH]\n                   [-e ENTRY_POINT | -s | -F | -l | --metadata-dump]\n                   [--no-fail-on-errors]\n                   [plugin ...]\n\nplugin documentation tool\n\npositional arguments:\n  plugin                Plugin\n\noptions:\n  --metadata-dump       **For internal use only** Dump json metadata for all\n                        entries, ignores other options.\n  --no-fail-on-errors   **For internal use only** Only used for --metadata-\n                        dump. Do not fail on errors. Report the error message\n                        in the JSON instead.\n  --playbook-dir BASEDIR\n                        Since this tool does not use playbooks, use this as a\n                        substitute playbook directory. This sets the relative\n                        path for many features including roles/ group_vars/\n                        etc.\n  --version             show program's version number, config file location,\n                        configured module search path, module location,\n                        executable location and exit\n  -F, --list_files      Show plugin names and their source files without\n                        summaries (implies --list). A supplied argument will\n                        be used for filtering, can be a namespace or full\n                        collection name.\n  -M MODULE_PATH, --module-path MODULE_PATH\n                        prepend colon-separated path(s) to module library\n                        (default={{ ANSIBLE_HOME ~\n                        \"/plugins/modules:/usr/share/ansible/plugins/modules\"\n                        }}). This argument may be specified multiple times.\n  -e ENTRY_POINT, --entry-point ENTRY_POINT\n                        Select the entry point for role(s).\n  -h, --help            show this help message and exit\n  -j, --json            Change output into json format.\n  -l, --list            List available plugins. A supplied argument will be\n                        used for filtering, can be a namespace or full\n                        collection name.\n  -r ROLES_PATH, --roles-path ROLES_PATH\n                        The path to the directory containing your roles. This\n                        argument may be specified multiple times.\n  -s, --snippet         Show playbook snippet for these plugin types:\n                        inventory, lookup, module\n  -t {become,cache,callback,cliconf,connection,httpapi,inventory,lookup,netconf,shell,vars,module,strategy,test,filter,role,keyword}, --type {become,cache,callback,cliconf,connection,httpapi,inventory,lookup,netconf,shell,vars,module,strategy,test,filter,role,keyword}\n                        Choose which plugin type (defaults to \"module\").\n                        Available plugin types are : ('become', 'cache',\n                        'callback', 'cliconf', 'connection', 'httpapi',\n                        'inventory', 'lookup', 'netconf', 'shell', 'vars',\n                        'module', 'strategy', 'test', 'filter', 'role',\n                        'keyword')\n  -v, --verbose         Causes Ansible to print more debug messages. Adding\n                        multiple -v will increase the verbosity, the builtin\n                        plugins currently evaluate up to -vvvvvv. A reasonable\n                        level to start is -vvv, connection debugging might\n                        require -vvvv. This argument may be specified multiple\n                        times.\n\nSee man pages for Ansible CLI options or website for tutorials\nhttps://docs.ansible.com",
+  "version": {
+    "core": "2.18.6"
+  }
+}

data/results/dev_tools/ansible-galaxy-latest.json

@@ -0,0 +1,29 @@
+{
+  "subcommands": [],
+  "options": [
+    {
+      "option": "--version",
+      "shortcut": null,
+      "description": "show program's version number, config file location, configured module search path, module location, executable location and exit",
+      "value": null,
+      "default": null
+    },
+    {
+      "option": "-h",
+      "shortcut": "--help",
+      "description": "show this help message and exit",
+      "value": null,
+      "default": null
+    },
+    {
+      "option": "-v",
+      "shortcut": "--verbose",
+      "description": "Causes Ansible to print more debug messages. Adding multiple -v will increase the verbosity, the builtin plugins currently evaluate up to -vvvvvv. A reasonable level to start is -vvv, connection debugging might require -vvvv.",
+      "value": null,
+      "default": null
+    }
+  ],
+  "name": "ansible-galaxy",
+  "raw_help_text": "usage: ansible-galaxy [-h] [--version] [-v] TYPE ...\n\nPerform various Role and Collection related operations.\n\npositional arguments:\n  TYPE\n    collection   Manage an Ansible Galaxy collection.\n    role         Manage an Ansible Galaxy role.\n\noptions:\n  --version      show program's version number, config file location,\n                 configured module search path, module location, executable\n                 location and exit\n  -h, --help     show this help message and exit\n  -v, --verbose  Causes Ansible to print more debug messages. Adding multiple\n                 -v will increase the verbosity, the builtin plugins currently\n                 evaluate up to -vvvvvv. A reasonable level to start is -vvv,\n                 connection debugging might require -vvvv. This argument may\n                 be specified multiple times.",
+  "version": "2.18.6"
+}