Merge pull request #542 from kellyjonbrazil/dev

Dev v1.25.1
fix sys.path update
2026-04-03 17:44:07 +02:00 · 2024-02-13 00:35:00 +00:00 · 2024-02-12 16:18:52 -08:00 · 2024-02-12 15:53:21 -08:00 · 2024-02-12 15:32:38 -08:00 · 2024-02-12 15:05:44 -08:00
365 changed files with 7702 additions and 1197 deletions
--- a/42
+++ b/42
@@ -1,5 +1,47 @@
 jc changelog

+20240212 v1.25.1
+- Fix for crash when optional libraries are not installed (e.g. xmltodict)
+- Fix for `ini` parser crashing with some keys with no values
+- Fix `xrandr` parser to extract more EDID data
+- Enhance `uptime` parser to support output with no user information
+- Enhance `--quiet` CLI option to cover more warning messages
+- Add tests for missing optional libraries
+- Documentation updates
+
+20240204 v1.25.0
+- Add `--slurp` functionality to wrap output from multiple lines into a single array.
+  Note, this only works with single-line input parsers. (e.g. `date`, `ip-address`, `url`, etc.)
+  Streaming parsers are not supported. Use `jc -hhh` to find parsers compatible with the slurp option.
+- Enhance `/proc` file magic syntax to allow slurping when multiple files are selected
+  and to include the `_file` metadata field in the data
+- Enhance `--meta-out` functionality to include a list of the input data when using `--slurp`
+  or `/proc` file magic syntax. For slurpable parsers, this is a list of string inputs in order.
+  For `/proc` file magic syntax, this is a list of `/proc` filenames in order. This can help with
+  identifying which input matches to which output when using `--slurp` or when converting multiple
+  files via `/proc` file magic syntax.
+- Add `curl-head` command parser for `curl --head` or `curl -I` with verbose support
+- Add `efibootmgr` command parser
+- Add `http-headers` parser for plain HTTP header output
+- Add `kv-dup` parser for Key/Value files with duplicate keys
+- Add `path` string parser to parse posix path
+- Add `path-list` string parser to parse path list strings found in env variables
+- Add source link to online parser documentation
+- Add snap package build scripts
+- Add `remove_quotes` function to `utils.py`
+- Add `normalize_key` function to `utils.py`
+- Add `line_slice` function to `utils.py`
+- Add `get_parser` function to `lib.py`
+- Enhance `nsd-control` parser to support more zone information
+- Enhance `ping` and `ping-s` parsers to support the `-I` command option
+- Enhance `proc-net-tcp` parser to add opposite endian support for architectures
+  like the s390x
+- Enhance `url` parser to add `parent`, `filename`, `stem`, and `extension` fields
+- Fix `ini` and `ini-dup` parsers to consistently handle null values as empty strings
+- Fix line slicer to not skip blank lines
+- Refactor parser aliases for `kv`, `pkg_index_deb`, `lsb_release`, and `os-release`
+- Update copyright date
+
 20231216 v1.24.0
 - Add `debconf-show` command parser
 - Add `iftop` command parser
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -1,5 +1,6 @@
 # Contributing to jc
-We love your input! We want to make contributing to this project as easy and transparent as possible, whether it's:
+We love your input! We want to make contributing to this project as easy and
+transparent as possible, whether it's:

 - Reporting a bug
 - Discussing the current state of the code
@@ -8,26 +9,65 @@ We love your input! We want to make contributing to this project as easy and tra
 - Proposing a new parser

 ## We Develop with Github
-We use github to host code, to track issues and feature requests, as well as accept pull requests.
+We use github to host code, to track issues and feature requests, as well as
+accept pull requests.

 ## We Use Github Flow, So All Code Changes Happen Through Pull Requests
-Pull requests are the best way to propose changes to the codebase (we use [Github Flow](https://guides.github.com/introduction/flow/index.html)). We actively welcome your pull requests:
+Pull requests are the best way to propose changes to the codebase (we use
+[Github Flow](https://guides.github.com/introduction/flow/index.html)). We
+actively welcome your pull requests:

-1. Open an issue to discuss the new feature, bug fix, or parser before opening a pull request. For new parsers, it is important to agree upon a schema before developing the parser.
-2. Fork the repo and create your branch from `dev`, if available, otherwise `master`.
-3. For new parsers: Use the [`jc/parsers/foo.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/foo.py) or [`jc/parsers/foo_s.py (streaming)`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/foo_s.py) parsers as a template to get started. You can even place a new parser python module file in the [parser plugin directory](https://github.com/kellyjonbrazil/jc#custom-parsers) to get started right away with just a standard `jc` installation.
-4. If you've added code that should be tested, add tests. All new parsers should have several sample outputs and tests.
-5. Documentation is auto-generated from docstrings, so ensure they are clear and accurate.
-6. Ensure the test suite passes. (Note: "**America/Los_Angeles**" timezone should be configured on the test system)
+1. Open an issue to discuss the new feature, bug fix, or parser before opening
+   a pull request. For new parsers, it is important to agree upon a schema
+   before developing the parser.
+2. Fork the repo and create your branch from `dev`, if available, otherwise
+   `master`.
+3. For new parsers:
+   - Templates: Use the [`jc/parsers/foo.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/foo.py)
+     or [`jc/parsers/foo_s.py (streaming)`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/foo_s.py)
+     parsers as a template to get started.
+   - Local development: You can even place a new parser python module file in
+     the [parser plugin directory](https://github.com/kellyjonbrazil/jc#parser-plugins)
+     to get started right away with just a standard `jc` installation.
+   - Parser registry: Add the parser name to the [jc/lib.py](https://github.com/kellyjonbrazil/jc/blob/master/jc/lib.py)
+     file.
+4. If you've added code that should be tested, add tests. All new parsers should
+   have several sample outputs and tests.
+   - Templates:
+     - **Recommended:** [tests/templates/_test_foo_simple.py](https://github.com/kellyjonbrazil/jc/tree/master/tests/templates/_test_foo_simple.py) as a template if you only have test with fixtures.
+       Execute these steps for standard tests:
+       - Save this file as `test_{parser_name}.py` since the helper methods extract parser names from the filename. Use underscores instead of dashes for the parser name.
+       - Organize fixtures in `tests/fixtures` for optimal structure.
+       - Format fixtures as follows (using double dashes):
+           - `{parser_name}--{some_test_description}.out` for command output. (no dots in the filename except for the `.out` suffix)
+           - `{parser_name}--{some_test_description}.json` for expected JSON after parsing. (no dots in the filename except for the `.json` suffix)
+     - Custom: [tests/templates/_test_foo.py](https://github.com/kellyjonbrazil/jc/blob/master/tests/templates/_test_foo.py) as a template for tests.
+     - Custom: [tests/templates/_test_foo_s.py](https://github.com/kellyjonbrazil/jc/tree/master/tests/templates/_test_foo_s.py) as a template for **streaming parser** tests.
+   - Fixtures: Tests typically consist of an input file and an expected output
+     JSON file. Add the data files to the appropriate folder under [tests/fixtures](https://github.com/kellyjonbrazil/jc/tree/master/tests/fixtures)
+5. Documentation is auto-generated from docstrings, so ensure they are clear and
+   accurate.
+6. Ensure the test suite passes. (Note: "**America/Los_Angeles**" timezone
+   should be configured on the test system)
 7. Make sure your code lints.
 8. Issue that pull request!

-## Parser Schema Guidelines
- Try to keep the schema as flat as possible - typically a list of flat dictionaries
- Keys should be lowercase, contain no special characters, and spaces should be converted to underscores
- Keys should be static, if possible. If they have to be dynamic, then they should not contain lists or dictionaries
+## Documentation And Completions

-This will make it easier to use tools like `jq` without requiring escaping of special characters, encapsulating key names in [""], keeps paths predictable, and makes iterating and searching for values easier.
+No need to worry about documentation and completions as those are auto generated
+via the python doc strings.
+
+## Parser Schema Guidelines
+- Try to keep the schema as flat as possible - typically a list of flat
+  dictionaries
+- Keys should be lowercase, contain no special characters, and spaces should be
+  converted to underscores
+- Keys should be static, if possible. If they have to be dynamic, then they
+  should not contain lists or dictionaries
+
+This will make it easier to use tools like `jq` without requiring escaping of
+special characters, encapsulating key names in `[""]`, keeps paths predictable,
+and makes iterating and searching for values easier.

 **Examples**

@@ -62,18 +102,61 @@ Good:
 ]
 ```

-## Tests
-It is essential to have good command output sample coverage and tests to keep the `jc` parser quality high.
+## Development Environment
+Use the following steps to set up the development environment.

-Many parsers include calculated timestamp fields using the `jc.utils.timestamp` class. Naive timestamps created with this class should be generated on a system configured with the "**America/Los_Angeles**" timezone on linux/macOS/unix and "**Pacific Standard Time**" timezone on Windows for tests to pass on the Github Actions CI tests. This timezone should be configured on your local system before running the tests locally, as well.
+### Virtual Environment
+Set up a Python virtual environment for `jc` development so you won't have to
+worry about library conflicts. This can be done with something like
+[pyenv](https://github.com/pyenv/pyenv) and/or
+[venv](https://docs.python.org/3/library/venv.html)
+
+### Clone the repo
+Once the virtual environment is set up, clone the `jc` repository inside:
+
+```bash
+git clone https://github.com/kellyjonbrazil/jc.git
+```
+
+### Install In Developer Mode
+Next, use the `./install.sh` script to install `jc` and the requirements in
+developer mode (code chages take effect immediately). This will install the
+console-script entry point to `$HOME/.local/bin` so you may need to add this
+to your path.
+
+## Tests
+It is essential to have good command output sample coverage and tests to keep
+the `jc` parser quality high.
+
+Many parsers include calculated timestamp fields using the `jc.utils.timestamp`
+class. Naive timestamps created with this class should be generated on a system
+configured with the "**America/Los_Angeles**" timezone on linux/macOS/unix and
+"**Pacific Standard Time**" timezone on Windows for tests to pass on the Github
+Actions CI tests. This timezone should be configured on your local system before
+running the tests locally, as well.
+
+You can run all tests by running the `./runtests.sh` script.
+
+## Debug Messages
+
+Use `--debug` or `-d` to see debug error messages (double to see more):
+
+```shell
+echo 'abc' | jc --parser-with-error -dd
+```

 ## Any contributions you make will be under the MIT Software License
-In short, when you submit code changes, your submissions are understood to be under the same [MIT License](http://choosealicense.com/licenses/mit/) that covers the project. Feel free to contact the maintainers if that's a concern.
+In short, when you submit code changes, your submissions are understood to be
+under the same [MIT License](http://choosealicense.com/licenses/mit/) that
+covers the project. Feel free to contact the maintainers if that's a concern.

 ## Report bugs using Github's Issues
-We use GitHub issues to track public bugs. Report a bug by [opening a new issue](https://github.com/kellyjonbrazil/jc/issues); it's that easy!
+We use GitHub issues to track public bugs. Report a bug by
+[opening a new issue](https://github.com/kellyjonbrazil/jc/issues); it's that
+easy!

 ## Write bug reports with detail, background, and sample code
+
 **Great Bug Reports** tend to have:

 - A quick summary and/or background
@@ -82,8 +165,10 @@ We use GitHub issues to track public bugs. Report a bug by [opening a new issue]
  - Give sample code if you can.
 - What you expected would happen
 - What actually happens
- Notes (possibly including why you think this might be happening, or stuff you tried that didn't work)
+- Notes (possibly including why you think this might be happening, or stuff you
+  tried that didn't work)

 ## Use a Consistent Coding Style
+
 * 4 spaces for indentation rather than tabs
 * Use a Python linter that will enforce PEP 8 and other best practices
--- a/README-snap.md
+++ b/README-snap.md
@@ -0,0 +1,75 @@
+# How to use `jc` with `snap`
+
+## How to build `snap` package
+
+- Install `snapd`. [One](https://snapcraft.io/docs/installing-snapd) or [two](https://github.com/don-rumata/ansible-role-install-snap).
+
+- Install `snapcraft`:
+
+```bash
+$ sudo snap install snapcraft --classic
+```
+
+- Update snapd:
+
+```bash
+$ sudo snap refresh snapcraft --edge
+```
+
+- Clone the repo:
+
+```bash
+$ git clone https://github.com/kellyjonbrazil/jc
+```
+
+- Change the directory:
+
+```bash
+$ cd ./jc
+```
+
+- Select branch:
+
+```bash
+$ git checkout snap-support
+```
+
+- Initialize LXD:
+
+```bash
+$ lxd init --auto
+```
+
+- Build `.snap` file:
+
+```bash
+$ snapcraft
+```
+
+## How to install local snap file
+
+```bash
+$ snap install --dangerous ./jc_*_amd64.snap
+```
+
+## How to use `jc` with plugins
+
+- Put your plugin in the `"$HOME/.local/share/jc"` directory.
+
+- To connect the directory, run:
+
+```bash
+snap connect jc:dot-jc-plugins snapd
+```
+
+## Urls
+
+- <https://snapcraft.io/docs/supported-interfaces>
+
+- <https://snapcraft.io/docs/interface-management>
+
+- <https://snapcraft.io/docs/personal-files-interface>
+
+- <https://snapcraft.io/docs/python-apps>
+
+- <https://documentation.ubuntu.com/lxd/en/latest/getting_started/>
--- a/README.md
+++ b/README.md
@@ -5,13 +5,12 @@

 > Try the `jc` [web demo](https://jc-web.onrender.com/) and [REST API](https://github.com/kellyjonbrazil/jc-restapi)

-> `jc` is [now available](https://galaxy.ansible.com/community/general) as an
-Ansible filter plugin in the `community.general` collection. See this
+> `jc` is available as an
+[Ansible filter plugin](https://docs.ansible.com/ansible/latest/collections/community/general/jc_filter.html#ansible-collections-community-general-jc-filter)
+in the `community.general` collection. See this
 [blog post](https://blog.kellybrazil.com/2020/08/30/parsing-command-output-in-ansible-with-jc/)
 for an example.

-> Looking for something like `jc` but lower-level? Check out [regex2json](https://gitlab.com/tozd/regex2json).
-
 # JC
 JSON Convert

@@ -177,6 +176,7 @@ option.
 |     `--crontab-u` | `crontab` file parser with user support                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/crontab_u)      |
 |           `--csv` | CSV file parser                                         | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/csv)            |
 |         `--csv-s` | CSV file streaming parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/csv_s)          |
+|     `--curl-head` | `curl --head` command parser                            | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/curl_head)      |
 |          `--date` | `date` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/date)           |
 |  `--datetime-iso` | ISO 8601 Datetime string parser                         | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/datetime_iso)   |
 |  `--debconf-show` | `debconf-show` command parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/debconf_show)   |
@@ -186,6 +186,7 @@ option.
 |     `--dmidecode` | `dmidecode` command parser                              | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/dmidecode)      |
 |        `--dpkg-l` | `dpkg -l` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/dpkg_l)         |
 |            `--du` | `du` command parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/du)             |
+|    `--efibootmgr` | `efibootmgr` command parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/efibootmgr)     |
 | `--email-address` | Email Address string parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/email_address)  |
 |           `--env` | `env` command parser                                    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/env)            |
 |          `--file` | `file` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/file)           |
@@ -206,6 +207,7 @@ option.
 |       `--history` | `history` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/history)        |
 |          `--host` | `host` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/host)           |
 |         `--hosts` | `/etc/hosts` file parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/hosts)          |
+|  `--http-headers` | HTTP headers parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/http_headers)   |
 |            `--id` | `id` command parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/id)             |
 |      `--ifconfig` | `ifconfig` command parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ifconfig)       |
 |           `--ini` | INI file parser                                         | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ini)            |
@@ -221,6 +223,7 @@ option.
 |          `--jobs` | `jobs` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/jobs)           |
 |           `--jwt` | JWT string parser                                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/jwt)            |
 |            `--kv` | Key/Value file and string parser                        | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/kv)             |
+|        `--kv-dup` | Key/Value with duplicate key file and string parser     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/kv_dup)         |
 |          `--last` | `last` and `lastb` command parser                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/last)           |
 |            `--ls` | `ls` command parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ls)             |
 |          `--ls-s` | `ls` command streaming parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ls_s)           |
@@ -244,6 +247,8 @@ option.
 |     `--os-prober` | `os-prober` command parser                              | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/os_prober)      |
 |    `--os-release` | `/etc/os-release` file parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/os_release)     |
 |        `--passwd` | `/etc/passwd` file parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/passwd)         |
+|          `--path` | POSIX path string parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/path)           |
+|     `--path-list` | POSIX path list string parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/path_list)      |
 |       `--pci-ids` | `pci.ids` file parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/pci_ids)        |
 |        `--pgpass` | PostgreSQL password file parser                         | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/pgpass)         |
 |       `--pidstat` | `pidstat -H` command parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/pidstat)        |
@@ -319,22 +324,23 @@ option.

 ### Options

-| Short | Long            | Description                                                                                                         |
-|-------|-----------------|---------------------------------------------------------------------------------------------------------------------|
-| `-a`  | `--about`       | About `jc`. Prints information about `jc` and the parsers (in JSON or YAML, of course!)                             |
-| `-C`  | `--force-color` | Force color output even when using pipes (overrides `-m` and the `NO_COLOR` env variable)                           |
-| `-d`  | `--debug`       | Debug mode. Prints trace messages if parsing issues are encountered (use`-dd` for verbose debugging)                |
-| `-h`  | `--help`        | Help. Use `jc -h --parser_name` for parser documentation. Use twice to show hidden parsers (e.g. `-hh`)             |
-| `-m`  | `--monochrome`  | Monochrome output                                                                                                   |
-| `-M`  | `--meta-out`    | Add metadata to output including timestamp, parser name, magic command, magic command exit code, etc.               |                                                                        |
-| `-p`  | `--pretty`      | Pretty format the JSON output                                                                                       |
-| `-q`  | `--quiet`       | Quiet mode. Suppresses parser warning messages (use `-qq` to ignore streaming parser errors)                        |
-| `-r`  | `--raw`         | Raw output. Provides more literal output, typically with string values and no additional semantic processing        |
-| `-u`  | `--unbuffer`    | Unbuffer output                                                                                                     |
-| `-v`  | `--version`     | Version information                                                                                                 |
-| `-y`  | `--yaml-out`    | YAML output                                                                                                         |
-| `-B`  | `--bash-comp`   | Generate Bash shell completion script ([more info](https://github.com/kellyjonbrazil/jc/wiki/Shell-Completions))    |
-| `-Z`  | `--zsh-comp`    | Generate Zsh shell completion script ([more info](https://github.com/kellyjonbrazil/jc/wiki/Shell-Completions))     |
+| Short | Long            | Description                                                                                                                                                  |
+|-------|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| `-a`  | `--about`       | About `jc`. Prints information about `jc` and the parsers (in JSON or YAML, of course!)                                                                      |
+| `-C`  | `--force-color` | Force color output even when using pipes (overrides `-m` and the `NO_COLOR` env variable)                                                                    |
+| `-d`  | `--debug`       | Debug mode. Prints trace messages if parsing issues are encountered (use`-dd` for verbose debugging)                                                         |
+| `-h`  | `--help`        | Help. Use `jc -h --parser_name` for parser documentation. Use twice to show hidden parsers (e.g. `-hh`). Use thrice to show parser categories (e.g. `-hhh`). |
+| `-m`  | `--monochrome`  | Monochrome output                                                                                                                                            |
+| `-M`  | `--meta-out`    | Add metadata to output including timestamp, parser name, magic command, magic command exit code, etc.                                                        |                                                                        |
+| `-p`  | `--pretty`      | Pretty format the JSON output                                                                                                                                |
+| `-q`  | `--quiet`       | Quiet mode. Suppresses parser warning messages (use `-qq` to ignore streaming parser errors)                                                                 |
+| `-r`  | `--raw`         | Raw output. Provides more literal output, typically with string values and no additional semantic processing                                                 |
+| `-s`  | `--slurp`       | Slurp multiple lines into an array. (use `-hhh` to find compatible parsers)                                                                                  |
+| `-u`  | `--unbuffer`    | Unbuffer output                                                                                                                                              |
+| `-v`  | `--version`     | Version information                                                                                                                                          |
+| `-y`  | `--yaml-out`    | YAML output                                                                                                                                                  |
+| `-B`  | `--bash-comp`   | Generate Bash shell completion script ([more info](https://github.com/kellyjonbrazil/jc/wiki/Shell-Completions))                                             |
+| `-Z`  | `--zsh-comp`    | Generate Zsh shell completion script ([more info](https://github.com/kellyjonbrazil/jc/wiki/Shell-Completions))                                              |

 ### Slice
 Line slicing is supported using the `START:STOP` syntax similar to Python
@@ -384,6 +390,58 @@ Here is a breakdown of line slice options:
 | `:-STOP`       | lines from the beginning through `STOP` lines from the end   |
 | `:`            | all lines                                                    |

+### Slurp
+Some parsers support multi-item input and can output an array of results in a
+single pass. Slurping works for string parsers that accept a single line of
+input. (e.g. `url` and `ip-address`) To see a list of parsers that support
+the `--slurp` option, use `jc -hhh`.
+
+For example, you can send a file with multiple IP addresses (one per line) to
+`jc` with the `--slurp` option and an array of results will output:
+
+```bash
+$ cat ip-addresses.txt | jc --slurp --ip-address
+[<multiple output objects>]
+```
+
+The magic syntax for `/proc` files automatically supports slurping of multiple
+files (no need to use the `--slurp` option). For example, you can convert many
+PID files at once:
+
+```bash
+$ jc /proc/*/status
+[<multiple output objects>]
+```
+
+When the `/proc` magic syntax is used and multiple files are selected, an
+additional `_file` field is inserted in the output so it is easier to tell what
+file each output object refers to.
+
+Finally, the `--meta-out` option can be used in conjunction with slurped output.
+In this case, the slurped output is wrapped in an object with the following
+structure:
+
+```json
+{
+  "result": [<multiple output objects>],
+  "_jc_meta": {
+    "parser": "url",
+    "timestamp": 1706235558.654576,
+    "slice_start": null,
+    "slice_end": null,
+    "input_list": [
+      "http://www.google.com",
+      "https://www.apple.com",
+      "https://www.microsoft.com"
+    ]
+  }
+}
+```
+
+With `--meta-out`, `input_list` contains a list of inputs (actual input strings
+or `/proc` filenames) so you can identify which output object relates to each
+input string or `/proc` filename.
+
 ### Exit Codes
 Any fatal errors within `jc` will generate an exit code of `100`, otherwise the
 exit code will be `0`.
@@ -1313,4 +1371,4 @@ cat istio.yaml | jc -p --yaml
 ]
 ```

-© 2019-2023 Kelly Brazil
+© 2019-2024 Kelly Brazil
--- a/completions/jc_bash_completion.sh
+++ b/completions/jc_bash_completion.sh
@@ -3,9 +3,9 @@ _jc()
    local cur prev words cword jc_commands jc_parsers jc_options \
          jc_about_options jc_about_mod_options jc_help_options jc_special_options

-    jc_commands=(acpi airport arp blkid bluetoothctl cbt certbot chage cksum crontab date debconf-show df dig dmidecode dpkg du env file findmnt finger free git gpg hciconfig host id ifconfig iostat ip iptables iw iwconfig jobs last lastb ls lsattr lsb_release lsblk lsmod lsof lspci lsusb md5 md5sum mdadm mount mpstat netstat nmcli nsd-control ntpq os-prober pidstat ping ping6 pip pip3 postconf printenv ps route rpm rsync sfdisk sha1sum sha224sum sha256sum sha384sum sha512sum shasum ss ssh sshd stat sum swapon sysctl systemctl systeminfo timedatectl top tracepath tracepath6 traceroute traceroute6 tune2fs udevadm ufw uname update-alternatives upower uptime vdir veracrypt vmstat w wc who xrandr zipinfo zpool)
-    jc_parsers=(--acpi --airport --airport-s --arp --asciitable --asciitable-m --blkid --bluetoothctl --cbt --cef --cef-s --certbot --chage --cksum --clf --clf-s --crontab --crontab-u --csv --csv-s --date --datetime-iso --debconf-show --df --dig --dir --dmidecode --dpkg-l --du --email-address --env --file --find --findmnt --finger --free --fstab --git-log --git-log-s --git-ls-remote --gpg --group --gshadow --hash --hashsum --hciconfig --history --host --hosts --id --ifconfig --ini --ini-dup --iostat --iostat-s --ip-address --iptables --ip-route --iw-scan --iwconfig --jar-manifest --jobs --jwt --kv --last --ls --ls-s --lsattr --lsb-release --lsblk --lsmod --lsof --lspci --lsusb --m3u --mdadm --mount --mpstat --mpstat-s --netstat --nmcli --nsd-control --ntpq --openvpn --os-prober --os-release --passwd --pci-ids --pgpass --pidstat --pidstat-s --ping --ping-s --pip-list --pip-show --pkg-index-apk --pkg-index-deb --plist --postconf --proc --proc-buddyinfo --proc-cmdline --proc-consoles --proc-cpuinfo --proc-crypto --proc-devices --proc-diskstats --proc-filesystems --proc-interrupts --proc-iomem --proc-ioports --proc-loadavg --proc-locks --proc-meminfo --proc-modules --proc-mtrr --proc-pagetypeinfo --proc-partitions --proc-slabinfo --proc-softirqs --proc-stat --proc-swaps --proc-uptime --proc-version --proc-vmallocinfo --proc-vmstat --proc-zoneinfo --proc-driver-rtc --proc-net-arp --proc-net-dev --proc-net-dev-mcast --proc-net-if-inet6 --proc-net-igmp --proc-net-igmp6 --proc-net-ipv6-route --proc-net-netlink --proc-net-netstat --proc-net-packet --proc-net-protocols --proc-net-route --proc-net-tcp --proc-net-unix --proc-pid-fdinfo --proc-pid-io --proc-pid-maps --proc-pid-mountinfo --proc-pid-numa-maps --proc-pid-smaps --proc-pid-stat --proc-pid-statm --proc-pid-status --ps --resolve-conf --route --rpm-qi --rsync --rsync-s --semver --sfdisk --shadow --srt --ss --ssh-conf --sshd-conf --stat --stat-s --swapon --sysctl --syslog --syslog-s --syslog-bsd --syslog-bsd-s --systemctl --systemctl-lj --systemctl-ls --systemctl-luf --systeminfo --time --timedatectl --timestamp --toml --top --top-s --tracepath --traceroute --tune2fs --udevadm --ufw --ufw-appinfo --uname --update-alt-gs --update-alt-q --upower --uptime --url --ver --veracrypt --vmstat --vmstat-s --w --wc --who --x509-cert --x509-csr --xml --xrandr --yaml --zipinfo --zpool-iostat --zpool-status)
-    jc_options=(--force-color -C --debug -d --monochrome -m --meta-out -M --pretty -p --quiet -q --raw -r --unbuffer -u --yaml-out -y)
+    jc_commands=(acpi airport arp blkid bluetoothctl cbt certbot chage cksum crontab curl date debconf-show df dig dmidecode dpkg du efibootmgr env file findmnt finger free git gpg hciconfig host id ifconfig iostat ip iptables iw iwconfig jobs last lastb ls lsattr lsb_release lsblk lsmod lsof lspci lsusb md5 md5sum mdadm mount mpstat netstat nmcli nsd-control ntpq os-prober pidstat ping ping6 pip pip3 postconf printenv ps route rpm rsync sfdisk sha1sum sha224sum sha256sum sha384sum sha512sum shasum ss ssh sshd stat sum swapon sysctl systemctl systeminfo timedatectl top tracepath tracepath6 traceroute traceroute6 tune2fs udevadm ufw uname update-alternatives upower uptime vdir veracrypt vmstat w wc who xrandr zipinfo zpool)
+    jc_parsers=(--acpi --airport --airport-s --arp --asciitable --asciitable-m --blkid --bluetoothctl --cbt --cef --cef-s --certbot --chage --cksum --clf --clf-s --crontab --crontab-u --csv --csv-s --curl-head --date --datetime-iso --debconf-show --df --dig --dir --dmidecode --dpkg-l --du --efibootmgr --email-address --env --file --find --findmnt --finger --free --fstab --git-log --git-log-s --git-ls-remote --gpg --group --gshadow --hash --hashsum --hciconfig --history --host --hosts --http-headers --id --ifconfig --ini --ini-dup --iostat --iostat-s --ip-address --iptables --ip-route --iw-scan --iwconfig --jar-manifest --jobs --jwt --kv --kv-dup --last --ls --ls-s --lsattr --lsb-release --lsblk --lsmod --lsof --lspci --lsusb --m3u --mdadm --mount --mpstat --mpstat-s --netstat --nmcli --nsd-control --ntpq --openvpn --os-prober --os-release --passwd --path --path-list --pci-ids --pgpass --pidstat --pidstat-s --ping --ping-s --pip-list --pip-show --pkg-index-apk --pkg-index-deb --plist --postconf --proc --proc-buddyinfo --proc-cmdline --proc-consoles --proc-cpuinfo --proc-crypto --proc-devices --proc-diskstats --proc-filesystems --proc-interrupts --proc-iomem --proc-ioports --proc-loadavg --proc-locks --proc-meminfo --proc-modules --proc-mtrr --proc-pagetypeinfo --proc-partitions --proc-slabinfo --proc-softirqs --proc-stat --proc-swaps --proc-uptime --proc-version --proc-vmallocinfo --proc-vmstat --proc-zoneinfo --proc-driver-rtc --proc-net-arp --proc-net-dev --proc-net-dev-mcast --proc-net-if-inet6 --proc-net-igmp --proc-net-igmp6 --proc-net-ipv6-route --proc-net-netlink --proc-net-netstat --proc-net-packet --proc-net-protocols --proc-net-route --proc-net-tcp --proc-net-unix --proc-pid-fdinfo --proc-pid-io --proc-pid-maps --proc-pid-mountinfo --proc-pid-numa-maps --proc-pid-smaps --proc-pid-stat --proc-pid-statm --proc-pid-status --ps --resolve-conf --route --rpm-qi --rsync --rsync-s --semver --sfdisk --shadow --srt --ss --ssh-conf --sshd-conf --stat --stat-s --swapon --sysctl --syslog --syslog-s --syslog-bsd --syslog-bsd-s --systemctl --systemctl-lj --systemctl-ls --systemctl-luf --systeminfo --time --timedatectl --timestamp --toml --top --top-s --tracepath --traceroute --tune2fs --udevadm --ufw --ufw-appinfo --uname --update-alt-gs --update-alt-q --upower --uptime --url --ver --veracrypt --vmstat --vmstat-s --w --wc --who --x509-cert --x509-csr --xml --xrandr --yaml --zipinfo --zpool-iostat --zpool-status)
+    jc_options=(--force-color -C --debug -d --monochrome -m --meta-out -M --pretty -p --quiet -q --raw -r --slurp -s --unbuffer -u --yaml-out -y)
    jc_about_options=(--about -a)
    jc_about_mod_options=(--pretty -p --yaml-out -y --monochrome -m --force-color -C)
    jc_help_options=(--help -h)
--- a/completions/jc_zsh_completion.sh
+++ b/completions/jc_zsh_completion.sh
@@ -9,7 +9,7 @@ _jc() {
             jc_help_options jc_help_options_describe \
             jc_special_options jc_special_options_describe

-    jc_commands=(acpi airport arp blkid bluetoothctl cbt certbot chage cksum crontab date debconf-show df dig dmidecode dpkg du env file findmnt finger free git gpg hciconfig host id ifconfig iostat ip iptables iw iwconfig jobs last lastb ls lsattr lsb_release lsblk lsmod lsof lspci lsusb md5 md5sum mdadm mount mpstat netstat nmcli nsd-control ntpq os-prober pidstat ping ping6 pip pip3 postconf printenv ps route rpm rsync sfdisk sha1sum sha224sum sha256sum sha384sum sha512sum shasum ss ssh sshd stat sum swapon sysctl systemctl systeminfo timedatectl top tracepath tracepath6 traceroute traceroute6 tune2fs udevadm ufw uname update-alternatives upower uptime vdir veracrypt vmstat w wc who xrandr zipinfo zpool)
+    jc_commands=(acpi airport arp blkid bluetoothctl cbt certbot chage cksum crontab curl date debconf-show df dig dmidecode dpkg du efibootmgr env file findmnt finger free git gpg hciconfig host id ifconfig iostat ip iptables iw iwconfig jobs last lastb ls lsattr lsb_release lsblk lsmod lsof lspci lsusb md5 md5sum mdadm mount mpstat netstat nmcli nsd-control ntpq os-prober pidstat ping ping6 pip pip3 postconf printenv ps route rpm rsync sfdisk sha1sum sha224sum sha256sum sha384sum sha512sum shasum ss ssh sshd stat sum swapon sysctl systemctl systeminfo timedatectl top tracepath tracepath6 traceroute traceroute6 tune2fs udevadm ufw uname update-alternatives upower uptime vdir veracrypt vmstat w wc who xrandr zipinfo zpool)
    jc_commands_describe=(
        'acpi:run "acpi" command with magic syntax.'
        'airport:run "airport" command with magic syntax.'
@@ -21,6 +21,7 @@ _jc() {
        'chage:run "chage" command with magic syntax.'
        'cksum:run "cksum" command with magic syntax.'
        'crontab:run "crontab" command with magic syntax.'
+        'curl:run "curl" command with magic syntax.'
        'date:run "date" command with magic syntax.'
        'debconf-show:run "debconf-show" command with magic syntax.'
        'df:run "df" command with magic syntax.'
@@ -28,6 +29,7 @@ _jc() {
        'dmidecode:run "dmidecode" command with magic syntax.'
        'dpkg:run "dpkg" command with magic syntax.'
        'du:run "du" command with magic syntax.'
+        'efibootmgr:run "efibootmgr" command with magic syntax.'
        'env:run "env" command with magic syntax.'
        'file:run "file" command with magic syntax.'
        'findmnt:run "findmnt" command with magic syntax.'
@@ -115,7 +117,7 @@ _jc() {
        'zipinfo:run "zipinfo" command with magic syntax.'
        'zpool:run "zpool" command with magic syntax.'
    )
-    jc_parsers=(--acpi --airport --airport-s --arp --asciitable --asciitable-m --blkid --bluetoothctl --cbt --cef --cef-s --certbot --chage --cksum --clf --clf-s --crontab --crontab-u --csv --csv-s --date --datetime-iso --debconf-show --df --dig --dir --dmidecode --dpkg-l --du --email-address --env --file --find --findmnt --finger --free --fstab --git-log --git-log-s --git-ls-remote --gpg --group --gshadow --hash --hashsum --hciconfig --history --host --hosts --id --ifconfig --ini --ini-dup --iostat --iostat-s --ip-address --iptables --ip-route --iw-scan --iwconfig --jar-manifest --jobs --jwt --kv --last --ls --ls-s --lsattr --lsb-release --lsblk --lsmod --lsof --lspci --lsusb --m3u --mdadm --mount --mpstat --mpstat-s --netstat --nmcli --nsd-control --ntpq --openvpn --os-prober --os-release --passwd --pci-ids --pgpass --pidstat --pidstat-s --ping --ping-s --pip-list --pip-show --pkg-index-apk --pkg-index-deb --plist --postconf --proc --proc-buddyinfo --proc-cmdline --proc-consoles --proc-cpuinfo --proc-crypto --proc-devices --proc-diskstats --proc-filesystems --proc-interrupts --proc-iomem --proc-ioports --proc-loadavg --proc-locks --proc-meminfo --proc-modules --proc-mtrr --proc-pagetypeinfo --proc-partitions --proc-slabinfo --proc-softirqs --proc-stat --proc-swaps --proc-uptime --proc-version --proc-vmallocinfo --proc-vmstat --proc-zoneinfo --proc-driver-rtc --proc-net-arp --proc-net-dev --proc-net-dev-mcast --proc-net-if-inet6 --proc-net-igmp --proc-net-igmp6 --proc-net-ipv6-route --proc-net-netlink --proc-net-netstat --proc-net-packet --proc-net-protocols --proc-net-route --proc-net-tcp --proc-net-unix --proc-pid-fdinfo --proc-pid-io --proc-pid-maps --proc-pid-mountinfo --proc-pid-numa-maps --proc-pid-smaps --proc-pid-stat --proc-pid-statm --proc-pid-status --ps --resolve-conf --route --rpm-qi --rsync --rsync-s --semver --sfdisk --shadow --srt --ss --ssh-conf --sshd-conf --stat --stat-s --swapon --sysctl --syslog --syslog-s --syslog-bsd --syslog-bsd-s --systemctl --systemctl-lj --systemctl-ls --systemctl-luf --systeminfo --time --timedatectl --timestamp --toml --top --top-s --tracepath --traceroute --tune2fs --udevadm --ufw --ufw-appinfo --uname --update-alt-gs --update-alt-q --upower --uptime --url --ver --veracrypt --vmstat --vmstat-s --w --wc --who --x509-cert --x509-csr --xml --xrandr --yaml --zipinfo --zpool-iostat --zpool-status)
+    jc_parsers=(--acpi --airport --airport-s --arp --asciitable --asciitable-m --blkid --bluetoothctl --cbt --cef --cef-s --certbot --chage --cksum --clf --clf-s --crontab --crontab-u --csv --csv-s --curl-head --date --datetime-iso --debconf-show --df --dig --dir --dmidecode --dpkg-l --du --efibootmgr --email-address --env --file --find --findmnt --finger --free --fstab --git-log --git-log-s --git-ls-remote --gpg --group --gshadow --hash --hashsum --hciconfig --history --host --hosts --http-headers --id --ifconfig --ini --ini-dup --iostat --iostat-s --ip-address --iptables --ip-route --iw-scan --iwconfig --jar-manifest --jobs --jwt --kv --kv-dup --last --ls --ls-s --lsattr --lsb-release --lsblk --lsmod --lsof --lspci --lsusb --m3u --mdadm --mount --mpstat --mpstat-s --netstat --nmcli --nsd-control --ntpq --openvpn --os-prober --os-release --passwd --path --path-list --pci-ids --pgpass --pidstat --pidstat-s --ping --ping-s --pip-list --pip-show --pkg-index-apk --pkg-index-deb --plist --postconf --proc --proc-buddyinfo --proc-cmdline --proc-consoles --proc-cpuinfo --proc-crypto --proc-devices --proc-diskstats --proc-filesystems --proc-interrupts --proc-iomem --proc-ioports --proc-loadavg --proc-locks --proc-meminfo --proc-modules --proc-mtrr --proc-pagetypeinfo --proc-partitions --proc-slabinfo --proc-softirqs --proc-stat --proc-swaps --proc-uptime --proc-version --proc-vmallocinfo --proc-vmstat --proc-zoneinfo --proc-driver-rtc --proc-net-arp --proc-net-dev --proc-net-dev-mcast --proc-net-if-inet6 --proc-net-igmp --proc-net-igmp6 --proc-net-ipv6-route --proc-net-netlink --proc-net-netstat --proc-net-packet --proc-net-protocols --proc-net-route --proc-net-tcp --proc-net-unix --proc-pid-fdinfo --proc-pid-io --proc-pid-maps --proc-pid-mountinfo --proc-pid-numa-maps --proc-pid-smaps --proc-pid-stat --proc-pid-statm --proc-pid-status --ps --resolve-conf --route --rpm-qi --rsync --rsync-s --semver --sfdisk --shadow --srt --ss --ssh-conf --sshd-conf --stat --stat-s --swapon --sysctl --syslog --syslog-s --syslog-bsd --syslog-bsd-s --systemctl --systemctl-lj --systemctl-ls --systemctl-luf --systeminfo --time --timedatectl --timestamp --toml --top --top-s --tracepath --traceroute --tune2fs --udevadm --ufw --ufw-appinfo --uname --update-alt-gs --update-alt-q --upower --uptime --url --ver --veracrypt --vmstat --vmstat-s --w --wc --who --x509-cert --x509-csr --xml --xrandr --yaml --zipinfo --zpool-iostat --zpool-status)
    jc_parsers_describe=(
        '--acpi:`acpi` command parser'
        '--airport:`airport -I` command parser'
@@ -137,6 +139,7 @@ _jc() {
        '--crontab-u:`crontab` file parser with user support'
        '--csv:CSV file parser'
        '--csv-s:CSV file streaming parser'
+        '--curl-head:`curl --head` command parser'
        '--date:`date` command parser'
        '--datetime-iso:ISO 8601 Datetime string parser'
        '--debconf-show:`debconf-show` command parser'
@@ -146,6 +149,7 @@ _jc() {
        '--dmidecode:`dmidecode` command parser'
        '--dpkg-l:`dpkg -l` command parser'
        '--du:`du` command parser'
+        '--efibootmgr:`efibootmgr` command parser'
        '--email-address:Email Address string parser'
        '--env:`env` command parser'
        '--file:`file` command parser'
@@ -166,6 +170,7 @@ _jc() {
        '--history:`history` command parser'
        '--host:`host` command parser'
        '--hosts:`/etc/hosts` file parser'
+        '--http-headers:HTTP headers parser'
        '--id:`id` command parser'
        '--ifconfig:`ifconfig` command parser'
        '--ini:INI file parser'
@@ -181,6 +186,7 @@ _jc() {
        '--jobs:`jobs` command parser'
        '--jwt:JWT string parser'
        '--kv:Key/Value file and string parser'
+        '--kv-dup:Key/Value with duplicate key file and string parser'
        '--last:`last` and `lastb` command parser'
        '--ls:`ls` command parser'
        '--ls-s:`ls` command streaming parser'
@@ -204,6 +210,8 @@ _jc() {
        '--os-prober:`os-prober` command parser'
        '--os-release:`/etc/os-release` file parser'
        '--passwd:`/etc/passwd` file parser'
+        '--path:POSIX path string parser'
+        '--path-list:POSIX path list string parser'
        '--pci-ids:`pci.ids` file parser'
        '--pgpass:PostgreSQL password file parser'
        '--pidstat:`pidstat -H` command parser'
@@ -328,7 +336,7 @@ _jc() {
        '--zpool-iostat:`zpool iostat` command parser'
        '--zpool-status:`zpool status` command parser'
    )
-    jc_options=(--force-color -C --debug -d --monochrome -m --meta-out -M --pretty -p --quiet -q --raw -r --unbuffer -u --yaml-out -y)
+    jc_options=(--force-color -C --debug -d --monochrome -m --meta-out -M --pretty -p --quiet -q --raw -r --slurp -s --unbuffer -u --yaml-out -y)
    jc_options_describe=(
        '--force-color:force color output (overrides -m)'
        '-C:force color output (overrides -m)'
@@ -344,6 +352,8 @@ _jc() {
        '-q:suppress warnings (double to ignore streaming errors)'
        '--raw:raw output'
        '-r:raw output'
+        '--slurp:slurp multiple lines into an array'
+        '-s:slurp multiple lines into an array'
        '--unbuffer:unbuffer output'
        '-u:unbuffer output'
        '--yaml-out:YAML output'
--- a/docgen.sh
+++ b/docgen.sh
@@ -130,6 +130,14 @@ for parser in "${parsers[@]}"; do
                echo "### Parser Information" >> ../docs/parsers/"${parser_name}".md
                echo "Compatibility:  ${compatible}" >> ../docs/parsers/"${parser_name}".md
                echo >> ../docs/parsers/"${parser_name}".md
+                echo "Source: [\`jc/parsers/${parser_name}.py\`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/${parser_name}.py)" >> ../docs/parsers/"${parser_name}".md
+                echo >> ../docs/parsers/"${parser_name}".md
+
+                if $(jq -e '.tags | contains(["slurpable"])' <<< "$parser"); then
+                    echo "This parser can be used with the \`--slurp\` command-line option." >> ../docs/parsers/"${parser_name}".md
+                    echo >> ../docs/parsers/"${parser_name}".md
+                fi
+
                echo "Version ${version} by ${author} (${author_email})" >> ../docs/parsers/"${parser_name}".md
                echo "+++ ${parser_name} docs complete"
            fi
--- a/docs/lib.md
+++ b/docs/lib.md
@@ -1,11 +1,13 @@
 # Table of Contents

 * [jc.lib](#jc.lib)
+  * [get\_parser](#jc.lib.get_parser)
  * [parse](#jc.lib.parse)
  * [parser\_mod\_list](#jc.lib.parser_mod_list)
  * [plugin\_parser\_mod\_list](#jc.lib.plugin_parser_mod_list)
  * [standard\_parser\_mod\_list](#jc.lib.standard_parser_mod_list)
  * [streaming\_parser\_mod\_list](#jc.lib.streaming_parser_mod_list)
+  * [slurpable\_parser\_mod\_list](#jc.lib.slurpable_parser_mod_list)
  * [parser\_info](#jc.lib.parser_info)
  * [all\_parser\_info](#jc.lib.all_parser_info)
  * [get\_help](#jc.lib.get_help)
@@ -16,6 +18,38 @@

 jc - JSON Convert lib module

+<a id="jc.lib.get_parser"></a>
+
+### get\_parser
+
+```python
+def get_parser(parser_mod_name: Union[str, ModuleType]) -> ModuleType
+```
+
+Return the parser module object and check that the module is a valid
+parser module.
+
+Parameters:
+
+    parser_mod_name:    (string or   Name of the parser module. This
+                        Module)      function will accept module_name,
+                                     cli-name, and --argument-name
+                                     variants of the module name.
+
+                                     If a Module is given and the Module
+                                     is a valid parser Module, then the
+                                     same Module is returned.
+
+Returns:
+
+    Module:  the parser Module object
+
+Raises:
+
+    ModuleNotFoundError:  If the Module is not found or is not a valid
+                          parser Module, then a ModuleNotFoundError
+                          exception is raised.
+
 <a id="jc.lib.parse"></a>

 ### parse
@@ -59,15 +93,25 @@ To get a list of available parser module names, use `parser_mod_list()`.
 Alternatively, a parser module object can be supplied:

    >>> import jc
-    >>> import jc.parsers.date as jc_date
+    >>> jc_date = jc.get_parser('date')
    >>> date_obj = jc.parse(jc_date, 'Tue Jan 18 10:23:07 PST 2022')
    >>> print(f'The year is: {date_obj["year"]}')
    The year is: 2022

-You can also use the lower-level parser modules directly:
+You can also use the parser modules directly via `get_parser()`:
+
+    >>> import jc
+    >>> jc_date = jc.get_parser('date')
+    >>> date_obj = jc_date.parse('Tue Jan 18 10:23:07 PST 2022')
+    >>> print(f'The year is: {date_obj["year"]}')
+    The year is: 2022
+
+Finally, you can access the low-level parser modules manually:

    >>> import jc.parsers.date
-    >>> jc.parsers.date.parse('Tue Jan 18 10:23:07 PST 2022')
+    >>> date_obj = jc.parsers.date.parse('Tue Jan 18 10:23:07 PST 2022')
+    >>> print(f'The year is: {date_obj["year"]}')
+    The year is: 2022

 Though, accessing plugin parsers directly is a bit more cumbersome, so
 this higher-level API is recommended. Here is how you can access plugin
@@ -90,7 +134,7 @@ Parameters:
                                     variants of the module name.

                                     A Module object can also be passed
-                                     directly or via _get_parser()
+                                     directly or via get_parser()

    data:               (string or   data to parse (string or bytes for
                        bytes or     standard parsers, iterable of
@@ -156,6 +200,18 @@ def streaming_parser_mod_list(show_hidden: bool = False,
 Returns a list of streaming parser module names. This function is a
 subset of `parser_mod_list()`.

+<a id="jc.lib.slurpable_parser_mod_list"></a>
+
+### slurpable\_parser\_mod\_list
+
+```python
+def slurpable_parser_mod_list(show_hidden: bool = False,
+                              show_deprecated: bool = False) -> List[str]
+```
+
+Returns a list of slurpable parser module names. This function is a
+subset of `parser_mod_list()`.
+
 <a id="jc.lib.parser_info"></a>

 ### parser\_info
--- a/docs/parsers/acpi.md
+++ b/docs/parsers/acpi.md
@@ -250,4 +250,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/acpi.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/acpi.py)
+
 Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/airport.md
+++ b/docs/parsers/airport.md
@@ -103,4 +103,6 @@ Returns:
 ### Parser Information
 Compatibility:  darwin

+Source: [`jc/parsers/airport.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/airport.py)
+
 Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/airport_s.md
+++ b/docs/parsers/airport_s.md
@@ -131,4 +131,6 @@ Returns:
 ### Parser Information
 Compatibility:  darwin

+Source: [`jc/parsers/airport_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/airport_s.py)
+
 Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/arp.md
+++ b/docs/parsers/arp.md
@@ -140,4 +140,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, aix, freebsd, darwin

+Source: [`jc/parsers/arp.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/arp.py)
+
 Version 1.12 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/asciitable.md
+++ b/docs/parsers/asciitable.md
@@ -144,4 +144,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/asciitable.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/asciitable.py)
+
 Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/asciitable_m.md
+++ b/docs/parsers/asciitable_m.md
@@ -129,4 +129,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/asciitable_m.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/asciitable_m.py)
+
 Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/blkid.md
+++ b/docs/parsers/blkid.md
@@ -143,4 +143,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/blkid.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/blkid.py)
+
 Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/bluetoothctl.md
+++ b/docs/parsers/bluetoothctl.md
@@ -130,4 +130,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/bluetoothctl.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/bluetoothctl.py)
+
 Version 1.1 by Jake Ob (iakopap at gmail.com)
--- a/docs/parsers/cbt.md
+++ b/docs/parsers/cbt.md
@@ -122,4 +122,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/cbt.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/cbt.py)
+
 Version 1.0 by Andreas Weiden (andreas.weiden@gmail.com)
--- a/docs/parsers/cef.md
+++ b/docs/parsers/cef.md
@@ -143,4 +143,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/cef.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/cef.py)
+
 Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/cef_s.md
+++ b/docs/parsers/cef_s.md
@@ -121,4 +121,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/cef_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/cef_s.py)
+
 Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/certbot.md
+++ b/docs/parsers/certbot.md
@@ -158,4 +158,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/certbot.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/certbot.py)
+
 Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/chage.md
+++ b/docs/parsers/chage.md
@@ -79,4 +79,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/chage.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/chage.py)
+
 Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/cksum.md
+++ b/docs/parsers/cksum.md
@@ -77,4 +77,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd

+Source: [`jc/parsers/cksum.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/cksum.py)
+
 Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/clf.md
+++ b/docs/parsers/clf.md
@@ -196,4 +196,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/clf.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/clf.py)
+
 Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/clf_s.md
+++ b/docs/parsers/clf_s.md
@@ -114,4 +114,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/clf_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/clf_s.py)
+
 Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/crontab.md
+++ b/docs/parsers/crontab.md
@@ -32,7 +32,6 @@ Schema:
      ],
      "schedule": [
        {
-          "occurrence"        string,
          "minute": [
                              string
          ],
@@ -196,4 +195,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, aix, freebsd

-Version 1.8 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/crontab.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/crontab.py)
+
+Version 1.9 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/crontab_u.md
+++ b/docs/parsers/crontab_u.md
@@ -29,7 +29,6 @@ Schema:
      ],
      "schedule": [
        {
-          "occurrence"        string,
          "minute": [
                              string
          ],
@@ -193,4 +192,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, aix, freebsd

-Version 1.9 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/crontab_u.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/crontab_u.py)
+
+Version 1.10 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/csv.md
+++ b/docs/parsers/csv.md
@@ -102,4 +102,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/csv.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/csv.py)
+
 Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/csv_s.md
+++ b/docs/parsers/csv_s.md
@@ -86,4 +86,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/csv_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/csv_s.py)
+
 Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/curl_head.md
+++ b/docs/parsers/curl_head.md
@@ -0,0 +1,309 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.curl_head"></a>
+
+# jc.parsers.curl\_head
+
+jc - JSON Convert `curl --head` command output parser
+
+This parser converts standard and verbose `curl --head` output.
+
+When converting verbose output from `curl` (to gather request headers, for
+example) you will need to redirect STDERR to STDOUT with `2>&1`. The magic
+syntax will not work in this case.
+
+Usage (cli):
+
+    $ curl --head www.example.com | jc --curl-head
+    $ curl -Ivs www.example.com 2>&1 | jc --curl-head
+
+or
+
+    $ jc curl --head www.example.com
+
+Usage (module):
+
+    import jc
+    result = jc.parse('curl_head', curl_head_command_output)
+
+Schema:
+
+    [
+      {
+        "_type":                                string,  # request or response
+        "_request_method":                      string,
+        "_request_uri":                         string,
+        "_request_version":                     string,
+        "_response_version":                    string,
+        "_response_status":                     integer,
+        "_response_reason":                     string or null,
+        "<header>":                             string,
+
+        # well-known headers:
+
+        "accept": [
+                                                string
+        ],
+        "accept-ch": [
+                                                string
+        ],
+        "accept-ch-lifetime":                   integer,
+        "accept-encoding": [
+                                                string
+        ],
+        "accept-language": [
+                                                string
+        ],
+        "accept-patch": [
+                                                string
+        ],
+        "accept-post": [
+                                                string
+        ],
+        "accept-ranges": [
+                                                string
+        ],
+        "access-control-allow-headers": [
+                                                string
+        ],
+        "access-control-allow-methods": [
+                                                string
+        ],
+        "access-control-expose-headers": [
+                                                string
+        ],
+        "access-control-max-age":               integer,
+        "access-control-request-headers": [
+                                                string
+        ],
+        "age":                                  integer,
+        "allow": [
+                                                string
+        ],
+        "alt-svc": [
+                                                string
+        ],
+        "cache-control": [
+                                                string
+        ],
+        "clear-site-data": [
+                                                string
+        ],
+        "connection": [
+                                                string
+        ],
+        "content-encoding": [
+                                                string
+        ],
+        "content-dpr":                          integer,
+        "content-language": [
+                                                string
+        ],
+        "content-length":                       integer,
+        "content-security-policy": [
+                                                string
+        ],
+        "content-security-policy-report-only": [
+                                                string
+        ],
+        "cookie": [
+                                                string
+        ],
+        "critical-ch": [
+                                                string
+        ],
+        "date":                                 string,
+        "date_epoch_utc":                       integer,
+        "expect-ct": [
+                                                string
+        ],
+        "expires":                              string,
+        "expires_epoch_utc":                    integer,
+        "device-memory":                        integer,
+        "downlink":                             integer,
+        "dpr":                                  integer,
+        "forwarded": [
+                                                string
+        ],
+        "if-match": [
+                                                string
+        ],
+        "if-modified-since":                    string,
+        "if-modified-since_epoch_utc":          integer,
+        "if-none-match": [
+                                                string
+        ],
+        "if-range":                             string,
+        "if-range_epoch_utc":                   integer,
+        "if-unmodified-since":                  string,
+        "if-unmodified-since_epoch_utc":        integer,
+        "im": [
+                                                string
+        ],
+        "keep-alive": [
+                                                string
+        ],
+        "large-allocation":                     integer,
+        "last-modified":                        string,
+        "last-modified_epoch_utc":              integer,
+        "link": [
+                                                string
+        ],
+        "max-forwards":                         integer,
+        "memento-datetime":                     string,
+        "memento-datetime_epoch_utc":           integer,
+        "permissions-policy": [
+                                                string
+        ],
+        "permissions-policy-report-only": [
+                                                string
+        ],
+        "pragma": [
+                                                string
+        ],
+        "proxy-authenticate": [
+                                                string
+        ],
+        "reporting-endpoints": [
+                                                string
+        ],
+        "retry-after":                          string,
+        "retry-after_epoch_utc":                integer,
+        "rtt":                                  integer,
+        "sec-ch-ua": [
+                                                string
+        ],
+        "sec-ch-ua-full-version-list": [
+                                                string
+        ],
+        "server": [
+                                                string
+        ],
+        "server-timing": [
+                                                string
+        ],
+        "set-cookie": [
+                                                string
+        ],
+        "timing-allow-origin": [
+                                                string
+        ],
+        "trailer": [
+                                                string
+        ],
+        "transfer-encoding": [
+                                                string
+        ],
+        "upgrade": [
+                                                string
+        ],
+        "upgrade-insecure-requests":            integer,
+        "vary": [
+                                                string
+        ],
+        "via": [
+                                                string
+        ],
+        "warning": [
+                                                string
+        ],
+        "www-authenticate": [
+                                                string
+        ],
+        "x-cache-hits": [
+                                                integer
+        ],
+        "x-content-duration":                   float
+      }
+    ]
+
+Examples:
+
+    $ curl --head www.example.com | jc --curl-head -p
+    [
+      {
+        "_type": "response",
+        "_response_version": "HTTP/1.1",
+        "_response_status": 200,
+        "_response_reason": [
+          "OK"
+        ],
+        "accept-ranges": [
+          "bytes"
+        ],
+        "age": 241144,
+        "cache-control": [
+          "max-age=604800"
+        ],
+        "content-type": "text/html; charset=UTF-8",
+        "date": "Sun, 04 Feb 2024 23:26:29 GMT",
+        "etag": "\"3147526947\"",
+        "expires": "Sun, 11 Feb 2024 23:26:29 GMT",
+        "last-modified": "Thu, 17 Oct 2019 07:18:26 GMT",
+        "server": [
+          "ECS (sac/2508)"
+        ],
+        "x-cache": "HIT",
+        "content-length": 1256,
+        "date_epoch_utc": 1707089189,
+        "expires_epoch_utc": 1707693989,
+        "last-modified_epoch_utc": 1571296706
+      }
+    ]
+
+    $ curl --head www.example.com | jc --curl-head -p -r
+    [
+      {
+        "_type": "response",
+        "_response_version": "HTTP/1.1",
+        "_response_status": 200,
+        "_response_reason": [
+          "OK"
+        ],
+        "accept-ranges": [
+          "bytes"
+        ],
+        "age": "225102",
+        "cache-control": [
+          "max-age=604800"
+        ],
+        "content-type": "text/html; charset=UTF-8",
+        "date": "Sun, 04 Feb 2024 23:28:17 GMT",
+        "etag": "\"3147526947\"",
+        "expires": "Sun, 11 Feb 2024 23:28:17 GMT",
+        "last-modified": "Thu, 17 Oct 2019 07:18:26 GMT",
+        "server": [
+          "ECS (sac/2575)"
+        ],
+        "x-cache": "HIT",
+        "content-length": "1256"
+      }
+    ]
+
+<a id="jc.parsers.curl_head.parse"></a>
+
+### parse
+
+```python
+def parse(data: str,
+          raw: bool = False,
+          quiet: bool = False) -> List[JSONDictType]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Source: [`jc/parsers/curl_head.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/curl_head.py)
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/date.md
+++ b/docs/parsers/date.md
@@ -100,4 +100,8 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, freebsd

-Version 2.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/date.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/date.py)
+
+This parser can be used with the `--slurp` command-line option.
+
+Version 2.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/datetime_iso.md
+++ b/docs/parsers/datetime_iso.md
@@ -88,4 +88,8 @@ Returns:
 ### Parser Information
 Compatibility:  linux, aix, freebsd, darwin, win32, cygwin

-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/datetime_iso.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/datetime_iso.py)
+
+This parser can be used with the `--slurp` command-line option.
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/debconf_show.md
+++ b/docs/parsers/debconf_show.md
@@ -102,4 +102,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/debconf_show.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/debconf_show.py)
+
 Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/df.md
+++ b/docs/parsers/df.md
@@ -120,4 +120,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, freebsd

+Source: [`jc/parsers/df.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/df.py)
+
 Version 1.11 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/dig.md
+++ b/docs/parsers/dig.md
@@ -346,4 +346,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, aix, freebsd, darwin, win32, cygwin

+Source: [`jc/parsers/dig.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/dig.py)
+
 Version 2.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/dir.md
+++ b/docs/parsers/dir.md
@@ -143,4 +143,6 @@ Returns:
 ### Parser Information
 Compatibility:  win32

+Source: [`jc/parsers/dir.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/dir.py)
+
 Version 1.6 by Rasheed Elsaleh (rasheed@rebelliondefense.com)
--- a/docs/parsers/dmidecode.md
+++ b/docs/parsers/dmidecode.md
@@ -148,4 +148,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/dmidecode.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/dmidecode.py)
+
 Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/dpkg_l.md
+++ b/docs/parsers/dpkg_l.md
@@ -154,4 +154,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/dpkg_l.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/dpkg_l.py)
+
 Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/du.md
+++ b/docs/parsers/du.md
@@ -114,4 +114,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, aix, freebsd

+Source: [`jc/parsers/du.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/du.py)
+
 Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/efibootmgr.md
+++ b/docs/parsers/efibootmgr.md
@@ -0,0 +1,104 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.efibootmgr"></a>
+
+# jc.parsers.efibootmgr
+
+jc - JSON Convert `efibootmgr` command output parser
+
+The `-v` option is also supported.
+
+Usage (cli):
+
+    $ sudo efibootmgr | jc --efibootmgr
+    $ sudo efibootmgr -v | jc --efibootmgr
+
+or
+
+    $ sudo jc efibootmgr
+
+Usage (module):
+
+    import jc
+    result = jc.parse('efibootmgr', efibootmgr_command_output)
+
+Schema:
+
+    {
+        "boot_current":                     string,
+        "timeout_seconds":                  integer,
+        "boot_order": [
+                                            string
+        ],
+        mirrored_percentage_above_4g:       float,
+        mirror_memory_below_4gb:            boolean,
+        "boot_options": [
+            {
+                "boot_option_reference":    string,
+                "display_name":             string,
+                "uefi_device_path":         string,
+                "boot_option_enabled":      boolean
+            }
+        ]
+    }
+
+Examples:
+
+    $ sudo efibootmgr -v | jc --efibootmgr --p
+    {
+      "boot_current": "0002",
+      "timeout_seconds": 0,
+      "boot_order": [
+        "0002",
+        "0000",
+        "0001"
+      ],
+      "mirrored_percentage_above_4g": 0.0,
+      "mirror_memory_below_4gb": false,
+      "boot_options": [
+        {
+          "boot_option_reference": "Boot0000",
+          "display_name": "WARNADO",
+          "uefi_device_path": "HD(1,GPT,05b9944c-1c60-492b-a510-7bbedccdc...",
+          "boot_option_enabled": true
+        },
+        {
+          "boot_option_reference": "Boot0001",
+          "display_name": "Embedded NIC 1 Port 1 Partition 1",
+          "uefi_device_path": "VenHw(3a191845-5f86-4e78-8fce-c4cff59f9daa)",
+          "boot_option_enabled": true
+        },
+        {
+          "boot_option_reference": "Boot0002",
+          "display_name": "opensuse-secureboot",
+          "uefi_device_path": "HD(1,GPT,c5d4f69d-6fc2-48c7-acee-af3f30336...",
+          "boot_option_enabled": true
+        }
+      ]
+    }
+
+<a id="jc.parsers.efibootmgr.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> JSONDictType
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    Dictionary. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Source: [`jc/parsers/efibootmgr.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/efibootmgr.py)
+
+Version 1.0 by Yaofei Zheng (zyf26256@gmail.com, Yaofei.Zheng@dell.com)
--- a/docs/parsers/email_address.md
+++ b/docs/parsers/email_address.md
@@ -64,4 +64,8 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/email_address.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/email_address.py)
+
+This parser can be used with the `--slurp` command-line option.
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/env.md
+++ b/docs/parsers/env.md
@@ -96,4 +96,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/env.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/env.py)
+
 Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/file.md
+++ b/docs/parsers/file.md
@@ -85,4 +85,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, aix, freebsd, darwin

+Source: [`jc/parsers/file.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/file.py)
+
 Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/find.md
+++ b/docs/parsers/find.md
@@ -79,4 +79,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/find.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/find.py)
+
 Version 1.0 by Solomon Leang (solomonleang@gmail.com)
--- a/docs/parsers/findmnt.md
+++ b/docs/parsers/findmnt.md
@@ -114,4 +114,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/findmnt.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/findmnt.py)
+
 Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/finger.md
+++ b/docs/parsers/finger.md
@@ -113,4 +113,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, freebsd

+Source: [`jc/parsers/finger.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/finger.py)
+
 Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/free.md
+++ b/docs/parsers/free.md
@@ -95,4 +95,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/free.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/free.py)
+
 Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/fstab.md
+++ b/docs/parsers/fstab.md
@@ -108,4 +108,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, freebsd

+Source: [`jc/parsers/fstab.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/fstab.py)
+
 Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/git_log.md
+++ b/docs/parsers/git_log.md
@@ -172,4 +172,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/git_log.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/git_log.py)
+
 Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/git_log_s.md
+++ b/docs/parsers/git_log_s.md
@@ -108,4 +108,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/git_log_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/git_log_s.py)
+
 Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/git_ls_remote.md
+++ b/docs/parsers/git_ls_remote.md
@@ -89,4 +89,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/git_ls_remote.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/git_ls_remote.py)
+
 Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/gpg.md
+++ b/docs/parsers/gpg.md
@@ -142,4 +142,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/gpg.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/gpg.py)
+
 Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/group.md
+++ b/docs/parsers/group.md
@@ -132,4 +132,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, aix, freebsd

+Source: [`jc/parsers/group.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/group.py)
+
 Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/gshadow.md
+++ b/docs/parsers/gshadow.md
@@ -100,4 +100,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, aix, freebsd

+Source: [`jc/parsers/gshadow.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/gshadow.py)
+
 Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/hash.md
+++ b/docs/parsers/hash.md
@@ -60,4 +60,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd

+Source: [`jc/parsers/hash.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/hash.py)
+
 Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/hashsum.md
+++ b/docs/parsers/hashsum.md
@@ -91,4 +91,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd

+Source: [`jc/parsers/hashsum.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/hashsum.py)
+
 Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/hciconfig.md
+++ b/docs/parsers/hciconfig.md
@@ -340,4 +340,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/hciconfig.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/hciconfig.py)
+
 Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/history.md
+++ b/docs/parsers/history.md
@@ -87,4 +87,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd

+Source: [`jc/parsers/history.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/history.py)
+
 Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/host.md
+++ b/docs/parsers/host.md
@@ -110,4 +110,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/host.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/host.py)
+
 Version 1.0 by Pettai (pettai@sunet.se)
--- a/docs/parsers/hosts.md
+++ b/docs/parsers/hosts.md
@@ -97,4 +97,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/hosts.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/hosts.py)
+
 Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/http_headers.md
+++ b/docs/parsers/http_headers.md
@@ -0,0 +1,336 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.http_headers"></a>
+
+# jc.parsers.http\_headers
+
+jc - JSON Convert HTTP headers parser
+
+Converts HTTP request and response headers into a list of dictionaries.
+Well-known headers are processed to allow multiple instances which are
+aggregated into an array along with any comma-separated values. Integer,
+float, and datetimes are converted where defined in the specifications.
+
+https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers
+https://datatracker.ietf.org/doc/html/rfc2616
+https://datatracker.ietf.org/doc/html/rfc3229
+https://datatracker.ietf.org/doc/html/rfc7089
+https://datatracker.ietf.org/doc/html/rfc7231
+https://datatracker.ietf.org/doc/html/rfc5789
+
+If you are converting HTTP headers from `curl` verbose output, use the
+`curl-head` parser which will strip the `>` and `<` characters and remove
+non-header lines that begin with `*`.
+
+Usage (cli):
+
+    $ cat headers.txt | jc --http-headers
+
+Usage (module):
+
+    import jc
+    result = jc.parse('http_headers', http_headers_output)
+
+Schema:
+
+    [
+      {
+        "_type":                                string,  # request or response
+        "_request_method":                      string,
+        "_request_uri":                         string,
+        "_request_version":                     string,
+        "_response_version":                    string,
+        "_response_status":                     integer,
+        "_response_reason":                     string or null,
+        "<header>":                             string,
+
+        # well-known headers:
+
+        "accept": [
+                                                string
+        ],
+        "accept-ch": [
+                                                string
+        ],
+        "accept-ch-lifetime":                   integer,
+        "accept-encoding": [
+                                                string
+        ],
+        "accept-language": [
+                                                string
+        ],
+        "accept-patch": [
+                                                string
+        ],
+        "accept-post": [
+                                                string
+        ],
+        "accept-ranges": [
+                                                string
+        ],
+        "access-control-allow-headers": [
+                                                string
+        ],
+        "access-control-allow-methods": [
+                                                string
+        ],
+        "access-control-expose-headers": [
+                                                string
+        ],
+        "access-control-max-age":               integer,
+        "access-control-request-headers": [
+                                                string
+        ],
+        "age":                                  integer,
+        "allow": [
+                                                string
+        ],
+        "alt-svc": [
+                                                string
+        ],
+        "cache-control": [
+                                                string
+        ],
+        "clear-site-data": [
+                                                string
+        ],
+        "connection": [
+                                                string
+        ],
+        "content-encoding": [
+                                                string
+        ],
+        "content-dpr":                          integer,
+        "content-language": [
+                                                string
+        ],
+        "content-length":                       integer,
+        "content-security-policy": [
+                                                string
+        ],
+        "content-security-policy-report-only": [
+                                                string
+        ],
+        "cookie": [
+                                                string
+        ],
+        "critical-ch": [
+                                                string
+        ],
+        "date":                                 string,
+        "date_epoch_utc":                       integer,
+        "expect-ct": [
+                                                string
+        ],
+        "expires":                              string,
+        "expires_epoch_utc":                    integer,
+        "device-memory":                        integer,
+        "downlink":                             integer,
+        "dpr":                                  integer,
+        "forwarded": [
+                                                string
+        ],
+        "if-match": [
+                                                string
+        ],
+        "if-modified-since":                    string,
+        "if-modified-since_epoch_utc":          integer,
+        "if-none-match": [
+                                                string
+        ],
+        "if-range":                             string,
+        "if-range_epoch_utc":                   integer,
+        "if-unmodified-since":                  string,
+        "if-unmodified-since_epoch_utc":        integer,
+        "im": [
+                                                string
+        ],
+        "keep-alive": [
+                                                string
+        ],
+        "large-allocation":                     integer,
+        "last-modified":                        string,
+        "last-modified_epoch_utc":              integer,
+        "link": [
+                                                string
+        ],
+        "max-forwards":                         integer,
+        "memento-datetime":                     string,
+        "memento-datetime_epoch_utc":           integer,
+        "permissions-policy": [
+                                                string
+        ],
+        "permissions-policy-report-only": [
+                                                string
+        ],
+        "pragma": [
+                                                string
+        ],
+        "proxy-authenticate": [
+                                                string
+        ],
+        "reporting-endpoints": [
+                                                string
+        ],
+        "retry-after":                          string,
+        "retry-after_epoch_utc":                integer,
+        "rtt":                                  integer,
+        "sec-ch-ua": [
+                                                string
+        ],
+        "sec-ch-ua-full-version-list": [
+                                                string
+        ],
+        "server": [
+                                                string
+        ],
+        "server-timing": [
+                                                string
+        ],
+        "set-cookie": [
+                                                string
+        ],
+        "timing-allow-origin": [
+                                                string
+        ],
+        "trailer": [
+                                                string
+        ],
+        "transfer-encoding": [
+                                                string
+        ],
+        "upgrade": [
+                                                string
+        ],
+        "upgrade-insecure-requests":            integer,
+        "vary": [
+                                                string
+        ],
+        "via": [
+                                                string
+        ],
+        "warning": [
+                                                string
+        ],
+        "www-authenticate": [
+                                                string
+        ],
+        "x-cache-hits": [
+                                                integer
+        ],
+        "x-content-duration":                   float
+      }
+    ]
+
+Examples:
+
+    $ cat headers.txt | jc --http-headers -p
+    [
+      {
+        "_type": "request",
+        "_request_method": "HEAD",
+        "_request_uri": "/",
+        "_request_version": "HTTP/1.1",
+        "host": "example.com",
+        "user-agent": "curl/8.1.2",
+        "accept": [
+          "*/*"
+        ]
+      },
+      {
+        "_type": "response",
+        "_response_version": "HTTP/1.1",
+        "_response_status": 200,
+        "_response_reason": [
+          "OK"
+        ],
+        "accept-ranges": [
+          "bytes"
+        ],
+        "age": 140203,
+        "cache-control": [
+          "max-age=604800"
+        ],
+        "content-type": "text/html; charset=UTF-8",
+        "date": "Sun, 04 Feb 2024 02:25:07 GMT",
+        "etag": "\"3147526947\"",
+        "expires": "Sun, 11 Feb 2024 02:25:07 GMT",
+        "last-modified": "Thu, 17 Oct 2019 07:18:26 GMT",
+        "server": [
+          "ECS (sac/252F)"
+        ],
+        "x-cache": "HIT",
+        "content-length": 1256,
+        "date_epoch_utc": 1707013507,
+        "expires_epoch_utc": 1707618307,
+        "last-modified_epoch_utc": 1571296706
+      }
+    ]
+
+    $ cat headers.txt | jc --http-headers -p -r
+    [
+      {
+        "_type": "request",
+        "_request_method": "HEAD",
+        "_request_uri": "/",
+        "_request_version": "HTTP/1.1",
+        "host": "example.com",
+        "user-agent": "curl/8.1.2",
+        "accept": [
+          "*/*"
+        ]
+      },
+      {
+        "_type": "response",
+        "_response_version": "HTTP/1.1",
+        "_response_status": 200,
+        "_response_reason": [
+          "OK"
+        ],
+        "accept-ranges": [
+          "bytes"
+        ],
+        "age": "140203",
+        "cache-control": [
+          "max-age=604800"
+        ],
+        "content-type": "text/html; charset=UTF-8",
+        "date": "Sun, 04 Feb 2024 02:25:07 GMT",
+        "etag": "\"3147526947\"",
+        "expires": "Sun, 11 Feb 2024 02:25:07 GMT",
+        "last-modified": "Thu, 17 Oct 2019 07:18:26 GMT",
+        "server": [
+          "ECS (sac/252F)"
+        ],
+        "x-cache": "HIT",
+        "content-length": "1256"
+      }
+    ]
+
+<a id="jc.parsers.http_headers.parse"></a>
+
+### parse
+
+```python
+def parse(data: str,
+          raw: bool = False,
+          quiet: bool = False) -> List[JSONDictType]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Source: [`jc/parsers/http_headers.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/http_headers.py)
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/id.md
+++ b/docs/parsers/id.md
@@ -128,4 +128,8 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, aix, freebsd

-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/id.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/id.py)
+
+This parser can be used with the `--slurp` command-line option.
+
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/ifconfig.md
+++ b/docs/parsers/ifconfig.md
@@ -240,4 +240,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, aix, freebsd, darwin

+Source: [`jc/parsers/ifconfig.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ifconfig.py)
+
 Version 2.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/ini.md
+++ b/docs/parsers/ini.md
@@ -96,4 +96,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

-Version 2.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/ini.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ini.py)
+
+Version 2.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/ini_dup.md
+++ b/docs/parsers/ini_dup.md
@@ -118,4 +118,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

-Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/ini_dup.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ini_dup.py)
+
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/iostat.md
+++ b/docs/parsers/iostat.md
@@ -182,4 +182,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/iostat.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/iostat.py)
+
 Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/iostat_s.md
+++ b/docs/parsers/iostat_s.md
@@ -130,4 +130,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/iostat_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/iostat_s.py)
+
 Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/ip_address.md
+++ b/docs/parsers/ip_address.md
@@ -552,4 +552,8 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

-Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/ip_address.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ip_address.py)
+
+This parser can be used with the `--slurp` command-line option.
+
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/ip_route.md
+++ b/docs/parsers/ip_route.md
@@ -71,4 +71,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/ip_route.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ip_route.py)
+
 Version 1.0 by Julian Jackson (jackson.julian55@yahoo.com)
--- a/docs/parsers/iptables.md
+++ b/docs/parsers/iptables.md
@@ -186,4 +186,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.9 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/iptables.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/iptables.py)
+
+Version 1.10 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/iw_scan.md
+++ b/docs/parsers/iw_scan.md
@@ -144,4 +144,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/iw_scan.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/iw_scan.py)
+
 Version 0.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/iwconfig.md
+++ b/docs/parsers/iwconfig.md
@@ -108,4 +108,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/iwconfig.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/iwconfig.py)
+
 Version 1.1 by Thomas Vincent (vrince@gmail.com)
--- a/docs/parsers/jar_manifest.md
+++ b/docs/parsers/jar_manifest.md
@@ -100,4 +100,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/jar_manifest.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/jar_manifest.py)
+
 Version 0.01 by Matt J (https://github.com/listuser)
--- a/docs/parsers/jobs.md
+++ b/docs/parsers/jobs.md
@@ -116,4 +116,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd

+Source: [`jc/parsers/jobs.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/jobs.py)
+
 Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/jwt.md
+++ b/docs/parsers/jwt.md
@@ -70,4 +70,8 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/jwt.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/jwt.py)
+
+This parser can be used with the `--slurp` command-line option.
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/kv.md
+++ b/docs/parsers/kv.md
@@ -79,4 +79,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

-Version 2.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/kv.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/kv.py)
+
+Version 2.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/kv_dup.md
+++ b/docs/parsers/kv_dup.md
@@ -0,0 +1,91 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.kv_dup"></a>
+
+# jc.parsers.kv\_dup
+
+jc - JSON Convert `Key/Value` with duplicate key file and string parser
+
+Supports files containing simple key/value pairs and preserves duplicate
+values. All values are contained in lists/arrays.
+
+- Delimiter can be `=` or `:`. Missing values are supported.
+- Comment prefix can be `#` or `;`. Comments must be on their own line.
+- If multi-line values are used, each line will be a separate item in the
+  value list. Blank lines in multi-line values are not supported.
+
+> Note: Values starting and ending with quotation marks will have the marks
+> removed. If you would like to keep the quotation marks, use the `-r`
+> command-line argument or the `raw=True` argument in `parse()`.
+
+Usage (cli):
+
+    $ cat foo.txt | jc --kv-dup
+
+Usage (module):
+
+    import jc
+    result = jc.parse('kv_dup', kv_file_output)
+
+Schema:
+
+Key/Value document converted to a dictionary - see the python configparser
+standard library documentation for more details.
+
+    {
+      "<key1>": [
+                            string
+      ],
+      "<key2>": [
+                            string
+      ]
+    }
+
+Examples:
+
+    $ cat keyvalue.txt
+    # this file contains key/value pairs
+    name = John Doe
+    address=555 California Drive
+    age: 34
+
+    ; comments can include # or ;
+    # delimiter can be = or :
+    # quoted values have quotation marks stripped by default
+    # but can be preserved with the -r argument
+    occupation:"Engineer"
+    occupation = "Pilot"
+
+    $ cat keyvalue.txt | jc --kv-dup -p
+    {
+      "name": ["John Doe"],
+      "address": ["555 California Drive"],
+      "age": ["34"],
+      "occupation": ["Engineer", "Pilot"]
+    }
+
+<a id="jc.parsers.kv_dup.parse"></a>
+
+### parse
+
+```python
+def parse(data, raw=False, quiet=False)
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    Dictionary representing a Key/Value pair document.
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Source: [`jc/parsers/kv_dup.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/kv_dup.py)
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/last.md
+++ b/docs/parsers/last.md
@@ -127,4 +127,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, aix, freebsd

+Source: [`jc/parsers/last.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/last.py)
+
 Version 1.9 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/ls.md
+++ b/docs/parsers/ls.md
@@ -140,4 +140,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd

+Source: [`jc/parsers/ls.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ls.py)
+
 Version 1.12 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/ls_s.md
+++ b/docs/parsers/ls_s.md
@@ -99,4 +99,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd

+Source: [`jc/parsers/ls_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ls_s.py)
+
 Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/lsattr.md
+++ b/docs/parsers/lsattr.md
@@ -86,4 +86,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/lsattr.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/lsattr.py)
+
 Version 1.0 by Mark Rotner (rotner.mr@gmail.com)
--- a/docs/parsers/lsb_release.md
+++ b/docs/parsers/lsb_release.md
@@ -58,4 +58,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/lsb_release.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/lsb_release.py)
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/lsblk.md
+++ b/docs/parsers/lsblk.md
@@ -297,4 +297,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/lsblk.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/lsblk.py)
+
 Version 1.9 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/lsmod.md
+++ b/docs/parsers/lsmod.md
@@ -148,4 +148,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/lsmod.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/lsmod.py)
+
 Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/lsof.md
+++ b/docs/parsers/lsof.md
@@ -142,4 +142,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, aix, freebsd

+Source: [`jc/parsers/lsof.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/lsof.py)
+
 Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/lspci.md
+++ b/docs/parsers/lspci.md
@@ -145,4 +145,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/lspci.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/lspci.py)
+
 Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/lsusb.md
+++ b/docs/parsers/lsusb.md
@@ -330,4 +330,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/lsusb.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/lsusb.py)
+
 Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/m3u.md
+++ b/docs/parsers/m3u.md
@@ -87,4 +87,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/m3u.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/m3u.py)
+
 Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/mdadm.md
+++ b/docs/parsers/mdadm.md
@@ -249,4 +249,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/mdadm.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/mdadm.py)
+
 Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/mount.md
+++ b/docs/parsers/mount.md
@@ -98,4 +98,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, freebsd, aix

+Source: [`jc/parsers/mount.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/mount.py)
+
 Version 1.9 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/mpstat.md
+++ b/docs/parsers/mpstat.md
@@ -137,4 +137,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/mpstat.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/mpstat.py)
+
 Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/mpstat_s.md
+++ b/docs/parsers/mpstat_s.md
@@ -125,4 +125,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/mpstat_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/mpstat_s.py)
+
 Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/netstat.md
+++ b/docs/parsers/netstat.md
@@ -378,4 +378,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, freebsd, win32

+Source: [`jc/parsers/netstat.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/netstat.py)
+
 Version 1.15 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/nmcli.md
+++ b/docs/parsers/nmcli.md
@@ -168,4 +168,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux

+Source: [`jc/parsers/nmcli.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/nmcli.py)
+
 Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/nsd_control.md
+++ b/docs/parsers/nsd_control.md
@@ -87,4 +87,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

-Version 1.0 by Pettai (pettai@sunet.se)
+Source: [`jc/parsers/nsd_control.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/nsd_control.py)
+
+Version 1.1 by Pettai (pettai@sunet.se)
--- a/docs/parsers/ntpq.md
+++ b/docs/parsers/ntpq.md
@@ -229,4 +229,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, freebsd

+Source: [`jc/parsers/ntpq.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ntpq.py)
+
 Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/openvpn.md
+++ b/docs/parsers/openvpn.md
@@ -175,4 +175,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

+Source: [`jc/parsers/openvpn.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/openvpn.py)
+
 Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/os_prober.md
+++ b/docs/parsers/os_prober.md
@@ -63,4 +63,8 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/os_prober.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/os_prober.py)
+
+This parser can be used with the `--slurp` command-line option.
+
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/os_release.md
+++ b/docs/parsers/os_release.md
@@ -83,4 +83,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/os_release.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/os_release.py)
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/passwd.md
+++ b/docs/parsers/passwd.md
@@ -117,4 +117,6 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, aix, freebsd

+Source: [`jc/parsers/passwd.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/passwd.py)
+
 Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/path.md
+++ b/docs/parsers/path.md
@@ -0,0 +1,76 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.path"></a>
+
+# jc.parsers.path
+
+jc - JSON Convert POSIX path string parser
+
+Parse a POSIX path.
+
+Usage (cli):
+
+    $ echo "/Users/admin/.docker/bin" | jc --path
+
+Usage (module):
+
+    import jc
+    result = jc.parse('path', path_string)
+
+Schema:
+
+    {
+      "path":                      string,
+      "parent":                    string,
+      "filename":                  string,
+      "stem":                      string,
+      "extension":                 string,
+      "path_list": [
+                                   string
+      ],
+    }
+
+Examples:
+
+    $ echo "/abc/def/gh.txt" | jc --path -p
+    {
+      "path": "/abc/def/gh.txt",
+      "parent": "/abc/def",
+      "filename": "gh.txt",
+      "stem": "gh",
+      "extension": "txt",
+      "path_list": [
+        "/",
+        "abc",
+        "def",
+        "gh.txt"
+      ]
+    }
+
+<a id="jc.parsers.path.parse"></a>
+
+### parse
+
+```python
+def parse(data, raw=False, quiet=False)
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    Dictionary representing a Key/Value pair document.
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Source: [`jc/parsers/path.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/path.py)
+
+This parser can be used with the `--slurp` command-line option.
+
+Version 1.0 by Michael Nietzold (https://github.com/muescha)
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Kelly Brazil	2cdbebb7fd	Merge pull request #542 from kellyjonbrazil/dev Dev v1.25.1	2024-02-13 00:35:00 +00:00
Kelly Brazil	412f11276a	fix sys.path update	2024-02-12 16:18:52 -08:00
Kelly Brazil	f3dd51f517	hard-code disabled parser path	2024-02-12 15:53:21 -08:00
Kelly Brazil	f66f1aadaa	use shlex to correctly split the /proc files in magic_run_command_str	2024-02-12 15:32:38 -08:00
Kelly Brazil	8ead7e4835	rename List class to _List for documentation purposes	2024-02-12 15:05:44 -08:00
Kelly Brazil	f1177a2606	add more coverage for --quiet cli option	2024-02-12 11:00:27 -08:00
Kelly Brazil	44dc2a74c1	add test for jc -h	2024-02-12 11:00:02 -08:00
Kevin Lyter	d50bd96ce6	[xrandr] Allow props command (#540 ) * [xrandr] Allow props command Responding to issue #525 Somewhat substantial rewriting here to make the parser more resilient - Change parser to not mutate the incoming data list, instead index - Create `Line` class and `categorize` classmethod - Every line is categorized and regexed, so it gets dispatched to the right level of responsibility * Bump version --------- Co-authored-by: Kelly Brazil <kellyjonbrazil@gmail.com>	2024-02-12 09:03:25 -08:00
Kelly Brazil	5cde127a04	raise ParseError instead of output empty object for disabled parser	2024-02-10 14:58:15 -08:00
Kelly Brazil	63d1cead90	enhance uptime parser for busybox output with no user info	2024-02-10 11:55:19 -08:00
Kelly Brazil	d3e7f09ca3	fix for more graceful handling of missing optional libraries	2024-02-10 11:16:38 -08:00
Kelly Brazil	e6bdbb42d3	add more ini tests	2024-02-09 19:32:19 -08:00
Kelly Brazil	3cfc5e3e3c	fix ini parser for edge cases with non-value keys	2024-02-09 17:13:19 -08:00
Kelly Brazil	082d4a3f80	doc update	2024-02-07 11:53:13 -08:00
Kelly Brazil	158c28455b	version bump	2024-02-05 18:30:26 -08:00
Kelly Brazil	efb02493b8	remove extra $ from slicing example	2024-02-05 18:22:05 -08:00
Kelly Brazil	a319ec85ca	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	e754e88f2d	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	cfa7f267fc	update schema	2024-02-06 01:54:31 +00:00
Kelly Brazil	c581e959fa	formatting	2024-02-06 01:54:31 +00:00
Kelly Brazil	9eb56543be	add verbosity check for printing	2024-02-06 01:54:31 +00:00
Kelly Brazil	67643906b1	formatting	2024-02-06 01:54:31 +00:00
Kelly Brazil	14d257225c	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	0411940f75	add full path to error messages	2024-02-06 01:54:31 +00:00
Kelly Brazil	7d60df67f3	check for missing fixtures	2024-02-06 01:54:31 +00:00
Kelly Brazil	70a971a2f1	formatting	2024-02-06 01:54:31 +00:00
Kelly Brazil	3fbdffd028	efibootmgr updates	2024-02-06 01:54:31 +00:00
yaofei zheng	539fe72d16	add "sudo efibootmgr" (without -v) output test case (#534 )	2024-02-06 01:54:31 +00:00
Kelly Brazil	bd6611aaba	doc updates	2024-02-06 01:54:31 +00:00
Kelly Brazil	cf77ddc396	cleanup	2024-02-06 01:54:31 +00:00
Kelly Brazil	77bcd616cd	add tests for curl-head and http-headers parsers	2024-02-06 01:54:31 +00:00
yaofei zheng	5ee2eda83e	add efibootmgr parser (#528 ) * More nsd fixes (#523) * Update nsd_control.py support catz output * Update nsd_control.py fix parsing of catz zones * add testdata add corresponding catz testdata * Revert "More nsd fixes" (#526) * add efibootmgr parser * add efibootmgr completions * Multiple fixes on jc/parsers/efibootmgr.py 1. Update schema in comments. 1. Add an example. 1. Use clean and clear sub string finding sytax. 1. Wrap schema in an object. 1. Make variable scope as small as possible. * add tests for efibootmgr * Update jc/parsers/efibootmgr.py Update example using `--pretty` for output. Co-authored-by: Muescha <184316+muescha@users.noreply.github.com> * jc/parsers/efibootmgr multiple changes 1. convert all keys to "snake_case" 2. add "mirrored_percentage_above_4g" and "mirror_memory_below_4gb" 3. move conversion (from string to other types) to "_process" --------- Co-authored-by: pettai <pettai@sunet.se> Co-authored-by: Kelly Brazil <kellyjonbrazil@gmail.com> Co-authored-by: Muescha <184316+muescha@users.noreply.github.com>	2024-02-06 01:54:31 +00:00
Kelly Brazil	5b849b0275	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	3e5d206f0c	test utils cleanup	2024-02-06 01:54:31 +00:00
Kelly Brazil	f50f96381d	doc update	2024-02-06 01:54:31 +00:00
Muescha	962632ac1f	Feature: generic fixtures tests (#529 ) * add generic test runners * extract generic test runners * beautify messages, remove unused return value * add template and info do CONTRIBUTING * typo --------- Co-authored-by: Kelly Brazil <kellyjonbrazil@gmail.com>	2024-02-06 01:54:31 +00:00
Kelly Brazil	d209780a9d	only add timestamp field if datetime string is parsable	2024-02-06 01:54:31 +00:00
Kelly Brazil	8e5451a7c1	fix for datetime or integer fields	2024-02-06 01:54:31 +00:00
Kelly Brazil	86a09c17cf	remove unused _process function	2024-02-06 01:54:31 +00:00
Kelly Brazil	4bb85195e2	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	39f43aad63	add http_headers and curl_head parsers	2024-02-06 01:54:31 +00:00
Kelly Brazil	29689f7603	formatting	2024-02-06 01:54:31 +00:00
Muescha	78d7ab1308	add info about documentation and completions (#531 )	2024-02-06 01:54:31 +00:00
Kelly Brazil	303cd12de3	version bump to v1.25.0	2024-02-06 01:54:31 +00:00
Kelly Brazil	b65f37e075	add normalize_key() function and tests	2024-02-06 01:54:31 +00:00
Kelly Brazil	c05fa7e9cd	add remove_quotes() to utils and use in ini parsers	2024-02-06 01:54:31 +00:00
Kelly Brazil	264272a8b8	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	7fadb23fea	use convert_size_to_int()	2024-02-06 01:54:31 +00:00
Kelly Brazil	c419e460db	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	6434ff61bf	add HTTP header datetime format	2024-02-06 01:54:31 +00:00
Kelly Brazil	45a1be11e2	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	7659fe470a	formatting	2024-02-06 01:54:31 +00:00
Muescha	c332c4febf	draft for path and path_list (#513 ) * draft for path_list * updaate doc * add input check * fix types * fix schema: add missing properties * add _process * fix _process docs * refactor: extract path.py parser * swap order of names alphabetically * documentation and comments * path parser: add early return for nodata * path and path-list parser: add test and fixtures * typo in file name * add early return for nodata * add test and fixtures * typo in file name * rename fixtures * rename fixtures * refactor to pathlib.Path * failing on windows - use PurePosixPath * changed the way to strip dot from suffix * add POSIX to path * test commit to see results on windows is failing * test commit to see results on windows is failing * add windows path detection * somehow Path not like the newline from input line * add test with more items * remove debug print * wrap test loops into into subTest * remove print statements * add path and path-list to CHANGELOG --------- Co-authored-by: Kelly Brazil <kellyjonbrazil@gmail.com>	2024-02-06 01:54:31 +00:00
Kelly Brazil	2cc212bfab	use convert_size_to_int() from utils	2024-02-06 01:54:31 +00:00
Kelly Brazil	b836ffc583	add tests for convert_size_to_int()	2024-02-06 01:54:31 +00:00
Kelly Brazil	29f1a1d425	fix proc doc - output is dict or list of dicts	2024-02-06 01:54:31 +00:00
Kelly Brazil	9f78dc6afa	proc parser doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	74c7e11948	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	6ba6dc0374	version bump	2024-02-06 01:54:31 +00:00
pettai	ec0f2569e5	More nsd fixes (#523 ) * Update nsd_control.py support catz output * Update nsd_control.py fix parsing of catz zones * add testdata add corresponding catz testdata	2024-02-06 01:54:31 +00:00
Kelly Brazil	65e30c4440	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	8d9ebf5dfa	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	c3746454ff	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	ea0f6493a2	update contributing guide	2024-02-06 01:54:31 +00:00
Kelly Brazil	afbc46076e	add ping tests	2024-02-06 01:54:31 +00:00
Mabuchin	2b9b6550a7	Fix data_bytes is null in ping -I option (#520 ) * fixed header parsing when specifying ping interface * add source_ip parsing test for ping/ping-s --------- Co-authored-by: Kelly Brazil <kellyjonbrazil@gmail.com>	2024-02-06 01:54:31 +00:00
Kelly Brazil	6fb3c0a409	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	1b8911ad36	add slurp docs	2024-02-06 01:54:31 +00:00
Kelly Brazil	cc61b57dd1	add blank line tests to slicer	2024-02-06 01:54:31 +00:00
Kelly Brazil	6d679b2895	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	1e1fc08a47	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	b5c3a03d56	implement slurp by wrapping in a list, adding "_file" for /proc, and further wrapping in {"result": data} when --meta-out is used.	2024-02-06 01:54:31 +00:00
Kelly Brazil	9e269f070f	update slice help doc	2024-02-06 01:54:31 +00:00
Kelly Brazil	f863cfdef4	fix for slicing blank lines	2024-02-06 01:54:31 +00:00
Kelly Brazil	2cd58d75e7	make parser_shortname more robust	2024-02-06 01:54:31 +00:00
Kelly Brazil	03b70eebb7	make /proc slurpable with magic syntax	2024-02-06 01:54:31 +00:00
Kelly Brazil	1e76ce2aea	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	d9fc1b4242	doc update	2024-02-06 01:54:31 +00:00
Muescha	36a3d2e96d	crontab remove double entry in doc (#518 )	2024-02-06 01:54:31 +00:00
Kelly Brazil	bf05de1d63	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	cae41df1d8	add get_parser tests	2024-02-06 01:54:31 +00:00
Kelly Brazil	8e9ff7fa9f	refactor to use get_parser()	2024-02-06 01:54:31 +00:00
Muescha	973c535c72	extract to public jc.get_parser(parser_name) (#516 ) * remove unused imports and RegEx * extract to public jc.get_parser(parser_name) * changed order of exports * add doc * add doc.md * remove data_dir from doc.md --------- Co-authored-by: Kelly Brazil <kellyjonbrazil@gmail.com>	2024-02-06 01:54:31 +00:00
Muescha	8614d3dde9	remove unused imports and RegEx (#515 )	2024-02-06 01:54:31 +00:00
Kelly Brazil	a73ee47bcf	move slurp error message so it will work for all parser types	2024-02-06 01:54:31 +00:00
Kelly Brazil	d54a81831f	update slicer to use utils.line_slice()	2024-02-06 01:54:31 +00:00
Kelly Brazil	73ae1396b9	enhance slurp error message	2024-02-06 01:54:31 +00:00
Kelly Brazil	3399e8551e	add slurpable_parser_mod_list test	2024-02-06 01:54:31 +00:00
Kelly Brazil	b9656c2fae	add line_slice tests	2024-02-06 01:54:31 +00:00
Kelly Brazil	e08ccb7942	add slurp test. fix cli_json_out_pretty test	2024-02-06 01:54:31 +00:00
Kelly Brazil	9b648e8560	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	c97a8fb48f	add line_slice function	2024-02-06 01:54:31 +00:00
Kelly Brazil	3a95407161	back out slurp array flattening code	2024-02-06 01:54:31 +00:00
Kelly Brazil	7609af28b3	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	c2b2e81a2b	add more slurpable parsers	2024-02-06 01:54:31 +00:00
Kelly Brazil	3b0594a4a6	flatten slurp output if parser outputs a list	2024-02-06 01:54:31 +00:00
Kelly Brazil	2b0b9dd7ba	doc update	2024-02-06 01:54:31 +00:00
don Rumata	f159dd6b9d	Add plugins support 4 snapcraft (#512 ) * Added `snap` support. * Added plugins support. * Add README 4 snap. --------- Co-authored-by: Kelly Brazil <kellyjonbrazil@gmail.com>	2024-02-06 01:54:31 +00:00
Kelly Brazil	2d5d87c73d	version bump and doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	a260ceba1c	add slurp functionality	2024-02-06 01:54:31 +00:00
Kelly Brazil	6c30b8106c	use PurePosixPath to fix tests running on Windows	2024-02-06 01:54:31 +00:00
Kelly Brazil	a23921c879	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	3999276d17	add parent, filename, stem, and extension to schema	2024-02-06 01:54:31 +00:00
Kelly Brazil	65bd4850f2	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	d71c2d2b20	add kv_dup tests	2024-02-06 01:54:31 +00:00
Kelly Brazil	6dd5b29998	fix to make None values always a blank string	2024-02-06 01:54:31 +00:00
Kelly Brazil	1868b28f74	doc fix	2024-02-06 01:54:31 +00:00
Kelly Brazil	e8c0bef6ca	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	2c09a06b5a	add kv_dup parser	2024-02-06 01:54:31 +00:00
Kelly Brazil	fc75ce90d1	refactor alias parsers	2024-02-06 01:54:31 +00:00
Kelly Brazil	45a6cfc9cf	add source info to docs	2024-02-06 01:54:31 +00:00
Kelly Brazil	69a0922410	doc update	2024-02-06 01:54:31 +00:00
Kelly Brazil	2bb201a706	fix parser source path	2024-02-06 01:54:31 +00:00
Kelly Brazil	50d5d3a3ba	add opposite endian ipv6 addresses for s390x and other Big Endian architecture support	2024-02-06 01:54:31 +00:00
Kelly Brazil	b14a8980b8	add more info for unit tests	2024-02-06 01:54:31 +00:00
muescha	de6aa1cc92	change `\n` to echo to create new lines	2024-02-06 01:54:31 +00:00
Muescha	c4dcedb269	Update docgen.sh: add link to source	2024-02-06 01:54:31 +00:00
Kelly Brazil	140a61702b	Revert "More nsd fixes" (#526 )	2024-01-26 14:22:13 -08:00
pettai	4d3fc07e3b	More nsd fixes (#523 ) * Update nsd_control.py support catz output * Update nsd_control.py fix parsing of catz zones * add testdata add corresponding catz testdata	2024-01-26 14:20:33 -08:00
Kelly Brazil	dcc4d35d55	Merge branch 'dev' into master	2023-12-21 22:02:56 +00:00
Muescha	cfb30b32f3	Update CONTRIBUTING.md (#509 ) * Update CONTRIBUTING.md fix: - bullet points - fix link to custom plugins - add info about appending to `jc/lib.py` * Update CONTRIBUTING.md fix numbering * typo: lowercase	2023-12-21 07:42:04 -08:00
Kelly Brazil	26f2738471	Merge pull request #502 from kellyjonbrazil/master sync to dev	2023-12-18 20:13:45 +00:00