Merge pull request #477 from kellyjonbrazil/dev

v1.23.6

.github/workflows/pythonapp.yml

@@ -13,11 +13,11 @@ jobs:
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        os: [macos-latest, ubuntu-latest, windows-latest]
-        python-version: ["3.7", "3.8", "3.9", "3.10"]
+        os: [macos-latest, ubuntu-20.04, windows-latest]
+        python-version: ["3.6", "3.7", "3.8", "3.9", "3.10", "3.11"]
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - name: "Set up timezone to America/Los_Angeles"
       uses: szenius/set-timezone@v1.0
       with:
@@ -25,7 +25,7 @@ jobs:
         timezoneMacos: "America/Los_Angeles"
         timezoneWindows: "Pacific Standard Time"
     - name: Set up Python ${{ matrix.python-version }}
-      uses: actions/setup-python@v1
+      uses: actions/setup-python@v4
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies

CHANGELOG

@@ -1,5 +1,342 @@
 jc changelog
 
+20231023 v1.23.6
+- Fix XML parser for xmltodict library versions < 0.13.0
+- Fix `who` command parser for cases when the from field contains spaces
+
+20231021 v1.23.5
+- Add `host` command parser
+- Add `nsd-control` command parser
+- Add `lsb_release` command parser
+- Add `/etc/os-release` file parser
+- Enhance `env` command parser to support multi-line values
+- Enhance `ping` and `ping-s` parsers to add error and corrupted support
+- Enhance `xml` parser to include comments in the JSON output
+- Fix `pidstat` command parser when using `-T ALL`
+- Fix `x509-cert` parser to allow negative serial numbers
+- Fix `x509-cert` parser for cases when bitstrings are larger than standard
+- Fix `xrandr` command parser for associated device issues
+- Fix error when pygments library is not installed
+
+20230730 v1.23.4
+- Add `/etc/resolve.conf` file parser
+- Add `/proc/net/tcp` and `/proc/net/tcp6` file parser
+- Add `find` command parser
+- Add `ip route` command parser
+- Fix `certbot` command parser to be more robust with different line endings
+
+20230621 v1.23.3
+- Add `lsattr` command parser
+- Add `srt` file parser
+- Add `veracrypt` command parser
+- Add X509 Certificate Request file parser
+- Enhance X509 Certificate parser to allow non-compliant email addresses with a warning
+- Enhance `dig` command parser to support the `+nsid` option
+- Enhance `last` and `lastb` command parser to support the `-x` option
+- Enhance `route` command parser to add Windows support
+- Enhnace `netstat` command parser to add Windows support
+- Enhance `ss` command parser to support extended options
+- Enhance the compatibility warning message
+- Fix `bluetoothctl` command parser for some mouse devices
+- Fix `ping` command parsers for output with missing hostname
+- Fix `stat` command parser for older versions that may not contain all fields
+- Fix deprecated option in `setup.cfg`
+
+20230429 v1.23.2
+- Add `bluetoothctl` command parser
+- Add `certbot` command parser for `certificates` and `show_account` options
+- Fix `acpi` command parser for "Not charging" battery status lines
+- Fix `iwconfig` command parser for SSIDs with dashes in the name
+- Fix `crontab` command parsers for incorrect variable parsing in some cases
+- Fix `git-log` and `git-log-s` command parsers for incorrect insertion/deletion parsing
+- Fix `ufw-appinfo` command parser for parsing errors on multiline description fields
+- Fix pytest warnings
+
+20230323 v1.23.1
+- Fix `zpool-status` command parser for lines that start with tab
+- Fix `timedatectl` command parser when RTC set to local
+- Fix to ensure `py.typed` file is included in the package wheel
+- Fix `lsusb` command parser to support CDC MBIM and CDC MBIM Extended fields
+- Add support for the `timesync-status` for the `timedatectl` command parser
+- Fix to ignore non-parser-plugins in the parser plugin directory
+
+20230227 v1.23.0
+- Add input slicing as a `jc` command-line option
+- Add `ssh` configuration file parser
+- Add `ver` Version string parser
+- Add `zpool iostat` command parser
+- Add `zpool status` command parser
+- Fix `acpi` command parser for "will never fully discharge" battery state
+- Fix `crontab` and `crontab-u` command and file parsers for cases where only
+  shortcut schedule items exist
+- Fix `ifconfig` command parser for older-style linux output
+- Fix `xrandr` command parser for proper `is_current` output
+- Fix `xrandr` command parser for infinite loop with some device configurations
+- Add `reflection` key to `xrandr` parser schema
+- Add display model info from EDID to `xrandr` parser
+- Add `MPX-specific VMA` support for VM Flags in `/proc/<pid>/smaps` parser
+
+20230111 v1.22.5
+- Add TOML file parser
+- Add INI with duplicate key support file parser
+- Add AIX support for the `arp` command parser
+- Add AIX support for the `mount` command parser
+- Fix `lsusb` command parser when extra hub port status information is output
+- Refactor `lsusb` command parser for more code reuse
+- Fix INI file parser to include top-level values with no section header
+- Fix INI file parser to not specially handle the [DEFAULT] section
+- Fix INI file and Key/Value parsers to only remove one quotation mark from the
+  beginning and end of values.
+- Update copyright dates
+
+20221230 v1.22.4
+- Add `iwconfig` command parser
+- Add NeXTSTEP format support to the PLIST file parser
+- Fix `proc` parser magic signature detection for `/proc/pid/stat` hacks
+- Fix `x509-cert` parser for string serial numbers
+- Add category tags to parser metadata: generic, standard, file, string, binary, command
+- Add "list parsers by category" view to help
+- Fix python 3.6-related issues
+- Add python 3.6 to automated tests
+
+20221216 v1.22.3
+- Add Common Log Format and Combined Log Format file parser (standard and streaming)
+- Add PostgreSQL password file parser
+- Add openvpn-status.log file parser
+- Add `cbt` command parser (Google Big Table)
+- Enhance `ifconfig` parser with interface lane information on BSD
+- Enhance `ifconfig` parser with additional IPv6 `scope_id` info for BSD
+- Fix `ifconfig` parser to capture some IPv6 addresses missed on BSD
+- Fix `git-log` and `git-log-s` parsers for failure on empty author name
+- Update `os-prober` parser with split EFI partition fields
+- Add ISO string attribute (`.iso`) to `jc.utils.timestamp()`
+- Fix several documentation typos
+
+20221107 v1.22.2
+- add `sshd_conf` parser for `sshd` configuration files and `sshd -T` output
+- add `findmnt` command parser
+- add `git ls-remote` command parser
+- add `os-prober` command parser
+- add SemVer string parser
+- enhance the `ifconfig` parser so it can output multiple IPv4 and IPv6 addresses
+- enhance the `ifconfig` parser so it can output additional fields common on BSD
+- enhance `xml` parser with optional `_` prefix for attributes instead of
+  `@` by using the `--raw` option. This can make it easier to filter the
+  JSON output in some tools.
+- fix the `xml` parser to output a normal Dictionary instead of OrderdDict.
+  This cleans up YAML output. (No `!!omap` comments)
+- fix `csv` and `csv-s` parsers for UTF-8 encoded CSV files with leading BOM bytes
+- fix exit code to be non-zero on interrupt
+- allow parser module objects to be used as arguments to `jc.get_help()` and `jc.parser_info()`
+- catch unexpected exceptions in the CLI
+- add error message on interrupt to STDERR
+- add python 3.11 tests to github actions
+
+20221024 v1.22.1
+- add `udevadm` command parser
+- add `lspci` command parser
+- add `pci.ids` file parser
+- fix `proc-pid-stat` parser for command names with spaces and newlines
+- enhance `ip-address` parser to add `ip_split` field
+- rename `iso-datetime` parser to `datetime-iso`. A deprecation warning will
+  display until `iso-datetime` is removed in a future version.
+- refactor cli module
+- optimize performance of calculated timestamps
+- add more type annotations
+- add support for deprecating parsers
+- move jc-web demo site from heroku to render.com
+
+20220926 v1.22.0
+- Add /proc file parsers for linux. Support for the following files:
+  `/proc/buddyinfo`
+  `/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/unix`
+  `/proc/<pid>/fdinfo/<fd>`
+  `/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`
+- Magic syntax support for `/proc` files
+- Enhance bash and zsh autocompletions for `/proc` files
+- Enhance `free` parser to support `-w` option integer conversions
+- Fix `ini` and `kv` parsers so they don't change keynames to lower case
+  NOTE: This can be a breaking change in your scripts
+- Fix `id` command parser to allow usernames and groupnames with spaces
+- Enhance metadata output to output metadata even when results are empty
+- Optimize tests
+- Optimize documentation build script
+
+20220829 v1.21.2
+- Fix IP Address string parser for older python versions that don't cleanly
+  accept decimal input format - IPv6 fix (e.g. python 3.6)
+
+20220828 v1.21.1
+- Fix IP Address string parser for older python versions that don't cleanly
+  accept decimal input format - IPv4 fix (e.g. python 3.6)
+- Fix `arp -a` parser for cases where incomplete hardware addresses are found
+  in the arp table on linux
+
+20220821 v1.21.0
+- Add IP Address string parser
+- Add Syslog standard and streaming string parsers (RFC 3164 and RFC 5424)
+- Add CEF standard and streaming string parser
+- Add PLIST file parser (XML and binary support)
+- Add `-n` support to the `traceroute` parser
+- Add `mdadm` command parser tested on linux
+- Add `--meta-out` or `-M` option to add metadata to the JSON output, including
+  a UTC timestamp, parser name, magic command, and magic command exit code
+- Fix `lsusb` command parser for output containing a `Device Qualifier` and
+  `Binary Object Store Descriptor` sections
+- Change `LANG=C` to `LC_ALL=C` in locale instructions
+- Add `__main__.py` to package allowing `python -m jc` usage
+- Add an enclosing top-level folder inside the windows.zip package
+
+20220723 v1.20.4
+- Fix URL string parser path list for URLs ending in a forward slash
+
+20220723 v1.20.3
+- Add URL string parser
+- Add Email Address string parser
+- Add JWT string parser
+- Add ISO 8601 Datetime string parser
+- Add UNIX Epoch Timestamp string parser
+- Add M3U/M3U8 file parser
+- Add pager functionality to help (parser documentation only)
+- Minor parser performance optimizations
+
+20220705 v1.20.2
+- Add `gpg --with-colons` parser tested on linux
+- Add DER and PEM encoded X.509 Certificate parser
+- Add Bash and Zsh completion scripts to DEB and RPM packages
+
+20220615 v1.20.1
+- Add `postconf -M` parser tested on linux
+- Update `asciitable` and `asciitable-m` parsers to preserve case in key
+  names when using the `-r` or `raw=True` options.
+- Add long options (e.g. `--help`, `--about`, `--pretty`, etc.)
+- Add shell completions for Bash and Zsh
+- Fix `id` parser for cases where the user or group name is not present
+
+20220531 v1.20.0
+- Add YAML output option with `-y`
+- Add `top -b` standard and streaming parsers tested on linux
+- Add `plugin_parser_count`, `standard_parser_count`, and `streaming_parser_count`
+  keys to `jc -a` output
+- Add `is_compatible` function to the `utils` module
+- Fix `pip-show` parser for packages with a multi-line license field
+- Fix ASCII Table parser for cases where centered headers cause mis-aligned fields
+
+20220513 v1.19.0
+- Add `chage --list` command parser tested on linux
+- Add `git log` command streaming parser
+- Fix `git log` standard parser for corner-cases where hash values are in messages
+- Fix `df` command parser for rare instances when a newline is found at the end
+- Allow jc to pip install on unsupported python version 3.6
+- Fix `asciitable-m` parser to skip some rows that contain column separator
+  characters in cell data. A warning message will be printed to STDERR
+  unless `-q` or `quiet=True` is used.
+
+20220427 v1.18.8
+- Fix `update-alternatives --query` parser for cases where `slaves` are not present
+- Fix UnicodeEncodeError on some systems where LANG=C is set and unicode
+  characters are in the output
+- Update `history` parser: do not drop non-ASCII characters if the system
+  is configured for UTF-8 encoding
+- Enhance "magic syntax" to always use UTF-8 encoding
+
+20220425 v1.18.7
+- Add `git log` command parser
+- Add `update-alternatives --query` parser
+- Add `update-alternatives --get-selections` parser
+- Fix key/value and ini parsers to allow duplicate keys
+- Fix yaml file parser for files including timestamp objects
+- Update `xrandr` parser: add a 'rotation' field
+- Fix failing tests by moving template files
+- Add python interpreter version and path to -v and -a output
+
+20220325 v1.18.6
+- Add `pidstat` command parser tested on linux
+- Add `pidstat` command streaming parser tested on linux
+- Add `mpstat` command parser tested on linux
+- Add `mpstat` command streaming parser tested on linux
+- Add single-line ASCII and Unicode table parser
+- Add multi-line ASCII and Unicode table parser
+- Add documentation option to `parser_info()` and `all_parser_info()`
+
+20220305 v1.18.5
+- Fix date parser to ensure AM/PM period string is always uppercase
+
+20220304 v1.18.4
+- Add nmcli command parser tested on linux
+- Enhance parse error messages at the cli
+- Add standard and streaming parser list functions to the public API
+- Enhance python developer documentation formatting
+
+20220214 v1.18.3
+- Add rsync command and log file parser tested on linux and macOS
+- Add rsync command and log file streaming parser tested on linux and macOS
+- Add xrandr command parser tested on linux
+- Enhance timestamp performance with caching and format hints
+- Refactor ignore_exceptions functionality in streaming parsers
+- Fix man page in packages
+
+20220127 v1.18.2
+- Fix for plugin parsers with underscores in the name
+- Add type hints to public API functions
+- Add plugin attribute to plugin parser metadata
+- Add C locale hint to parsing error messages
+- Refactor more cli code into lib
+
+20220121 v1.18.1
+- Minor fix for MacOS binary
+
+20220121 v1.18.0
+- Add high-level parse API for built-in and plugin parsers
+- Add python module developer documentation
+- Enhance magic syntax exception messages
+- Enhance documentation formatting
+
 20220106 v1.17.7
 - Add stat command streaming parser tested on linux and macOS
 
@@ -319,16 +656,16 @@ jc changelog
 - Add axfr support for dig command parser
 
 20200312 v1.9.2
-- Updated arp parser to fix OSX detection for some edge cases
+- Update arp parser to fix OSX detection for some edge cases
 
 20200312 v1.9.1
-- Updated file command parser to make filename splitting more robust
+- Update file command parser to make filename splitting more robust
 
 20200311 v1.9.0
-- Added ntpq command parser
-- Added timedatectl status command parser
-- Added airport -I and airport -s command parser
-- Added file command parser
+- Add ntpq command parser
+- Add timedatectl status command parser
+- Add airport -I and airport -s command parser
+- Add file command parser
 - Optimized history command parser by https://github.com/philippeitis
 - Magic syntax fix for certain edge cases
 
@@ -336,27 +673,27 @@ jc changelog
 - CLI optimizations by https://github.com/philippeitis
 - Refactored magic syntax function and added tests (https://github.com/philippeitis)
 - Github actions for CI testing on multiple platforms by https://github.com/philippeitis
-- Updated ls parser to fix parsing error in OSX with -lR when there are empty folders
+- Update ls parser to fix parsing error in OSX with -lR when there are empty folders
 
 20200303 v1.8.0
-- Added blkid command parser
-- Added last and lastb command parser
-- Added who command parser
-- Added CSV file parser
-- Added /etc/passwd file parser
-- Added /etc/shadow file parser
-- Added /etc/group file parser
-- Added /etc/gshadow file parser
+- Add blkid command parser
+- Add last and lastb command parser
+- Add who command parser
+- Add CSV file parser
+- Add /etc/passwd file parser
+- Add /etc/shadow file parser
+- Add /etc/group file parser
+- Add /etc/gshadow file parser
 
 20200227 v1.7.5
-- Updated ls parser to support filenames with newline characters
+- Update ls parser to support filenames with newline characters
 
 20200219 v1.7.4
-- Updated ls parser to support multiple directories, globbing, and -R (recursive)
+- Update ls parser to support multiple directories, globbing, and -R (recursive)
 
 20200211 v1.7.3
 - Add alternative 'magic' syntax: e.g. `jc ls -al`
-- Options can now be condensed (e.g. -prq is equivalant to -p -r -q)
+- Options can now be condensed (e.g. -prq is equivalent to -p -r -q)
 
 20200208 v1.7.2
 - Include test fixtures in wheel and sdist
@@ -369,8 +706,8 @@ jc changelog
 - Add crontab file parser with user support (tested on linux)
 - Add __version__ variable to parser modules
 - Add exit code on error
-- Updated history parser to output "line" as an integer
-- Updated compatibility list for some parsers
+- Update history parser to output "line" as an integer
+- Update compatibility list for some parsers
 - Bugfix in crontab file parser: header insertion was clobbering first row
 - Just-in-time loading of parser modules instead of loading all at start
 
@@ -383,7 +720,7 @@ jc changelog
 - Add tests for ls, dig, ps, w, uptime on OSX
 - Add about option
 - Add universal parsers to refactor repetitive code
-- Updated ifconfig parser to output 'state' as an array
+- Update ifconfig parser to output 'state' as an array
 
 20191117 v1.5.1
 - Add ss parser
@@ -396,11 +733,11 @@ jc changelog
 - Add -d option to debug parsing issues
 - Add compatibility warnings to stderr
 - Add documentation
-- Updated iptables parser to allow --line-numbers option
-- Updated lsblk parser to allow parsing of added columns
-- Updated mount parser: changed 'access' field name to 'options'
-- Updated netstat parser to allow parsing of unix sockets and raw network connections
-- Updated w parser to fix unaligned data where blanks are possible
+- Update iptables parser to allow --line-numbers option
+- Update lsblk parser to allow parsing of added columns
+- Update mount parser: changed 'access' field name to 'options'
+- Update netstat parser to allow parsing of unix sockets and raw network connections
+- Update w parser to fix unaligned data where blanks are possible
 - Clean up code and reorganize package
 
 20191031 v1.1.1

MANIFEST.in

@@ -1,3 +1,3 @@
-include jc/man/jc.1.gz
+include jc/py.typed
 include man/jc.1
 include CHANGELOG

README.md

@@ -1,60 +1,87 @@
-![Tests](https://github.com/kellyjonbrazil/jc/workflows/Tests/badge.svg?branch=master)
-![Pypi](https://img.shields.io/pypi/v/jc.svg)
+[![Tests](https://github.com/kellyjonbrazil/jc/workflows/Tests/badge.svg?branch=master)](https://github.com/kellyjonbrazil/jc/actions)
+[![Pypi](https://img.shields.io/pypi/v/jc.svg)](https://pypi.org/project/jc/)
 
-> Try the `jc` [web demo](https://jc-web-demo.herokuapp.com/)
+> Check out the `jc` Python [package documentation](https://github.com/kellyjonbrazil/jc/tree/master/docs) for developers
 
-> JC is [now available](https://galaxy.ansible.com/community/general) as an Ansible filter plugin 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.
+> 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
+[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 CLI output utility
+JSON Convert
 
-`jc` JSONifies the output of many CLI tools and file-types for easier parsing in scripts. See the [**Parsers**](#parsers) section for supported commands and file-types.
+`jc` JSONifies the output of many CLI tools, file-types, and common strings
+for easier parsing in scripts. See the [**Parsers**](#parsers) section for
+supported commands, file-types, and strings.
 ```bash
 dig example.com | jc --dig
 ```
 ```json
-[{"id":38052,"opcode":"QUERY","status":"NOERROR","flags":["qr","rd","ra"],"query_num":1,"answer_num":1,
-"authority_num":0,"additional_num":1,"opt_pseudosection":{"edns":{"version":0,"flags":[],"udp":4096}},"question":
-{"name":"example.com.","class":"IN","type":"A"},"answer":[{"name":"example.com.","class":"IN","type":"A","ttl":
-39049,"data":"93.184.216.34"}],"query_time":49,"server":"2600:1700:bab0:d40::1#53(2600:1700:bab0:d40::1)","when":
-"Fri Apr 16 16:09:00 PDT 2021","rcvd":56,"when_epoch":1618614540,"when_epoch_utc":null}]
+[{"id":38052,"opcode":"QUERY","status":"NOERROR","flags":["qr","rd","ra"],
+"query_num":1,"answer_num":1,"authority_num":0,"additional_num":1,
+"opt_pseudosection":{"edns":{"version":0,"flags":[],"udp":4096}},"question":
+{"name":"example.com.","class":"IN","type":"A"},"answer":[{"name":
+"example.com.","class":"IN","type":"A","ttl":39049,"data":"93.184.216.34"}],
+"query_time":49,"server":"2600:1700:bab0:d40::1#53(2600:1700:bab0:d40::1)",
+"when":"Fri Apr 16 16:09:00 PDT 2021","rcvd":56,"when_epoch":1618614540,
+"when_epoch_utc":null}]
 ```
-This allows further command-line processing of output with tools like `jq` or [`jello`](https://github.com/kellyjonbrazil/jello) by piping commands:
+
+This allows further command-line processing of output with tools like `jq`
+or [`jello`](https://github.com/kellyjonbrazil/jello) by piping commands:
 ```bash
 $ dig example.com | jc --dig | jq -r '.[].answer[].data'
 93.184.216.34
 ```
+
 or using the alternative "magic" syntax:
+
 ```bash
 $ jc dig example.com | jq -r '.[].answer[].data'
 93.184.216.34
 ```
-The `jc` parsers can also be used as python modules. In this case the output will be a python dictionary, or list of dictionaries, instead of JSON:
+
+`jc` can also be used as a python library. In this case the returned value
+will be a python dictionary, a list of dictionaries, or even a
+[lazy iterable of dictionaries](#using-streaming-parsers-as-python-modules)
+instead of JSON:
 ```python
 >>> import subprocess
->>> import jc.parsers.dig
->>> 
->>> cmd_output = subprocess.check_output(['dig', 'example.com'], text=True)
->>> data = jc.parsers.dig.parse(cmd_output)
+>>> import jc
 >>>
->>> data
-[{'id': 64612, 'opcode': 'QUERY', 'status': 'NOERROR', 'flags': ['qr', 'rd', 'ra'], 'query_num': 1, 'answer_num':
-1, 'authority_num': 0, 'additional_num': 1, 'opt_pseudosection': {'edns': {'version': 0, 'flags': [], 'udp':
-4096}}, 'question': {'name': 'example.com.', 'class': 'IN', 'type': 'A'}, 'answer': [{'name': 'example.com.',
-'class': 'IN', 'type': 'A', 'ttl': 29658, 'data': '93.184.216.34'}], 'query_time': 52, 'server':
-'2600:1700:bab0:d40::1#53(2600:1700:bab0:d40::1)', 'when': 'Fri Apr 16 16:13:00 PDT 2021', 'rcvd': 56,
-'when_epoch': 1618614780, 'when_epoch_utc': None}]
+>>> cmd_output = subprocess.check_output(['dig', 'example.com'], text=True)
+>>> data = jc.parse('dig', cmd_output)
+>>>
+>>> data[0]['answer']
+[{'name': 'example.com.', 'class': 'IN', 'type': 'A', 'ttl': 29658, 'data':
+'93.184.216.34'}]
 ```
-Two representations of the data are available. The default representation uses a strict schema per parser and converts known numbers to int/float JSON values. Certain known values of `None` are converted to JSON `null`, known boolean values are converted, and, in some cases, additional semantic context fields are added.
 
-To access the raw, pre-processed JSON, use the `-r` cli option or the `raw=True` function parameter in `parse()`.
+> For `jc` Python package documentation, use `help('jc')`, `help('jc.lib')`, or
+see the [online documentation](https://github.com/kellyjonbrazil/jc/tree/master/docs).
 
-Schemas for each parser can be found at the documentation link beside each [**Parser**](#parsers) below.
+Two representations of the data are available. The default representation uses a
+strict schema per parser and converts known numbers to int/float JSON values.
+Certain known values of `None` are converted to JSON `null`, known boolean
+values are converted, and, in some cases, additional semantic context fields are
+added.
+
+To access the raw, pre-processed JSON, use the `-r` cli option or the `raw=True`
+function parameter in `parse()` when using `jc` as a python library.
+
+Schemas for each parser can be found at the documentation link beside each
+[**Parser**](#parsers) below.
 
 Release notes can be found [here](https://blog.kellybrazil.com/category/jc-news/).
 
 ## Why Would Anyone Do This!?
-For more information on the motivations for this project, please see my blog post on [Bringing the Unix Philosophy to the 21st Century](https://blog.kellybrazil.com/2019/11/26/bringing-the-unix-philosophy-to-the-21st-century/).
+For more information on the motivations for this project, please see my blog
+post on [Bringing the Unix Philosophy to the 21st Century](https://blog.kellybrazil.com/2019/11/26/bringing-the-unix-philosophy-to-the-21st-century/) and my [interview with Console](https://console.substack.com/p/console-89).
 
 See also:
 - [libxo on FreeBSD](http://juniper.github.io/libxo/libxo-manual.html)
@@ -68,164 +95,357 @@ Use Cases:
 - [Ansible command output parsing](https://blog.kellybrazil.com/2020/08/30/parsing-command-output-in-ansible-with-jc/)
 - [Saltstack command output parsing](https://blog.kellybrazil.com/2020/09/15/parsing-command-output-in-saltstack-with-jc/)
 - [Nornir command output parsing](https://blog.kellybrazil.com/2020/12/09/parsing-command-output-in-nornir-with-jc/)
+- [FortiSOAR command output parsing](https://docs.fortinet.com/document/fortisoar/1.0.0/jc-parse-command-output/323/jc-parse-command-output-v1-0-0)
 
 ## Installation
-There are several ways to get `jc`. You can install via `pip`, OS package repositories, via DEB/RPM/MSI packaged binaries for linux and Windows, or by downloading the correct binary for your architecture and running it anywhere on your filesystem.
+There are several ways to get `jc`. You can install via `pip`, OS package
+[repositories](https://repology.org/project/jc/versions), or by downloading the
+correct [binary](https://github.com/kellyjonbrazil/jc/releases) for your
+architecture and running it anywhere on your filesystem.
 
 ### Pip (macOS, linux, unix, Windows)
+[![Pypi](https://img.shields.io/pypi/v/jc.svg)](https://pypi.org/project/jc/)
 ```bash
 pip3 install jc
 ```
 
 ### OS Package Repositories
 
-| OS                    | Command                                                                       | 
-|-----------------------|-------------------------------------------------------------------------------|
-| Debian/Ubuntu linux   | `apt-get install jc`                                                          |
-| Fedora linux          | `dnf install jc`                                                              |
-| openSUSE linux        | `zypper install jc`                                                           |
-| Arch linux            | `pacman -S jc`                                                                |
-| NixOS linux           | `nix-env -iA nixpkgs.jc` or `nix-env -iA nixos.jc`                            |
-| Guix System linux     | `guix install jc`                                                             |
-| macOS                 | `brew install jc`                                                             |
-| FreeBSD               | `portsnap fetch update && cd /usr/ports/textproc/py-jc && make install clean` |
-| Ansible filter plugin | `ansible-galaxy collection install community.general`                         |
+| OS                                   | Command                                                                       |
+|--------------------------------------|-------------------------------------------------------------------------------|
+| Debian/Ubuntu linux                  | `apt-get install jc`                                                          |
+| Fedora linux                         | `dnf install jc`                                                              |
+| openSUSE linux                       | `zypper install jc`                                                           |
+| Arch linux                           | `pacman -S jc`                                                                |
+| NixOS linux                          | `nix-env -iA nixpkgs.jc` or `nix-env -iA nixos.jc`                            |
+| Guix System linux                    | `guix install jc`                                                             |
+| Gentoo Linux                         | `emerge dev-python/jc`                                                        |
+| macOS                                | `brew install jc`                                                             |
+| FreeBSD                              | `portsnap fetch update && cd /usr/ports/textproc/py-jc && make install clean` |
+| Ansible filter plugin                | `ansible-galaxy collection install community.general`                         |
+| FortiSOAR connector                  | Install from FortiSOAR Connector Marketplace                                  |
 
 > For more OS Packages, see https://repology.org/project/jc/versions.
 
-### Binaries and Packages
-For precompiled binaries and packages, see [Releases](https://github.com/kellyjonbrazil/jc/releases) on Github.
+### Binaries
+For precompiled binaries, see [Releases](https://github.com/kellyjonbrazil/jc/releases)
+on Github.
 
 ## Usage
-`jc` accepts piped input from `STDIN` and outputs a JSON representation of the previous command's output to `STDOUT`.
+`jc` accepts piped input from `STDIN` and outputs a JSON representation of the
+previous command's output to `STDOUT`.
 ```bash
-COMMAND | jc PARSER [OPTIONS]
+COMMAND | jc [SLICE] [OPTIONS] PARSER
+cat FILE | jc [SLICE] [OPTIONS] PARSER
+echo STRING | jc [SLICE] [OPTIONS] PARSER
 ```
-Alternatively, the "magic" syntax can be used by prepending `jc` to the command to be converted. Options can be passed to `jc` immediately before the command is given. (Note: command aliases and shell builtins are not supported)
+
+Alternatively, the "magic" syntax can be used by prepending `jc` to the command
+to be converted or in front of the absolute path for Proc files. Options can be
+passed to `jc` immediately before the command or Proc file path is given.
+(Note: command aliases and shell builtins are not supported)
 ```bash
-jc [OPTIONS] COMMAND
+jc [SLICE] [OPTIONS] COMMAND
+jc [SLICE] [OPTIONS] /proc/<path-to-procfile>
 ```
-The JSON output can be compact (default) or pretty formatted with the `-p` option.
+
+The JSON output can be compact (default) or pretty formatted with the `-p`
+option.
 
 ### Parsers
 
-- `--acpi` enables the `acpi` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/acpi))
-- `--airport` enables the `airport -I` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/airport))
-- `--airport-s` enables the `airport -s` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/airport_s))
-- `--arp` enables the `arp` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/arp))
-- `--blkid` enables the `blkid` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/blkid))
-- `--cksum` enables the `cksum` and `sum` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/cksum))
-- `--crontab` enables the `crontab` command and file parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/crontab))
-- `--crontab-u` enables the `crontab` file parser with user support ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/crontab_u))
-- `--csv` enables the CSV file parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/csv))
-- `--csv-s` enables the CSV file streaming parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/csv_s))
-- `--date` enables the `date` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/date))
-- `--df` enables the `df` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/df))
-- `--dig` enables the `dig` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/dig))
-- `--dir` enables the `dir` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/dir))
-- `--dmidecode` enables the `dmidecode` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/dmidecode))
-- `--dpkg-l` enables the `dpkg -l` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/dpkg_l))
-- `--du` enables the `du` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/du))
-- `--env` enables the `env` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/env))
-- `--file` enables the `file` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/file))
-- `--finger` enables the `finger` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/finger))
-- `--free` enables the `free` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/free))
-- `--fstab` enables the `/etc/fstab` file parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/fstab))
-- `--group` enables the `/etc/group` file parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/group))
-- `--gshadow` enables the `/etc/gshadow` file parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/gshadow))
-- `--hash` enables the `hash` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/hash))
-- `--hashsum` enables the hashsum command parser (`md5sum`, `shasum`, etc.) ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/hashsum))
-- `--hciconfig` enables the `hciconfig` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/hciconfig))
-- `--history` enables the `history` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/history))
-- `--hosts` enables the `/etc/hosts` file parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/hosts))
-- `--id` enables the `id` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/id))
-- `--ifconfig` enables the `ifconfig` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/ifconfig))
-- `--ini` enables the INI file parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/ini))
-- `--iostat` enables the `iostat` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/iostat))
-- `--iostat-s` enables the `iostat` command streaming parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/iostat_s))
-- `--iptables` enables the `iptables` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/iptables))
-- `--iw-scan` enables the `iw dev [device] scan` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/iw_scan))
-- `--jar-manifest` enables the MANIFEST.MF file parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/jar_manifest))
-- `--jobs` enables the `jobs` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/jobs))
-- `--kv` enables the Key/Value file parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/kv))
-- `--last` enables the `last` and `lastb` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/last))
-- `--ls` enables the `ls` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/ls))
-- `--ls-s` enables the `ls` command streaming parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/ls_s))
-- `--lsblk` enables the `lsblk` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/lsblk))
-- `--lsmod` enables the `lsmod` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/lsmod))
-- `--lsof` enables the `lsof` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/lsof))
-- `--lsusb` enables the `lsusb` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/lsusb))
-- `--mount` enables the `mount` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/mount))
-- `--netstat` enables the `netstat` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/netstat))
-- `--ntpq` enables the `ntpq -p` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/ntpq))
-- `--passwd` enables the `/etc/passwd` file parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/passwd))
-- `--ping` enables the `ping` and `ping6` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/ping))
-- `--ping-s` enables the `ping` and `ping6` command streaming parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/ping_s))
-- `--pip-list` enables the `pip list` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/pip_list))
-- `--pip-show` enables the `pip show` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/pip_show))
-- `--ps` enables the `ps` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/ps))
-- `--route` enables the `route` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/route))
-- `--rpm-qi` enables the `rpm -qi` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/rpm_qi))
-- `--sfdisk` enables the `sfdisk` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/sfdisk))
-- `--shadow` enables the `/etc/shadow` file parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/shadow))
-- `--ss` enables the `ss` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/ss))
-- `--stat` enables the `stat` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/stat))
-- `--stat-s` enables the `stat` command streaming parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/stat_s))
-- `--sysctl` enables the `sysctl` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/sysctl))
-- `--systemctl` enables the `systemctl` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl))
-- `--systemctl-lj` enables the `systemctl list-jobs` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl_lj))
-- `--systemctl-ls` enables the `systemctl list-sockets` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl_ls))
-- `--systemctl-luf` enables the `systemctl list-unit-files` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl_luf))
-- `--systeminfo` enables the `systeminfo` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/systeminfo))
-- `--time` enables the `/usr/bin/time` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/time))
-- `--timedatectl` enables the `timedatectl status` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/timedatectl))
-- `--tracepath` enables the `tracepath` and `tracepath6` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/tracepath))
-- `--traceroute` enables the `traceroute` and `traceroute6` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/traceroute))
-- `--ufw` enables the `ufw status` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/ufw))
-- `--ufw-appinfo` enables the `ufw app info [application]` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/ufw_appinfo))
-- `--uname` enables the `uname -a` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/uname))
-- `--upower` enables the `upower` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/upower))
-- `--uptime` enables the `uptime` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/uptime))
-- `--vmstat` enables the `vmstat` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/vmstat))
-- `--vmstat-s` enables the `vmstat` command streaming parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/vmstat_s))
-- `--w` enables the `w` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/w))
-- `--wc` enables the `wc` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/wc))
-- `--who` enables the `who` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/who))
-- `--xml` enables the XML file parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/xml))
-- `--yaml` enables the YAML file parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/yaml))
-- `--zipinfo` enables the `zipinfo` command parser ([documentation](https://kellyjonbrazil.github.io/jc/docs/parsers/zipinfo))
+| Argument          | Command or Filetype                                     | Documentation                                                              |
+|-------------------|---------------------------------------------------------|----------------------------------------------------------------------------|
+|          `--acpi` | `acpi` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/acpi)           |
+|       `--airport` | `airport -I` command parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/airport)        |
+|     `--airport-s` | `airport -s` command parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/airport_s)      |
+|           `--arp` | `arp` command parser                                    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/arp)            |
+|    `--asciitable` | ASCII and Unicode table parser                          | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/asciitable)     |
+|  `--asciitable-m` | multi-line ASCII and Unicode table parser               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/asciitable_m)   |
+|         `--blkid` | `blkid` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/blkid)          |
+|  `--bluetoothctl` | `bluetoothctl` command parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/bluetoothctl)   |
+|           `--cbt` | `cbt` (Google Bigtable) command parser                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/cbt)            |
+|           `--cef` | CEF string parser                                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/cef)            |
+|         `--cef-s` | CEF string streaming parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/cef_s)          |
+|       `--certbot` | `certbot` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/certbot)        |
+|         `--chage` | `chage --list` command parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/chage)          |
+|         `--cksum` | `cksum` and `sum` command parser                        | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/cksum)          |
+|           `--clf` | Common and Combined Log Format file parser              | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/clf)            |
+|         `--clf-s` | Common and Combined Log Format file streaming parser    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/clf_s)          |
+|       `--crontab` | `crontab` command and file parser                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/crontab)        |
+|     `--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)          |
+|          `--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)   |
+|            `--df` | `df` command parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/df)             |
+|           `--dig` | `dig` command parser                                    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/dig)            |
+|           `--dir` | `dir` command parser                                    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/dir)            |
+|     `--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)             |
+| `--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)           |
+|          `--find` | `find` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/find)           |
+|       `--findmnt` | `findmnt` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/findmnt)        |
+|        `--finger` | `finger` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/finger)         |
+|          `--free` | `free` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/free)           |
+|         `--fstab` | `/etc/fstab` file parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/fstab)          |
+|       `--git-log` | `git log` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/git_log)        |
+|     `--git-log-s` | `git log` command streaming parser                      | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/git_log_s)      |
+| `--git-ls-remote` | `git ls-remote` command parser                          | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/git_ls_remote)  |
+|           `--gpg` | `gpg --with-colons` command parser                      | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/gpg)            |
+|         `--group` | `/etc/group` file parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/group)          |
+|       `--gshadow` | `/etc/gshadow` file parser                              | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/gshadow)        |
+|          `--hash` | `hash` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/hash)           |
+|       `--hashsum` | hashsum command parser (`md5sum`, `shasum`, etc.)       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/hashsum)        |
+|     `--hciconfig` | `hciconfig` command parser                              | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/hciconfig)      |
+|       `--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)          |
+|            `--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)            |
+|       `--ini-dup` | INI with duplicate key file parser                      | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ini_dup)        |
+|        `--iostat` | `iostat` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/iostat)         |
+|      `--iostat-s` | `iostat` command streaming parser                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/iostat_s)       |
+|    `--ip-address` | IPv4 and IPv6 Address string parser                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ip_address)     |
+|      `--iptables` | `iptables` command parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/iptables)       |
+|      `--ip-route` | `ip route` command parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ip_route)       |
+|       `--iw-scan` | `iw dev [device] scan` command parser                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/iw_scan)        |
+|      `--iwconfig` | `iwconfig` command parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/iwconfig)       |
+|  `--jar-manifest` | Java MANIFEST.MF file parser                            | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/jar_manifest)   |
+|          `--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)             |
+|          `--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)           |
+|        `--lsattr` | `lsattr` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/lsattr)         |
+|   `--lsb-release` | `lsb_release` command parser                            | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/lsb_release)    |
+|         `--lsblk` | `lsblk` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/lsblk)          |
+|         `--lsmod` | `lsmod` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/lsmod)          |
+|          `--lsof` | `lsof` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/lsof)           |
+|         `--lspci` | `lspci -mmv` command parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/lspci)          |
+|         `--lsusb` | `lsusb` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/lsusb)          |
+|           `--m3u` | M3U and M3U8 file parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/m3u)            |
+|         `--mdadm` | `mdadm` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/mdadm)          |
+|         `--mount` | `mount` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/mount)          |
+|        `--mpstat` | `mpstat` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/mpstat)         |
+|      `--mpstat-s` | `mpstat` command streaming parser                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/mpstat_s)       |
+|       `--netstat` | `netstat` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/netstat)        |
+|         `--nmcli` | `nmcli` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/nmcli)          |
+|   `--nsd-control` | `nsd-control` command parser                            | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/nsd_control)    |
+|          `--ntpq` | `ntpq -p` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ntpq)           |
+|       `--openvpn` | openvpn-status.log file parser                          | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/openvpn)        |
+|     `--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)         |
+|       `--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)        |
+|     `--pidstat-s` | `pidstat -H` command streaming parser                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/pidstat_s)      |
+|          `--ping` | `ping` and `ping6` command parser                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ping)           |
+|        `--ping-s` | `ping` and `ping6` command streaming parser             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ping_s)         |
+|      `--pip-list` | `pip list` command parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/pip_list)       |
+|      `--pip-show` | `pip show` command parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/pip_show)       |
+|         `--plist` | PLIST file parser                                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/plist)          |
+|      `--postconf` | `postconf -M` command parser                            | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/postconf)       |
+|          `--proc` | `/proc/` file parser                                    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/proc)           |
+|            `--ps` | `ps` command parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ps)             |
+|  `--resolve-conf` | `/etc/resolve.conf` file parser                         | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/resolve_conf)   |
+|         `--route` | `route` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/route)          |
+|        `--rpm-qi` | `rpm -qi` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/rpm_qi)         |
+|         `--rsync` | `rsync` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/rsync)          |
+|       `--rsync-s` | `rsync` command streaming parser                        | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/rsync_s)        |
+|        `--semver` | Semantic Version string parser                          | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/semver)         |
+|        `--sfdisk` | `sfdisk` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/sfdisk)         |
+|        `--shadow` | `/etc/shadow` file parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/shadow)         |
+|           `--srt` | SRT file parser                                         | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/srt)            |
+|            `--ss` | `ss` command parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ss)             |
+|      `--ssh-conf` | `ssh` config file and `ssh -G` command parser           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ssh_conf)       |
+|     `--sshd-conf` | `sshd` config file and `sshd -T` command parser         | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/sshd_conf)      |
+|          `--stat` | `stat` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/stat)           |
+|        `--stat-s` | `stat` command streaming parser                         | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/stat_s)         |
+|        `--sysctl` | `sysctl` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/sysctl)         |
+|        `--syslog` | Syslog RFC 5424 string parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/syslog)         |
+|      `--syslog-s` | Syslog RFC 5424 string streaming parser                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/syslog_s)       |
+|    `--syslog-bsd` | Syslog RFC 3164 string parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/syslog_bsd)     |
+|  `--syslog-bsd-s` | Syslog RFC 3164 string streaming parser                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/syslog_bsd_s)   |
+|     `--systemctl` | `systemctl` command parser                              | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl)      |
+|  `--systemctl-lj` | `systemctl list-jobs` command parser                    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl_lj)   |
+|  `--systemctl-ls` | `systemctl list-sockets` command parser                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl_ls)   |
+| `--systemctl-luf` | `systemctl list-unit-files` command parser              | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl_luf)  |
+|    `--systeminfo` | `systeminfo` command parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/systeminfo)     |
+|          `--time` | `/usr/bin/time` command parser                          | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/time)           |
+|   `--timedatectl` | `timedatectl status` command parser                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/timedatectl)    |
+|     `--timestamp` | Unix Epoch Timestamp string parser                      | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/timestamp)      |
+|          `--toml` | TOML file parser                                        | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/toml)           |
+|           `--top` | `top -b` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/top)            |
+|         `--top-s` | `top -b` command streaming parser                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/top_s)          |
+|     `--tracepath` | `tracepath` and `tracepath6` command parser             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/tracepath)      |
+|    `--traceroute` | `traceroute` and `traceroute6` command parser           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/traceroute)     |
+|       `--udevadm` | `udevadm info` command parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/udevadm)        |
+|           `--ufw` | `ufw status` command parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ufw)            |
+|   `--ufw-appinfo` | `ufw app info [application]` command parser             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ufw_appinfo)    |
+|         `--uname` | `uname -a` command parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/uname)          |
+| `--update-alt-gs` | `update-alternatives --get-selections` command parser   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/update_alt_gs)  |
+|  `--update-alt-q` | `update-alternatives --query` command parser            | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/update_alt_q)   |
+|        `--upower` | `upower` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/upower)         |
+|        `--uptime` | `uptime` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/uptime)         |
+|           `--url` | URL string parser                                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/url)            |
+|           `--ver` | Version string parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ver)            |
+|     `--veracrypt` | `veracrypt` command parser                              | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/veracrypt)      |
+|        `--vmstat` | `vmstat` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/vmstat)         |
+|      `--vmstat-s` | `vmstat` command streaming parser                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/vmstat_s)       |
+|             `--w` | `w` command parser                                      | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/w)              |
+|            `--wc` | `wc` command parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/wc)             |
+|           `--who` | `who` command parser                                    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/who)            |
+|     `--x509-cert` | X.509 PEM and DER certificate file parser               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/x509_cert)      |
+|      `--x509-csr` | X.509 PEM and DER certificate request file parser       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/x509_csr)       |
+|           `--xml` | XML file parser                                         | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/xml)            |
+|        `--xrandr` | `xrandr` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/xrandr)         |
+|          `--yaml` | YAML file parser                                        | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/yaml)           |
+|       `--zipinfo` | `zipinfo` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/zipinfo)        |
+|  `--zpool-iostat` | `zpool iostat` command parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/zpool_iostat)   |
+|  `--zpool-status` | `zpool status` command parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/zpool_status)   |
 
 ### Options
-- `-a` about `jc`. Prints information about `jc` and the parsers (in JSON, of course!)
-- `-C` force color output even when using pipes (overrides `-m` and the `NO_COLOR` env variable)
-- `-d` debug mode. Prints trace messages if parsing issues are encountered (use `-dd` for verbose debugging)
-- `-h` help. Use `jc -h --parser_name` for parser documentation
-- `-m` monochrome JSON output
-- `-p` pretty format the JSON output
-- `-q` quiet mode. Suppresses parser warning messages (use `-qq` to ignore streaming parser errors)
-- `-r` raw output. Provides a more literal JSON output, typically with string values and no additional semantic processing
-- `-u` unbuffer output
-- `-v` version information
+
+| 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))     |
+
+### Slice
+Line slicing is supported using the `START:STOP` syntax similar to Python
+slicing. This allows you to skip lines at the beginning and/or end of the
+`STDIN` input you would like `jc` to convert.
+
+`START` and `STOP` can be positive or negative integers or blank and allow
+you to specify how many lines to skip and how many lines to process.
+Positive and blank slices are the most memory efficient. Any negative
+integers in the slice will use more memory.
+
+For example, to skip the first and last line of the following text, you
+could express the slice in a couple ways:
+
+```bash
+$ cat table.txt
+      ### We want to skip this header ###
+          col1       col2
+          foo        1
+          bar        2
+      ### We want to skip this footer ###
+$ cat table.txt | jc 1:-1 --asciitable
+[{"col1":"foo","col2":"1"},{"col1":"bar","col2":"2"}]
+$ cat table.txt | jc 1:4 --asciitable
+[{"col1":"foo","col2":"1"},{"col1":"bar","col2":"2"}]
+```
+In this example `1:-1` and `1:4` line slices provide the same output.
+
+When using positive integers the index location of `STOP` is non-inclusive.
+Positive slices count from the first line of the input toward the end
+starting at `0` as the first line. Negative slices count from the last line
+toward the beginning starting at `-1` as the last line. This is also the way
+[Python's slicing](https://stackoverflow.com/questions/509211/understanding-slicing)
+feature works.
+
+Here is a breakdown of line slice options:
+
+| Slice Notation | Input Lines Processed                                        |
+|----------------|--------------------------------------------------------------|
+| `START:STOP`   | lines `START` through `STOP - 1`                             |
+| `START:`       | lines `START` through the rest of the output                 |
+| `:STOP`        | lines from the beginning through `STOP - 1`                  |
+| `-START:STOP`  | `START` lines from the end through `STOP - 1`                |
+| `START:-STOP`  | lines `START` through `STOP` lines from the end              |
+| `-START:-STOP` | `START` lines from the end through `STOP` lines from the end |
+| `-START:`      | `START` lines from the end through the rest of the output    |
+| `:-STOP`       | lines from the beginning through `STOP` lines from the end   |
+| `:`            | all lines                                                    |
 
 ### Exit Codes
-Any fatal errors within `jc` will generate an exit code of `100`, otherwise the exit code will be `0`. When using the "magic" syntax (e.g. `jc ifconfig eth0`), `jc` will store the exit code of the program being parsed and add it to the `jc` exit code. This way it is easier to determine if an error was from the parsed program or `jc`.
+Any fatal errors within `jc` will generate an exit code of `100`, otherwise the
+exit code will be `0`.
+
+When using the "magic" syntax (e.g. `jc ifconfig eth0`),
+`jc` will store the exit code of the program being parsed and add it to the `jc`
+exit code. This way it is easier to determine if an error was from the parsed
+program or `jc`.
 
 Consider the following examples using `ifconfig`:
 
-| `ifconfig` exit code | `jc` exit code | Combined exit code | Interpretation                     | 
+| `ifconfig` exit code | `jc` exit code | Combined exit code | Interpretation                     |
 |----------------------|----------------|--------------------|------------------------------------|
 | `0`                  | `0`            | `0`                | No errors                          |
 | `1`                  | `0`            | `1`                | Error in  `ifconfig`               |
 | `0`                  | `100`          | `100`              | Error in  `jc`                     |
 | `1`                  | `100`          | `101`              | Error in  both `ifconfig` and `jc` |
 
+When using the "magic" syntax you can also retrieve the exit code of the called
+program by using the `--meta-out` or `-M` option. This will append a `_jc_meta`
+object to the output that will include the magic command information, including
+the exit code.
+
+Here is an example with `ping`:
+```bash
+$ jc --meta-out -p ping -c2 192.168.1.252
+{
+  "destination_ip": "192.168.1.252",
+  "data_bytes": 56,
+  "pattern": null,
+  "destination": "192.168.1.252",
+  "packets_transmitted": 2,
+  "packets_received": 0,
+  "packet_loss_percent": 100.0,
+  "duplicates": 0,
+  "responses": [
+    {
+      "type": "timeout",
+      "icmp_seq": 0,
+      "duplicate": false
+    }
+  ],
+  "_jc_meta": {
+    "parser": "ping",
+    "timestamp": 1661357115.27949,
+    "magic_command": [
+      "ping",
+      "-c2",
+      "192.168.1.252"
+    ],
+    "magic_command_exit": 2
+  }
+}
+$ echo $?
+2
+```
 
 ### Setting Custom Colors via Environment Variable
-You can specify custom colors via the `JC_COLORS` environment variable. The `JC_COLORS` environment variable takes four comma separated string values in the following format:
+You can specify custom colors via the `JC_COLORS` environment variable. The
+`JC_COLORS` environment variable takes four comma separated string values in
+the following format:
 ```bash
 JC_COLORS=<keyname_color>,<keyword_color>,<number_color>,<string_color>
 ```
-Where colors are: `black`, `red`, `green`, `yellow`, `blue`, `magenta`, `cyan`, `gray`, `brightblack`, `brightred`, `brightgreen`, `brightyellow`, `brightblue`, `brightmagenta`, `brightcyan`, `white`, or  `default`
+
+Where colors are: `black`, `red`, `green`, `yellow`, `blue`, `magenta`, `cyan`,
+`gray`, `brightblack`, `brightred`, `brightgreen`, `brightyellow`, `brightblue`,
+`brightmagenta`, `brightcyan`, `white`, or  `default`
 
 For example, to set to the default colors:
 ```bash
@@ -237,16 +457,33 @@ JC_COLORS=default,default,default,default
 ```
 
 ### Disable Colors via Environment Variable
-You can set the [`NO_COLOR`](http://no-color.org/) environment variable to any value to disable color output in `jc`. Note that using the `-C` option to force color output will override both the `NO_COLOR` environment variable and the `-m` option.
+You can set the [`NO_COLOR`](http://no-color.org/) environment variable to any
+value to disable color output in `jc`. Note that using the `-C` option to force
+color output will override both the `NO_COLOR` environment variable and the `-m`
+option.
 
 ### Streaming Parsers
-Most parsers load all of the data from STDIN, parse it, then output the entire JSON document serially. There are some streaming parsers (e.g. `ls-s` and `ping-s`) that immediately start processing and outputing the data line-by-line as [JSON Lines](https://jsonlines.org/) (aka [NDJSON](http://ndjson.org/)) while it is being received from STDIN. This can significantly reduce the amount of memory required to parse large amounts of command output (e.g. `ls -lR /`) and can sometimes process the data more quickly. Streaming parsers have slightly different behavior than standard parsers as outlined below.
+Most parsers load all of the data from `STDIN`, parse it, then output the entire
+JSON document serially. There are some streaming parsers (e.g. `ls-s` and
+`ping-s`) that immediately start processing and outputting the data line-by-line
+as [JSON Lines](https://jsonlines.org/) (aka [NDJSON](http://ndjson.org/)) while
+it is being received from `STDIN`. This can significantly reduce the amount of
+memory required to parse large amounts of command output (e.g. `ls -lR /`) and
+can sometimes process the data more quickly. Streaming parsers have slightly
+different behavior than standard parsers as outlined below.
 
 > Note: Streaming parsers cannot be used with the "magic" syntax
 
 #### Ignoring Errors
 
-You may want to ignore parsing errors when using streaming parsers since these may be used in long-lived processing pipelines and errors can break the pipe. To ignore parsing errors, use the `-qq` cli option or the `ignore_exceptions=True` argument with the `parse()` function. This will add a `_jc_meta` object to the JSON output with a `success` attribute. If `success` is `true`, then there were no issues parsing the line. If `success` is `false`, then a parsing issue was found and `error` and `line` fields will be added to include a short error description and the contents of the unparsable line, respectively:
+You may want to ignore parsing errors when using streaming parsers since these
+may be used in long-lived processing pipelines and errors can break the pipe. To
+ignore parsing errors, use the `-qq` cli option or the `ignore_exceptions=True`
+argument with the `parse()` function. This will add a `_jc_meta` object to the
+JSON output with a `success` attribute. If `success` is `true`, then there were
+no issues parsing the line. If `success` is `false`, then a parsing issue was
+found and `error` and `line` fields will be added to include a short error
+description and the contents of the unparsable line, respectively:
 
 Successfully parsed line with `-qq` option:
 ```json
@@ -257,6 +494,7 @@ Successfully parsed line with `-qq` option:
   }
 }
 ```
+
 Unsuccessfully parsed line with `-qq` option:
 ```json
 {
@@ -270,77 +508,131 @@ Unsuccessfully parsed line with `-qq` option:
 
 #### Unbuffering Output
 
-Most operating systems will buffer output that is being piped from process to process. The buffer is usually around 4KB. When viewing the output in the terminal the OS buffer is not engaged so output is immediately displayed on the screen. When piping multiple processes together, though, it may seem as if the output is hanging when the input data is very slow (e.g. `ping`):
+Most operating systems will buffer output that is being piped from process to
+process. The buffer is usually around 4KB. When viewing the output in the
+terminal the OS buffer is not engaged so output is immediately displayed on the
+screen. When piping multiple processes together, though, it may seem as if the
+output is hanging when the input data is very slow (e.g. `ping`):
 ```
 $ ping 1.1.1.1 | jc --ping-s | jq
 <slow output>
 ```
-This is because the OS engages the 4KB buffer between `jc` and `jq` in this example. To display the data on the terminal in realtime, you can disable the buffer with the `-u` (unbuffer) cli option:
+
+This is because the OS engages the 4KB buffer between `jc` and `jq` in this
+example. To display the data on the terminal in realtime, you can disable the
+buffer with the `-u` (unbuffer) cli option:
 ```
 $ ping 1.1.1.1 | jc --ping-s -u | jq
-{"type":"reply","pattern":null,"timestamp":null,"bytes":"64","response_ip":"1.1.1.1","icmp_seq":"1","ttl":"128","time_ms":"24.6","duplicate":false}
-{"type":"reply","pattern":null,"timestamp":null,"bytes":"64","response_ip":"1.1.1.1","icmp_seq":"2","ttl":"128","time_ms":"26.8","duplicate":false}
+{"type":"reply","pattern":null,"timestamp":null,"bytes":"64","respons...}
+{"type":"reply","pattern":null,"timestamp":null,"bytes":"64","respons...}
 ...
 ```
+
 > Note: Unbuffered output can be slower for large data streams.
 
 #### Using Streaming Parsers as Python Modules
 
-Streaming parsers accept any iterable object and return a generator iterator object allowing lazy processing of the data. The input data should iterate on lines of string data. Examples of good input data are `sys.stdin` or `str.splitlines()`.
+Streaming parsers accept any iterable object and return an iterable object
+allowing lazy processing of the data. The input data should iterate on lines
+of string data. Examples of good input data are `sys.stdin` or
+`str.splitlines()`.
 
-To use the generator object in your code, simply loop through it or use the [next()](https://docs.python.org/3/library/functions.html#next) builtin function:
+To use the returned iterable object in your code, simply loop through it or
+use the [next()](https://docs.python.org/3/library/functions.html#next)
+builtin function:
 ```python
-import jc.parsers.ls_s
+import jc
 
-result = jc.parsers.ls_s.parse(ls_command_output.splitlines())
+result = jc.parse('ls_s', ls_command_output.splitlines())
 for item in result:
     print(item["filename"])
 ```
 
-### Custom Parsers
-Custom local parser plugins may be placed in a `jc/jcparsers` folder in your local **"App data directory"**:
+### Parser Plugins
+Parser plugins may be placed in a `jc/jcparsers` folder in your local
+**"App data directory"**:
 
 - Linux/unix: `$HOME/.local/share/jc/jcparsers`
 - macOS: `$HOME/Library/Application Support/jc/jcparsers`
 - Windows: `$LOCALAPPDATA\jc\jc\jcparsers`
 
-Local parser plugins are standard python module files. 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) parser as a template and simply place a `.py` file in the `jcparsers` subfolder.
+Parser plugins are standard python module files. 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)
+parser as a template and simply place a `.py` file in the `jcparsers` subfolder.
+Any dependencies can be placed in the `jc` folder above `jcparsers` and can
+be imported in the parser code.
 
-Local plugin filenames must be valid python module names, therefore must consist entirely of alphanumerics and start with a letter. Local plugins may override default parsers.
+Parser plugin filenames must be valid python module names and therefore must
+start with a letter and consist entirely of alphanumerics and underscores.
+Local plugins may override default parsers.
 
-> Note: The application data directory follows the [XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html)
+> Note: The application data directory follows the
+[XDG Base Directory Specification](https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html)
 
 ### Caveats
 
 #### Locale
 
-For best results set the `LANG` locale environment variable to `C` or `en_US.UTF-8`. For example, either by setting directly on the command-line:
+For best results set the locale environment variables to `C` or
+`en_US.UTF-8` by modifying the `LC_ALL` variable:
 ```
-$ LANG=C date | jc --date
+$ LC_ALL=C date | jc --date
 ```
-or by exporting to the environment before running commands:
+
+You can also set the locale variables individually:
 ```
 $ export LANG=C
+$ export LC_NUMERIC=C
 ```
 
+On some older systems UTF-8 output will be downgraded to ASCII with `\\u`
+escape sequences if the `C` locale does not support UTF-8 encoding.
+
 #### Timezones
 
-Some parsers have calculated epoch timestamp fields added to the output. Unless a timestamp field name has a `_utc` suffix it is considered naive. (i.e. based on the local timezone of the system the `jc` parser was run on).
+Some parsers have calculated epoch timestamp fields added to the output. Unless
+a timestamp field name has a `_utc` suffix it is considered naive. (i.e. based
+on the local timezone of the system the `jc` parser was run on).
 
-If a UTC timezone can be detected in the text of the command output, the timestamp will be timezone aware and have a `_utc` suffix on the key name. (e.g. `epoch_utc`) No other timezones are supported for aware timestamps.
+If a UTC timezone can be detected in the text of the command output, the
+timestamp will be timezone aware and have a `_utc` suffix on the key name.
+(e.g. `epoch_utc`) No other timezones are supported for aware timestamps.
+
+## Use In Other Shells
+`jc` can be used in most any shell. Some modern shells have JSON deserialization
+and filtering capabilities built-in which makes using `jc` even more convenient.
+
+For example, the following is possible in [NGS](https://ngs-lang.org/)
+(Next Generation Shell):
+```bash
+myvar = ``jc dig www.google.com``[0].answer[0].data
+```
+This runs `jc`, parses the output JSON, and assigs the resulting data structure
+to a variable in a single line of code.
+
+For more examples of how to use `jc` in other shells, see this
+[wiki page](https://github.com/kellyjonbrazil/jc/wiki/Using-jc-With-Different-Shells).
 
 ## Compatibility
-Some parsers like `dig`, `xml`, `csv`, etc. will work on any platform. Other parsers that convert platform-specific output will generate a warning message if they are run on an unsupported platform. To see all parser information, including compatibility, run `jc -ap`.
+Some parsers like `dig`, `xml`, `csv`, etc. will work on any platform. Other
+parsers that convert platform-specific output will generate a warning message if
+they are run on an unsupported platform. To see all parser information,
+including compatibility, run `jc -ap`.
 
-You may still use a parser on an unsupported platform - for example, you may want to parse a file with linux `lsof` output on an macOS or Windows laptop. In that case you can suppress the warning message with the `-q` cli option or the `quiet=True` function parameter in `parse()`:
+You may still use a parser on an unsupported platform - for example, you may
+want to parse a file with linux `lsof` output on a macOS or Windows laptop. In
+that case you can suppress the warning message with the `-q` cli option or the
+`quiet=True` function parameter in `parse()`:
 
 macOS:
 ```bash
-cat lsof.out | jc --lsof -q
+cat lsof.out | jc -q --lsof
 ```
+
 or Windows:
 ```bash
-type lsof.out | jc --lsof -q
+type lsof.out | jc -q --lsof
 ```
 
 Tested on:
@@ -357,25 +649,34 @@ Tested on:
 - Windows 2019 Server
 
 ## Contributions
-Feel free to add/improve code or parsers! You can 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 and submit your parser with a pull request.
+Feel free to add/improve code or parsers! You can 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 and submit your parser with a pull
+request.
 
 Please see the [Contributing Guidelines](https://github.com/kellyjonbrazil/jc/blob/master/CONTRIBUTING.md) for more information.
 
 ## Acknowledgments
 - Local parser plugin feature contributed by [Dean Serenevy](https://github.com/duelafn)
 - CI automation and code optimizations by [philippeitis](https://github.com/philippeitis)
-- [`ifconfig-parser`](https://github.com/KnightWhoSayNi/ifconfig-parser) module by KnightWhoSayNi
+- [`ifconfig-parser`](https://github.com/KnightWhoSayNi/ifconfig-parser) module
+  by KnightWhoSayNi
 - [`xmltodict`](https://github.com/martinblech/xmltodict) module by Martín Blech
-- [`ruamel.yaml`](https://pypi.org/project/ruamel.yaml) module by Anthon van der Neut
+- [`ruamel.yaml`](https://pypi.org/project/ruamel.yaml) module by Anthon van
+  der Neut
 - [`trparse`](https://github.com/lbenitez000/trparse) module by Luis Benitez
-- Parsing [code](https://gist.github.com/cahna/43a1a3ff4d075bcd71f9d7120037a501) from Conor Heine adapted for some parsers
+- Parsing [code](https://gist.github.com/cahna/43a1a3ff4d075bcd71f9d7120037a501)
+  from Conor Heine adapted for some parsers
 - Excellent constructive feedback from [Ilya Sher](https://github.com/ilyash-b)
 
 ## Examples
-Here are some examples of `jc` output. For more examples, see [here](https://kellyjonbrazil.github.io/jc/EXAMPLES) or the parser documentation.
+Here are some examples of `jc` output. For more examples, see
+[here](https://kellyjonbrazil.github.io/jc/EXAMPLES) or the parser
+documentation.
+
 ### arp
 ```bash
-arp | jc --arp -p          # or:  jc -p arp
+arp | jc -p --arp          # or:  jc -p arp
 ```
 ```json
 [
@@ -414,7 +715,7 @@ cat homes.csv
 ...
 ```
 ```bash
-cat homes.csv | jc --csv -p
+cat homes.csv | jc -p --csv
 ```
 ```json
 [
@@ -455,7 +756,7 @@ cat homes.csv | jc --csv -p
 ```
 ### /etc/hosts file
 ```bash
-cat /etc/hosts | jc --hosts -p
+cat /etc/hosts | jc -p --hosts
 ```
 ```json
 [
@@ -482,7 +783,7 @@ cat /etc/hosts | jc --hosts -p
 ```
 ### ifconfig
 ```bash
-ifconfig | jc --ifconfig -p          # or:  jc -p ifconfig
+ifconfig | jc -p --ifconfig          # or:  jc -p ifconfig
 ```
 ```json
 [
@@ -526,43 +827,37 @@ ifconfig | jc --ifconfig -p          # or:  jc -p ifconfig
 cat example.ini
 ```
 ```
-[DEFAULT]
-ServerAliveInterval = 45
-Compression = yes
-CompressionLevel = 9
-ForwardX11 = yes
+foo = fiz
+bar = buz
 
-[bitbucket.org]
-User = hg
+[section1]
+fruit = apple
+color = blue
 
-[topsecret.server.com]
-Port = 50022
-ForwardX11 = no
+[section2]
+fruit = pear
+color = green
 ```
 ```bash
-cat example.ini | jc --ini -p
+cat example.ini | jc -p --ini
 ```
 ```json
 {
-  "bitbucket.org": {
-    "serveraliveinterval": "45",
-    "compression": "yes",
-    "compressionlevel": "9",
-    "forwardx11": "yes",
-    "user": "hg"
+  "foo": "fiz",
+  "bar": "buz",
+  "section1": {
+    "fruit": "apple",
+    "color": "blue"
   },
-  "topsecret.server.com": {
-    "serveraliveinterval": "45",
-    "compression": "yes",
-    "compressionlevel": "9",
-    "forwardx11": "no",
-    "port": "50022"
+  "section2": {
+    "fruit": "pear",
+    "color": "green"
   }
 }
 ```
 ### ls
 ```bash
-$ ls -l /usr/bin | jc --ls -p          # or:  jc -p ls -l /usr/bin
+$ ls -l /usr/bin | jc -p --ls          # or:  jc -p ls -l /usr/bin
 ```
 ```json
 [
@@ -598,7 +893,7 @@ $ ls -l /usr/bin | jc --ls -p          # or:  jc -p ls -l /usr/bin
 ```
 ### netstat
 ```bash
-netstat -apee | jc --netstat -p          # or:  jc -p netstat -apee
+netstat -apee | jc -p --netstat          # or:  jc -p netstat -apee
 ```
 ```json
 [
@@ -686,7 +981,7 @@ netstat -apee | jc --netstat -p          # or:  jc -p netstat -apee
 ```
 ### /etc/passwd file
 ```bash
-cat /etc/passwd | jc --passwd -p
+cat /etc/passwd | jc -p --passwd
 ```
 ```json
 [
@@ -712,7 +1007,7 @@ cat /etc/passwd | jc --passwd -p
 ```
 ### ping
 ```bash
-ping 8.8.8.8 -c 3 | jc --ping -p          # or:  jc -p ping 8.8.8.8 -c 3
+ping 8.8.8.8 -c 3 | jc -p --ping          # or:  jc -p ping 8.8.8.8 -c 3
 ```
 ```json
 {
@@ -765,7 +1060,7 @@ ping 8.8.8.8 -c 3 | jc --ping -p          # or:  jc -p ping 8.8.8.8 -c 3
 ```
 ### ps
 ```bash
-ps axu | jc --ps -p          # or:  jc -p ps axu
+ps axu | jc -p --ps          # or:  jc -p ps axu
 ```
 ```json
 [
@@ -780,7 +1075,7 @@ ps axu | jc --ps -p          # or:  jc -p ps axu
     "stat": "Ss",
     "start": "Nov09",
     "time": "0:08",
-    "command": "/usr/lib/systemd/systemd --switched-root --system --deserialize 22"
+    "command": "/usr/lib/systemd/systemd --switched-root --system --deseria..."
   },
   {
     "user": "root",
@@ -812,7 +1107,8 @@ ps axu | jc --ps -p          # or:  jc -p ps axu
 ```
 ### traceroute
 ```bash
-traceroute -m 2 8.8.8.8 | jc --traceroute -p          # or:  jc -p traceroute -m 2 8.8.8.8
+traceroute -m 2 8.8.8.8 | jc -p --traceroute
+# or:  jc -p traceroute -m 2 8.8.8.8
 ```
 ```json
 {
@@ -876,7 +1172,7 @@ traceroute -m 2 8.8.8.8 | jc --traceroute -p          # or:  jc -p traceroute -m
 ```
 ### uptime
 ```bash
-uptime | jc --uptime -p          # or:  jc -p uptime
+uptime | jc -p --uptime          # or:  jc -p uptime
 ```
 ```json
 {
@@ -921,7 +1217,7 @@ cat cd_catalog.xml
   ...
 ```
 ```bash
-cat cd_catalog.xml | jc --xml -p
+cat cd_catalog.xml | jc -p --xml
 ```
 ```json
 {
@@ -973,7 +1269,7 @@ spec:
       mode: ISTIO_MUTUAL
 ```
 ```bash
-cat istio.yaml | jc --yaml -p
+cat istio.yaml | jc -p --yaml
 ```
 ```json
 [
@@ -1011,4 +1307,4 @@ cat istio.yaml | jc --yaml -p
 ]
 ```
 
-© 2019-2022 Kelly Brazil
+© 2019-2023 Kelly Brazil

_config.yml

@@ -1 +1,2 @@
-theme: jekyll-theme-cayman
+theme: jekyll-theme-cayman
+markdown: GFM

build-completions.py

@@ -0,0 +1,9 @@
+#!/usr/bin/env python3
+# build Bash and Zsh completion scripts and add to the completions folder
+from jc.shell_completions import bash_completion, zsh_completion
+
+with open('completions/jc_bash_completion.sh', 'w') as f:
+    print(bash_completion(), file=f)
+
+with open('completions/jc_zsh_completion.sh', 'w') as f:
+    print(zsh_completion(), file=f)

completions/jc_bash_completion.sh

@@ -0,0 +1,90 @@
+_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 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 sysctl systemctl systeminfo timedatectl top tracepath tracepath6 traceroute traceroute6 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 --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 --plist --postconf --proc --proc-buddyinfo --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 --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 --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_about_options=(--about -a)
+    jc_about_mod_options=(--pretty -p --yaml-out -y --monochrome -m --force-color -C)
+    jc_help_options=(--help -h)
+    jc_special_options=(--version -v --bash-comp -B --zsh-comp -Z)
+
+    COMPREPLY=()
+    _get_comp_words_by_ref cur prev words cword
+
+    # if jc_about_options are found anywhere in the line, then only complete from jc_about_mod_options
+    for i in "${words[@]::${#words[@]}-1}"; do
+        if [[ " ${jc_about_options[*]} " =~ " ${i} " ]]; then
+            COMPREPLY=( $( compgen -W "${jc_about_mod_options[*]}" \
+            -- "${cur}" ) )
+            return 0
+        fi
+    done
+
+    # if jc_help_options and a parser are found anywhere in the line, then no more completions
+    if
+        (
+            for i in "${words[@]::${#words[@]}-1}"; do
+                if [[ " ${jc_help_options[*]} " =~ " ${i} " ]]; then
+                    return 0
+                fi
+            done
+            return 1
+        ) && (
+            for i in "${words[@]::${#words[@]}-1}"; do
+                if [[ " ${jc_parsers[*]} " =~ " ${i} " ]]; then
+                    return 0
+                fi
+            done
+            return 1
+        ); then
+        return 0
+    fi
+
+    # if jc_help_options are found anywhere in the line, then only complete with parsers
+    for i in "${words[@]::${#words[@]}-1}"; do
+        if [[ " ${jc_help_options[*]} " =~ " ${i} " ]]; then
+            COMPREPLY=( $( compgen -W "${jc_parsers[*]}" \
+            -- "${cur}" ) )
+            return 0
+        fi
+    done
+
+    # if special options are found anywhere in the line, then no more completions
+    for i in "${words[@]::${#words[@]}-1}"; do
+        if [[ " ${jc_special_options[*]} " =~ " ${i} " ]]; then
+            return 0
+        fi
+    done
+
+    # if magic command is found anywhere in the line, use called command's autocompletion
+    for i in "${words[@]::${#words[@]}-1}"; do
+        if [[ " ${jc_commands[*]} " =~ " ${i} " ]]; then
+            _command
+            return 0
+        fi
+    done
+
+    # if "/pr[oc]" (magic for Procfile parsers) is in the current word, complete with files/directories in the path
+    if [[ "${cur}" =~ "/pr" ]]; then
+        _filedir
+        return 0
+    fi
+
+    # if a parser arg is found anywhere in the line, only show options and help options
+    for i in "${words[@]::${#words[@]}-1}"; do
+        if [[ " ${jc_parsers[*]} " =~ " ${i} " ]]; then
+            COMPREPLY=( $( compgen -W "${jc_options[*]} ${jc_help_options[*]}" \
+            -- "${cur}" ) )
+            return 0
+        fi
+    done
+
+    # default completion
+    COMPREPLY=( $( compgen -W "${jc_options[*]} ${jc_about_options[*]} ${jc_help_options[*]} ${jc_special_options[*]} ${jc_parsers[*]} ${jc_commands[*]}" \
+        -- "${cur}" ) )
+} &&
+complete -F _jc jc
+

completions/jc_zsh_completion.sh

@@ -0,0 +1,451 @@
+#compdef jc
+
+_jc() {
+    local -a jc_commands jc_commands_describe \
+             jc_parsers jc_parsers_describe \
+             jc_options jc_options_describe \
+             jc_about_options jc_about_options_describe \
+             jc_about_mod_options jc_about_mod_options_describe \
+             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 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 sysctl systemctl systeminfo timedatectl top tracepath tracepath6 traceroute traceroute6 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.'
+        'arp:run "arp" command with magic syntax.'
+        'blkid:run "blkid" command with magic syntax.'
+        'bluetoothctl:run "bluetoothctl" command with magic syntax.'
+        'cbt:run "cbt" command with magic syntax.'
+        'certbot:run "certbot" command with magic syntax.'
+        'chage:run "chage" command with magic syntax.'
+        'cksum:run "cksum" command with magic syntax.'
+        'crontab:run "crontab" command with magic syntax.'
+        'date:run "date" command with magic syntax.'
+        'df:run "df" command with magic syntax.'
+        'dig:run "dig" command with magic syntax.'
+        'dmidecode:run "dmidecode" command with magic syntax.'
+        'dpkg:run "dpkg" command with magic syntax.'
+        'du:run "du" 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.'
+        'finger:run "finger" command with magic syntax.'
+        'free:run "free" command with magic syntax.'
+        'git:run "git" command with magic syntax.'
+        'gpg:run "gpg" command with magic syntax.'
+        'hciconfig:run "hciconfig" command with magic syntax.'
+        'host:run "host" command with magic syntax.'
+        'id:run "id" command with magic syntax.'
+        'ifconfig:run "ifconfig" command with magic syntax.'
+        'iostat:run "iostat" command with magic syntax.'
+        'ip:run "ip" command with magic syntax.'
+        'iptables:run "iptables" command with magic syntax.'
+        'iw:run "iw" command with magic syntax.'
+        'iwconfig:run "iwconfig" command with magic syntax.'
+        'jobs:run "jobs" command with magic syntax.'
+        'last:run "last" command with magic syntax.'
+        'lastb:run "lastb" command with magic syntax.'
+        'ls:run "ls" command with magic syntax.'
+        'lsattr:run "lsattr" command with magic syntax.'
+        'lsb_release:run "lsb_release" command with magic syntax.'
+        'lsblk:run "lsblk" command with magic syntax.'
+        'lsmod:run "lsmod" command with magic syntax.'
+        'lsof:run "lsof" command with magic syntax.'
+        'lspci:run "lspci" command with magic syntax.'
+        'lsusb:run "lsusb" command with magic syntax.'
+        'md5:run "md5" command with magic syntax.'
+        'md5sum:run "md5sum" command with magic syntax.'
+        'mdadm:run "mdadm" command with magic syntax.'
+        'mount:run "mount" command with magic syntax.'
+        'mpstat:run "mpstat" command with magic syntax.'
+        'netstat:run "netstat" command with magic syntax.'
+        'nmcli:run "nmcli" command with magic syntax.'
+        'nsd-control:run "nsd-control" command with magic syntax.'
+        'ntpq:run "ntpq" command with magic syntax.'
+        'os-prober:run "os-prober" command with magic syntax.'
+        'pidstat:run "pidstat" command with magic syntax.'
+        'ping:run "ping" command with magic syntax.'
+        'ping6:run "ping6" command with magic syntax.'
+        'pip:run "pip" command with magic syntax.'
+        'pip3:run "pip3" command with magic syntax.'
+        'postconf:run "postconf" command with magic syntax.'
+        'printenv:run "printenv" command with magic syntax.'
+        'ps:run "ps" command with magic syntax.'
+        'route:run "route" command with magic syntax.'
+        'rpm:run "rpm" command with magic syntax.'
+        'rsync:run "rsync" command with magic syntax.'
+        'sfdisk:run "sfdisk" command with magic syntax.'
+        'sha1sum:run "sha1sum" command with magic syntax.'
+        'sha224sum:run "sha224sum" command with magic syntax.'
+        'sha256sum:run "sha256sum" command with magic syntax.'
+        'sha384sum:run "sha384sum" command with magic syntax.'
+        'sha512sum:run "sha512sum" command with magic syntax.'
+        'shasum:run "shasum" command with magic syntax.'
+        'ss:run "ss" command with magic syntax.'
+        'ssh:run "ssh" command with magic syntax.'
+        'sshd:run "sshd" command with magic syntax.'
+        'stat:run "stat" command with magic syntax.'
+        'sum:run "sum" command with magic syntax.'
+        'sysctl:run "sysctl" command with magic syntax.'
+        'systemctl:run "systemctl" command with magic syntax.'
+        'systeminfo:run "systeminfo" command with magic syntax.'
+        'timedatectl:run "timedatectl" command with magic syntax.'
+        'top:run "top" command with magic syntax.'
+        'tracepath:run "tracepath" command with magic syntax.'
+        'tracepath6:run "tracepath6" command with magic syntax.'
+        'traceroute:run "traceroute" command with magic syntax.'
+        'traceroute6:run "traceroute6" command with magic syntax.'
+        'udevadm:run "udevadm" command with magic syntax.'
+        'ufw:run "ufw" command with magic syntax.'
+        'uname:run "uname" command with magic syntax.'
+        'update-alternatives:run "update-alternatives" command with magic syntax.'
+        'upower:run "upower" command with magic syntax.'
+        'uptime:run "uptime" command with magic syntax.'
+        'vdir:run "vdir" command with magic syntax.'
+        'veracrypt:run "veracrypt" command with magic syntax.'
+        'vmstat:run "vmstat" command with magic syntax.'
+        'w:run "w" command with magic syntax.'
+        'wc:run "wc" command with magic syntax.'
+        'who:run "who" command with magic syntax.'
+        'xrandr:run "xrandr" command with magic syntax.'
+        '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 --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 --plist --postconf --proc --proc-buddyinfo --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 --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 --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'
+        '--airport-s:`airport -s` command parser'
+        '--arp:`arp` command parser'
+        '--asciitable:ASCII and Unicode table parser'
+        '--asciitable-m:multi-line ASCII and Unicode table parser'
+        '--blkid:`blkid` command parser'
+        '--bluetoothctl:`bluetoothctl` command parser'
+        '--cbt:`cbt` (Google Bigtable) command parser'
+        '--cef:CEF string parser'
+        '--cef-s:CEF string streaming parser'
+        '--certbot:`certbot` command parser'
+        '--chage:`chage --list` command parser'
+        '--cksum:`cksum` and `sum` command parser'
+        '--clf:Common and Combined Log Format file parser'
+        '--clf-s:Common and Combined Log Format file streaming parser'
+        '--crontab:`crontab` command and file parser'
+        '--crontab-u:`crontab` file parser with user support'
+        '--csv:CSV file parser'
+        '--csv-s:CSV file streaming parser'
+        '--date:`date` command parser'
+        '--datetime-iso:ISO 8601 Datetime string parser'
+        '--df:`df` command parser'
+        '--dig:`dig` command parser'
+        '--dir:`dir` command parser'
+        '--dmidecode:`dmidecode` command parser'
+        '--dpkg-l:`dpkg -l` command parser'
+        '--du:`du` command parser'
+        '--email-address:Email Address string parser'
+        '--env:`env` command parser'
+        '--file:`file` command parser'
+        '--find:`find` command parser'
+        '--findmnt:`findmnt` command parser'
+        '--finger:`finger` command parser'
+        '--free:`free` command parser'
+        '--fstab:`/etc/fstab` file parser'
+        '--git-log:`git log` command parser'
+        '--git-log-s:`git log` command streaming parser'
+        '--git-ls-remote:`git ls-remote` command parser'
+        '--gpg:`gpg --with-colons` command parser'
+        '--group:`/etc/group` file parser'
+        '--gshadow:`/etc/gshadow` file parser'
+        '--hash:`hash` command parser'
+        '--hashsum:hashsum command parser (`md5sum`, `shasum`, etc.)'
+        '--hciconfig:`hciconfig` command parser'
+        '--history:`history` command parser'
+        '--host:`host` command parser'
+        '--hosts:`/etc/hosts` file parser'
+        '--id:`id` command parser'
+        '--ifconfig:`ifconfig` command parser'
+        '--ini:INI file parser'
+        '--ini-dup:INI with duplicate key file parser'
+        '--iostat:`iostat` command parser'
+        '--iostat-s:`iostat` command streaming parser'
+        '--ip-address:IPv4 and IPv6 Address string parser'
+        '--iptables:`iptables` command parser'
+        '--ip-route:`ip route` command parser'
+        '--iw-scan:`iw dev [device] scan` command parser'
+        '--iwconfig:`iwconfig` command parser'
+        '--jar-manifest:Java MANIFEST.MF file parser'
+        '--jobs:`jobs` command parser'
+        '--jwt:JWT string parser'
+        '--kv:Key/Value file and string parser'
+        '--last:`last` and `lastb` command parser'
+        '--ls:`ls` command parser'
+        '--ls-s:`ls` command streaming parser'
+        '--lsattr:`lsattr` command parser'
+        '--lsb-release:`lsb_release` command parser'
+        '--lsblk:`lsblk` command parser'
+        '--lsmod:`lsmod` command parser'
+        '--lsof:`lsof` command parser'
+        '--lspci:`lspci -mmv` command parser'
+        '--lsusb:`lsusb` command parser'
+        '--m3u:M3U and M3U8 file parser'
+        '--mdadm:`mdadm` command parser'
+        '--mount:`mount` command parser'
+        '--mpstat:`mpstat` command parser'
+        '--mpstat-s:`mpstat` command streaming parser'
+        '--netstat:`netstat` command parser'
+        '--nmcli:`nmcli` command parser'
+        '--nsd-control:`nsd-control` command parser'
+        '--ntpq:`ntpq -p` command parser'
+        '--openvpn:openvpn-status.log file parser'
+        '--os-prober:`os-prober` command parser'
+        '--os-release:`/etc/os-release` file parser'
+        '--passwd:`/etc/passwd` file parser'
+        '--pci-ids:`pci.ids` file parser'
+        '--pgpass:PostgreSQL password file parser'
+        '--pidstat:`pidstat -H` command parser'
+        '--pidstat-s:`pidstat -H` command streaming parser'
+        '--ping:`ping` and `ping6` command parser'
+        '--ping-s:`ping` and `ping6` command streaming parser'
+        '--pip-list:`pip list` command parser'
+        '--pip-show:`pip show` command parser'
+        '--plist:PLIST file parser'
+        '--postconf:`postconf -M` command parser'
+        '--proc:`/proc/` file parser'
+        '--proc-buddyinfo:`/proc/buddyinfo` file parser'
+        '--proc-consoles:`/proc/consoles` file parser'
+        '--proc-cpuinfo:`/proc/cpuinfo` file parser'
+        '--proc-crypto:`/proc/crypto` file parser'
+        '--proc-devices:`/proc/devices` file parser'
+        '--proc-diskstats:`/proc/diskstats` file parser'
+        '--proc-filesystems:`/proc/filesystems` file parser'
+        '--proc-interrupts:`/proc/interrupts` file parser'
+        '--proc-iomem:`/proc/iomem` file parser'
+        '--proc-ioports:`/proc/ioports` file parser'
+        '--proc-loadavg:`/proc/loadavg` file parser'
+        '--proc-locks:`/proc/locks` file parser'
+        '--proc-meminfo:`/proc/meminfo` file parser'
+        '--proc-modules:`/proc/modules` file parser'
+        '--proc-mtrr:`/proc/mtrr` file parser'
+        '--proc-pagetypeinfo:`/proc/pagetypeinfo` file parser'
+        '--proc-partitions:`/proc/partitions` file parser'
+        '--proc-slabinfo:`/proc/slabinfo` file parser'
+        '--proc-softirqs:`/proc/softirqs` file parser'
+        '--proc-stat:`/proc/stat` file parser'
+        '--proc-swaps:`/proc/swaps` file parser'
+        '--proc-uptime:`/proc/uptime` file parser'
+        '--proc-version:`/proc/version` file parser'
+        '--proc-vmallocinfo:`/proc/vmallocinfo` file parser'
+        '--proc-vmstat:`/proc/vmstat` file parser'
+        '--proc-zoneinfo:`/proc/zoneinfo` file parser'
+        '--proc-driver-rtc:`/proc/driver/rtc` file parser'
+        '--proc-net-arp:`/proc/net/arp` file parser'
+        '--proc-net-dev:`/proc/net/dev` file parser'
+        '--proc-net-dev-mcast:`/proc/net/dev_mcast` file parser'
+        '--proc-net-if-inet6:`/proc/net/if_inet6` file parser'
+        '--proc-net-igmp:`/proc/net/igmp` file parser'
+        '--proc-net-igmp6:`/proc/net/igmp6` file parser'
+        '--proc-net-ipv6-route:`/proc/net/ipv6_route` file parser'
+        '--proc-net-netlink:`/proc/net/netlink` file parser'
+        '--proc-net-netstat:`/proc/net/netstat` file parser'
+        '--proc-net-packet:`/proc/net/packet` file parser'
+        '--proc-net-protocols:`/proc/net/protocols` file parser'
+        '--proc-net-route:`/proc/net/route` file parser'
+        '--proc-net-tcp:`/proc/net/tcp` and `/proc/net/tcp6` file parser'
+        '--proc-net-unix:`/proc/net/unix` file parser'
+        '--proc-pid-fdinfo:`/proc/<pid>/fdinfo/<fd>` file parser'
+        '--proc-pid-io:`/proc/<pid>/io` file parser'
+        '--proc-pid-maps:`/proc/<pid>/maps` file parser'
+        '--proc-pid-mountinfo:`/proc/<pid>/mountinfo` file parser'
+        '--proc-pid-numa-maps:`/proc/<pid>/numa_maps` file parser'
+        '--proc-pid-smaps:`/proc/<pid>/smaps` file parser'
+        '--proc-pid-stat:`/proc/<pid>/stat` file parser'
+        '--proc-pid-statm:`/proc/<pid>/statm` file parser'
+        '--proc-pid-status:`/proc/<pid>/status` file parser'
+        '--ps:`ps` command parser'
+        '--resolve-conf:`/etc/resolve.conf` file parser'
+        '--route:`route` command parser'
+        '--rpm-qi:`rpm -qi` command parser'
+        '--rsync:`rsync` command parser'
+        '--rsync-s:`rsync` command streaming parser'
+        '--semver:Semantic Version string parser'
+        '--sfdisk:`sfdisk` command parser'
+        '--shadow:`/etc/shadow` file parser'
+        '--srt:SRT file parser'
+        '--ss:`ss` command parser'
+        '--ssh-conf:`ssh` config file and `ssh -G` command parser'
+        '--sshd-conf:`sshd` config file and `sshd -T` command parser'
+        '--stat:`stat` command parser'
+        '--stat-s:`stat` command streaming parser'
+        '--sysctl:`sysctl` command parser'
+        '--syslog:Syslog RFC 5424 string parser'
+        '--syslog-s:Syslog RFC 5424 string streaming parser'
+        '--syslog-bsd:Syslog RFC 3164 string parser'
+        '--syslog-bsd-s:Syslog RFC 3164 string streaming parser'
+        '--systemctl:`systemctl` command parser'
+        '--systemctl-lj:`systemctl list-jobs` command parser'
+        '--systemctl-ls:`systemctl list-sockets` command parser'
+        '--systemctl-luf:`systemctl list-unit-files` command parser'
+        '--systeminfo:`systeminfo` command parser'
+        '--time:`/usr/bin/time` command parser'
+        '--timedatectl:`timedatectl status` command parser'
+        '--timestamp:Unix Epoch Timestamp string parser'
+        '--toml:TOML file parser'
+        '--top:`top -b` command parser'
+        '--top-s:`top -b` command streaming parser'
+        '--tracepath:`tracepath` and `tracepath6` command parser'
+        '--traceroute:`traceroute` and `traceroute6` command parser'
+        '--udevadm:`udevadm info` command parser'
+        '--ufw:`ufw status` command parser'
+        '--ufw-appinfo:`ufw app info [application]` command parser'
+        '--uname:`uname -a` command parser'
+        '--update-alt-gs:`update-alternatives --get-selections` command parser'
+        '--update-alt-q:`update-alternatives --query` command parser'
+        '--upower:`upower` command parser'
+        '--uptime:`uptime` command parser'
+        '--url:URL string parser'
+        '--ver:Version string parser'
+        '--veracrypt:`veracrypt` command parser'
+        '--vmstat:`vmstat` command parser'
+        '--vmstat-s:`vmstat` command streaming parser'
+        '--w:`w` command parser'
+        '--wc:`wc` command parser'
+        '--who:`who` command parser'
+        '--x509-cert:X.509 PEM and DER certificate file parser'
+        '--x509-csr:X.509 PEM and DER certificate request file parser'
+        '--xml:XML file parser'
+        '--xrandr:`xrandr` command parser'
+        '--yaml:YAML file parser'
+        '--zipinfo:`zipinfo` command parser'
+        '--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_describe=(
+        '--force-color:force color output (overrides -m)'
+        '-C:force color output (overrides -m)'
+        '--debug:debug (double for verbose debug)'
+        '-d:debug (double for verbose debug)'
+        '--monochrome:monochrome output'
+        '-m:monochrome output'
+        '--meta-out:add metadata to output including timestamp, etc.'
+        '-M:add metadata to output including timestamp, etc.'
+        '--pretty:pretty print output'
+        '-p:pretty print output'
+        '--quiet:suppress warnings (double to ignore streaming errors)'
+        '-q:suppress warnings (double to ignore streaming errors)'
+        '--raw:raw output'
+        '-r:raw output'
+        '--unbuffer:unbuffer output'
+        '-u:unbuffer output'
+        '--yaml-out:YAML output'
+        '-y:YAML output'
+    )
+    jc_about_options=(--about -a)
+    jc_about_options_describe=(
+        '--about:about jc'
+        '-a:about jc'
+    )
+    jc_about_mod_options=(--pretty -p --yaml-out -y --monochrome -m --force-color -C)
+    jc_about_mod_options_describe=(
+        '--pretty:pretty print output'
+        '-p:pretty print output'
+        '--yaml-out:YAML output'
+        '-y:YAML output'
+        '--monochrome:monochrome output'
+        '-m:monochrome output'
+        '--force-color:force color output (overrides -m)'
+        '-C:force color output (overrides -m)'
+    )
+    jc_help_options=(--help -h)
+    jc_help_options_describe=(
+        '--help:help (--help --parser_name for parser documentation)'
+        '-h:help (--help --parser_name for parser documentation)'
+    )
+    jc_special_options=(--version -v --bash-comp -B --zsh-comp -Z)
+    jc_special_options_describe=(
+        '--version:version info'
+        '-v:version info'
+        '--bash-comp:gen Bash completion: jc -B > /etc/bash_completion.d/jc'
+        '-B:gen Bash completion: jc -B > /etc/bash_completion.d/jc'
+        '--zsh-comp:gen Zsh completion: jc -Z > "${fpath[1]}/_jc"'
+        '-Z:gen Zsh completion: jc -Z > "${fpath[1]}/_jc"'
+    )
+
+    # if jc_about_options are found anywhere in the line, then only complete from jc_about_mod_options
+    for i in ${words:0:-1}; do
+        if (( $jc_about_options[(Ie)${i}] )); then
+            _describe 'commands' jc_about_mod_options_describe
+            return 0
+        fi
+    done
+
+    # if jc_help_options and a parser are found anywhere in the line, then no more completions
+     if
+        (
+            for i in ${words:0:-1}; do
+                if (( $jc_help_options[(Ie)${i}] )); then
+                    return 0
+                fi
+            done
+            return 1
+        ) && (
+            for i in ${words:0:-1}; do
+                if (( $jc_parsers[(Ie)${i}] )); then
+                    return 0
+                fi
+            done
+            return 1
+        ); then
+        return 0
+    fi
+
+    # if jc_help_options are found anywhere in the line, then only complete with parsers
+    for i in ${words:0:-1}; do
+        if (( $jc_help_options[(Ie)${i}] )); then
+            _describe 'commands' jc_parsers_describe
+            return 0
+        fi
+    done
+
+    # if special options are found anywhere in the line, then no more completions
+    for i in ${words:0:-1}; do
+        if (( $jc_special_options[(Ie)${i}] )); then
+            return 0
+        fi
+    done
+
+    # if magic command is found anywhere in the line, use called command's autocompletion
+    for i in ${words:0:-1}; do
+        if (( $jc_commands[(Ie)${i}] )); then
+            # hack to remove options between jc and the magic command
+            shift $(( ${#words} - 2 )) words
+            words[1,0]=(jc)
+            CURRENT=${#words}
+
+            # run the magic command's completions
+            _arguments '*::arguments:_normal'
+            return 0
+        fi
+    done
+
+    # if "/pr[oc]" (magic for Procfile parsers) is in the current word, complete with files/directories in the path
+    if [[ "${words[-1]}" =~ "/pr" ]]; then
+        # run files completion
+        _files
+        return 0
+    fi
+
+    # if a parser arg is found anywhere in the line, only show options and help options
+    for i in ${words:0:-1}; do
+        if (( $jc_parsers[(Ie)${i}] )); then
+            _describe 'commands' jc_options_describe -- jc_help_options_describe
+            return 0
+        fi
+    done
+
+    # default completion
+    _describe 'commands' jc_options_describe -- jc_about_options_describe -- jc_help_options_describe -- jc_special_options_describe -- jc_parsers_describe -- jc_commands_describe
+}
+
+_jc
+

docgen.sh

@@ -1,37 +1,139 @@
 #!/bin/bash
 # Generate docs.md
-# requires pydoc-markdown 2.1.0.post1
+# requires pydoc-markdown 4.6.1
+
+# use ./docgen all to generate all docs
+
+readme_config=$(cat <<'EOF'
+{
+    "processors": [
+        {
+            "type": "filter"
+        },
+        {
+            "type": "pydocmd"
+        }
+    ],
+    "renderer": {
+        "type": "markdown",
+        "header_level_by_type": {
+            "Module": 1,
+            "Class": 3,
+            "Method": 3,
+            "Function": 3,
+            "Variable": 3
+        }
+    }
+}
+EOF
+)
+
+toc_config=$(cat <<'EOF'
+{
+    "processors": [
+        {
+            "type": "filter"
+        },
+        {
+            "type": "pydocmd"
+        }
+    ],
+    "renderer": {
+        "type": "markdown",
+        "render_toc": true,
+        "header_level_by_type": {
+            "Module": 1,
+            "Class": 3,
+            "Method": 3,
+            "Function": 3,
+            "Variable": 3
+        }
+    }
+}
+EOF
+)
+
+parser_config=$(cat <<'EOF'
+{
+    "processors": [
+        {
+            "type": "filter",
+            "expression": "not name == \"info\" and not name.startswith(\"_\") and default()"
+        },
+        {
+            "type": "pydocmd"
+        }
+    ],
+    "renderer": {
+        "type": "markdown",
+        "header_level_by_type": {
+            "Module": 1,
+            "Class": 3,
+            "Method": 3,
+            "Function": 3,
+            "Variable": 3
+        }
+    }
+}
+EOF
+)
 
 cd jc
-echo Building docs for: package
-pydocmd simple jc+ > ../docs/readme.md
-echo Building docs for: utils
-pydocmd simple utils+ > ../docs/utils.md
+(
+    echo Building docs for: package
+    pydoc-markdown -m jc "${readme_config}" > ../docs/readme.md; echo "+++ package docs complete"
+) &
+
+(
+    echo Building docs for: lib
+    pydoc-markdown -m jc.lib "${toc_config}" > ../docs/lib.md; echo "+++ lib docs complete"
+) &
+
+(
+    echo Building docs for: utils
+    pydoc-markdown -m jc.utils "${toc_config}" > ../docs/utils.md; echo "+++ utils docs complete"
+) &
+
+(
+    echo Building docs for: streaming
+    pydoc-markdown -m jc.streaming "${toc_config}" > ../docs/streaming.md; echo "+++ streaming docs complete"
+) &
+
+(
+    echo Building docs for: universal parser
+    pydoc-markdown -m jc.parsers.universal "${toc_config}" > ../docs/parsers/universal.md; echo "+++ universal parser docs complete"
+) &
 
 # a bit of inception here... jc is being used to help
 # automate the generation of its own documentation. :)
 
 # pull jc parser objects into a bash array from jq
+# filter out any plugin parsers
 parsers=()
 while read -r value
 do
     parsers+=("$value")
-done < <(jc -a | jq -c '.parsers[]')
+done < <(jc -a | jq -c '.parsers[] | select(.plugin != true)')
 
-# iterate over the bash array
-for parser in "${parsers[@]}"
-do
+for parser in "${parsers[@]}"; do
     parser_name=$(jq -r '.name' <<< "$parser")
-    compatible=$(jq -r '.compatible | join(", ")' <<< "$parser")
-    version=$(jq -r '.version' <<< "$parser")
-    author=$(jq -r '.author' <<< "$parser")
-    author_email=$(jq -r '.author_email' <<< "$parser")
+        {
+            if [[ $1 == "all" ]] || ! git diff --quiet --exit-code HEAD~5 -- "parsers/${parser_name}.py"; then
+                compatible=$(jq -r '.compatible | join(", ")' <<< "$parser")
+                version=$(jq -r '.version' <<< "$parser")
+                author=$(jq -r '.author' <<< "$parser")
+                author_email=$(jq -r '.author_email' <<< "$parser")
 
-    echo "Building docs for: ${parser_name}"
-    echo "[Home](https://kellyjonbrazil.github.io/jc/)" > ../docs/parsers/"${parser_name}".md
-    pydocmd simple jc.parsers."${parser_name}"+ >> ../docs/parsers/"${parser_name}".md
-    echo "## Parser Information" >> ../docs/parsers/"${parser_name}".md
-    echo "Compatibility:  ${compatible}" >> ../docs/parsers/"${parser_name}".md
-    echo >> ../docs/parsers/"${parser_name}".md
-    echo "Version ${version} by ${author} (${author_email})" >> ../docs/parsers/"${parser_name}".md
+                echo "Building docs for: ${parser_name}"
+                echo "[Home](https://kellyjonbrazil.github.io/jc/)" > ../docs/parsers/"${parser_name}".md
+                pydoc-markdown -m jc.parsers."${parser_name}" "${parser_config}" >> ../docs/parsers/"${parser_name}".md
+                echo "### Parser Information" >> ../docs/parsers/"${parser_name}".md
+                echo "Compatibility:  ${compatible}" >> ../docs/parsers/"${parser_name}".md
+                echo >> ../docs/parsers/"${parser_name}".md
+                echo "Version ${version} by ${author} (${author_email})" >> ../docs/parsers/"${parser_name}".md
+                echo "+++ ${parser_name} docs complete"
+            fi
+        } &
 done
+wait
+echo "Document Generation Complete"

docs/_config.yml

@@ -1 +0,0 @@
-theme: jekyll-theme-cayman

docs/lib.md

@@ -0,0 +1,215 @@
+# Table of Contents
+
+* [jc.lib](#jc.lib)
+  * [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)
+  * [parser\_info](#jc.lib.parser_info)
+  * [all\_parser\_info](#jc.lib.all_parser_info)
+  * [get\_help](#jc.lib.get_help)
+
+<a id="jc.lib"></a>
+
+# jc.lib
+
+jc - JSON Convert lib module
+
+<a id="jc.lib.parse"></a>
+
+### parse
+
+```python
+def parse(
+    parser_mod_name: Union[str, ModuleType],
+    data: Union[str, bytes, Iterable[str]],
+    quiet: bool = False,
+    raw: bool = False,
+    ignore_exceptions: Optional[bool] = None,
+    **kwargs
+) -> Union[JSONDictType, List[JSONDictType], Iterator[JSONDictType]]
+```
+
+Parse the data (string or bytes) using the supplied parser (string or
+module object).
+
+This function provides a high-level API to simplify parser use. This
+function will call built-in parsers and custom plugin parsers.
+
+Example (standard parsers):
+
+    >>> import jc
+    >>> date_obj = jc.parse('date', 'Tue Jan 18 10:23:07 PST 2022')
+    >>> print(f'The year is: {date_obj["year"]}')
+    The year is: 2022
+
+Example (streaming parsers):
+
+    >>> import jc
+    >>> ping_gen = jc.parse('ping_s', ping_output.splitlines())
+    >>> for item in ping_gen:
+    >>>     print(f'Response time: {item["time_ms"]} ms')
+    Response time: 102 ms
+    Response time: 109 ms
+    ...
+
+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
+    >>> 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:
+
+    >>> import jc.parsers.date
+    >>> jc.parsers.date.parse('Tue Jan 18 10:23:07 PST 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
+parsers without this API:
+
+    >>> import os
+    >>> import sys
+    >>> import jc.appdirs
+    >>> data_dir = jc.appdirs.user_data_dir('jc', 'jc')
+    >>> local_parsers_dir = os.path.join(data_dir, 'jcparsers')
+    >>> sys.path.append(local_parsers_dir)
+    >>> import my_custom_parser
+    >>> my_custom_parser.parse('command_data')
+
+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.
+
+                                     A Module object can also be passed
+                                     directly or via _get_parser()
+
+    data:               (string or   data to parse (string or bytes for
+                        bytes or     standard parsers, iterable of
+                        iterable)    strings for streaming parsers)
+
+    raw:                (boolean)    output preprocessed JSON if True
+
+    quiet:              (boolean)    suppress warning messages if True
+
+    ignore_exceptions:  (boolean)    ignore parsing exceptions if True
+                                     (streaming parsers only)
+
+Returns:
+
+    Standard Parsers:   Dictionary or List of Dictionaries
+    Streaming Parsers:  Generator Object containing Dictionaries
+
+<a id="jc.lib.parser_mod_list"></a>
+
+### parser\_mod\_list
+
+```python
+def parser_mod_list(show_hidden: bool = False,
+                    show_deprecated: bool = False) -> List[str]
+```
+
+Returns a list of all available parser module names.
+
+<a id="jc.lib.plugin_parser_mod_list"></a>
+
+### plugin\_parser\_mod\_list
+
+```python
+def plugin_parser_mod_list(show_hidden: bool = False,
+                           show_deprecated: bool = False) -> List[str]
+```
+
+Returns a list of plugin parser module names. This function is a
+subset of `parser_mod_list()`.
+
+<a id="jc.lib.standard_parser_mod_list"></a>
+
+### standard\_parser\_mod\_list
+
+```python
+def standard_parser_mod_list(show_hidden: bool = False,
+                             show_deprecated: bool = False) -> List[str]
+```
+
+Returns a list of standard parser module names. This function is a
+subset of `parser_mod_list()` and does not contain any streaming
+parsers.
+
+<a id="jc.lib.streaming_parser_mod_list"></a>
+
+### streaming\_parser\_mod\_list
+
+```python
+def streaming_parser_mod_list(show_hidden: bool = False,
+                              show_deprecated: bool = False) -> List[str]
+```
+
+Returns a list of streaming parser module names. This function is a
+subset of `parser_mod_list()`.
+
+<a id="jc.lib.parser_info"></a>
+
+### parser\_info
+
+```python
+def parser_info(parser_mod_name: Union[str, ModuleType],
+                documentation: bool = False) -> ParserInfoType
+```
+
+Returns a dictionary that includes the parser module metadata.
+
+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 as well
+                                     as a parser module object.
+
+    documentation:      (boolean)    include parser docstring if True
+
+<a id="jc.lib.all_parser_info"></a>
+
+### all\_parser\_info
+
+```python
+def all_parser_info(documentation: bool = False,
+                    show_hidden: bool = False,
+                    show_deprecated: bool = False) -> List[ParserInfoType]
+```
+
+Returns a list of dictionaries that includes metadata for all parser
+modules. By default only non-hidden, non-deprecated parsers are
+returned.
+
+Parameters:
+
+    documentation:      (boolean)    include parser docstrings if True
+    show_hidden:        (boolean)    also show parsers marked as hidden
+                                     in their info metadata.
+    show_deprecated:    (boolean)    also show parsers marked as
+                                     deprecated in their info metadata.
+
+<a id="jc.lib.get_help"></a>
+
+### get\_help
+
+```python
+def get_help(parser_mod_name: Union[str, ModuleType]) -> None
+```
+
+Show help screen for the selected parser.
+
+This function will accept **module_name**, **cli-name**, and
+**--argument-name** variants of the module name string as well as a
+parser module object.
+

docs/parsers/acpi.md

@@ -1,20 +1,22 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.acpi"></a>
 
 # jc.parsers.acpi
-jc - JSON CLI output utility `acpi` command output parser
+
+jc - JSON Convert `acpi` command output parser
 
 Usage (cli):
 
     $ acpi -V | jc --acpi
 
-    or
+or
 
     $ jc acpi -V
 
 Usage (module):
 
-    import jc.parsers.acpi
-    result = jc.parsers.acpi.parse(acpi_command_output)
+    import jc
+    result = jc.parse('acpi', acpi_command_output)
 
 Schema:
 
@@ -225,16 +227,12 @@ Examples:
       }
     ]
 
+<a id="jc.parsers.acpi.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -242,14 +240,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux
 
-Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/airport.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.airport"></a>
 
 # jc.parsers.airport
-jc - JSON CLI output utility `airport -I` command output parser
+
+jc - JSON Convert `airport -I` command output parser
 
 The `airport` program can be found at `/System/Library/PrivateFrameworks/Apple80211.framework/Versions/Current/Resources/airport`.
 
@@ -9,14 +11,14 @@ Usage (cli):
 
     $ airport -I | jc --airport
 
-    or
+or
 
     $ jc airport -I
 
 Usage (module):
 
-    import jc.parsers.airport
-    result = jc.parsers.airport.parse(airport_command_output)
+    import jc
+    result = jc.parse('airport', airport_command_output)
 
 Schema:
 
@@ -78,16 +80,12 @@ Examples:
       "channel": "48,80"
     }
 
+<a id="jc.parsers.airport.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -95,14 +93,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     Dictionary. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  darwin
 
-Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/airport_s.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.airport_s"></a>
 
-# jc.parsers.airport_s
-jc - JSON CLI output utility `airport -s` command output parser
+# jc.parsers.airport\_s
+
+jc - JSON Convert `airport -s` command output parser
 
 The `airport` program can be found at `/System/Library/PrivateFrameworks/Apple80211.framework/Versions/Current/Resources/airport`.
 
@@ -9,14 +11,14 @@ Usage (cli):
 
     $ airport -s | jc --airport-s
 
-    or
+or
 
     $ jc airport -s
 
 Usage (module):
 
-    import jc.parsers.airport_s
-    result = jc.parsers.airport_s.parse(airport_s_command_output)
+    import jc
+    result = jc.parse('airport_s', airport_s_command_output)
 
 Schema:
 
@@ -106,16 +108,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.airport_s.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -123,14 +121,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  darwin
 
-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/arp.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.arp"></a>
 
 # jc.parsers.arp
-jc - JSON CLI output utility `arp` command output parser
+
+jc - JSON Convert `arp` command output parser
 
 Supports `arp` and `arp -a` output.
 
@@ -9,14 +11,14 @@ Usage (cli):
 
     $ arp | jc --arp
 
-    or
+or
 
     $ jc arp
 
 Usage (module):
 
-    import jc.parsers.arp
-    result = jc.parsers.arp.parse(arp_command_output)
+    import jc
+    result = jc.parse('arp', arp_command_output)
 
 Schema:
 
@@ -115,16 +117,12 @@ Examples:
       }
     ]
 
+<a id="jc.parsers.arp.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
 ```
 
 Main text parsing function
@@ -132,14 +130,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, aix, freebsd, darwin
 
-Version 1.8 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.12 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/asciitable.md

@@ -0,0 +1,147 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.asciitable"></a>
+
+# jc.parsers.asciitable
+
+jc - JSON Convert `asciitable` parser
+
+This parser converts ASCII and Unicode text tables with single-line rows.
+
+Column headers must be at least two spaces apart from each other and must
+be unique. For best results, column headers should be left-justified. If
+column separators are present, then non-left-justified headers will be fixed
+automatically.
+
+Row separators are optional and are ignored. Each non-row-separator line is
+considered a separate row in the table.
+
+For example:
+
+    ╒══════════╤═════════╤════════╕
+    │ foo      │ bar     │ baz    │
+    ╞══════════╪═════════╪════════╡
+    │ good day │         │ 12345  │
+    ├──────────┼─────────┼────────┤
+    │ hi there │ abc def │ 3.14   │
+    ╘══════════╧═════════╧════════╛
+
+or
+
+    +-----------------------------+
+    | foo        bar       baz    |
+    +-----------------------------+
+    | good day             12345  |
+    | hi there   abc def   3.14   |
+    +-----------------------------+
+
+or
+
+    | foo      | bar     | baz    |
+    |----------|---------|--------|
+    | good day |         | 12345  |
+    | hi there | abc def | 3.14   |
+
+or
+
+    foo        bar       baz
+    ---------  --------  ------
+    good day             12345
+    hi there   abc def   3.14
+
+or
+
+    foo        bar       baz
+    good day             12345
+    hi there   abc def   3.14
+
+etc...
+
+Headers (keys) are converted to snake-case. All values are returned as
+strings, except empty strings, which are converted to None/null.
+
+> Note: To preserve the case of the keys use the `-r` cli option or
+> `raw=True` argument in `parse()`.
+
+Usage (cli):
+
+    $ cat table.txt | jc --asciitable
+
+Usage (module):
+
+    import jc
+    result = jc.parse('asciitable', asciitable_string)
+
+Schema:
+
+    [
+      {
+        "column_name1":     string,    # empty string is null
+        "column_name2":     string     # empty string is null
+      }
+    ]
+
+Examples:
+
+    $ echo '
+    >     ╒══════════╤═════════╤════════╕
+    >     │ foo      │ bar     │ baz    │
+    >     ╞══════════╪═════════╪════════╡
+    >     │ good day │         │ 12345  │
+    >     ├──────────┼─────────┼────────┤
+    >     │ hi there │ abc def │ 3.14   │
+    >     ╘══════════╧═════════╧════════╛' | jc --asciitable -p
+    [
+      {
+        "foo": "good day",
+        "bar": null,
+        "baz": "12345"
+      },
+      {
+        "foo": "hi there",
+        "bar": "abc def",
+        "baz": "3.14"
+      }
+    ]
+
+    $ echo '
+    >     foo        bar       baz
+    >     ---------  --------  ------
+    >     good day             12345
+    >     hi there   abc def   3.14'  | jc --asciitable -p
+    [
+      {
+        "foo": "good day",
+        "bar": null,
+        "baz": "12345"
+      },
+      {
+        "foo": "hi there",
+        "bar": "abc def",
+        "baz": "3.14"
+      }
+    ]
+
+<a id="jc.parsers.asciitable.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+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
+
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/asciitable_m.md

@@ -0,0 +1,132 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.asciitable_m"></a>
+
+# jc.parsers.asciitable\_m
+
+jc - JSON Convert `asciitable-m` parser
+
+This parser converts various styles of ASCII and Unicode text tables with
+multi-line rows. Tables must have a header row and separator line between
+rows.
+
+For example:
+
+    ╒══════════╤═════════╤════════╕
+    │ foo      │ bar baz │ fiz    │
+    │          │         │ buz    │
+    ╞══════════╪═════════╪════════╡
+    │ good day │ 12345   │        │
+    │ mate     │         │        │
+    ├──────────┼─────────┼────────┤
+    │ hi there │ abc def │ 3.14   │
+    │          │         │        │
+    ╘══════════╧═════════╧════════╛
+
+Cells with multiple lines within rows will be joined with a newline
+character ('\\n').
+
+Headers (keys) are converted to snake-case and newlines between multi-line
+headers are joined with an underscore. All values are returned as strings,
+except empty strings, which are converted to None/null.
+
+> Note: To preserve the case of the keys use the `-r` cli option or
+> `raw=True` argument in `parse()`.
+
+> Note: table column separator characters (e.g. `|`) cannot be present
+> inside the cell data. If detected, a warning message will be printed to
+> `STDERR` and the line will be skipped. The warning message can be
+> suppressed by using the `-q` command option or by setting `quiet=True` in
+> `parse()`.
+
+Usage (cli):
+
+    $ cat table.txt | jc --asciitable-m
+
+Usage (module):
+
+    import jc
+    result = jc.parse('asciitable_m', asciitable-string)
+
+Schema:
+
+    [
+      {
+        "column_name1":     string,    # empty string is null
+        "column_name2":     string     # empty string is null
+      }
+    ]
+
+Examples:
+
+    $ echo '
+    > +----------+---------+--------+
+    > | foo      | bar     | baz    |
+    > |          |         | buz    |
+    > +==========+=========+========+
+    > | good day | 12345   |        |
+    > | mate     |         |        |
+    > +----------+---------+--------+
+    > | hi there | abc def | 3.14   |
+    > |          |         |        |
+    > +==========+=========+========+' | jc --asciitable-m -p
+    [
+      {
+        "foo": "good day\\nmate",
+        "bar": "12345",
+        "baz_buz": null
+      },
+      {
+        "foo": "hi there",
+        "bar": "abc def",
+        "baz_buz": "3.14"
+      }
+    ]
+
+    $ echo '
+    > ╒══════════╤═════════╤════════╕
+    > │ foo      │ bar     │ baz    │
+    > │          │         │ buz    │
+    > ╞══════════╪═════════╪════════╡
+    > │ good day │ 12345   │        │
+    > │ mate     │         │        │
+    > ├──────────┼─────────┼────────┤
+    > │ hi there │ abc def │ 3.14   │
+    > │          │         │        │
+    > ╘══════════╧═════════╧════════╛' | jc --asciitable-m -p
+    [
+      {
+        "foo": "good day\\nmate",
+        "bar": "12345",
+        "baz_buz": null
+      },
+      {
+        "foo": "hi there",
+        "bar": "abc def",
+        "baz_buz": "3.14"
+      }
+    ]
+
+<a id="jc.parsers.asciitable_m.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+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
+
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/blkid.md

@@ -1,20 +1,22 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.blkid"></a>
 
 # jc.parsers.blkid
-jc - JSON CLI output utility `blkid` command output parser
+
+jc - JSON Convert `blkid` command output parser
 
 Usage (cli):
 
     $ blkid | jc --blkid
 
-    or
+or
 
     $ jc blkid
 
 Usage (module):
 
-    import jc.parsers.blkid
-    result = jc.parsers.blkid.parse(blkid_command_output)
+    import jc
+    result = jc.parse('blkid', blkid_command_output)
 
 Schema:
 
@@ -83,7 +85,7 @@ Examples:
       {
         "id_fs_uuid": "3klkIj-w1kk-DkJi-0XBJ-y3i7-i2Ac-vHqWBM",
         "id_fs_uuid_enc": "3klkIj-w1kk-DkJi-0XBJ-y3i7-i2Ac-vHqWBM",
-        "id_fs_version": "LVM2\x20001",
+        "id_fs_version": "LVM2\\x20001",
         "id_fs_type": "LVM2_member",
         "id_fs_usage": "raid",
         "id_iolimit_minimum_io_size": 512,
@@ -118,16 +120,12 @@ Examples:
       }
     ]
 
+<a id="jc.parsers.blkid.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -135,14 +133,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux
 
-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/bluetoothctl.md

@@ -0,0 +1,133 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.bluetoothctl"></a>
+
+# jc.parsers.bluetoothctl
+
+jc - JSON Convert `bluetoothctl` command output parser
+
+Supports the following `bluetoothctl` subcommands:
+- `bluetoothctl list`
+- `bluetoothctl show`
+- `bluetoothctl show <ctrl>`
+- `bluetoothctl devices`
+- `bluetoothctl info <dev>`
+
+Usage (cli):
+
+    $ bluetoothctl info <dev> | jc --bluetoothctl
+or
+
+    $ jc bluetoothctl info <dev>
+
+Usage (module):
+
+    import jc
+    result = jc.parse('bluetoothctl', bluetoothctl_command_output)
+
+Schema:
+
+Because bluetoothctl is handling two main entities, controllers and devices,
+the schema is shared between them. Most of the fields are common between
+a controller and a device but there might be fields corresponding to one entity.
+
+    Controller:
+    [
+        {
+            "name":                 string,
+            "is_default":           boolean,
+            "is_public":            boolean,
+            "is_random":            boolean,
+            "address":              string,
+            "alias":                string,
+            "class":                string,
+            "powered":              string,
+            "discoverable":         string,
+            "discoverable_timeout": string,
+            "pairable":             string,
+            "modalias":             string,
+            "discovering":          string,
+            "uuids":                array
+        }
+    ]
+
+    Device:
+    [
+        {
+            "name":                 string,
+            "is_public":            boolean,
+            "is_random":            boolean,
+            "address":              string,
+            "alias":                string,
+            "appearance":           string,
+            "class":                string,
+            "icon":                 string,
+            "paired":               string,
+            "bonded":               string,
+            "trusted":              string,
+            "blocked":              string,
+            "connected":            string,
+            "legacy_pairing":       string,
+            "rssi":                 int,
+            "txpower":              int,
+            "uuids":                array,
+            "modalias":             string
+        }
+    ]
+
+Examples:
+
+    $ bluetoothctl info EB:06:EF:62:B3:19 | jc --bluetoothctl -p
+    [
+        {
+            "address": "22:06:33:62:B3:19",
+            "is_public": true,
+            "name": "TaoTronics TT-BH336",
+            "alias": "TaoTronics TT-BH336",
+            "class": "0x00240455",
+            "icon": "audio-headset",
+            "paired": "no",
+            "bonded": "no",
+            "trusted": "no",
+            "blocked": "no",
+            "connected": "no",
+            "legacy_pairing": "no",
+            "uuids": [
+                "Advanced Audio Distribu.. (0000120d-0000-1000-8000-00805f9b34fb)",
+                "Audio Sink                (0000130b-0000-1000-8000-00805f9b34fb)",
+                "A/V Remote Control        (0000140e-0000-1000-8000-00805f9b34fb)",
+                "A/V Remote Control Cont.. (0000150f-0000-1000-8000-00805f9b34fb)",
+                "Handsfree                 (0000161e-0000-1000-8000-00805f9b34fb)",
+                "Headset                   (00001708-0000-1000-8000-00805f9b34fb)",
+                "Headset HS                (00001831-0000-1000-8000-00805f9b34fb)"
+            ],
+            "rssi": -52,
+            "txpower": 4
+        }
+    ]
+
+<a id="jc.parsers.bluetoothctl.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
+
+Version 1.1 by Jake Ob (iakopap at gmail.com)

docs/parsers/cbt.md

@@ -0,0 +1,125 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.cbt"></a>
+
+# jc.parsers.cbt
+
+jc - JSON Convert `cbt` command output parser (Google Bigtable)
+
+Parses the human-, but not machine-, friendly output of the cbt command (for
+Google's Bigtable).
+
+No effort is made to convert the data types of the values in the cells.
+
+The `timestamp_epoch` calculated timestamp field is naive. (i.e. based on
+the local time of the system the parser is run on)
+
+The `timestamp_epoch_utc` calculated timestamp field is timezone-aware and
+is only available if the timestamp has a UTC timezone.
+
+The `timestamp_iso` calculated timestamp field will only include UTC
+timezone information if the timestamp has a UTC timezone.
+
+Raw output contains all cells for each column (including timestamps), while
+the normal output contains only the latest value for each column.
+
+Usage (cli):
+
+    $ cbt | jc --cbt
+
+or
+
+    $ jc cbt
+
+Usage (module):
+
+    import jc
+    result = jc.parse('cbt', cbt_command_output)
+
+Schema:
+
+    [
+      {
+        "key":                      string,
+        "cells": {
+          <string>: {                         # column family
+            <string>:               string    # column: value
+          }
+        }
+      }
+    ]
+
+Schema (raw):
+
+    [
+      {
+        "key":                      string,
+        "cells": [
+          {
+            "column_family":        string,
+            "column":               string,
+            "value":                string,
+            "timestamp_iso":        string,
+            "timestamp_epoch":      integer,
+            "timestamp_epoch_utc":  integer
+          }
+        ]
+      }
+    ]
+
+Examples:
+
+    $ cbt -project=$PROJECT -instance=$INSTANCE lookup $TABLE foo | jc --cbt -p
+    [
+      {
+        "key": "foo",
+        "cells": {
+          "foo": {
+            "bar": "baz"
+          }
+        }
+      }
+    ]
+
+    $ cbt -project=$PROJECT -instance=$INSTANCE lookup $TABLE foo | jc --cbt -p -r
+    [
+      {
+        "key": "foo",
+        "cells": [
+          {
+            "column_family": "foo",
+            "column": "bar",
+            "value": "baz1",
+            "timestamp_iso": "1970-01-01T01:00:00",
+            "timestamp_epoch": 32400,
+            "timestamp_epoch_utc": null
+          }
+        ]
+      }
+    ]
+
+<a id="jc.parsers.cbt.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
+
+Version 1.0 by Andreas Weiden (andreas.weiden@gmail.com)

docs/parsers/cef.md

@@ -0,0 +1,146 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.cef"></a>
+
+# jc.parsers.cef
+
+jc - JSON Convert CEF string parser
+
+This parser conforms to the Microfocus Arcsight CEF specification.
+
+This parser will accept a single CEF string or multiple CEF string lines.
+Any text before "CEF" will be ignored. Syslog and CEF escaped characters
+(`\\`, `\\"`, `\\]`, `\\|`, `\\=`, `\\%`, `\\#`, `\\n`, and `\\r`) are
+unescaped.
+
+Extended fields, as defined in the CEF specification, are relabeled
+and the values are converted to their respective types. Extra naive and
+UTC epoch timestamps are added where appropriate per the CEF specification.
+
+A warning message to `STDERR` will be printed if an unparsable line is found
+unless `--quiet` or `quiet=True` is used.
+
+To preserve escaping and original keynames and to prevent type conversions
+use the `--raw` CLI option or `raw=True` param in the `parse()` function.
+
+Usage (cli):
+
+    $ echo 'CEF:0|Vendor|Product|3.2.0|1|SYSTEM|1|... | jc --cef
+
+Usage (module):
+
+    import jc
+    result = jc.parse('cef', cef_string_output)
+
+Schema:
+
+See: https://www.microfocus.com/documentation/arcsight/arcsight-smartconnectors-8.3/cef-implementation-standard/Content/CEF/Chapter%201%20What%20is%20CEF.htm
+
+> Note: Special characters in key names will be converted to underscores.
+
+    [
+      {
+        "deviceVendor":                   string,
+        "deviceProduct":                  string,
+        "deviceVersion":                  string,
+        "deviceEventClassId":             string,
+        "deviceEventClassIdNum":          integer/null,
+        "name":                           string,
+        "agentSeverity":                  string/integer,
+        "agentSeverityString":            string,
+        "agentSeverityNum":               integer/null,
+        "CEFVersion":                     integer,
+        <extended fields>                 string/integer/float,  # [0]
+        <extended fields>"_epoch":        integer/null,  # [1]
+        <extended fields>"_epoch_utc":    integer/null,  # [2]
+        <custom fields>                   string,
+        "unparsable":                     string  # [3]
+      }
+    ]
+
+    [0] Will attempt to convert extended fields to the type specified in the
+        CEF specification. If conversion fails, then the field will remain
+        a string.
+    [1] Naive calculated epoch timestamp
+    [2] Timezone-aware calculated epoch timestamp. (UTC only) This value
+        will be null if a UTC timezone cannot be extracted from the original
+        timestamp string value.
+    [3] This field exists if the CEF line is not parsable. The value
+        is the original syslog line.
+
+Examples:
+
+    $ cat cef.log | jc --cef -p
+    [
+      {
+        "deviceVendor": "Trend Micro",
+        "deviceProduct": "Deep Security Agent",
+        "deviceVersion": "<DSA version>",
+        "deviceEventClassId": "4000000",
+        "name": "Eicar_test_file",
+        "agentSeverity": 6,
+        "CEFVersion": 0,
+        "dvchost": "hostname",
+        "string": "hello \"world\"!",
+        "start": "Nov 08 2020 12:30:00.111 UTC",
+        "start_epoch": 1604867400,
+        "start_epoch_utc": 1604838600,
+        "Host_ID": 1,
+        "Quarantine": 205,
+        "myDate": "Nov 08 2022 12:30:00.111",
+        "myDate_epoch": 1667939400,
+        "myDate_epoch_utc": null,
+        "myFloat": 3.14,
+        "deviceEventClassIdNum": 4000000,
+        "agentSeverityString": "Medium",
+        "agentSeverityNum": 6
+      }
+    ]
+
+    $ cat cef.log | jc --cef -p -r
+    [
+      {
+        "deviceVendor": "Trend Micro",
+        "deviceProduct": "Deep Security Agent",
+        "deviceVersion": "<DSA version>",
+        "deviceEventClassId": "4000000",
+        "name": "Eicar_test_file",
+        "agentSeverity": "6",
+        "CEFVersion": "0",
+        "cn1": "1",
+        "cn1Label": "Host ID",
+        "dvchost": "hostname",
+        "cn2": "205",
+        "cn2Label": "Quarantine",
+        "string": "hello \\\"world\\\"!",
+        "start": "Nov 08 2020 12:30:00.111 UTC",
+        "deviceCustomDate1": "Nov 08 2022 12:30:00.111",
+        "deviceCustomDate1Label": "myDate",
+        "cfp1": "3.14",
+        "cfp1Label": "myFloat"
+      }
+    ]
+
+<a id="jc.parsers.cef.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+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
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/cef_s.md

@@ -0,0 +1,124 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.cef_s"></a>
+
+# jc.parsers.cef\_s
+
+jc - JSON Convert CEF string output streaming parser
+
+> This streaming parser outputs JSON Lines (cli) or returns an Iterable of
+> Dictionaries (module)
+
+This parser conforms to the Microfocus Arcsight CEF specification.
+
+This parser will accept a single CEF string or multiple CEF string lines.
+Any text before "CEF" will be ignored. Syslog and CEF escaped characters
+(`\\`, `\\"`, `\\]`, `\\|`, `\\=`, `\\%`, `\\#`, `\\n`, and `\\r`) are
+unescaped.
+
+Extended fields, as defined in the CEF specification, are relabeled
+and the values are converted to their respective types. Extra naive and
+UTC epoch timestamps are added where appropriate per the CEF specification.
+
+A warning message to `STDERR` will be printed if an unparsable line is found
+unless `--quiet` or `quiet=True` is used.
+
+To preserve escaping and original keynames and to prevent type conversions
+use the `--raw` CLI option or `raw=True` param in the `parse()` function.
+
+Usage (cli):
+
+    $ echo 'CEF:0|Vendor|Product|3.2.0|1|SYSTEM|1|... | jc --cef-s
+
+Usage (module):
+
+    import jc
+
+    result = jc.parse('cef_s', cef_command_output.splitlines())
+    for item in result:
+        # do something
+
+Schema:
+
+See: https://www.microfocus.com/documentation/arcsight/arcsight-smartconnectors-8.3/cef-implementation-standard/Content/CEF/Chapter%201%20What%20is%20CEF.htm
+
+> Note: Special characters in key names will be converted to underscores.
+
+    {
+      "deviceVendor":                   string,
+      "deviceProduct":                  string,
+      "deviceVersion":                  string,
+      "deviceEventClassId":             string,
+      "deviceEventClassIdNum":          integer/null,
+      "name":                           string,
+      "agentSeverity":                  string/integer,
+      "agentSeverityString":            string,
+      "agentSeverityNum":               integer/null,
+      "CEFVersion":                     integer,
+      <extended fields>                 string/integer/float,  # [0]
+      <extended fields>"_epoch":        integer/null,  # [1]
+      <extended fields>"_epoch_utc":    integer/null,  # [2]
+      <custom fields>                   string,
+      "unparsable":                     string  # [3]
+
+      # below object only exists if using -qq or ignore_exceptions=True
+      "_jc_meta": {
+        "success":      boolean,     # false if error parsing
+        "error":        string,      # exists if "success" is false
+        "line":         string       # exists if "success" is false
+      }
+    }
+
+    [0] Will attempt to convert extended fields to the type specified in the
+        CEF specification. If conversion fails, then the field will remain
+        a string.
+    [1] Naive calculated epoch timestamp
+    [2] Timezone-aware calculated epoch timestamp. (UTC only) This value
+        will be null if a UTC timezone cannot be extracted from the original
+        timestamp string value.
+    [3] This field exists if the CEF line is not parsable. The value
+        is the original syslog line.
+
+Examples:
+
+    $ cat cef.log | jc --cef-s
+    {"deviceVendor":"Fortinet","deviceProduct":"FortiDeceptor","deviceV...}
+    {"deviceVendor":"Trend Micro","deviceProduct":"Deep Security Agent"...}
+    ...
+
+    $ cat cef.log | jc --cef-s -r
+    {"deviceVendor":"Fortinet","deviceProduct":"FortiDeceptor","deviceV...}
+    {"deviceVendor":"Trend Micro","deviceProduct":"Deep Security Agent"...}
+    ...
+
+<a id="jc.parsers.cef_s.parse"></a>
+
+### parse
+
+```python
+@add_jc_meta
+def parse(data: Iterable[str],
+          raw: bool = False,
+          quiet: bool = False,
+          ignore_exceptions: bool = False) -> Union[Iterable[Dict], tuple]
+```
+
+Main text parsing generator function. Returns an iterable object.
+
+Parameters:
+
+    data:              (iterable)  line-based text data to parse
+                                   (e.g. sys.stdin or str.splitlines())
+
+    raw:               (boolean)   unprocessed output if True
+    quiet:             (boolean)   suppress warning messages if True
+    ignore_exceptions: (boolean)   ignore parsing exceptions if True
+
+
+Returns:
+
+    Iterable of Dictionaries
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/certbot.md

@@ -0,0 +1,161 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.certbot"></a>
+
+# jc.parsers.certbot
+
+jc - JSON Convert `certbot` command output parser
+
+Supports the following `certbot` commands:
+
+- `certbot show_account`
+- `certbot certificates`
+
+Verbose options are not supported.
+
+Usage (cli):
+
+    $ certbot show_account | jc --certbot
+    $ certbot certificates | jc --certbot
+
+or
+
+    $ jc certbot show_account
+    $ jc certbot certificates
+
+Usage (module):
+
+    import jc
+    result = jc.parse('certbot', certbot_command_output)
+
+Schema:
+
+    {
+      "certificates": [
+        {
+          "name":                             string,
+          "serial_number":                    string,
+          "key_type":                         string,
+          "domains": [
+                                              string
+          ],
+          "expiration_date":                  string,
+          "expiration_date_epoch":            integer,
+          "expiration_date_epoch_utc":        integer,
+          "expiration_date_iso":              string,
+          "validity":                         string,
+          "certificate_path":                 string,
+          "private_key_path":                 string
+        }
+      ],
+      "account": {
+        "server":                             string,
+        "url":                                string,
+        "email":                              string
+      }
+    }
+
+Examples:
+
+    $ certbot certificates | jc --certbot -p
+    {
+      "certificates": [
+        {
+          "name": "example.com",
+          "serial_number": "3f7axxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+          "key_type": "RSA",
+          "domains": [
+            "example.com",
+            "www.example.com"
+          ],
+          "expiration_date": "2023-05-11 01:33:10+00:00",
+          "validity": "63 days",
+          "certificate_path": "/etc/letsencrypt/live/example.com/chain.pem",
+          "private_key_path": "/etc/letsencrypt/live/example.com/priv.pem",
+          "expiration_date_epoch": 1683793990,
+          "expiration_date_epoch_utc": 1683768790,
+          "expiration_date_iso": "2023-05-11T01:33:10+00:00"
+        },
+        {
+          "name": "example.org",
+          "serial_number": "3bcyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
+          "key_type": "RSA",
+          "domains": [
+            "example.org",
+            "www.example.org"
+          ],
+          "expiration_date": "2023-06-12 01:35:30+00:00",
+          "validity": "63 days",
+          "certificate_path": "/etc/letsencrypt/live/example.org/chain.pem",
+          "private_key_path": "/etc/letsencrypt/live/example.org/key.pem",
+          "expiration_date_epoch": 1686558930,
+          "expiration_date_epoch_utc": 1686533730,
+          "expiration_date_iso": "2023-06-12T01:35:30+00:00"
+        }
+      ]
+    }
+
+    $ certbot certificates | jc --certbot -p -r
+    {
+      "certificates": [
+        {
+          "name": "example.com",
+          "serial_number": "3f7axxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
+          "key_type": "RSA",
+          "domains": [
+            "example.com",
+            "www.example.com"
+          ],
+          "expiration_date": "2023-05-11 01:33:10+00:00",
+          "validity": "63 days",
+          "certificate_path": "/etc/letsencrypt/live/example.com/chain.pem",
+          "private_key_path": "/etc/letsencrypt/live/example.com/priv.pem"
+        },
+        {
+          "name": "example.org",
+          "serial_number": "3bcyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy",
+          "key_type": "RSA",
+          "domains": [
+            "example.org",
+            "www.example.org"
+          ],
+          "expiration_date": "2023-06-12 01:35:30+00:00",
+          "validity": "63 days",
+          "certificate_path": "/etc/letsencrypt/live/example.org/chain.pem",
+          "private_key_path": "/etc/letsencrypt/live/example.org/key.pem"
+        }
+      ]
+    }
+
+    $ certbot show_account | jc --certbot -p
+    {
+      "account": {
+        "server": "https://acme-staging-v02.api.letsencrypt.org/directory",
+        "url": "https://acme-staging-v02.api.letsencrypt.org/acme/acct/123",
+        "email": "some@example.com"
+      }
+    }
+
+<a id="jc.parsers.certbot.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, darwin, cygwin, win32, aix, freebsd
+
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/chage.md

@@ -0,0 +1,82 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.chage"></a>
+
+# jc.parsers.chage
+
+jc - JSON Convert `chage --list` command output parser
+
+Supports `chage -l <username>` or `chage --list <username>`
+
+Usage (cli):
+
+    $ chage -l johndoe | jc --chage
+
+or
+
+    $ jc chage -l johndoe
+
+Usage (module):
+
+    import jc
+    result = jc.parse('chage', chage_command_output)
+
+Schema:
+
+    {
+      "password_last_changed":                      string,
+      "password_expires":                           string,
+      "password_inactive":                          string,
+      "account_expires":                            string,
+      "min_days_between_password_change":           integer,
+      "max_days_between_password_change":           integer,
+      "warning_days_before_password_expires":       integer
+    }
+
+Examples:
+
+    $ chage --list joeuser | jc --chage -p
+    {
+      "password_last_changed": "never",
+      "password_expires": "never",
+      "password_inactive": "never",
+      "account_expires": "never",
+      "min_days_between_password_change": 0,
+      "max_days_between_password_change": 99999,
+      "warning_days_before_password_expires": 7
+    }
+
+    $ chage --list joeuser | jc --chage -p -r
+    {
+      "password_last_changed": "never",
+      "password_expires": "never",
+      "password_inactive": "never",
+      "account_expires": "never",
+      "min_days_between_password_change": "0",
+      "max_days_between_password_change": "99999",
+      "warning_days_before_password_expires": "7"
+    }
+
+<a id="jc.parsers.chage.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict
+```
+
+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
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/cksum.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.cksum"></a>
 
 # jc.parsers.cksum
-jc - JSON CLI output utility `cksum` command output parser
+
+jc - JSON Convert `cksum` command output parser
 
 This parser works with the following checksum calculation utilities:
 - `sum`
@@ -11,14 +13,14 @@ Usage (cli):
 
     $ cksum file.txt | jc --cksum
 
-    or
+or
 
     $ jc cksum file.txt
 
 Usage (module):
 
-    import jc.parsers.cksum
-    result = jc.parsers.cksum.parse(cksum_command_output)
+    import jc
+    result = jc.parse('cksum', cksum_command_output)
 
 Schema:
 
@@ -52,16 +54,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.cksum.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -69,14 +67,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd
 
-Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/clf.md

@@ -0,0 +1,199 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.clf"></a>
+
+# jc.parsers.clf
+
+jc - JSON Convert Common Log Format file parser
+
+This parser will handle the Common Log Format standard as specified at
+https://www.w3.org/Daemon/User/Config/Logging.html#common-logfile-format.
+
+Combined Log Format is also supported. (Referer and User Agent fields added)
+
+Extra fields may be present and will be enclosed in the `extra` field as
+a single string.
+
+If a log line cannot be parsed, an object with an `unparsable` field will
+be present with a value of the original line.
+
+The `epoch` calculated timestamp field is naive. (i.e. based on the
+local time of the system the parser is run on)
+
+The `epoch_utc` calculated timestamp field is timezone-aware and is
+only available if the timezone field is UTC.
+
+Usage (cli):
+
+    $ cat file.log | jc --clf
+
+Usage (module):
+
+    import jc
+    result = jc.parse('clf', common_log_file_output)
+
+Schema:
+
+Empty strings and `-` values are converted to `null`/`None`.
+
+    [
+      {
+        "host":                         string,
+        "ident":                        string,
+        "authuser":                     string,
+        "date":                         string,
+        "day":                          integer,
+        "month":                        string,
+        "year":                         integer,
+        "hour":                         integer,
+        "minute":                       integer,
+        "second":                       integer,
+        "tz":                           string,
+        "request":                      string,
+        "request_method":               string,
+        "request_url":                  string,
+        "request_version":              string,
+        "status":                       integer,
+        "bytes":                        integer,
+        "referer":                      string,
+        "user_agent":                   string,
+        "extra":                        string,
+        "epoch":                        integer,  # [0]
+        "epoch_utc":                    integer,  # [1]
+        "unparsable":                   string    # [2]
+      }
+    ]
+
+    [0] naive timestamp
+    [1] timezone-aware timestamp. Only available if timezone field is UTC
+    [2] exists if the line was not able to be parsed
+
+Examples:
+
+    $ cat file.log | jc --clf -p
+    [
+      {
+        "host": "127.0.0.1",
+        "ident": "user-identifier",
+        "authuser": "frank",
+        "date": "10/Oct/2000:13:55:36 -0700",
+        "day": 10,
+        "month": "Oct",
+        "year": 2000,
+        "hour": 13,
+        "minute": 55,
+        "second": 36,
+        "tz": "-0700",
+        "request": "GET /apache_pb.gif HTTPS/1.0",
+        "status": 200,
+        "bytes": 2326,
+        "referer": null,
+        "user_agent": null,
+        "extra": null,
+        "request_method": "GET",
+        "request_url": "/apache_pb.gif",
+        "request_version": "HTTPS/1.0",
+        "epoch": 971211336,
+        "epoch_utc": null
+      },
+      {
+        "host": "1.1.1.2",
+        "ident": null,
+        "authuser": null,
+        "date": "11/Nov/2016:03:04:55 +0100",
+        "day": 11,
+        "month": "Nov",
+        "year": 2016,
+        "hour": 3,
+        "minute": 4,
+        "second": 55,
+        "tz": "+0100",
+        "request": "GET /",
+        "status": 200,
+        "bytes": 83,
+        "referer": null,
+        "user_agent": null,
+        "extra": "- 9221 1.1.1.1",
+        "request_method": "GET",
+        "request_url": "/",
+        "request_version": null,
+        "epoch": 1478862295,
+        "epoch_utc": null
+      },
+      ...
+    ]
+
+    $ cat file.log | jc --clf -p -r
+    [
+      {
+        "host": "127.0.0.1",
+        "ident": "user-identifier",
+        "authuser": "frank",
+        "date": "10/Oct/2000:13:55:36 -0700",
+        "day": "10",
+        "month": "Oct",
+        "year": "2000",
+        "hour": "13",
+        "minute": "55",
+        "second": "36",
+        "tz": "-0700",
+        "request": "GET /apache_pb.gif HTTPS/1.0",
+        "status": "200",
+        "bytes": "2326",
+        "referer": null,
+        "user_agent": null,
+        "extra": "",
+        "request_method": "GET",
+        "request_url": "/apache_pb.gif",
+        "request_version": "HTTPS/1.0"
+      },
+      {
+        "host": "1.1.1.2",
+        "ident": "-",
+        "authuser": "-",
+        "date": "11/Nov/2016:03:04:55 +0100",
+        "day": "11",
+        "month": "Nov",
+        "year": "2016",
+        "hour": "03",
+        "minute": "04",
+        "second": "55",
+        "tz": "+0100",
+        "request": "GET /",
+        "status": "200",
+        "bytes": "83",
+        "referer": "-",
+        "user_agent": "-",
+        "extra": "- 9221 1.1.1.1",
+        "request_method": "GET",
+        "request_url": "/",
+        "request_version": null
+      },
+      ...
+    ]
+
+<a id="jc.parsers.clf.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
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/clf_s.md

@@ -0,0 +1,117 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.clf_s"></a>
+
+# jc.parsers.clf\_s
+
+jc - JSON Convert Common Log Format file streaming parser
+
+> This streaming parser outputs JSON Lines (cli) or returns an Iterable of
+> Dictionaries (module)
+
+This parser will handle the Common Log Format standard as specified at
+https://www.w3.org/Daemon/User/Config/Logging.html#common-logfile-format.
+
+Combined Log Format is also supported. (Referer and User Agent fields added)
+
+Extra fields may be present and will be enclosed in the `extra` field as
+a single string.
+
+If a log line cannot be parsed, an object with an `unparsable` field will
+be present with a value of the original line.
+
+The `epoch` calculated timestamp field is naive. (i.e. based on the
+local time of the system the parser is run on)
+
+The `epoch_utc` calculated timestamp field is timezone-aware and is
+only available if the timezone field is UTC.
+
+Usage (cli):
+
+    $ cat file.log | jc --clf-s
+
+Usage (module):
+
+    import jc
+
+    result = jc.parse('clf_s', common_log_file_output.splitlines())
+    for item in result:
+        # do something
+
+Schema:
+
+    Empty strings and `-` values are converted to `null`/`None`.
+
+    {
+      "host":                         string,
+      "ident":                        string,
+      "authuser":                     string,
+      "date":                         string,
+      "day":                          integer,
+      "month":                        string,
+      "year":                         integer,
+      "hour":                         integer,
+      "minute":                       integer,
+      "second":                       integer,
+      "tz":                           string,
+      "request":                      string,
+      "request_method":               string,
+      "request_url":                  string,
+      "request_version":              string,
+      "status":                       integer,
+      "bytes":                        integer,
+      "referer":                      string,
+      "user_agent":                   string,
+      "extra":                        string,
+      "epoch":                        integer,  # [0]
+      "epoch_utc":                    integer,  # [1]
+      "unparsable":                   string    # [2]
+    }
+
+    [0] naive timestamp
+    [1] timezone-aware timestamp. Only available if timezone field is UTC
+    [2] exists if the line was not able to be parsed
+
+Examples:
+
+    $ cat file.log | jc --clf-s
+    {"host":"127.0.0.1","ident":"user-identifier","authuser":"frank","...}
+    {"host":"1.1.1.2","ident":null,"authuser":null,"date":"11/Nov/2016...}
+    ...
+
+    $ cat file.log | jc --clf-s -r
+    {"host":"127.0.0.1","ident":"user-identifier","authuser":"frank","...}
+    {"host":"1.1.1.2","ident":"-","authuser":"-","date":"11/Nov/2016:0...}
+    ...
+
+<a id="jc.parsers.clf_s.parse"></a>
+
+### parse
+
+```python
+@add_jc_meta
+def parse(data: Iterable[str],
+          raw: bool = False,
+          quiet: bool = False,
+          ignore_exceptions: bool = False) -> StreamingOutputType
+```
+
+Main text parsing generator function. Returns an iterable object.
+
+Parameters:
+
+    data:              (iterable)  line-based text data to parse
+                                   (e.g. sys.stdin or str.splitlines())
+
+    raw:               (boolean)   unprocessed output if True
+    quiet:             (boolean)   suppress warning messages if True
+    ignore_exceptions: (boolean)   ignore parsing exceptions if True
+
+
+Returns:
+
+    Iterable of Dictionaries
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/crontab.md

@@ -1,7 +1,10 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.crontab"></a>
 
 # jc.parsers.crontab
-jc - JSON CLI output utility `crontab -l` command output and crontab file parser
+
+jc - JSON Convert `crontab -l` command output and crontab
+file parser
 
 Supports `crontab -l` command output and crontab files.
 
@@ -9,14 +12,14 @@ Usage (cli):
 
     $ crontab -l | jc --crontab
 
-    or
+or
 
     $ jc crontab -l
 
 Usage (module):
 
-    import jc.parsers.crontab
-    result = jc.parsers.crontab.parse(crontab_output)
+    import jc
+    result = jc.parse('crontab', crontab_output)
 
 Schema:
 
@@ -170,16 +173,12 @@ Examples:
       ]
     }
 
+<a id="jc.parsers.crontab.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -187,14 +186,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     Dictionary. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, aix, freebsd
 
-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.8 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/crontab_u.md

@@ -1,9 +1,13 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.crontab_u"></a>
 
-# jc.parsers.crontab_u
-jc - JSON CLI output utility `crontab -l` command output and crontab file parser
+# jc.parsers.crontab\_u
 
-This version of the `crontab -l` parser supports output that contains user information for processes.
+jc - JSON Convert `crontab -l` command output and crontab
+file parser
+
+This version of the `crontab -l` parser supports output that contains user
+information for processes.
 
 Usage (cli):
 
@@ -11,8 +15,8 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.crontab_u
-    result = jc.parsers.crontab_u.parse(crontab_u_output)
+    import jc
+    result = jc.parse('crontab_u', crontab_u_output)
 
 Schema:
 
@@ -55,7 +59,7 @@ Examples:
       "variables": [
         {
           "name": "PATH",
-          "value": "/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin"
+          "value": "/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sb..."
         },
         {
           "name": "SHELL",
@@ -80,7 +84,7 @@ Examples:
             "*"
           ],
           "user": "root",
-          "command": "test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.daily )"
+          "command": "test -x /usr/sbin/anacron || ( cd / && run-parts ..."
         },
         {
           "minute": [
@@ -99,7 +103,7 @@ Examples:
             "7"
           ],
           "user": "root",
-          "command": "test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.weekly )"
+          "command": "test -x /usr/sbin/anacron || ( cd / && run-parts ..."
         },
         {
           "minute": [
@@ -118,7 +122,7 @@ Examples:
             "*"
           ],
           "user": "root",
-          "command": "test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.monthly )"
+          "command": "test -x /usr/sbin/anacron || ( cd / && run-parts ..."
         }
       ]
     }
@@ -128,7 +132,7 @@ Examples:
       "variables": [
         {
           "name": "PATH",
-          "value": "/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin"
+          "value": "/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/..."
         },
         {
           "name": "SHELL",
@@ -143,7 +147,7 @@ Examples:
           "month": "*",
           "day_of_week": "*",
           "user": "root",
-          "command": "test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.daily )"
+          "command": "test -x /usr/sbin/anacron || ( cd / && run-parts ..."
         },
         {
           "minute": "47",
@@ -152,7 +156,7 @@ Examples:
           "month": "*",
           "day_of_week": "7",
           "user": "root",
-          "command": "test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.weekly )"
+          "command": "test -x /usr/sbin/anacron || ( cd / && run-parts ..."
         },
         {
           "minute": "52",
@@ -161,21 +165,17 @@ Examples:
           "month": "*",
           "day_of_week": "*",
           "user": "root",
-          "command": "test -x /usr/sbin/anacron || ( cd / && run-parts --report /etc/cron.monthly )"
+          "command": "test -x /usr/sbin/anacron || ( cd / && run-parts ..."
         }
       ]
     }
 
+<a id="jc.parsers.crontab_u.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -183,14 +183,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     Dictionary. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, aix, freebsd
 
-Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.9 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/csv.md

@@ -1,9 +1,13 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.csv"></a>
 
 # jc.parsers.csv
-jc - JSON CLI output utility `csv` file parser
 
-The `csv` parser will attempt to automatically detect the delimiter character. If the delimiter cannot be detected it will default to comma. The first row of the file must be a header row.
+jc - JSON Convert `csv` file parser
+
+The `csv` parser will attempt to automatically detect the delimiter
+character. If the delimiter cannot be detected it will default to comma.
+The first row of the file must be a header row.
 
 Usage (cli):
 
@@ -11,12 +15,13 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.csv
-    result = jc.parsers.csv.parse(csv_output)
+    import jc
+    result = jc.parse('csv', csv_output)
 
 Schema:
 
-    csv file converted to a Dictionary: https://docs.python.org/3/library/csv.html
+CSV file converted to a Dictionary:
+https://docs.python.org/3/library/csv.html
 
     [
       {
@@ -28,7 +33,7 @@ Schema:
 Examples:
 
     $ cat homes.csv
-    "Sell", "List", "Living", "Rooms", "Beds", "Baths", "Age", "Acres", "Taxes"
+    "Sell", "List", "Living", "Rooms", "Beds", "Baths", "Age", "Acres"...
     142, 160, 28, 10, 5, 3,  60, 0.28,  3167
     175, 180, 18,  8, 4, 1,  12, 0.43,  4033
     129, 132, 13,  6, 3, 1,  41, 0.33,  1471
@@ -72,16 +77,14 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.csv.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data: Union[str, bytes],
+          raw: bool = False,
+          quiet: bool = False) -> List[JSONDictType]
 ```
 
 Main text parsing function
@@ -89,14 +92,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
 
-Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/csv_s.md

@@ -1,13 +1,19 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.csv_s"></a>
 
-# jc.parsers.csv_s
-jc - JSON CLI output utility `csv` file streaming parser
+# jc.parsers.csv\_s
 
-> This streaming parser outputs JSON Lines
+jc - JSON Convert `csv` file streaming parser
 
-The `csv` streaming parser will attempt to automatically detect the delimiter character. If the delimiter cannot be detected it will default to comma. The first row of the file must be a header row.
+> This streaming parser outputs JSON Lines (cli) or returns an Iterable of
+> Dictionaries (module)
 
-Note: The first 100 rows are read into memory to enable delimiter detection, then the rest of the rows are loaded lazily.
+The `csv` streaming parser will attempt to automatically detect the
+delimiter character. If the delimiter cannot be detected it will default
+to comma. The first row of the file must be a header row.
+
+> Note: The first 100 rows are read into memory to enable delimiter
+> detection, then the rest of the rows are loaded lazily.
 
 Usage (cli):
 
@@ -15,71 +21,69 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.csv_s
-    result = jc.parsers.csv_s.parse(csv_output.splitlines())    # result is an iterable object
+    import jc
+
+    result = jc.parse('csv_s', csv_output.splitlines())
     for item in result:
         # do something
 
 Schema:
 
-    csv file converted to a Dictionary: https://docs.python.org/3/library/csv.html
+CSV file converted to a Dictionary:
+https://docs.python.org/3/library/csv.html
 
     {
       "column_name1":     string,
       "column_name2":     string,
-      "_jc_meta":                      # This object only exists if using -qq or ignore_exceptions=True
-        {
-          "success":      boolean,     # true if successfully parsed, false if error
-          "error":        string,      # exists if "success" is false
-          "line":         string       # exists if "success" is false
-        }
+
+      # below object only exists if using -qq or ignore_exceptions=True
+      "_jc_meta": {
+        "success":        boolean,     # false if error parsing
+        "error":          string,      # exists if "success" is false
+        "line":           string       # exists if "success" is false
+      }
     }
 
 Examples:
 
     $ cat homes.csv
-    "Sell", "List", "Living", "Rooms", "Beds", "Baths", "Age", "Acres", "Taxes"
+    "Sell", "List", "Living", "Rooms", "Beds", "Baths", "Age", "Acres"...
     142, 160, 28, 10, 5, 3,  60, 0.28,  3167
     175, 180, 18,  8, 4, 1,  12, 0.43,  4033
     129, 132, 13,  6, 3, 1,  41, 0.33,  1471
     ...
 
     $ cat homes.csv | jc --csv-s
-    {"Sell":"142","List":"160","Living":"28","Rooms":"10","Beds":"5","Baths":"3","Age":"60","Acres":"0.28","Taxes":"3167"}
-    {"Sell":"175","List":"180","Living":"18","Rooms":"8","Beds":"4","Baths":"1","Age":"12","Acres":"0.43","Taxes":"4033"}
-    {"Sell":"129","List":"132","Living":"13","Rooms":"6","Beds":"3","Baths":"1","Age":"41","Acres":"0.33","Taxes":"1471"}
+    {"Sell":"142","List":"160","Living":"28","Rooms":"10","Beds":"5"...}
+    {"Sell":"175","List":"180","Living":"18","Rooms":"8","Beds":"4"...}
+    {"Sell":"129","List":"132","Living":"13","Rooms":"6","Beds":"3"...}
     ...
 
+<a id="jc.parsers.csv_s.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False, ignore_exceptions=False)
+@add_jc_meta
+def parse(data, raw=False, quiet=False, ignore_exceptions=False)
 ```
 
-Main text parsing generator function. Returns an iterator object.
+Main text parsing generator function. Returns an iterable object.
 
 Parameters:
 
-    data:              (iterable)  line-based text data to parse (e.g. sys.stdin or str.splitlines())
-    raw:               (boolean)   output preprocessed JSON if True
+    data:              (iterable)  line-based text data to parse
+                                   (e.g. sys.stdin or str.splitlines())
+
+    raw:               (boolean)   unprocessed output if True
     quiet:             (boolean)   suppress warning messages if True
     ignore_exceptions: (boolean)   ignore parsing exceptions if True
 
-Yields:
-
-    Dictionary. Raw or processed structured data.
-
 Returns:
 
-    Iterator object
+    Iterable of Dictionaries
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
 
-Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/date.md

@@ -1,24 +1,28 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.date"></a>
 
 # jc.parsers.date
-jc - JSON CLI output utility `date` command output parser
 
-The `epoch` calculated timestamp field is naive. (i.e. based on the local time of the system the parser is run on)
+jc - JSON Convert `date` command output parser
 
-The `epoch_utc` calculated timestamp field is timezone-aware and is only available if the timezone field is UTC.
+The `epoch` calculated timestamp field is naive. (i.e. based on the local
+time of the system the parser is run on)
+
+The `epoch_utc` calculated timestamp field is timezone-aware and is only
+available if the timezone field is UTC.
 
 Usage (cli):
 
     $ date | jc --date
 
-    or
+or
 
     $ jc date
 
 Usage (module):
 
-    import jc.parsers.date
-    result = jc.parsers.date.parse(date_command_output)
+    import jc
+    result = jc.parse('date', date_command_output)
 
 Schema:
 
@@ -35,15 +39,19 @@ Schema:
       "second":             integer,
       "period":             string,
       "timezone":           string,
-      "utc_offset":         string,       # null if timezone field is not UTC
+      "utc_offset":         string,      # null if timezone field is not UTC
       "day_of_year":        integer,
       "week_of_year":       integer,
       "iso":                string,
-      "epoch":              integer,      # naive timestamp
-      "epoch_utc":          integer,      # timezone-aware timestamp. Only available if timezone field is UTC
-      "timezone_aware":     boolean       # if true, all fields are correctly based on UTC
+      "epoch":              integer,     # [0]
+      "epoch_utc":          integer,     # [1]
+      "timezone_aware":     boolean      # [2]
     }
 
+    [0] naive timestamp
+    [1] timezone-aware timestamp. Only available if timezone field is UTC
+    [2] if true, all fields are correctly based on UTC
+
 Examples:
 
     $ date | jc --date -p
@@ -69,16 +77,12 @@ Examples:
       "timezone_aware": true
     }
 
+<a id="jc.parsers.date.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -86,14 +90,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     Dictionary. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, freebsd
 
-Version 2.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 2.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/datetime_iso.md

@@ -0,0 +1,91 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.datetime_iso"></a>
+
+# jc.parsers.datetime\_iso
+
+jc - JSON Convert ISO 8601 Datetime string parser
+
+This parser supports standard ISO 8601 strings that include both date and
+time. If no timezone or offset information is available in the string, then
+UTC timezone is used.
+
+Usage (cli):
+
+    $ echo "2022-07-20T14:52:45Z" | jc --iso-datetime
+
+Usage (module):
+
+    import jc
+    result = jc.parse('iso_datetime', iso_8601_string)
+
+Schema:
+
+    {
+      "year":               integer,
+      "month":              string,
+      "month_num":          integer,
+      "day":                integer,
+      "weekday":            string,
+      "weekday_num":        integer,
+      "hour":               integer,
+      "hour_24":            integer,
+      "minute":             integer,
+      "second":             integer,
+      "microsecond":        integer,
+      "period":             string,
+      "utc_offset":         string,
+      "day_of_year":        integer,
+      "week_of_year":       integer,
+      "iso":                string,
+      "timestamp":          integer  # [0]
+    }
+
+    [0] timezone aware UNIX timestamp expressed in UTC
+
+Examples:
+
+    $ echo "2022-07-20T14:52:45Z" | jc --iso-datetime -p
+    {
+      "year": 2022,
+      "month": "Jul",
+      "month_num": 7,
+      "day": 20,
+      "weekday": "Wed",
+      "weekday_num": 3,
+      "hour": 2,
+      "hour_24": 14,
+      "minute": 52,
+      "second": 45,
+      "microsecond": 0,
+      "period": "PM",
+      "utc_offset": "+0000",
+      "day_of_year": 201,
+      "week_of_year": 29,
+      "iso": "2022-07-20T14:52:45+00:00",
+      "timestamp": 1658328765
+    }
+
+<a id="jc.parsers.datetime_iso.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. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux, aix, freebsd, darwin, win32, cygwin
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/df.md

@@ -1,20 +1,22 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.df"></a>
 
 # jc.parsers.df
-jc - JSON CLI output utility `df` command output parser
+
+jc - JSON Convert `df` command output parser
 
 Usage (cli):
 
     $ df | jc --df
 
-    or
+or
 
     $ jc df
 
 Usage (module):
 
-    import jc.parsers.df
-    result = jc.parsers.df.parse(df_command_output)
+    import jc
+    result = jc.parse('df', df_command_output)
 
 Schema:
 
@@ -95,16 +97,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.df.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -112,14 +110,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, freebsd
 
-Version 1.9 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.11 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/dig.md

@@ -1,28 +1,34 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.dig"></a>
 
 # jc.parsers.dig
-jc - JSON CLI output utility `dig` command output parser
+
+jc - JSON Convert `dig` command output parser
 
 Options supported:
-- `+noall +answer` options are supported in cases where only the answer information is desired.
+- `+noall +answer` options are supported in cases where only the answer
+  information is desired.
 - `+axfr` option is supported on its own
+- `+nsid` option is supported
 
-The `when_epoch` calculated timestamp field is naive (i.e. based on the local time of the system the parser is run on)
+The `when_epoch` calculated timestamp field is naive. (i.e. based on the
+local time of the system the parser is run on)
 
-The `when_epoch_utc` calculated timestamp field is timezone-aware and is only available if the timezone field is UTC.
+The `when_epoch_utc` calculated timestamp field is timezone-aware and is
+only available if the timezone field is UTC.
 
 Usage (cli):
 
     $ dig example.com | jc --dig
 
-    or
+or
 
     $ jc dig example.com
 
 Usage (module):
 
-    import jc.parsers.dig
-    result = jc.parsers.dig.parse(dig_command_output)
+    import jc
+    result = jc.parse('dig', dig_command_output)
 
 Schema:
 
@@ -93,13 +99,16 @@ Schema:
         "query_time":           integer,   # in msec
         "server":               string,
         "when":                 string,
-        "when_epoch":           integer,   # naive timestamp if when field is parsable, else null
-        "when_epoch_utc":       integer,   # timezone aware timestamp availabe for UTC, else null
+        "when_epoch":           integer,   # [0]
+        "when_epoch_utc":       integer,   # [1]
         "rcvd":                 integer
         "size":                 string
       }
     ]
 
+    [0] naive timestamp if "when" field is parsable, else null
+    [1] timezone aware timestamp available for UTC, else null
+
 Examples:
 
     $ dig example.com | jc --dig -p
@@ -314,16 +323,12 @@ Examples:
       }
     ]
 
+<a id="jc.parsers.dig.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -331,14 +336,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, aix, freebsd, darwin, win32, cygwin
 
-Version 2.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 2.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/dir.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.dir"></a>
 
 # jc.parsers.dir
-jc - JSON CLI output utility `dir` command output parser
+
+jc - JSON Convert `dir` command output parser
 
 Options supported:
 - `/T timefield`
@@ -9,18 +11,20 @@ Options supported:
 - `/C, /-C`
 - `/S`
 
-The "Magic" syntax is not supported since the `dir` command is a shell builtin.
+The "Magic" syntax is not supported since the `dir` command is a shell
+builtin.
 
-The `epoch` calculated timestamp field is naive (i.e. based on the local time of the system the parser is run on)
+The `epoch` calculated timestamp field is naive. (i.e. based on the local
+time of the system the parser is run on)
 
 Usage (cli):
 
-    C:> dir | jc --dir
+    C:\> dir | jc --dir
 
 Usage (module):
 
-    import jc.parsers.dir
-    result = jc.parsers.dir.parse(dir_command_output)
+    import jc
+    result = jc.parse('dir', dir_command_output)
 
 Schema:
 
@@ -38,7 +42,7 @@ Schema:
 
 Examples:
 
-    C:> dir | jc --dir -p
+    C:\> dir | jc --dir -p
     [
       {
         "date": "03/24/2021",
@@ -46,7 +50,7 @@ Examples:
         "dir": true,
         "size": null,
         "filename": ".",
-        "parent": "C:\Program Files\Internet Explorer",
+        "parent": "C:\\Program Files\\Internet Explorer",
         "epoch": 1616624100
       },
       {
@@ -55,7 +59,7 @@ Examples:
         "dir": true,
         "size": null,
         "filename": "..",
-        "parent": "C:\Program Files\Internet Explorer",
+        "parent": "C:\\Program Files\\Internet Explorer",
         "epoch": 1616624100
       },
       {
@@ -64,7 +68,7 @@ Examples:
         "dir": true,
         "size": null,
         "filename": "en-US",
-        "parent": "C:\Program Files\Internet Explorer",
+        "parent": "C:\\Program Files\\Internet Explorer",
         "epoch": 1575715740
       },
       {
@@ -73,13 +77,13 @@ Examples:
         "dir": false,
         "size": 54784,
         "filename": "ExtExport.exe",
-        "parent": "C:\Program Files\Internet Explorer",
+        "parent": "C:\\Program Files\\Internet Explorer",
         "epoch": 1575713340
       },
       ...
     ]
 
-    C:> dir | jc --dir -p -r
+    C:\> dir | jc --dir -p -r
     [
       {
         "date": "03/24/2021",
@@ -87,7 +91,7 @@ Examples:
         "dir": true,
         "size": null,
         "filename": ".",
-        "parent": "C:\Program Files\Internet Explorer"
+        "parent": "C:\\Program Files\\Internet Explorer"
       },
       {
         "date": "03/24/2021",
@@ -95,7 +99,7 @@ Examples:
         "dir": true,
         "size": null,
         "filename": "..",
-        "parent": "C:\Program Files\Internet Explorer"
+        "parent": "C:\\Program Files\\Internet Explorer"
       },
       {
         "date": "12/07/2019",
@@ -103,7 +107,7 @@ Examples:
         "dir": true,
         "size": null,
         "filename": "en-US",
-        "parent": "C:\Program Files\Internet Explorer"
+        "parent": "C:\\Program Files\\Internet Explorer"
       },
       {
         "date": "12/07/2019",
@@ -111,21 +115,17 @@ Examples:
         "dir": false,
         "size": "54,784",
         "filename": "ExtExport.exe",
-        "parent": "C:\Program Files\Internet Explorer"
+        "parent": "C:\\Program Files\\Internet Explorer"
       },
       ...
     ]
 
+<a id="jc.parsers.dir.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -133,14 +133,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  win32
 
-Version 1.4 by Rasheed Elsaleh (rasheed@rebelliondefense.com)
+Version 1.6 by Rasheed Elsaleh (rasheed@rebelliondefense.com)

docs/parsers/dmidecode.md

@@ -1,20 +1,22 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.dmidecode"></a>
 
 # jc.parsers.dmidecode
-jc - JSON CLI output utility `dmidecode` command output parser
+
+jc - JSON Convert `dmidecode` command output parser
 
 Usage (cli):
 
     $ dmidecode | jc --dmidecode
 
-    or
+or
 
     $ jc dmidecode
 
 Usage (module):
 
-    import jc.parsers.dmidecode
-    result = jc.parsers.dmidecode.parse(dmidecode_command_output)
+    import jc
+    result = jc.parse('dmidecode', dmidecode_command_output)
 
 Schema:
 
@@ -24,7 +26,7 @@ Schema:
         "type":                        integer,
         "bytes":                       integer,
         "description":                 string,
-        "values": {                               (null if empty)
+        "values": {                                 # null if empty
           "lowercase_no_spaces_keys":  string,
           "multiline_key_values": [
                                        string,
@@ -123,16 +125,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.dmidecode.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -140,14 +138,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux
 
-Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/dpkg_l.md

@@ -1,9 +1,12 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.dpkg_l"></a>
 
-# jc.parsers.dpkg_l
-jc - JSON CLI output utility `dpkg -l` command output parser
+# jc.parsers.dpkg\_l
 
-Set the `COLUMNS` environment variable to a large value to avoid field truncation. For example:
+jc - JSON Convert `dpkg -l` command output parser
+
+Set the `COLUMNS` environment variable to a large value to avoid field
+truncation. For example:
 
     $ COLUMNS=500 dpkg -l | jc --dpkg-l
 
@@ -11,14 +14,14 @@ Usage (cli):
 
     $ dpkg -l | jc --dpkg-l
 
-    or
+or
 
     $ jc dpkg -l
 
 Usage (module):
 
-    import jc.parsers.dpkg_l
-    result = jc.parsers.dpkg_l.parse(dpkg_command_output)
+    import jc
+    result = jc.parse('dpkg_l', dpkg_command_output)
 
 Schema:
 
@@ -72,7 +75,7 @@ Examples:
         "name": "acpid",
         "version": "1:2.0.28-1ubuntu1",
         "architecture": "amd64",
-        "description": "Advanced Configuration and Power Interface event daemon",
+        "description": "Advanced Configuration and Power Interface...",
         "desired": "remove",
         "status": "half installed"
       },
@@ -116,7 +119,7 @@ Examples:
         "name": "acpid",
         "version": "1:2.0.28-1ubuntu1",
         "architecture": "amd64",
-        "description": "Advanced Configuration and Power Interface event daemon"
+        "description": "Advanced Configuration and Power Interface..."
       },
       {
         "codes": "pn",
@@ -128,16 +131,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.dpkg_l.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -145,14 +144,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux
 
-Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/du.md

@@ -1,20 +1,26 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.du"></a>
 
 # jc.parsers.du
-jc - JSON CLI output utility `du` command output parser
+
+jc - JSON Convert `du` command output parser
+
+The `du -h` option is not supported with the default output. If you
+would like to use `du -h` or other options that change the output, be sure
+to use `jc --raw` (cli) or `raw=True` (module).
 
 Usage (cli):
 
     $ du | jc --du
 
-    or
+or
 
     $ jc du
 
 Usage (module):
 
-    import jc.parsers.du
-    result = jc.parsers.du.parse(du_command_output)
+    import jc
+    result = jc.parse('du', du_command_output)
 
 Schema:
 
@@ -35,23 +41,23 @@ Examples:
       },
       {
         "size": 56,
-        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/Contents/_CodeSignature"
+        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/..."
       },
       {
         "size": 0,
-        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/Contents/Resources/Firmware/usr/local/standalone"
+        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/..."
       },
       {
         "size": 0,
-        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/Contents/Resources/Firmware/usr/local"
+        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/..."
       },
       {
         "size": 0,
-        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/Contents/Resources/Firmware/usr"
+        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/..."
       },
       {
         "size": 1008,
-        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/Contents/Resources/Firmware/dfu"
+        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/..."
       },
       ...
     ]
@@ -64,37 +70,33 @@ Examples:
       },
       {
         "size": "56",
-        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/Contents/_CodeSignature"
+        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/..."
       },
       {
         "size": "0",
-        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/Contents/Resources/Firmware/usr/local/standalone"
+        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/..."
       },
       {
         "size": "0",
-        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/Contents/Resources/Firmware/usr/local"
+        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/..."
       },
       {
         "size": "0",
-        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/Contents/Resources/Firmware/usr"
+        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/..."
       },
       {
         "size": "1008",
-        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/Contents/Resources/Firmware/dfu"
+        "name": "/usr/standalone/firmware/iBridge1_1Customer.bundle/..."
       },
       ...
     ]
 
+<a id="jc.parsers.du.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -102,14 +104,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, aix, freebsd
 
-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/email_address.md

@@ -0,0 +1,67 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.email_address"></a>
+
+# jc.parsers.email\_address
+
+jc - JSON Convert Email Address string parser
+
+Usage (cli):
+
+    $ echo "username@example.com" | jc --email-address
+
+Usage (module):
+
+    import jc
+    result = jc.parse('email_address', email_address_string)
+
+Schema:
+
+    {
+      "username":             string,
+      "domain":               string,
+      "local":                string,
+      "local_plus_suffix":    string or null
+    }
+
+Examples:
+
+    $ echo 'joe.user@gmail.com' | jc --email-address -p
+    {
+      "username": "joe.user",
+      "domain": "gmail.com",
+      "local": "joe.user",
+      "local_plus_suffix": null
+    }
+
+    $ echo 'joe.user+spam@gmail.com' | jc --email-address -p
+    {
+      "username": "joe.user",
+      "domain": "gmail.com",
+      "local": "joe.user+spam",
+      "local_plus_suffix": "spam"
+    }
+
+<a id="jc.parsers.email_address.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict
+```
+
+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, darwin, cygwin, win32, aix, freebsd
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/env.md

@@ -1,22 +1,27 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.env"></a>
 
 # jc.parsers.env
-jc - JSON CLI output utility `env` and `printenv` command output parser
 
-This parser will output a list of dictionaries each containing `name` and `value` keys. If you would like a simple dictionary output, then use the `-r` command-line option or the `raw=True` argument in the `parse()` function.
+jc - JSON Convert `env` and `printenv` command output parser
+
+This parser will output a list of dictionaries each containing `name` and
+`value` keys. If you would like a simple dictionary output, then use the
+`-r` command-line option or the `raw=True` argument in the `parse()`
+function.
 
 Usage (cli):
 
     $ env | jc --env
 
-    or
+or
 
     $ jc env
 
 Usage (module):
 
-    import jc.parsers.env
-    result = jc.parsers.env.parse(env_command_output)
+    import jc
+    result = jc.parse('env', env_command_output)
 
 Schema:
 
@@ -67,16 +72,12 @@ Examples:
       "_": "/usr/bin/env"
     }
 
+<a id="jc.parsers.env.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -84,15 +85,15 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
-    Dictionary of raw structured data or
-    List of Dictionaries of processed structured data
+    Dictionary of raw structured data or (default)
+    List of Dictionaries of processed structured data (raw)
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
 
-Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/file.md

@@ -1,27 +1,29 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.file"></a>
 
 # jc.parsers.file
-jc - JSON CLI output utility `file` command output parser
+
+jc - JSON Convert `file` command output parser
 
 Usage (cli):
 
     $ file * | jc --file
 
-    or
+or
 
     $ jc file *
 
 Usage (module):
 
-    import jc.parsers.file
-    result = jc.parsers.file.parse(file_command_output)
+    import jc
+    result = jc.parse('file', file_command_output)
 
 Schema:
 
     [
       {
         "filename":   string,
-        "type   ":    string
+        "type":       string
       }
     ]
 
@@ -51,25 +53,21 @@ Examples:
       },
       {
         "filename": "cd_catalog.xml",
-        "type": "XML 1.0 document text, ASCII text, with CRLF line terminators"
+        "type": "XML 1.0 document text, ASCII text, with CRLF line ..."
       },
       {
         "filename": "centosserial.sh",
-        "type": "Bourne-Again shell script text executable, UTF-8 Unicode text"
+        "type": "Bourne-Again shell script text executable, UTF-8 ..."
       },
       ...
     ]
 
+<a id="jc.parsers.file.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -77,14 +75,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, aix, freebsd, darwin
 
 Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/find.md

@@ -0,0 +1,82 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.find"></a>
+
+# jc.parsers.find
+
+jc - JSON Convert `find` command output parser
+
+This parser returns a list of objects by default and a list of strings if
+the `--raw` option is used.
+
+Usage (cli):
+
+    $ find | jc --find
+
+Usage (module):
+
+    import jc
+    result = jc.parse('find', find_command_output)
+
+Schema:
+
+    [
+      {
+        "path":     string,
+        "node":     string,
+        "error":    string
+      }
+    ]
+
+Examples:
+
+    $ find | jc --find -p
+    [
+        {
+          "path": "./directory"
+          "node": "filename"
+        },
+        {
+          "path": "./anotherdirectory"
+          "node": "anotherfile"
+        },
+        {
+          "path":   null
+          "node":   null
+          "error":  "find: './inaccessible': Permission denied"
+        }
+        ...
+    ]
+
+    $ find | jc --find -p -r
+    [
+      "./templates/readme_template",
+      "./templates/manpage_template",
+      "./.github/workflows/pythonapp.yml",
+      ...
+    ]
+
+<a id="jc.parsers.find.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:
+
+    List of raw strings or
+    List of Dictionaries of processed structured data
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Solomon Leang (solomonleang@gmail.com)

docs/parsers/findmnt.md

@@ -0,0 +1,117 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.findmnt"></a>
+
+# jc.parsers.findmnt
+
+jc - JSON Convert `findmnt` command output parser
+
+Supports `-a`, `-l`, or no `findmnt` options.
+
+> Note: Newer versions of `findmnt` have a JSON output option.
+
+Usage (cli):
+
+    $ findmnt | jc --findmnt
+
+or
+
+    $ jc findmnt
+
+Usage (module):
+
+    import jc
+    result = jc.parse('findmnt', findmnt_command_output)
+
+Schema:
+
+    [
+      {
+        "target":                   string,
+        "source":                   string,
+        "fstype":                   string,
+        "options": [
+                                    string
+        ],
+        "kv_options": {
+          "<key_name>":             string
+        }
+    ]
+
+Examples:
+
+    $ findmnt | jc --findmnt -p
+    [
+      {
+        "target": "/",
+        "source": "/dev/mapper/centos-root",
+        "fstype": "xfs",
+        "options": [
+          "rw",
+          "relatime",
+          "seclabel",
+          "attr2",
+          "inode64",
+          "noquota"
+        ]
+      },
+      {
+        "target": "/sys/fs/cgroup",
+        "source": "tmpfs",
+        "fstype": "tmpfs",
+        "options": [
+          "ro",
+          "nosuid",
+          "nodev",
+          "noexec",
+          "seclabel"
+        ],
+        "kv_options": {
+          "mode": "755"
+        }
+      },
+      ...
+    ]
+
+    $ findmnt | jc --findmnt -p -r
+    [
+      {
+        "target": "/",
+        "source": "/dev/mapper/centos-root",
+        "fstype": "xfs",
+        "options": "rw,relatime,seclabel,attr2,inode64,noquota"
+      },
+      {
+        "target": "/sys/fs/cgroup",
+        "source": "tmpfs",
+        "fstype": "tmpfs",
+        "options": "ro,nosuid,nodev,noexec,seclabel,mode=755"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.findmnt.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
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/finger.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.finger"></a>
 
 # jc.parsers.finger
-jc - JSON CLI output utility `finger` command output parser
+
+jc - JSON Convert `finger` command output parser
 
 Supports `-s` output option. Does not support the `-l` detail option.
 
@@ -9,14 +11,14 @@ Usage (cli):
 
     $ finger | jc --finger
 
-    or
+or
 
     $ jc finger
 
 Usage (module):
 
-    import jc.parsers.finger
-    result = jc.parsers.finger.parse(finger_command_output)
+    import jc
+    result = jc.parse('finger', finger_command_output)
 
 Schema:
 
@@ -88,16 +90,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.finger.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -105,14 +103,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, freebsd
 
 Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/free.md

@@ -1,20 +1,22 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.free"></a>
 
 # jc.parsers.free
-jc - JSON CLI output utility `free` command output parser
+
+jc - JSON Convert `free` command output parser
 
 Usage (cli):
 
     $ free | jc --free
 
-    or
+or
 
     $ jc free
 
 Usage (module):
 
-    import jc.parsers.free
-    result = jc.parsers.free.parse(free_command_output)
+    import jc
+    result = jc.parse('free', free_command_output)
 
 Schema:
 
@@ -70,16 +72,12 @@ Examples:
       }
     ]
 
+<a id="jc.parsers.free.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -87,14 +85,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux
 
-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/fstab.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.fstab"></a>
 
 # jc.parsers.fstab
-jc - JSON CLI output utility `fstab` file parser
+
+jc - JSON Convert `fstab` file parser
 
 Usage (cli):
 
@@ -9,8 +11,8 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.fstab
-    result = jc.parsers.fstab.parse(fstab_command_output)
+    import jc
+    result = jc.parse('fstab', fstab_command_output)
 
 Schema:
 
@@ -83,16 +85,12 @@ Examples:
       }
     ]
 
+<a id="jc.parsers.fstab.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -100,14 +98,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, freebsd
 
-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/git_log.md

@@ -0,0 +1,175 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.git_log"></a>
+
+# jc.parsers.git\_log
+
+jc - JSON Convert `git log` command output parser
+
+Can be used with the following format options:
+- `oneline`
+- `short`
+- `medium`
+- `full`
+- `fuller`
+
+Additional options supported:
+- `--stat`
+- `--shortstat`
+
+The `epoch` calculated timestamp field is naive. (i.e. based on the
+local time of the system the parser is run on)
+
+The `epoch_utc` calculated timestamp field is timezone-aware and is
+only available if the timezone field is UTC.
+
+Usage (cli):
+
+    $ git log | jc --git-log
+
+or
+
+    $ jc git log
+
+Usage (module):
+
+    import jc
+    result = jc.parse('git_log', git_log_command_output)
+
+Schema:
+
+    [
+      {
+        "commit":               string,
+        "author":               string/null,
+        "author_email":         string/null,
+        "date":                 string,
+        "epoch":                integer,  # [0]
+        "epoch_utc":            integer,  # [1]
+        "commit_by":            string/null,
+        "commit_by_email":      string/null,
+        "commit_by_date":       string,
+        "message":              string,
+        "stats" : {
+          "files_changed":      integer,
+          "insertions":         integer,
+          "deletions":          integer,
+          "files": [
+                                string
+          ]
+        }
+      }
+    ]
+
+    [0] naive timestamp if "date" field is parsable, else null
+    [1] timezone aware timestamp available for UTC, else null
+
+Examples:
+
+    $ git log --stat | jc --git-log -p
+    [
+      {
+        "commit": "728d882ed007b3c8b785018874a0eb06e1143b66",
+        "author": "Kelly Brazil",
+        "author_email": "kellyjonbrazil@gmail.com",
+        "date": "Wed Apr 20 09:50:19 2022 -0400",
+        "stats": {
+          "files_changed": 2,
+          "insertions": 90,
+          "deletions": 12,
+          "files": [
+            "docs/parsers/git_log.md",
+            "jc/parsers/git_log.py"
+          ]
+        },
+        "message": "add timestamp docs and examples",
+        "epoch": 1650462619,
+        "epoch_utc": null
+      },
+      {
+        "commit": "b53e42aca623181aa9bc72194e6eeef1e9a3a237",
+        "author": "Kelly Brazil",
+        "author_email": "kellyjonbrazil@gmail.com",
+        "date": "Wed Apr 20 09:44:42 2022 -0400",
+        "stats": {
+          "files_changed": 5,
+          "insertions": 29,
+          "deletions": 6,
+          "files": [
+            "docs/parsers/git_log.md",
+            "docs/utils.md",
+            "jc/parsers/git_log.py",
+            "jc/utils.py",
+            "man/jc.1"
+          ]
+        },
+        "message": "add calculated timestamp",
+        "epoch": 1650462282,
+        "epoch_utc": null
+      },
+      ...
+    ]
+
+    $ git log --stat | jc --git-log -p -r
+    [
+      {
+        "commit": "728d882ed007b3c8b785018874a0eb06e1143b66",
+        "author": "Kelly Brazil",
+        "author_email": "kellyjonbrazil@gmail.com",
+        "date": "Wed Apr 20 09:50:19 2022 -0400",
+        "stats": {
+          "files_changed": "2",
+          "insertions": "90",
+          "deletions": "12",
+          "files": [
+            "docs/parsers/git_log.md",
+            "jc/parsers/git_log.py"
+          ]
+        },
+        "message": "add timestamp docs and examples"
+      },
+      {
+        "commit": "b53e42aca623181aa9bc72194e6eeef1e9a3a237",
+        "author": "Kelly Brazil",
+        "author_email": "kellyjonbrazil@gmail.com",
+        "date": "Wed Apr 20 09:44:42 2022 -0400",
+        "stats": {
+          "files_changed": "5",
+          "insertions": "29",
+          "deletions": "6",
+          "files": [
+            "docs/parsers/git_log.md",
+            "docs/utils.md",
+            "jc/parsers/git_log.py",
+            "jc/utils.py",
+            "man/jc.1"
+          ]
+        },
+        "message": "add calculated timestamp"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.git_log.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+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
+
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/git_log_s.md

@@ -0,0 +1,111 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.git_log_s"></a>
+
+# jc.parsers.git\_log\_s
+
+jc - JSON Convert `git log` command output streaming parser
+
+> This streaming parser outputs JSON Lines (cli) or returns an Iterable of
+> Dictionaries (module)
+
+Can be used with the following format options:
+- `oneline`
+- `short`
+- `medium`
+- `full`
+- `fuller`
+
+Additional options supported:
+- `--stat`
+- `--shortstat`
+
+The `epoch` calculated timestamp field is naive. (i.e. based on the
+local time of the system the parser is run on)
+
+The `epoch_utc` calculated timestamp field is timezone-aware and is
+only available if the timezone field is UTC.
+
+Usage (cli):
+
+    $ git log | jc --git-log-s
+
+Usage (module):
+
+    import jc
+
+    result = jc.parse('git_log_s', git_log_command_output.splitlines())
+    for item in result:
+        # do something
+
+Schema:
+
+    {
+      "commit":               string,
+      "author":               string/null,
+      "author_email":         string/null,
+      "date":                 string,
+      "epoch":                integer,  # [0]
+      "epoch_utc":            integer,  # [1]
+      "commit_by":            string/null,
+      "commit_by_email":      string/null,
+      "commit_by_date":       string,
+      "message":              string,
+      "stats" : {
+        "files_changed":      integer,
+        "insertions":         integer,
+        "deletions":          integer,
+        "files": [
+                              string
+        ]
+      }
+
+      # below object only exists if using -qq or ignore_exceptions=True
+      "_jc_meta": {
+        "success":      boolean,     # false if error parsing
+        "error":        string,      # exists if "success" is false
+        "line":         string       # exists if "success" is false
+      }
+    }
+
+    [0] naive timestamp if "date" field is parsable, else null
+    [1] timezone aware timestamp available for UTC, else null
+
+Examples:
+
+    $ git log | jc --git-log-s
+    {"commit":"a730ae18c8e81c5261db132df73cd74f272a0a26","author":"Kelly...}
+    {"commit":"930bf439c06c48a952baec05a9896c8d92b7693e","author":"Kelly...}
+    ...
+
+<a id="jc.parsers.git_log_s.parse"></a>
+
+### parse
+
+```python
+@add_jc_meta
+def parse(data: Iterable[str],
+          raw: bool = False,
+          quiet: bool = False,
+          ignore_exceptions: bool = False) -> Union[Iterable[Dict], tuple]
+```
+
+Main text parsing generator function. Returns an iterable object.
+
+Parameters:
+
+    data:              (iterable)  line-based text data to parse
+                                   (e.g. sys.stdin or str.splitlines())
+
+    raw:               (boolean)   unprocessed output if True
+    quiet:             (boolean)   suppress warning messages if True
+    ignore_exceptions: (boolean)   ignore parsing exceptions if True
+
+
+Returns:
+
+    Iterable of Dictionaries
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/git_ls_remote.md

@@ -0,0 +1,92 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.git_ls_remote"></a>
+
+# jc.parsers.git\_ls\_remote
+
+jc - JSON Convert `git ls-remote` command output parser
+
+This parser outputs two schemas:
+
+- Default: A single object with key/value pairs
+- Raw: An array of objects (`--raw` (cli) or `raw=True (module))
+
+See the Schema section for more details
+
+Usage (cli):
+
+    $ git ls-remote | jc --git-ls-remote
+
+or
+
+    $ jc git ls-remote
+
+Usage (module):
+
+    import jc
+    result = jc.parse('git_ls_remote', git_ls_remote_command_output)
+
+Schema:
+
+    Default:
+    {
+      <reference>:            string
+    }
+
+    Raw:
+    [
+      {
+        "reference":          string,
+        "commit":             string
+      }
+    ]
+
+Examples:
+
+    $ git ls-remote | jc --git-ls-remote -p
+    {
+      "HEAD": "214cd6b9e09603b3c4fa02203b24fb2bc3d4e338",
+      "refs/heads/dev": "b884f6aacca39e05994596d8fdfa7e7c4f1e0389",
+      "refs/heads/master": "214cd6b9e09603b3c4fa02203b24fb2bc3d4e338",
+      "refs/pull/1/head": "e416c77bed1267254da972b0f95b7ff1d43fccef",
+      ...
+    }
+
+    $ git ls-remote | jc --git-ls-remote -p -r
+    [
+      {
+        "reference": "HEAD",
+        "commit": "214cd6b9e09603b3c4fa02203b24fb2bc3d4e338"
+      },
+      {
+        "reference": "refs/heads/dev",
+        "commit": "b884f6aacca39e05994596d8fdfa7e7c4f1e0389"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.git_ls_remote.parse"></a>
+
+### parse
+
+```python
+def parse(data: str,
+          raw: bool = False,
+          quiet: bool = False) -> Union[JSONDictType, 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:
+
+    Dictionary (default) or List of Dictionaries (raw)
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/gpg.md

@@ -0,0 +1,145 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.gpg"></a>
+
+# jc.parsers.gpg
+
+jc - JSON Convert `gpg --with-colons` command output parser
+
+Usage (cli):
+
+    $ gpg --with-colons --show-keys file.gpg | jc --gpg
+
+or
+
+    $ jc gpg --with-colons --show-keys file.gpg
+
+Usage (module):
+
+    import jc
+    result = jc.parse('gpg', gpg_command_output)
+
+Schema:
+
+Field definitions from https://git.gnupg.org/cgi-bin/gitweb.cgi?p=gnupg.git;a=blob_plain;f=doc/DETAILS
+
+> Note: Number values are not converted to integers because many field
+> specifications are overloaded and future augmentations are implied in the
+> documentation.
+
+    [
+      {
+        "type":                             string,
+        "validity":                         string,
+        "key_length":                       string,
+        "pub_key_alg":                      string,
+        "key_id":                           string,
+        "creation_date":                    string,
+        "expiration_date":                  string,
+        "certsn_uidhash_trustinfo":         string,
+        "owner_trust":                      string,
+        "user_id":                          string,
+        "signature_class":                  string,
+        "key_capabilities":                 string,
+        "cert_fingerprint_other":           string,
+        "flag":                             string,
+        "token_sn":                         string,
+        "hash_alg":                         string,
+        "curve_name":                       string,
+        "compliance_flags":                 string,
+        "last_update_date":                 string,
+        "origin":                           string,
+        "comment":                          string,
+        "index":                            string,  # [0]
+        "bits":                             string,  # [0]
+        "value":                            string,  # [0]
+        "version":                          string,  # [1], [4]
+        "signature_count":                  string,  # [1]
+        "encryption_count":                 string,  # [1]
+        "policy":                           string,  # [1]
+        "signature_first_seen":             string,  # [1]
+        "signature_most_recent_seen":       string,  # [1]
+        "encryption_first_done":            string,  # [1]
+        "encryption_most_recent_done":      string,  # [1]
+        "staleness_reason":                 string,  # [2]
+        "trust_model":                      string,  # [2]
+        "trust_db_created":                 string,  # [2]
+        "trust_db_expires":                 string,  # [2]
+        "marginally_trusted_users":         string,  # [2]
+        "completely_trusted_users":         string,  # [2]
+        "cert_chain_max_depth":             string,  # [2]
+        "subpacket_number":                 string,  # [3]
+        "hex_flags":                        string,  # [3]
+        "subpacket_length":                 string,  # [3]
+        "subpacket_data":                   string,  # [3]
+        "pubkey":                           string,  # [4]
+        "cipher":                           string,  # [4]
+        "digest":                           string,  # [4]
+        "compress":                         string,  # [4]
+        "group":                            string,  # [4]
+        "members":                          string,  # [4]
+        "curve_names":                      string,  # [4]
+      }
+    ]
+
+    All blank values are converted to null/None.
+
+    [0] for 'pkd' type
+    [1] for 'tfs' type
+    [2] for 'tru' type
+    [3] for 'skp' type
+    [4] for 'cfg' type
+
+Examples:
+
+    $ gpg --with-colons --show-keys file.gpg | jc --gpg -p
+    [
+      {
+        "type": "pub",
+        "validity": "f",
+        "key_length": "1024",
+        "pub_key_alg": "17",
+        "key_id": "6C7EE1B8621CC013",
+        "creation_date": "899817715",
+        "expiration_date": "1055898235",
+        "certsn_uidhash_trustinfo": null,
+        "owner_trust": "m",
+        "user_id": null,
+        "signature_class": null,
+        "key_capabilities": "scESC",
+        "cert_fingerprint_other": null,
+        "flag": null,
+        "token_sn": null,
+        "hash_alg": null,
+        "curve_name": null,
+        "compliance_flags": null,
+        "last_update_date": null,
+        "origin": null,
+        "comment": null
+      },
+      ...
+    ]
+
+<a id="jc.parsers.gpg.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+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
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/group.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.group"></a>
 
 # jc.parsers.group
-jc - JSON CLI output utility `/etc/group` file parser
+
+jc - JSON Convert `/etc/group` file parser
 
 Usage (cli):
 
@@ -9,8 +11,8 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.group
-    result = jc.parsers.group.parse(group_file_output)
+    import jc
+    result = jc.parse('group', group_file_output)
 
 Schema:
 
@@ -107,16 +109,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.group.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -124,14 +122,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, aix, freebsd
 
-Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/gshadow.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.gshadow"></a>
 
 # jc.parsers.gshadow
-jc - JSON CLI output utility `/etc/gshadow` file parser
+
+jc - JSON Convert `/etc/gshadow` file parser
 
 Usage (cli):
 
@@ -9,8 +11,8 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.gshadow
-    result = jc.parsers.gshadow.parse(gshadow_file_output)
+    import jc
+    result = jc.parse('gshadow', gshadow_file_output)
 
 Schema:
 
@@ -75,16 +77,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.gshadow.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -92,14 +90,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, aix, freebsd
 
 Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/hash.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.hash"></a>
 
 # jc.parsers.hash
-jc - JSON CLI output utility `hash` command output parser
+
+jc - JSON Convert `hash` command output parser
 
 Usage (cli):
 
@@ -9,8 +11,8 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.hash
-    result = jc.parsers.hash.parse(hash_command_output)
+    import jc
+    result = jc.parse('hash', hash_command_output)
 
 Schema:
 
@@ -35,16 +37,12 @@ Examples:
       }
     ]
 
+<a id="jc.parsers.hash.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -52,14 +50,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd
 
-Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/hashsum.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.hashsum"></a>
 
 # jc.parsers.hashsum
-jc - JSON CLI output utility `hash sum` command output parser
+
+jc - JSON Convert `hash sum` command output parser
 
 This parser works with the following hash calculation utilities:
 - `md5`
@@ -17,14 +19,14 @@ Usage (cli):
 
     $ md5sum file.txt | jc --hashsum
 
-    or
+or
 
     $ jc md5sum file.txt
 
 Usage (module):
 
-    import jc.parsers.hashsum
-    result = jc.parsers.hashsum.parse(md5sum_command_output)
+    import jc
+    result = jc.parse('hashsum', md5sum_command_output)
 
 Schema:
 
@@ -66,16 +68,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.hashsum.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -83,14 +81,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd
 
 Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/hciconfig.md

@@ -1,20 +1,22 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.hciconfig"></a>
 
 # jc.parsers.hciconfig
-jc - JSON CLI output utility `hciconfig` command output parser
+
+jc - JSON Convert `hciconfig` command output parser
 
 Usage (cli):
 
     $ hciconfig | jc --hciconfig
 
-    or
+or
 
     $ jc hciconfig
 
 Usage (module):
 
-    import jc.parsers.hciconfig
-    result = jc.parsers.hciconfig.parse(hciconfig_command_output)
+    import jc
+    result = jc.parse('hciconfig', hciconfig_command_output)
 
 Schema:
 
@@ -315,16 +317,12 @@ Examples:
       }
     ]
 
+<a id="jc.parsers.hciconfig.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -332,14 +330,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux
 
-Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/history.md

@@ -1,11 +1,17 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.history"></a>
 
 # jc.parsers.history
-jc - JSON CLI output utility `history` command output parser
 
-This parser will output a list of dictionaries each containing `line` and `command` keys. If you would like a simple dictionary output, then use the `-r` command-line option or the `raw=True` argument in the `parse()` function.
+jc - JSON Convert `history` command output parser
 
-The "Magic" syntax is not supported since the `history` command is a shell builtin.
+This parser will output a list of dictionaries each containing `line` and
+`command` keys. If you would like a simple dictionary output, then use the
+`-r` command-line option or the `raw=True` argument in the `parse()`
+function.
+
+The "Magic" syntax is not supported since the `history` command is a shell
+builtin.
 
 Usage (cli):
 
@@ -13,8 +19,8 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.history
-    result = jc.parsers.history.parse(history_command_output)
+    import jc
+    result = jc.parse('history', history_command_output)
 
 Schema:
 
@@ -39,7 +45,7 @@ Examples:
       },
       {
         "line": 120,
-        "command": "echo "hello""
+        "command": "echo \"hello\""
       },
       {
         "line": 121,
@@ -52,21 +58,17 @@ Examples:
     {
       "118": "sleep 100",
       "119": "ls /bin",
-      "120": "echo "hello"",
+      "120": "echo \"hello\"",
       "121": "docker images",
       ...
     }
 
+<a id="jc.parsers.history.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -74,7 +76,7 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
@@ -82,7 +84,7 @@ Returns:
     Dictionary of raw structured data or
     List of Dictionaries of processed structured data
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd
 
-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/host.md

@@ -0,0 +1,113 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.host"></a>
+
+# jc.parsers.host
+
+jc - JSON Convert `host` command output parser
+
+Supports parsing of the most commonly used RR types (A, AAAA, MX, TXT)
+
+Usage (cli):
+
+    $ host google.com | jc --host
+
+or
+
+    $ jc host google.com
+
+Usage (module):
+
+    import jc
+    result = jc.parse('host', host_command_output)
+
+Schema:
+
+    [
+      {
+        "hostname":     string,
+        "address": [
+                        string
+        ],
+        "v6-address": [
+                        string
+        ],
+        "mail": [
+                        string
+        ]
+      }
+    ]
+
+    [
+      {
+        "nameserver":   string,
+        "zone":         string,
+        "mname":        string,
+        "rname":        string,
+        "serial":       integer,
+        "refresh":      integer,
+        "retry":        integer,
+        "expire":       integer,
+        "minimum":      integer
+      }
+    ]
+
+Examples:
+
+    $ host google.com | jc --host
+    [
+      {
+        "hostname": "google.com",
+        "address": [
+          "142.251.39.110"
+        ],
+        "v6-address": [
+          "2a00:1450:400e:811::200e"
+        ],
+        "mail": [
+          "smtp.google.com."
+        ]
+      }
+    ]
+
+    $ jc host -C sunet.se
+    [
+      {
+        "nameserver": "2001:6b0:7::2",
+        "zone": "sunet.se",
+        "mname": "sunic.sunet.se.",
+        "rname": "hostmaster.sunet.se.",
+        "serial": "2023090401",
+        "refresh": "28800",
+        "retry": "7200",
+        "expire": "604800",
+        "minimum": "300"
+      },
+      {
+        ...
+      }
+    ]
+
+<a id="jc.parsers.host.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = 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:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Version 1.0 by Pettai (pettai@sunet.se)

docs/parsers/hosts.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.hosts"></a>
 
 # jc.parsers.hosts
-jc - JSON CLI output utility `/etc/hosts` file parser
+
+jc - JSON Convert `/etc/hosts` file parser
 
 Usage (cli):
 
@@ -9,8 +11,8 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.hosts
-    result = jc.parsers.hosts.parse(hosts_file_output)
+    import jc
+    result = jc.parse('hosts', hosts_file_output)
 
 Schema:
 
@@ -72,16 +74,12 @@ Examples:
       }
     ]
 
+<a id="jc.parsers.hosts.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -89,14 +87,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
 
 Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/id.md

@@ -1,20 +1,22 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.id"></a>
 
 # jc.parsers.id
-jc - JSON CLI output utility `id` command output parser
+
+jc - JSON Convert `id` command output parser
 
 Usage (cli):
 
     $ id | jc --id
 
-    or
+or
 
     $ jc id
 
 Usage (module):
 
-    import jc.parsers.id
-    result = jc.parsers.id.parse(id_command_output)
+    import jc
+    result = jc.parse('id', id_command_output)
 
 Schema:
 
@@ -103,16 +105,12 @@ Examples:
       }
     }
 
+<a id="jc.parsers.id.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -120,14 +118,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     Dictionary. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, aix, freebsd
 
-Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ifconfig.md

@@ -1,61 +1,118 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.ifconfig"></a>
 
 # jc.parsers.ifconfig
-jc - JSON CLI output utility `ifconfig` command output parser
 
-Note: No `ifconfig` options are supported.
+jc - JSON Convert `ifconfig` command output parser
+
+No `ifconfig` options are supported.
+
+Consider using the `ip` command instead of `ifconfig` as it supports native
+JSON output.
 
 Usage (cli):
 
     $ ifconfig | jc --ifconfig
 
-    or
+or
 
     $ jc ifconfig
 
 Usage (module):
 
-    import jc.parsers.ifconfig
-    result = jc.parsers.ifconfig.parse(ifconfig_command_output)
+    import jc
+    result = jc.parse('ifconfig', ifconfig_command_output)
 
 Schema:
 
     [
       {
-        "name":             string,
-        "flags":            integer,
+        "name":                     string,
+        "type":                     string,
+        "metric":                   integer
+        "flags":                    integer,
         "state": [
-                            string
+                                    string
         ],
-        "mtu":              integer,
-        "ipv4_addr":        string,
-        "ipv4_mask":        string,
-        "ipv4_bcast":       string,
-        "ipv6_addr":        string,
-        "ipv6_mask":        integer,
-        "ipv6_scope":       string,
-        "mac_addr":         string,
-        "type":             string,
-        "rx_packets":       integer,
-        "rx_bytes":         integer,
-        "rx_errors":        integer,
-        "rx_dropped":       integer,
-        "rx_overruns":      integer,
-        "rx_frame":         integer,
-        "tx_packets":       integer,
-        "tx_bytes":         integer,
-        "tx_errors":        integer,
-        "tx_dropped":       integer,
-        "tx_overruns":      integer,
-        "tx_carrier":       integer,
-        "tx_collisions":    integer,
-        "metric":           integer
+        "mtu":                      integer,
+        "mac_addr":                 string,
+        "ipv4_addr":                string,    # [0]
+        "ipv4_mask":                string,    # [0]
+        "ipv4_bcast":               string,    # [0]
+        "ipv6_addr":                string,    # [0]
+        "ipv6_mask":                integer,   # [0]
+        "ipv6_scope":               string,    # [0]
+        "ipv6_scope_id":            string,    # [0]
+        "ipv6_type":                string,    # [0]
+        "rx_packets":               integer,
+        "rx_bytes":                 integer,
+        "rx_errors":                integer,
+        "rx_dropped":               integer,
+        "rx_overruns":              integer,
+        "rx_frame":                 integer,
+        "tx_packets":               integer,
+        "tx_bytes":                 integer,
+        "tx_errors":                integer,
+        "tx_dropped":               integer,
+        "tx_overruns":              integer,
+        "tx_carrier":               integer,
+        "tx_collisions":            integer,
+        "options":                  string,
+        "options_flags": [
+                                    string
+        ],
+        "status":                   string,
+        "hw_address":               string,
+        "media":                    string,
+        "media_flags": [
+                                    string
+        ],
+        "nd6_options":              integer,
+        "nd6_flags": [
+                                    string
+        ],
+        "plugged":                  string,
+        "vendor":                   string,
+        "vendor_pn":                string,
+        "vendor_sn":                string,
+        "vendor_date":              string,
+        "module_temperature":       string,
+        "module_voltage":           string
+        "ipv4": [
+          {
+            "address":              string,
+            "mask":                 string,
+            "broadcast":            string
+          }
+        ],
+        "ipv6: [
+          {
+            "address":              string,
+            "scope_id":             string,
+            "mask":                 integer,
+            "scope":                string,
+            "type":                 string
+          }
+        ],
+        "lanes": [
+          {
+            "lane":                 integer,
+            "rx_power_mw":          float,
+            "rx_power_dbm":         float,
+            "tx_bias_ma":           float
+          }
+        ]
       }
     ]
 
+    [0] these fields only pick up the last IP address in the interface
+        output and are here for backwards compatibility. For information on
+        all IP addresses, use the `ipv4` and `ipv6` objects which contain an
+        array of IP address objects.
+
 Examples:
 
-    $ ifconfig | jc --ifconfig -p
+    $ ifconfig ens33 | jc --ifconfig -p
     [
       {
         "name": "ens33",
@@ -67,133 +124,105 @@ Examples:
           "MULTICAST"
         ],
         "mtu": 1500,
+        "type": "Ethernet",
+        "mac_addr": "00:0c:29:3b:58:0e",
         "ipv4_addr": "192.168.71.137",
         "ipv4_mask": "255.255.255.0",
         "ipv4_bcast": "192.168.71.255",
         "ipv6_addr": "fe80::c1cb:715d:bc3e:b8a0",
         "ipv6_mask": 64,
         "ipv6_scope": "0x20",
-        "mac_addr": "00:0c:29:3b:58:0e",
-        "type": "Ethernet",
+        "ipv6_type": "link",
+        "metric": null,
         "rx_packets": 8061,
-        "rx_bytes": 1514413,
         "rx_errors": 0,
         "rx_dropped": 0,
         "rx_overruns": 0,
         "rx_frame": 0,
         "tx_packets": 4502,
+        "tx_errors": 0,
+        "tx_dropped": 0,
+        "tx_overruns": 0,
+        "tx_carrier": 0,
+        "tx_collisions": 0,
+        "rx_bytes": 1514413,
         "tx_bytes": 866622,
-        "tx_errors": 0,
-        "tx_dropped": 0,
-        "tx_overruns": 0,
-        "tx_carrier": 0,
-        "tx_collisions": 0,
-        "metric": null
-      },
-      {
-        "name": "lo",
-        "flags": 73,
-        "state": [
-          "UP",
-          "LOOPBACK",
-          "RUNNING"
+        "ipv4": [
+          {
+            "address": "192.168.71.137",
+            "mask": "255.255.255.0",
+            "broadcast": "192.168.71.255"
+          }
         ],
-        "mtu": 65536,
-        "ipv4_addr": "127.0.0.1",
-        "ipv4_mask": "255.0.0.0",
-        "ipv4_bcast": null,
-        "ipv6_addr": "::1",
-        "ipv6_mask": 128,
-        "ipv6_scope": "0x10",
-        "mac_addr": null,
-        "type": "Local Loopback",
-        "rx_packets": 73,
-        "rx_bytes": 6009,
-        "rx_errors": 0,
-        "rx_dropped": 0,
-        "rx_overruns": 0,
-        "rx_frame": 0,
-        "tx_packets": 73,
-        "tx_bytes": 6009,
-        "tx_errors": 0,
-        "tx_dropped": 0,
-        "tx_overruns": 0,
-        "tx_carrier": 0,
-        "tx_collisions": 0,
-        "metric": null
+        "ipv6": [
+          {
+            "address": "fe80::c1cb:715d:bc3e:b8a0",
+            "scope_id": null,
+            "mask": 64,
+            "scope": "0x20",
+            "type": "link"
+          }
+        ]
       }
     ]
 
-    $ ifconfig | jc --ifconfig -p -r
+    $ ifconfig ens33 | jc --ifconfig -p -r
     [
       {
         "name": "ens33",
         "flags": "4163",
         "state": "UP,BROADCAST,RUNNING,MULTICAST",
         "mtu": "1500",
+        "type": "Ethernet",
+        "mac_addr": "00:0c:29:3b:58:0e",
         "ipv4_addr": "192.168.71.137",
         "ipv4_mask": "255.255.255.0",
         "ipv4_bcast": "192.168.71.255",
         "ipv6_addr": "fe80::c1cb:715d:bc3e:b8a0",
         "ipv6_mask": "64",
         "ipv6_scope": "0x20",
-        "mac_addr": "00:0c:29:3b:58:0e",
-        "type": "Ethernet",
+        "ipv6_type": "link",
+        "metric": null,
         "rx_packets": "8061",
-        "rx_bytes": "1514413",
         "rx_errors": "0",
         "rx_dropped": "0",
         "rx_overruns": "0",
         "rx_frame": "0",
         "tx_packets": "4502",
+        "tx_errors": "0",
+        "tx_dropped": "0",
+        "tx_overruns": "0",
+        "tx_carrier": "0",
+        "tx_collisions": "0",
+        "rx_bytes": "1514413",
         "tx_bytes": "866622",
-        "tx_errors": "0",
-        "tx_dropped": "0",
-        "tx_overruns": "0",
-        "tx_carrier": "0",
-        "tx_collisions": "0",
-        "metric": null
-      },
-      {
-        "name": "lo",
-        "flags": "73",
-        "state": "UP,LOOPBACK,RUNNING",
-        "mtu": "65536",
-        "ipv4_addr": "127.0.0.1",
-        "ipv4_mask": "255.0.0.0",
-        "ipv4_bcast": null,
-        "ipv6_addr": "::1",
-        "ipv6_mask": "128",
-        "ipv6_scope": "0x10",
-        "mac_addr": null,
-        "type": "Local Loopback",
-        "rx_packets": "73",
-        "rx_bytes": "6009",
-        "rx_errors": "0",
-        "rx_dropped": "0",
-        "rx_overruns": "0",
-        "rx_frame": "0",
-        "tx_packets": "73",
-        "tx_bytes": "6009",
-        "tx_errors": "0",
-        "tx_dropped": "0",
-        "tx_overruns": "0",
-        "tx_carrier": "0",
-        "tx_collisions": "0",
-        "metric": null
+        "ipv4": [
+          {
+            "address": "192.168.71.137",
+            "mask": "255.255.255.0",
+            "broadcast": "192.168.71.255"
+          }
+        ],
+        "ipv6": [
+          {
+            "address": "fe80::c1cb:715d:bc3e:b8a0",
+            "scope_id": null,
+            "mask": "64",
+            "scope": "0x20",
+            "type": "link"
+          }
+        ]
       }
     ]
 
+<a id="jc.parsers.ifconfig.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data: str,
+          raw: bool = False,
+          quiet: bool = False) -> List[JSONDictType]
 ```
 
 Main text parsing function
@@ -201,14 +230,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, aix, freebsd, darwin
 
-Version 1.11 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 2.3 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ini.md

@@ -1,11 +1,22 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.ini"></a>
 
 # jc.parsers.ini
-jc - JSON CLI output utility `INI` file parser
 
-Parses standard `INI` files and files containing simple key/value pairs. Delimiter can be `=` or `:`. Missing values are supported. Comment prefix can be `#` or `;`. Comments must be on their own line.
+jc - JSON Convert INI file parser
 
-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()`.
+Parses standard INI files.
+
+- Delimiter can be `=` or `:`. Missing values are supported.
+- Comment prefix can be `#` or `;`. Comments must be on their own line.
+- If duplicate keys are found, only the last value will be used.
+- If any section names have the same name as a top-level key, the top-level
+  key will be overwritten by the section data.
+
+> Note: Values starting and ending with double or single 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):
 
@@ -13,66 +24,61 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.ini
-    result = jc.parsers.ini.parse(ini_file_output)
+    import jc
+    result = jc.parse('ini', ini_file_output)
 
 Schema:
 
-    ini or key/value document converted to a dictionary - see configparser standard
-          library documentation for more details.
-
-    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 or raw=True argument.
+INI document converted to a dictionary - see the python configparser
+standard library documentation for more details.
 
     {
-      "key1":       string,
-      "key2":       string
+      "<key1>":               string,
+      "<key2>":               string,
+      "<section1>": {
+        "<key1>":             string,
+        "<key2>":             string
+      },
+      "<section2>": {
+        "<key1>":             string,
+        "<key2>":             string
+      }
     }
 
 Examples:
 
     $ cat example.ini
-    [DEFAULT]
-    ServerAliveInterval = 45
-    Compression = yes
-    CompressionLevel = 9
-    ForwardX11 = yes
+    foo = fiz
+    bar = buz
 
-    [bitbucket.org]
-    User = hg
+    [section1]
+    fruit = apple
+    color = blue
 
-    [topsecret.server.com]
-    Port = 50022
-    ForwardX11 = no
+    [section2]
+    fruit = pear
+    color = green
 
     $ cat example.ini | jc --ini -p
     {
-      "bitbucket.org": {
-        "serveraliveinterval": "45",
-        "compression": "yes",
-        "compressionlevel": "9",
-        "forwardx11": "yes",
-        "user": "hg"
+      "foo": "fiz",
+      "bar": "buz",
+      "section1": {
+        "fruit": "apple",
+        "color": "blue"
       },
-      "topsecret.server.com": {
-        "serveraliveinterval": "45",
-        "compression": "yes",
-        "compressionlevel": "9",
-        "forwardx11": "no",
-        "port": "50022"
+      "section2": {
+        "fruit": "pear",
+        "color": "green"
       }
     }
 
+<a id="jc.parsers.ini.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -80,14 +86,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
-    Dictionary representing the ini file
+    Dictionary representing the INI file.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
 
-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 2.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ini_dup.md

@@ -0,0 +1,121 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.ini_dup"></a>
+
+# jc.parsers.ini\_dup
+
+jc - JSON Convert INI with duplicate key file parser
+
+Parses standard INI files 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 any section names have the same name as a top-level key, the top-level
+  key will be overwritten by the section data.
+- 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 double or single 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.ini | jc --ini-dup
+
+Usage (module):
+
+    import jc
+    result = jc.parse('ini_dup', ini_file_output)
+
+Schema:
+
+INI document converted to a dictionary - see the python configparser
+standard library documentation for more details.
+
+    {
+      "<key1>": [
+                            string
+      ],
+      "<key2>": [
+                            string
+      ],
+      "<section1>": {
+        "<key1>": [
+                            string
+        ],
+        "<key2>": [
+                            string
+        ]
+      }
+    }
+
+Examples:
+
+    $ cat example.ini
+    foo = fiz
+    bar = buz
+
+    [section1]
+    fruit = apple
+    color = blue
+    color = red
+
+    [section2]
+    fruit = pear
+    fruit = peach
+    color = green
+
+    $ cat example.ini | jc --ini-dup -p
+    {
+      "foo": [
+        "fiz"
+      ],
+      "bar": [
+        "buz"
+      ],
+      "section1": {
+        "fruit": [
+          "apple"
+        ],
+        "color": [
+          "blue",
+          "red"
+        ]
+      },
+      "section2": {
+        "fruit": [
+          "pear",
+          "peach"
+        ],
+        "color": [
+          "green"
+        ]
+      }
+    }
+
+<a id="jc.parsers.ini_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 the INI file.
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/iostat.md

@@ -1,22 +1,24 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.iostat"></a>
 
 # jc.parsers.iostat
-jc - JSON CLI output utility `iostat` command output parser
 
-Note: `iostat` version 11 and higher include a JSON output option
+jc - JSON Convert `iostat` command output parser
+
+> Note: `iostat` version 11 and higher include a JSON output option
 
 Usage (cli):
 
     $ iostat | jc --iostat
 
-    or
+or
 
     $ jc iostat
 
 Usage (module):
 
-    import jc.parsers.iostat
-    result = jc.parsers.iostat.parse(iostat_command_output)
+    import jc
+    result = jc.parse('iostat', iostat_command_output)
 
 Schema:
 
@@ -157,16 +159,12 @@ Examples:
       }
     ]
 
+<a id="jc.parsers.iostat.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -174,14 +172,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux
 
-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/iostat_s.md

@@ -1,20 +1,31 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.iostat_s"></a>
 
-# jc.parsers.iostat_s
-jc - JSON CLI output utility `iostat` command output streaming parser
+# jc.parsers.iostat\_s
 
-> This streaming parser outputs JSON Lines
+jc - JSON Convert `iostat` command output streaming parser
 
-Note: `iostat` version 11 and higher include a JSON output option
+> This streaming parser outputs JSON Lines (cli) or returns an Iterable of
+> Dictionaries (module)
+
+> Note: `iostat` version 11 and higher include a JSON output option
 
 Usage (cli):
 
     $ iostat | jc --iostat-s
 
+> Note: When piping `jc` converted `iostat` output to other processes it may
+> appear the output is hanging due to the OS pipe buffers. This is because
+> `iostat` output is too small to quickly fill up the buffer. Use the `-u`
+> option to unbuffer the `jc` output if you would like immediate output. See
+> the [readme](https://github.com/kellyjonbrazil/jc/tree/master#unbuffering-output)
+> for more information.
+
 Usage (module):
 
-    import jc.parsers.iostat_s
-    result = jc.parsers.iostat_s.parse(iostat_command_output.splitlines())    # result is an iterable object
+    import jc
+
+    result = jc.parse('iostat_s', iostat_command_output.splitlines())
     for item in result:
         # do something
 
@@ -71,56 +82,52 @@ Schema:
       "percent_util":     float,
       "percent_rrqm":     float,
       "percent_wrqm":     float,
-      "_jc_meta":                      # This object only exists if using -qq or ignore_exceptions=True
-        {
-          "success":      boolean,     # true if successfully parsed, false if error
-          "error":        string,      # exists if "success" is false
-          "line":         string       # exists if "success" is false
-        }
+
+      # below object only exists if using -qq or ignore_exceptions=True
+      "_jc_meta": {
+        "success":        boolean,     # false if error parsing
+        "error":          string,      # exists if "success" is false
+        "line":           string       # exists if "success" is false
+      }
     }
 
 Examples:
 
     $ iostat | jc --iostat-s
-    {"percent_user":0.14,"percent_nice":0.0,"percent_system":0.16,"percent_iowait":0.0,"percent_steal":0.0,"percent_idle":99.7,"type":"cpu"}
-    {"device":"sda","tps":0.24,"kb_read_s":5.28,"kb_wrtn_s":1.1,"kb_read":203305,"kb_wrtn":42368,"type":"device"}
+    {"percent_user":0.14,"percent_nice":0.0,"percent_system":0.16,...}
+    {"device":"sda","tps":0.24,"kb_read_s":5.28,"kb_wrtn_s":1.1...}
     ...
 
     $ iostat | jc --iostat-s -r
-    {"percent_user":"0.14","percent_nice":"0.00","percent_system":"0.16","percent_iowait":"0.00","percent_steal":"0.00","percent_idle":"99.70","type":"cpu"}
-    {"device":"sda","tps":"0.24","kb_read_s":"5.28","kb_wrtn_s":"1.10","kb_read":"203305","kb_wrtn":"42368","type":"device"}
+    {"percent_user":"0.14","percent_nice":"0.00","percent_system":"0.16"...}
+    {"device":"sda","tps":"0.24","kb_read_s":"5.28","kb_wrtn_s":"1.10"...}
     ...
 
+<a id="jc.parsers.iostat_s.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False, ignore_exceptions=False)
+@add_jc_meta
+def parse(data, raw=False, quiet=False, ignore_exceptions=False)
 ```
 
-Main text parsing generator function. Returns an iterator object.
+Main text parsing generator function. Returns an iterable object.
 
 Parameters:
 
-    data:              (iterable)  line-based text data to parse (e.g. sys.stdin or str.splitlines())
-    raw:               (boolean)   output preprocessed JSON if True
+    data:              (iterable)  line-based text data to parse
+                                   (e.g. sys.stdin or str.splitlines())
+
+    raw:               (boolean)   unprocessed output if True
     quiet:             (boolean)   suppress warning messages if True
     ignore_exceptions: (boolean)   ignore parsing exceptions if True
 
-Yields:
-
-    Dictionary. Raw or processed structured data.
-
 Returns:
 
-    Iterator object
+    Iterable of Dictionaries
 
-## Parser Information
+### Parser Information
 Compatibility:  linux
 
-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ip_address.md

@@ -0,0 +1,555 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.ip_address"></a>
+
+# jc.parsers.ip\_address
+
+jc - JSON Convert IP Address string parser
+
+Accepts standard and integer IP address notation for both IPv4 and IPv6
+addresses. CIDR subnet mask and Scope ID is also allowed for standard
+notation. See examples below.
+
+Usage (cli):
+
+    $ echo '192.168.1.1' | jc --ip-address
+
+Usage (module):
+
+    import jc
+    result = jc.parse('ip_address', ip_address_string)
+
+Schema:
+
+    {
+      "version":                  integer,
+      "max_prefix_length":        integer,
+      "ip":                       string,
+      "ip_compressed":            string,
+      "ip_exploded":              string,
+      "ip_split": [
+                                  string
+      ],
+      "scope_id":                 string/null,
+      "ipv4_mapped":              string/null,
+      "six_to_four":              string/null,
+      "teredo_client":            string/null,
+      "teredo_server":            string/null,
+      "dns_ptr":                  string,
+      "network":                  string,
+      "broadcast":                string,
+      "hostmask":                 string,
+      "netmask":                  string,
+      "cidr_netmask":             integer,
+      "hosts":                    integer,
+      "first_host":               string,
+      "last_host":                string,
+      "is_multicast":             boolean,
+      "is_private":               boolean,
+      "is_global":                boolean,
+      "is_link_local":            boolean,
+      "is_loopback":              boolean,
+      "is_reserved":              boolean,
+      "is_unspecified":           boolean,
+      "int": {
+        "ip":                     integer,
+        "network":                integer,
+        "broadcast":              integer,
+        "first_host":             integer,
+        "last_host":              integer
+      },
+      "hex": {
+        "ip":                     string,
+        "network":                string,
+        "broadcast":              string,
+        "hostmask":               string,
+        "netmask":                string,
+        "first_host":             string,
+        "last_host":              string
+      },
+      "bin": {
+        "ip":                     string,
+        "network":                string,
+        "broadcast":              string,
+        "hostmask":               string,
+        "netmask":                string,
+        "first_host":             string,
+        "last_host":              string
+      }
+    }
+
+Examples:
+
+    $ echo 192.168.2.10/24 | jc --ip-address -p
+    {
+      "version": 4,
+      "max_prefix_length": 32,
+      "ip": "192.168.2.10",
+      "ip_compressed": "192.168.2.10",
+      "ip_exploded": "192.168.2.10",
+      "ip_split": [
+        "192",
+        "168",
+        "2",
+        "10"
+      ],
+      "scope_id": null,
+      "ipv4_mapped": null,
+      "six_to_four": null,
+      "teredo_client": null,
+      "teredo_server": null,
+      "dns_ptr": "10.2.168.192.in-addr.arpa",
+      "network": "192.168.2.0",
+      "broadcast": "192.168.2.255",
+      "hostmask": "0.0.0.255",
+      "netmask": "255.255.255.0",
+      "cidr_netmask": 24,
+      "hosts": 254,
+      "first_host": "192.168.2.1",
+      "last_host": "192.168.2.254",
+      "is_multicast": false,
+      "is_private": true,
+      "is_global": false,
+      "is_link_local": false,
+      "is_loopback": false,
+      "is_reserved": false,
+      "is_unspecified": false,
+      "int": {
+        "ip": 3232236042,
+        "network": 3232236032,
+        "broadcast": 3232236287,
+        "first_host": 3232236033,
+        "last_host": 3232236286
+      },
+      "hex": {
+        "ip": "c0:a8:02:0a",
+        "network": "c0:a8:02:00",
+        "broadcast": "c0:a8:02:ff",
+        "hostmask": "00:00:00:ff",
+        "netmask": "ff:ff:ff:00",
+        "first_host": "c0:a8:02:01",
+        "last_host": "c0:a8:02:fe"
+      },
+      "bin": {
+        "ip": "11000000101010000000001000001010",
+        "network": "11000000101010000000001000000000",
+        "broadcast": "11000000101010000000001011111111",
+        "hostmask": "00000000000000000000000011111111",
+        "netmask": "11111111111111111111111100000000",
+        "first_host": "11000000101010000000001000000001",
+        "last_host": "11000000101010000000001011111110"
+      }
+    }
+
+    $ echo 3232236042 | jc --ip-address -p
+    {
+      "version": 4,
+      "max_prefix_length": 32,
+      "ip": "192.168.2.10",
+      "ip_compressed": "192.168.2.10",
+      "ip_exploded": "192.168.2.10",
+      "ip_split": [
+        "192",
+        "168",
+        "2",
+        "10"
+      ],
+      "scope_id": null,
+      "ipv4_mapped": null,
+      "six_to_four": null,
+      "teredo_client": null,
+      "teredo_server": null,
+      "dns_ptr": "10.2.168.192.in-addr.arpa",
+      "network": "192.168.2.10",
+      "broadcast": "192.168.2.10",
+      "hostmask": "0.0.0.0",
+      "netmask": "255.255.255.255",
+      "cidr_netmask": 32,
+      "hosts": 1,
+      "first_host": "192.168.2.10",
+      "last_host": "192.168.2.10",
+      "is_multicast": false,
+      "is_private": true,
+      "is_global": false,
+      "is_link_local": false,
+      "is_loopback": false,
+      "is_reserved": false,
+      "is_unspecified": false,
+      "int": {
+        "ip": 3232236042,
+        "network": 3232236042,
+        "broadcast": 3232236042,
+        "first_host": 3232236042,
+        "last_host": 3232236042
+      },
+      "hex": {
+        "ip": "c0:a8:02:0a",
+        "network": "c0:a8:02:0a",
+        "broadcast": "c0:a8:02:0a",
+        "hostmask": "00:00:00:00",
+        "netmask": "ff:ff:ff:ff",
+        "first_host": "c0:a8:02:0a",
+        "last_host": "c0:a8:02:0a"
+      },
+      "bin": {
+        "ip": "11000000101010000000001000001010",
+        "network": "11000000101010000000001000001010",
+        "broadcast": "11000000101010000000001000001010",
+        "hostmask": "00000000000000000000000000000000",
+        "netmask": "11111111111111111111111111111111",
+        "first_host": "11000000101010000000001000001010",
+        "last_host": "11000000101010000000001000001010"
+      }
+    }
+
+    $ echo 127:0:de::1%128/96 | jc --ip-address -p
+    {
+      "version": 6,
+      "max_prefix_length": 128,
+      "ip": "127:0:de::1",
+      "ip_compressed": "127:0:de::1",
+      "ip_exploded": "0127:0000:00de:0000:0000:0000:0000:0001",
+      "ip_split": [
+        "0127",
+        "0000",
+        "00de",
+        "0000",
+        "0000",
+        "0000",
+        "0000",
+        "0001"
+      ],
+      "scope_id": "128",
+      "ipv4_mapped": null,
+      "six_to_four": null,
+      "teredo_client": null,
+      "teredo_server": null,
+      "dns_ptr": "1.0.0.0.0.0...0.0.0.e.d.0.0.0.0.0.0.7.2.1.0.ip6.arpa",
+      "network": "127:0:de::",
+      "broadcast": "127:0:de::ffff:ffff",
+      "hostmask": "::ffff:ffff",
+      "netmask": "ffff:ffff:ffff:ffff:ffff:ffff::",
+      "cidr_netmask": 96,
+      "hosts": 4294967294,
+      "first_host": "127:0:de::1",
+      "last_host": "127:0:de::ffff:fffe",
+      "is_multicast": false,
+      "is_private": false,
+      "is_global": true,
+      "is_link_local": false,
+      "is_loopback": false,
+      "is_reserved": true,
+      "is_unspecified": false,
+      "int": {
+        "ip": 1531727573536155682370944093904699393,
+        "network": 1531727573536155682370944093904699392,
+        "broadcast": 1531727573536155682370944098199666687,
+        "first_host": 1531727573536155682370944093904699393,
+        "last_host": 1531727573536155682370944098199666686
+      },
+      "hex": {
+        "ip": "01:27:00:00:00:de:00:00:00:00:00:00:00:00:00:01",
+        "network": "01:27:00:00:00:de:00:00:00:00:00:00:00:00:00:00",
+        "broadcast": "01:27:00:00:00:de:00:00:00:00:00:00:ff:ff:ff:ff",
+        "hostmask": "00:00:00:00:00:00:00:00:00:00:00:00:ff:ff:ff:ff",
+        "netmask": "ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:00:00:00:00",
+        "first_host": "01:27:00:00:00:de:00:00:00:00:00:00:00:00:00:01",
+        "last_host": "01:27:00:00:00:de:00:00:00:00:00:00:ff:ff:ff:fe"
+      },
+      "bin": {
+        "ip": "0000000100100111000000000000000000000000110...000000000001",
+        "network": "00000001001001110000000000000000000000...000000000000",
+        "broadcast": "000000010010011100000000000000000000...111111111111",
+        "hostmask": "0000000000000000000000000000000000000...111111111111",
+        "netmask": "11111111111111111111111111111111111111...000000000000",
+        "first_host": "00000001001001110000000000000000000...000000000001",
+        "last_host": "000000010010011100000000000000000000...1111111111110"
+      }
+    }
+
+    $ echo 1531727573536155682370944093904699393 | jc --ip-address -p
+    {
+      "version": 6,
+      "max_prefix_length": 128,
+      "ip": "127:0:de::1",
+      "ip_compressed": "127:0:de::1",
+      "ip_exploded": "0127:0000:00de:0000:0000:0000:0000:0001",
+      "ip_split": [
+        "0127",
+        "0000",
+        "00de",
+        "0000",
+        "0000",
+        "0000",
+        "0000",
+        "0001"
+      ],
+      "scope_id": null,
+      "ipv4_mapped": null,
+      "six_to_four": null,
+      "teredo_client": null,
+      "teredo_server": null,
+      "dns_ptr": "1.0.0.0.0.0....0.0.0.0.e.d.0.0.0.0.0.0.7.2.1.0.ip6.arpa",
+      "network": "127:0:de::1",
+      "broadcast": "127:0:de::1",
+      "hostmask": "::",
+      "netmask": "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
+      "cidr_netmask": 128,
+      "hosts": 1,
+      "first_host": "127:0:de::1",
+      "last_host": "127:0:de::1",
+      "is_multicast": false,
+      "is_private": false,
+      "is_global": true,
+      "is_link_local": false,
+      "is_loopback": false,
+      "is_reserved": true,
+      "is_unspecified": false,
+      "int": {
+        "ip": 1531727573536155682370944093904699393,
+        "network": 1531727573536155682370944093904699393,
+        "broadcast": 1531727573536155682370944093904699393,
+        "first_host": 1531727573536155682370944093904699393,
+        "last_host": 1531727573536155682370944093904699393
+      },
+      "hex": {
+        "ip": "01:27:00:00:00:de:00:00:00:00:00:00:00:00:00:01",
+        "network": "01:27:00:00:00:de:00:00:00:00:00:00:00:00:00:01",
+        "broadcast": "01:27:00:00:00:de:00:00:00:00:00:00:00:00:00:01",
+        "hostmask": "00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00",
+        "netmask": "ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff",
+        "first_host": "01:27:00:00:00:de:00:00:00:00:00:00:00:00:00:01",
+        "last_host": "01:27:00:00:00:de:00:00:00:00:00:00:00:00:00:01"
+      },
+      "bin": {
+        "ip": "0000000100100111000000000000000000000000110111100...000001",
+        "network": "00000001001001110000000000000000000000001101...000001",
+        "broadcast": "000000010010011100000000000000000000000011...000001",
+        "hostmask": "0000000000000000000000000000000000000000000...000000",
+        "netmask": "11111111111111111111111111111111111111111111...111111",
+        "first_host": "00000001001001110000000000000000000000001...000001",
+        "last_host": "000000010010011100000000000000000000000011...0000001"
+      }
+    }
+
+    # IPv4 Mapped Address
+    $ echo ::FFFF:192.168.1.35 | jc --ip-address -p
+    {
+      "version": 6,
+      "max_prefix_length": 128,
+      "ip": "::ffff:c0a8:123",
+      "ip_compressed": "::ffff:c0a8:123",
+      "ip_exploded": "0000:0000:0000:0000:0000:ffff:c0a8:0123",
+      "ip_split": [
+        "0000",
+        "0000",
+        "0000",
+        "0000",
+        "0000",
+        "ffff",
+        "c0a8",
+        "0123"
+      ],
+      "scope_id": null,
+      "ipv4_mapped": "192.168.1.35",
+      "six_to_four": null,
+      "teredo_client": null,
+      "teredo_server": null,
+      "dns_ptr": "3.2.1.0.8.a.0.c.f.f.f.f.0.0....0.0.0.0.0.0.ip6.arpa",
+      "network": "::ffff:c0a8:123",
+      "broadcast": "::ffff:c0a8:123",
+      "hostmask": "::",
+      "netmask": "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
+      "cidr_netmask": 128,
+      "hosts": 1,
+      "first_host": "::ffff:c0a8:123",
+      "last_host": "::ffff:c0a8:123",
+      "is_multicast": false,
+      "is_private": true,
+      "is_global": false,
+      "is_link_local": false,
+      "is_loopback": false,
+      "is_reserved": true,
+      "is_unspecified": false,
+      "int": {
+        "ip": 281473913979171,
+        "network": 281473913979171,
+        "broadcast": 281473913979171,
+        "first_host": 281473913979171,
+        "last_host": 281473913979171
+      },
+      "hex": {
+        "ip": "00:00:00:00:00:00:00:00:00:00:ff:ff:c0:a8:01:23",
+        "network": "00:00:00:00:00:00:00:00:00:00:ff:ff:c0:a8:01:23",
+        "broadcast": "00:00:00:00:00:00:00:00:00:00:ff:ff:c0:a8:01:23",
+        "hostmask": "00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00",
+        "netmask": "ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff",
+        "first_host": "00:00:00:00:00:00:00:00:00:00:ff:ff:c0:a8:01:23",
+        "last_host": "00:00:00:00:00:00:00:00:00:00:ff:ff:c0:a8:01:23"
+      },
+      "bin": {
+        "ip": "000000000000000000000000000000000000000000000...100100011",
+        "network": "0000000000000000000000000000000000000000...000100011",
+        "broadcast": "00000000000000000000000000000000000000...000100011",
+        "hostmask": "000000000000000000000000000000000000000...000000000",
+        "netmask": "1111111111111111111111111111111111111111...111111111",
+        "first_host": "0000000000000000000000000000000000000...100100011",
+        "last_host": "00000000000000000000000000000000000000...0100100011"
+      }
+    }
+
+    # 6to4 Address
+    $ echo 2002:c000:204::/48 | jc --ip-address -p
+    {
+      "version": 6,
+      "max_prefix_length": 128,
+      "ip": "2002:c000:204::",
+      "ip_compressed": "2002:c000:204::",
+      "ip_exploded": "2002:c000:0204:0000:0000:0000:0000:0000",
+      "ip_split": [
+        "2002",
+        "c000",
+        "0204",
+        "0000",
+        "0000",
+        "0000",
+        "0000",
+        "0000"
+      ],
+      "scope_id": null,
+      "ipv4_mapped": null,
+      "six_to_four": "192.0.2.4",
+      "teredo_client": null,
+      "teredo_server": null,
+      "dns_ptr": "0.0.0.0.0.0.0...0.0.0.4.0.2.0.0.0.0.c.2.0.0.2.ip6.arpa",
+      "network": "2002:c000:204::",
+      "broadcast": "2002:c000:204:ffff:ffff:ffff:ffff:ffff",
+      "hostmask": "::ffff:ffff:ffff:ffff:ffff",
+      "netmask": "ffff:ffff:ffff::",
+      "cidr_netmask": 48,
+      "hosts": 1208925819614629174706174,
+      "first_host": "2002:c000:204::1",
+      "last_host": "2002:c000:204:ffff:ffff:ffff:ffff:fffe",
+      "is_multicast": false,
+      "is_private": false,
+      "is_global": true,
+      "is_link_local": false,
+      "is_loopback": false,
+      "is_reserved": false,
+      "is_unspecified": false,
+      "int": {
+        "ip": 42549574682102084431821433448024768512,
+        "network": 42549574682102084431821433448024768512,
+        "broadcast": 42549574682103293357641048077199474687,
+        "first_host": 42549574682102084431821433448024768513,
+        "last_host": 42549574682103293357641048077199474686
+      },
+      "hex": {
+        "ip": "20:02:c0:00:02:04:00:00:00:00:00:00:00:00:00:00",
+        "network": "20:02:c0:00:02:04:00:00:00:00:00:00:00:00:00:00",
+        "broadcast": "20:02:c0:00:02:04:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff",
+        "hostmask": "00:00:00:00:00:00:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff",
+        "netmask": "ff:ff:ff:ff:ff:ff:00:00:00:00:00:00:00:00:00:00",
+        "first_host": "20:02:c0:00:02:04:00:00:00:00:00:00:00:00:00:01",
+        "last_host": "20:02:c0:00:02:04:ff:ff:ff:ff:ff:ff:ff:ff:ff:fe"
+      },
+      "bin": {
+        "ip": "00100000000000101100000000000000000000100000010...00000000",
+        "network": "001000000000001011000000000000000000001000...00000000",
+        "broadcast": "0010000000000010110000000000000000000010...11111111",
+        "hostmask": "00000000000000000000000000000000000000000...11111111",
+        "netmask": "111111111111111111111111111111111111111111...00000000",
+        "first_host": "001000000000001011000000000000000000001...00000001",
+        "last_host": "0010000000000010110000000000000000000010...111111110"
+      }
+    }
+
+    # Teredo Address
+    $ echo 2001:0000:4136:e378:8000:63bf:3fff:fdd2 | jc --ip-address -p
+    {
+      "version": 6,
+      "max_prefix_length": 128,
+      "ip": "2001:0:4136:e378:8000:63bf:3fff:fdd2",
+      "ip_compressed": "2001:0:4136:e378:8000:63bf:3fff:fdd2",
+      "ip_exploded": "2001:0000:4136:e378:8000:63bf:3fff:fdd2",
+      "ip_split": [
+        "2001",
+        "0000",
+        "4136",
+        "e378",
+        "8000",
+        "63bf",
+        "3fff",
+        "fdd2"
+      ],
+      "scope_id": null,
+      "ipv4_mapped": null,
+      "six_to_four": null,
+      "teredo_client": "192.0.2.45",
+      "teredo_server": "65.54.227.120",
+      "dns_ptr": "2.d.d.f.f.f.f.3.f.b.3.6.0.0.0.8.8....0.1.0.0.2.ip6.arpa",
+      "network": "2001:0:4136:e378:8000:63bf:3fff:fdd2",
+      "broadcast": "2001:0:4136:e378:8000:63bf:3fff:fdd2",
+      "hostmask": "::",
+      "netmask": "ffff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
+      "cidr_netmask": 128,
+      "hosts": 1,
+      "first_host": "2001:0:4136:e378:8000:63bf:3fff:fdd2",
+      "last_host": "2001:0:4136:e378:8000:63bf:3fff:fdd2",
+      "is_multicast": false,
+      "is_private": true,
+      "is_global": false,
+      "is_link_local": false,
+      "is_loopback": false,
+      "is_reserved": false,
+      "is_unspecified": false,
+      "int": {
+        "ip": 42540488182158724593221357832373272018,
+        "network": 42540488182158724593221357832373272018,
+        "broadcast": 42540488182158724593221357832373272018,
+        "first_host": 42540488182158724593221357832373272018,
+        "last_host": 42540488182158724593221357832373272018
+      },
+      "hex": {
+        "ip": "20:01:00:00:41:36:e3:78:80:00:63:bf:3f:ff:fd:d2",
+        "network": "20:01:00:00:41:36:e3:78:80:00:63:bf:3f:ff:fd:d2",
+        "broadcast": "20:01:00:00:41:36:e3:78:80:00:63:bf:3f:ff:fd:d2",
+        "hostmask": "00:00:00:00:00:00:00:00:00:00:00:00:00:00:00:00",
+        "netmask": "ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff:ff",
+        "first_host": "20:01:00:00:41:36:e3:78:80:00:63:bf:3f:ff:fd:d2",
+        "last_host": "20:01:00:00:41:36:e3:78:80:00:63:bf:3f:ff:fd:d2"
+      },
+      "bin": {
+        "ip": "0010000000000001000000000000000001000001001...110111010010",
+        "network": "00100000000000010000000000000000010000...110111010010",
+        "broadcast": "001000000000000100000000000000000100...110111010010",
+        "hostmask": "0000000000000000000000000000000000000...000000000000",
+        "netmask": "11111111111111111111111111111111111111...111111111111",
+        "first_host": "00100000000000010000000000000000010...110111010010",
+        "last_host": "001000000000000100000000000000000100...110111010010"
+      }
+    }
+
+<a id="jc.parsers.ip_address.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict
+```
+
+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, darwin, cygwin, win32, aix, freebsd
+
+Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ip_route.md

@@ -0,0 +1,74 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.ip_route"></a>
+
+# jc.parsers.ip\_route
+
+jc - JSON Convert `ip route` command output parser
+
+Usage (cli):
+
+    $ ip route | jc --ip-route
+
+or
+
+    $ jc ip-route
+
+Usage (module):
+
+    import jc
+    result = jc.parse('ip_route', ip_route_command_output)
+
+Schema:
+
+    [
+      {
+        "ip":        string,
+        "via":       string,
+        "dev":       string,
+        "metric":    integer,
+        "proto":     string,
+        "scope":     string,
+        "src":       string,
+        "via":       string,
+        "status":    string
+      }
+    ]
+
+Examples:
+
+    $ ip route  | jc --ip-route -p
+    [
+      {
+        "ip": "10.0.2.0/24",
+        "dev": "enp0s3",
+        "proto": "kernel",
+        "scope": "link",
+        "src": "10.0.2.15",
+        "metric": 100
+      }
+    ]
+
+<a id="jc.parsers.ip_route.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:
+
+    List of Json objects if data is processed and Raw data if raw = true.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Julian Jackson (jackson.julian55@yahoo.com)

docs/parsers/iptables.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.iptables"></a>
 
 # jc.parsers.iptables
-jc - JSON CLI output utility `ipables` command output parser
+
+jc - JSON Convert `iptables` command output parser
 
 Supports `-vLn` and `--line-numbers` for all tables.
 
@@ -9,14 +11,14 @@ Usage (cli):
 
     $ sudo iptables -L -t nat | jc --iptables
 
-    or
+or
 
     $ jc iptables -L -t nat
 
 Usage (module):
 
-    import jc.parsers.iptables
-    result = jc.parsers.iptables.parse(iptables_command_output)
+    import jc
+    result = jc.parse('iptables', iptables_command_output)
 
 Schema:
 
@@ -161,16 +163,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.iptables.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -178,14 +176,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux
 
-Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.8 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/iso_datetime.md

@@ -0,0 +1,37 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.iso_datetime"></a>
+
+# jc.parsers.iso\_datetime
+
+jc - JSON Convert ISO 8601 Datetime string parser
+
+This parser has been renamed to datetime-iso (cli) or datetime_iso (module).
+
+This parser will be removed in a future version, so please start using
+the new parser name.
+
+<a id="jc.parsers.iso_datetime.parse"></a>
+
+### parse
+
+```python
+def parse(data, raw=False, quiet=False)
+```
+
+This parser is deprecated and calls datetime_iso. Please use datetime_iso
+directly. This parser will be removed in the future.
+
+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, aix, freebsd, darwin, win32, cygwin
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/iw_scan.md

@@ -1,28 +1,31 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.iw_scan"></a>
 
-# jc.parsers.iw_scan
-jc - JSON CLI output utility `iw dev <device> scan` command output parser
+# jc.parsers.iw\_scan
 
-This parser is considered beta quality. Not all fields are parsed and there are not enough samples to test.
+jc - JSON Convert `iw dev <device> scan` command output parser
+
+This parser is considered beta quality. Not all fields are parsed and there
+are not enough samples to test.
 
 Usage (cli):
 
     $ iw dev wlan0 scan | jc --iw-scan
 
-    or
+or
 
     $ jc iw dev wlan0 scan
 
 Usage (module):
 
-    import jc.parsers.iw-scan
-    result = jc.parsers.iw-scan.parse(iw-scan_command_output)
+    import jc
+    result = jc.parse('iw_scan', iw_scan_command_output)
 
 Schema:
 
     [
       {
-        "foo":     string/integer/float,         # best guess based on value
+        "foo":     string/integer/float,      # best guess based on value
         "bar":     string/integer/float,
         "baz":     string/integer/float
       }
@@ -118,16 +121,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.iw_scan.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -135,14 +134,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux
 
 Version 0.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/iwconfig.md

@@ -0,0 +1,111 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.iwconfig"></a>
+
+# jc.parsers.iwconfig
+
+jc - JSON Convert `iwconfig` command output parser
+
+No `iwconfig` options are supported.
+
+Usage (cli):
+
+    $ iwconfig | jc --iwconfig
+
+or
+
+    $ jc iwconfig
+
+Usage (module):
+
+    import jc
+    result = jc.parse('iwconfig', iwconfig_command_output)
+
+Schema:
+
+    [
+        {
+            "name":                         string,
+            "protocol":                     string,
+            "essid":                        string,
+            "mode":                         string,
+            "frequency":                    float,
+            "frequency_unit":               string,
+            "access_point":                 string,
+            "bit_rate":                     float,
+            "bit_rate_unit":                string,
+            "tx_power":                     integer,
+            "tx_power_unit":                string,
+            "retry_short_limit":            integer,
+            "rts_threshold":                boolean,
+            "fragment_threshold":           boolean,
+            "power_management":             boolean,
+            "link_quality":                 string,
+            "signal_level":                 integer,
+            "signal_level_unit":            string,
+            "rx_invalid_nwid":              integer,
+            "rx_invalid_crypt":             integer,
+            "rx_invalid_frag":              integer,
+            "tx_excessive_retries":         integer,
+            "invalid_misc":                 integer,
+            "missed_beacon":                integer
+        }
+    ]
+
+Examples:
+
+    $  iwconfig | jc --iwconfig -p
+    [
+      {
+        "name": "wlp5s0",
+        "protocol": "IEEE 802.11",
+        "essid": "BLABLABLA",
+        "mode": "Managed",
+        "frequency": 5.18,
+        "frequency_unit": "GHz",
+        "access_point": "E6:64:DA:16:51:BF",
+        "bit_rate": 6.0,
+        "bit_rate_unit": "Mb/s",
+        "tx_power": 30,
+        "tx_power_unit": "dBm",
+        "retry_short_limit": 7,
+        "rts_threshold": false,
+        "fragment_threshold": false,
+        "power_management": true,
+        "link_quality": "61/70",
+        "signal_level": -49,
+        "signal_level_unit": "dBm",
+        "rx_invalid_nwid": 0,
+        "rx_invalid_crypt": 0,
+        "rx_invalid_frag": 0,
+        "tx_excessive_retries": 0,
+        "invalid_misc": 2095,
+        "missed_beacon": 0
+      }
+    ]
+
+<a id="jc.parsers.iwconfig.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
+
+Version 1.1 by Thomas Vincent (vrince@gmail.com)

docs/parsers/jar_manifest.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.jar_manifest"></a>
 
-# jc.parsers.jar_manifest
-jc - JSON CLI output utility `MANIFEST.MF` file parser
+# jc.parsers.jar\_manifest
+
+jc - JSON Convert Java `MANIFEST.MF` file parser
 
 Usage (cli):
 
@@ -9,8 +11,8 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.jar_manifest
-    result = jc.parsers.jar_manifest.parse(jar_manifest_file_output)
+    import jc
+    result = jc.parse('jar_manifest', jar_manifest_file_output)
 
 Schema:
 
@@ -24,15 +26,16 @@ Schema:
 Examples:
 
     $ cat MANIFEST.MF | jc --jar-manifest -p
-    $ unzip -c apache-log4j-2.16.0-bin/log4j-core-2.16.0.jar META-INF/MANIFEST.MF | jc --jar-manifest -p
-    $ unzip -c 'apache-log4j-2.16.0-bin/*.jar' META-INF/MANIFEST.MF | jc --jar-manifest -p
+    $ unzip -c log4j-core-2.16.0.jar META-INF/MANIFEST.MF | \\
+      jc --jar-manifest -p
+    $ unzip -c 'apache-log4j-2.16.0-bin/*.jar' META-INF/MANIFEST.MF | \\
+      jc --jar-manifest -p
 
     $ cat MANIFEST.MF | jc --jar-manifest -p
-
     [
       {
-        "Import_Package": "com.conversantmedia.util.concurrent;resolution:=optional,com.fasterxml.jackson.annotation;version="[2.12,3)";resolution:=optional,com.fasterxml.jackson.core;version="[2.12,3)";resolution:=optional,com.fasterxml.jackson.core.type;version="[2.12,3)";resolution:=optional,com.fasterxml.jackson.cor...",
-        "Export_Package": "org.apache.logging.log4j.core;uses:="org.apache.logging.log4j,org.apache.logging.log4j.core.config,org.apache.logging.log4j.core.impl,org.apache.logging.log4j.core.layout,org.apache.logging.log4j.core.time,org.apache.logging.log4j.message,org.apache.logging.log4j.spi,org.apache.logging.log4j.status...",
+        "Import_Package": "com.conversantmedia.util.concurrent;resoluti...",
+        "Export_Package": "org.apache.logging.log4j.core;uses:=\"org.ap...",
         "Manifest_Version": "1.0",
         "Bundle_License": "https://www.apache.org/licenses/LICENSE-2.0.txt",
         "Bundle_SymbolicName": "org.apache.logging.log4j.core",
@@ -45,28 +48,28 @@ Examples:
       }
     ]
 
-    $ unzip -c 'apache-log4j-2.16.0-bin/*.jar' META-INF/MANIFEST.MF | jc --jar-manifest -p
-
+    $ unzip -c 'apache-log4j-2.16.0-bin/*.jar' META-INF/MANIFEST.MF | \\
+      jc --jar-manifest -p
     [
       ...
       {
-        "Archive": "apache-log4j-2.16.0-bin/log4j-spring-boot-2.16.0-sources.jar",
+        "Archive": "apache-log4j-2.16.0-bin/log4j-spring-boot-2.16.0-so...",
         "Manifest_Version": "1.0",
         "Built_By": "matt",
         "Created_By": "Apache Maven 3.8.4",
         "Build_Jdk": "1.8.0_312"
       },
       {
-        "Archive": "apache-log4j-2.16.0-bin/log4j-spring-boot-2.16.0-javadoc.jar",
+        "Archive": "apache-log4j-2.16.0-bin/log4j-spring-boot-2.16.0-ja...",
         "Manifest_Version": "1.0",
         "Built_By": "matt",
         "Created_By": "Apache Maven 3.8.4",
         "Build_Jdk": "1.8.0_312"
       },
       {
-        "Bundle_SymbolicName": "org.apache.logging.log4j.spring-cloud-config-client.logging.log4j.core.util;version="[2.16,3)",org.springframework.boot.autoconfigure.condition,org.springframework.cloud.context.environment,org.springframework.context,org.springframework.stereotype",
-        "Export_Package": "org.apache.logging.log4j.spring.cloud.config.controller;version="2.16.0"ient",
-        "Archive": "apache-log4j-2.16.0-bin/log4j-spring-cloud-config-client-2.16.0.jar",
+        "Bundle_SymbolicName": "org.apache.logging.log4j.spring-cloud-c...",
+        "Export_Package": "org.apache.logging.log4j.spring.cloud.config...",
+        "Archive": "apache-log4j-2.16.0-bin/log4j-spring-cloud-config-c...",
         "Manifest_Version": "1.0",
         "Bundle_License": "https://www.apache.org/licenses/LICENSE-2.0.txt",
         ...
@@ -74,16 +77,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.jar_manifest.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -91,14 +90,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
 
 Version 0.01 by Matt J (https://github.com/listuser)

docs/parsers/jobs.md

@@ -1,11 +1,14 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.jobs"></a>
 
 # jc.parsers.jobs
-jc - JSON CLI output utility `jobs` command output parser
+
+jc - JSON Convert `jobs` command output parser
 
 Also supports the `-l` option.
 
-The "Magic" syntax is not supported since the `jobs` command is a shell builtin.
+The "Magic" syntax is not supported since the `jobs` command is a shell
+builtin.
 
 Usage (cli):
 
@@ -13,8 +16,8 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.jobs
-    result = jc.parsers.jobs.parse(jobs_command_output)
+    import jc
+    result = jc.parse('jobs', jobs_command_output)
 
 Schema:
 
@@ -90,16 +93,12 @@ Example:
       }
     ]
 
+<a id="jc.parsers.jobs.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -107,14 +106,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd
 
-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/jwt.md

@@ -0,0 +1,73 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.jwt"></a>
+
+# jc.parsers.jwt
+
+jc - JSON Convert JWT string parser
+
+> Note: `jc` will not check the integrity of the JWT payload.
+
+Usage (cli):
+
+    $ echo "eyJhbGciOiJIUzI1N..." | jc --jwt
+
+Usage (module):
+
+    import jc
+    result = jc.parse('jwt', jwt_string)
+
+Schema:
+
+    {
+      "header": {
+        "alg":                    string,
+        "typ":                    string
+      },
+      "payload": {
+        <key name>:               string/integer/float/boolean/null
+      },
+      "signature":                string  # [0]
+    }
+
+    [0] in colon-delimited hex notation
+
+Examples:
+
+    % echo 'eyJhbGciOiJIUzI1N...' | jc --jwt -p
+    {
+      "header": {
+        "alg": "HS256",
+        "typ": "JWT"
+      },
+      "payload": {
+        "sub": "1234567890",
+        "name": "John Doe",
+        "iat": 1516239022
+      },
+      "signature": "49:f9:4a:c7:04:49:48:c7:8a:28:5d:90:4f:87:f0:a4:c7..."
+    }
+
+<a id="jc.parsers.jwt.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict
+```
+
+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, darwin, cygwin, win32, aix, freebsd
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/kv.md

@@ -1,11 +1,19 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.kv"></a>
 
 # jc.parsers.kv
-jc - JSON CLI output utility `Key/Value` file parser
 
-Supports files containing simple key/value pairs. Delimiter can be `=` or `:`. Missing values are supported. Comment prefix can be `#` or `;`. Comments must be on their own line.
+jc - JSON Convert `Key/Value` file and string parser
 
-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()`.
+Supports files containing simple key/value pairs.
+
+- Delimiter can be `=` or `:`. Missing values are supported.
+- Comment prefix can be `#` or `;`. Comments must be on their own line.
+- If duplicate keys are found, only the last value will be used.
+
+> 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):
 
@@ -13,12 +21,13 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.kv
-    result = jc.parsers.kv.parse(kv_file_output)
+    import jc
+    result = jc.parse('kv', kv_file_output)
 
 Schema:
 
-    key/value document converted to a dictionary - see configparser standard library documentation for more details.
+Key/Value document converted to a dictionary - see the python configparser
+standard library documentation for more details.
 
     {
       "key1":       string,
@@ -32,6 +41,7 @@ Examples:
     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
@@ -46,33 +56,27 @@ Examples:
       "occupation": "Engineer"
     }
 
+<a id="jc.parsers.kv.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
 
-    Note: this is just a wrapper for jc.parsers.ini
-
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
-    Dictionary representing the key/value file
+    Dictionary representing a Key/Value pair document.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
 
-Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 2.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/last.md

@@ -1,24 +1,28 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.last"></a>
 
 # jc.parsers.last
-jc - JSON CLI output utility `last` and `lastb` command output parser
 
-Supports `-w` and `-F` options.
+jc - JSON Convert `last` and `lastb` command output parser
 
-Calculated epoch time fields are naive (i.e. based on the local time of the system the parser is run on) since there is no timezone information in the `last` command output.
+Supports `-w`, `-F`, and `-x` options.
+
+Calculated epoch time fields are naive (i.e. based on the local time of the
+system the parser is run on) since there is no timezone information in the
+`last` command output.
 
 Usage (cli):
 
     $ last | jc --last
 
-    or
+or
 
     $ jc last
 
 Usage (module):
 
-    import jc.parsers.last
-    result = jc.parsers.last.parse(last_command_output)
+    import jc
+    result = jc.parse('last', last_command_output)
 
 Schema:
 
@@ -30,9 +34,9 @@ Schema:
         "login":            string,
         "logout":           string,
         "duration":         string,
-        "login_epoch":      integer,   # (naive) available with last -F option
-        "logout_epoch":     integer,   # (naive) available with last -F option
-        "duration_seconds": integer    # available with last -F option
+        "login_epoch":      integer,  # (naive) available w/last -F option
+        "logout_epoch":     integer,  # (naive) available w/last -F option
+        "duration_seconds": integer   # available w/last -F option
       }
     ]
 
@@ -100,17 +104,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.last.parse"></a>
 
+### parse
 
-## info
 ```python
-info()
-```
-Provides parser metadata (version, author, etc.)
-
-## parse
-```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -118,14 +117,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, aix, freebsd
 
-Version 1.8 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.9 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ls.md

@@ -1,30 +1,39 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.ls"></a>
 
 # jc.parsers.ls
-jc - JSON CLI output utility `ls` and `vdir` command output parser
+
+jc - JSON Convert `ls` and `vdir` command output parser
 
 Options supported:
 - `lbaR1`
 - `--time-style=full-iso`
 
-Note: The `-1`, `-l`, or `-b` option of `ls` should be used to correctly parse filenames that include newline characters. Since `ls` does not encode newlines in filenames when outputting to a pipe it will cause `jc` to see multiple files instead of a single file if `-1`, `-l`, or `-b` is not used. Alternatively, `vdir` can be used, which is the same as running `ls -lb`.
+> Note: The `-1`, `-l`, or `-b` option of `ls` should be used to correctly
+> parse filenames that include newline characters. Since `ls` does not
+> encode newlines in filenames when outputting to a pipe it will cause `jc`
+> to see multiple files instead of a single file if `-1`, `-l`, or `-b` is
+> not used. Alternatively, `vdir` can be used, which is the same as running
+> `ls -lb`.
 
-The `epoch` calculated timestamp field is naive (i.e. based on the local time of the system the parser is run on)
+The `epoch` calculated timestamp field is naive. (i.e. based on the local
+time of the system the parser is run on)
 
-The `epoch_utc` calculated timestamp field is timezone-aware and is only available if the timezone field is UTC.
+The `epoch_utc` calculated timestamp field is timezone-aware and is only
+available if the timezone field is UTC.
 
 Usage (cli):
 
     $ ls | jc --ls
 
-    or
+or
 
     $ jc ls
 
 Usage (module):
 
-    import jc.parsers.ls
-    result = jc.parsers.ls.parse(ls_command_output)
+    import jc
+    result = jc.parse('ls', ls_command_output)
 
 Schema:
 
@@ -38,11 +47,15 @@ Schema:
         "group":        string,
         "size":         integer,
         "date":         string,
-        "epoch":        integer,     # naive timestamp if date field exists and can be converted
-        "epoch_utc":    integer      # timezone aware timestamp if date field is in UTC and can be converted
+        "epoch":        integer,     # [0]
+        "epoch_utc":    integer      # [1]
       }
     ]
 
+    [0] naive timestamp if date field exists and can be converted.
+    [1] timezone aware timestamp if date field is in UTC and can
+        be converted.
+
 Examples:
 
     $ ls /usr/bin | jc --ls -p
@@ -104,16 +117,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.ls.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -121,14 +130,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd
 
-Version 1.10 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.12 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ls_s.md

@@ -1,17 +1,24 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.ls_s"></a>
 
-# jc.parsers.ls_s
-jc - JSON CLI output utility `ls` and `vdir` command output streaming parser
+# jc.parsers.ls\_s
 
-> This streaming parser outputs JSON Lines
+jc - JSON Convert `ls` and `vdir` command output streaming parser
 
-Requires the `-l` option to be used on `ls`. If there are newline characters in the filename, then make sure to use the `-b` option on `ls`.
+> This streaming parser outputs JSON Lines (cli) or returns an Iterable of
+> Dictionaries (module)
 
-The `jc` `-qq` option can be used to ignore parsing errors. (e.g. filenames with newline characters, but `-b` was not used)
+Requires the `-l` option to be used on `ls`. If there are newline characters
+in the filename, then make sure to use the `-b` option on `ls`.
 
-The `epoch` calculated timestamp field is naive (i.e. based on the local time of the system the parser is run on)
+The `jc` `-qq` option can be used to ignore parsing errors. (e.g. filenames
+with newline characters, but `-b` was not used)
 
-The `epoch_utc` calculated timestamp field is timezone-aware and is only available if the timezone field is UTC.
+The `epoch` calculated timestamp field is naive (i.e. based on the local
+time of the system the parser is run on)
+
+The `epoch_utc` calculated timestamp field is timezone-aware and is only
+available if the timezone field is UTC.
 
 Usage (cli):
 
@@ -19,8 +26,9 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.ls_s
-    result = jc.parsers.ls_s.parse(ls_command_output.splitlines())    # result is an iterable object
+    import jc
+
+    result = jc.parse('ls_s', ls_command_output.splitlines())
     for item in result:
         # do something
 
@@ -35,60 +43,60 @@ Schema:
       "group":          string,
       "size":           integer,
       "date":           string,
-      "epoch":          integer,     # naive timestamp if date field exists and can be converted
-      "epoch_utc":      integer,     # timezone aware timestamp if date field is in UTC and can be converted
-      "_jc_meta":                    # This object only exists if using -qq or ignore_exceptions=True
-        {
-          "success":    boolean,     # true if successfully parsed, false if error
-          "error":      string,      # exists if "success" is false
-          "line":       string       # exists if "success" is false
-        }
+      "epoch":          integer,     # [0]
+      "epoch_utc":      integer,     # [1]
+
+      # below object only exists if using -qq or ignore_exceptions=True
+      "_jc_meta": {
+        "success":      boolean,     # false if error parsing
+        "error":        string,      # exists if "success" is false
+        "line":         string       # exists if "success" is false
+      }
     }
 
+    [0] naive timestamp if date field exists and can be converted.
+    [1] timezone aware timestamp if date field is in UTC and can
+        be converted
+
 Examples:
 
     $ ls -l /usr/bin | jc --ls-s
-    {"filename":"2to3-","flags":"-rwxr-xr-x","links":4,"owner":"root","group":"wheel","size":925,"date":"Feb 22 2019"}
-    {"filename":"2to3-2.7","link_to":"../../System/Library/Frameworks/Python.framework/Versions/2.7/bin/2to3-2.7","flags":"lrwxr-xr-x","links":1,"owner":"root","group":"wheel","size":74,"date":"May 4 2019"}
-    {"filename":"AssetCacheLocatorUtil","flags":"-rwxr-xr-x","links":1,"owner":"root","group":"wheel","size":55152,"date":"May 3 2019"}
+    {"filename":"2to3-","flags":"-rwxr-xr-x","links":4,"owner":"root","...}
+    {"filename":"2to3-2.7","link_to":"../../System/Library/Frameworks/P...}
+    {"filename":"AssetCacheLocatorUtil","flags":"-rwxr-xr-x","links":1,...}
     ...
 
     $ ls -l /usr/bin | jc --ls-s -r
-    {"filename":"2to3-","flags":"-rwxr-xr-x","links":"4","owner":"root","group":"wheel","size":"925","date":"Feb 22 2019"}
-    {"filename":"2to3-2.7","link_to":"../../System/Library/Frameworks/Python.framework/Versions/2.7/bin/2to3-2.7","flags":"lrwxr-xr-x","links":"1","owner":"root","group":"wheel","size":"74","date":"May 4 2019"}
-    {"filename":"AssetCacheLocatorUtil","flags":"-rwxr-xr-x","links":"1","owner":"root","group":"wheel","size":"55152","date":"May 3 2019"}
+    {"filename":"2to3-","flags":"-rwxr-xr-x","links":"4","owner":"roo"..."}
+    {"filename":"2to3-2.7","link_to":"../../System/Library/Frameworks/P...}
+    {"filename":"AssetCacheLocatorUtil","flags":"-rwxr-xr-x","links":"1...}
     ...
 
+<a id="jc.parsers.ls_s.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False, ignore_exceptions=False)
+@add_jc_meta
+def parse(data, raw=False, quiet=False, ignore_exceptions=False)
 ```
 
-Main text parsing generator function. Returns an iterator object.
+Main text parsing generator function. Returns an iterable object.
 
 Parameters:
 
-    data:              (iterable)  line-based text data to parse (e.g. sys.stdin or str.splitlines())
-    raw:               (boolean)   output preprocessed JSON if True
+    data:              (iterable)  line-based text data to parse
+                                   (e.g. sys.stdin or str.splitlines())
+
+    raw:               (boolean)   unprocessed output if True
     quiet:             (boolean)   suppress warning messages if True
     ignore_exceptions: (boolean)   ignore parsing exceptions if True
 
-Yields:
-
-    Dictionary. Raw or processed structured data.
-
 Returns:
 
-    Iterator object
+    Iterable of Dictionaries
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd
 
-Version 0.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/lsattr.md

@@ -0,0 +1,89 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.lsattr"></a>
+
+# jc.parsers.lsattr
+
+jc - JSON Convert `lsattr` command output parser
+
+Usage (cli):
+
+    $ lsattr | jc --lsattr
+
+or
+
+    $ jc lsattr
+
+Usage (module):
+
+    import jc
+    result = jc.parse('lsattr', lsattr_command_output)
+
+Schema:
+
+Information from https://github.com/mirror/busybox/blob/2d4a3d9e6c1493a9520b907e07a41aca90cdfd94/e2fsprogs/e2fs_lib.c#L40
+used to define field names
+
+    [
+      {
+        "file":                           string,
+        "compressed_file":                Optional[boolean],
+        "compressed_dirty_file":          Optional[boolean],
+        "compression_raw_access":         Optional[boolean],
+        "secure_deletion":                Optional[boolean],
+        "undelete":                       Optional[boolean],
+        "synchronous_updates":            Optional[boolean],
+        "synchronous_directory_updates":  Optional[boolean],
+        "immutable":                      Optional[boolean],
+        "append_only":                    Optional[boolean],
+        "no_dump":                        Optional[boolean],
+        "no_atime":                       Optional[boolean],
+        "compression_requested":          Optional[boolean],
+        "encrypted":                      Optional[boolean],
+        "journaled_data":                 Optional[boolean],
+        "indexed_directory":              Optional[boolean],
+        "no_tailmerging":                 Optional[boolean],
+        "top_of_directory_hierarchies":   Optional[boolean],
+        "extents":                        Optional[boolean],
+        "no_cow":                         Optional[boolean],
+        "casefold":                       Optional[boolean],
+        "inline_data":                    Optional[boolean],
+        "project_hierarchy":              Optional[boolean],
+        "verity":                         Optional[boolean],
+      }
+    ]
+
+Examples:
+
+      $ sudo lsattr /etc/passwd | jc --lsattr
+      [
+        {
+            "file": "/etc/passwd",
+            "extents": true
+        }
+      ]
+
+<a id="jc.parsers.lsattr.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
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Mark Rotner (rotner.mr@gmail.com)

docs/parsers/lsb_release.md

@@ -0,0 +1,61 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.lsb_release"></a>
+
+# jc.parsers.lsb\_release
+
+jc - JSON Convert `lsb_release` command parser
+
+This parser is an alias to the Key/Value parser (`--kv`).
+
+Usage (cli):
+
+    $ lsb_release -a | jc --lsb-release
+
+or
+    $ jc lsb_release -a
+
+Usage (module):
+
+    import jc
+    result = jc.parse('lsb_release', lsb_release_command_output)
+
+Schema:
+
+    {
+        "<key>":     string
+    }
+
+Examples:
+
+    $ lsb_release -a | jc --lsb-release -p
+    {
+      "Distributor ID": "Ubuntu",
+      "Description": "Ubuntu 16.04.6 LTS",
+      "Release": "16.04",
+      "Codename": "xenial"
+    }
+
+<a id="jc.parsers.lsb_release.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, darwin, cygwin, win32, aix, freebsd
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/lsblk.md

@@ -1,20 +1,22 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.lsblk"></a>
 
 # jc.parsers.lsblk
-jc - JSON CLI output utility `lsblk` command output parser
+
+jc - JSON Convert `lsblk` command output parser
 
 Usage (cli):
 
     $ lsblk | jc --lsblk
 
-    or
+or
 
     $ jc lsblk
 
 Usage (module):
 
-    import jc.parsers.lsblk
-    result = jc.parsers.lsblk.parse(lsblk_command_output)
+    import jc
+    result = jc.parse('lsblk', lsblk_command_output)
 
 Schema:
 
@@ -88,7 +90,10 @@ Examples:
       ...
     ]
 
-    $ lsblk -o +KNAME,FSTYPE,LABEL,UUID,PARTLABEL,PARTUUID,RA,MODEL,SERIAL,STATE,OWNER,GROUP,MODE,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,DISC-ALN,DISC-GRAN,DISC-MAX,DISC-ZERO,WSAME,WWN,RAND,PKNAME,HCTL,TRAN,REV,VENDOR | jc --lsblk -p
+    $ lsblk -o +KNAME,FSTYPE,LABEL,UUID,PARTLABEL,PARTUUID,RA,MODEL,SERIAL,\\
+      STATE,OWNER,GROUP,MODE,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,\\
+      SCHED,RQ-SIZE,DISC-ALN,DISC-GRAN,DISC-MAX,DISC-ZERO,WSAME,WWN,RAND,\\
+      PKNAME,HCTL,TRAN,REV,VENDOR | jc --lsblk -p
     [
       {
         "name": "sda",
@@ -177,7 +182,10 @@ Examples:
       ...
     ]
 
-    $ lsblk -o +KNAME,FSTYPE,LABEL,UUID,PARTLABEL,PARTUUID,RA,MODEL,SERIAL,STATE,OWNER,GROUP,MODE,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,SCHED,RQ-SIZE,DISC-ALN,DISC-GRAN,DISC-MAX,DISC-ZERO,WSAME,WWN,RAND,PKNAME,HCTL,TRAN,REV,VENDOR | jc --lsblk -p -r
+    $ lsblk -o +KNAME,FSTYPE,LABEL,UUID,PARTLABEL,PARTUUID,RA,MODEL,SERIAL,\\
+      STATE,OWNER,GROUP,MODE,ALIGNMENT,MIN-IO,OPT-IO,PHY-SEC,LOG-SEC,ROTA,\\
+      SCHED,RQ-SIZE,DISC-ALN,DISC-GRAN,DISC-MAX,DISC-ZERO,WSAME,WWN,RAND,\\
+      PKNAME,HCTL,TRAN,REV,VENDOR | jc --lsblk -p -r
     [
       {
         "name": "sda",
@@ -266,16 +274,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.lsblk.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -283,14 +287,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux
 
-Version 1.8 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.9 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/lsmod.md

@@ -1,20 +1,22 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.lsmod"></a>
 
 # jc.parsers.lsmod
-jc - JSON CLI output utility `lsmod` command output parser
+
+jc - JSON Convert `lsmod` command output parser
 
 Usage (cli):
 
     $ lsmod | jc --lsmod
 
-    or
+or
 
     $ jc lsmod
 
 Usage (module):
 
-    import jc.parsers.lsmod
-    result = jc.parsers.lsmod.parse(lsmod_command_output)
+    import jc
+    result = jc.parse('lsmod', lsmod_command_output)
 
 Schema:
 
@@ -123,16 +125,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.lsmod.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -140,14 +138,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux
 
-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/lsof.md

@@ -1,20 +1,22 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.lsof"></a>
 
 # jc.parsers.lsof
-jc - JSON CLI output utility `lsof` command output parser
+
+jc - JSON Convert `lsof` command output parser
 
 Usage (cli):
 
     $ lsof | jc --lsof
 
-    or
+or
 
     $ jc lsof
 
 Usage (module):
 
-    import jc.parsers.lsof
-    result = jc.parsers.lsof.parse(lsof_command_output)
+    import jc
+    result = jc.parse('lsof', lsof_command_output)
 
 Schema:
 
@@ -117,16 +119,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.lsof.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -134,14 +132,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    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
+### Parser Information
+Compatibility:  linux, darwin, aix, freebsd
 
-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/lspci.md

@@ -0,0 +1,148 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.lspci"></a>
+
+# jc.parsers.lspci
+
+jc - JSON Convert `lspci -mmv` command output parser
+
+This parser supports the following `lspci` options:
+- `-mmv`
+- `-nmmv`
+- `-nnmmv`
+
+Usage (cli):
+
+    $ lspci -nnmmv | jc --lspci
+
+or
+
+    $ jc lspci -nnmmv
+
+Usage (module):
+
+    import jc
+    result = jc.parse('lspci', lspci_command_output)
+
+Schema:
+
+    [
+      {
+        "slot":                         string,
+        "domain":                       string,
+        "domain_int":                   integer,
+        "bus":                          string,
+        "bus_int":                      integer,
+        "dev":                          string,
+        "dev_int":                      integer,
+        "function":                     string,
+        "function_int":                 integer,
+        "class":                        string,
+        "class_id":                     string,
+        "class_id_int":                 integer,
+        "vendor":                       string,
+        "vendor_id":                    string,
+        "vendor_id_int":                integer,
+        "device":                       string,
+        "device_id":                    string,
+        "device_id_int":                integer,
+        "svendor":                      string,
+        "svendor_id":                   string,
+        "svendor_id_int":               integer,
+        "sdevice":                      string,
+        "sdevice_id":                   string,
+        "sdevice_id_int":               integer,
+        "rev":                          string,
+        "physlot":                      string,
+        "physlot_int":                  integer,
+        "progif":                       string,
+        "progif_int":                   integer
+      }
+    ]
+
+Examples:
+
+    $ lspci -nnmmv | jc --lspci -p
+    [
+      {
+        "slot": "ff:02:05.0",
+        "domain": "ff",
+        "domain_int": 255,
+        "bus": "02",
+        "bus_int": 2,
+        "dev": "05",
+        "dev_int": 5,
+        "function": "0",
+        "function_int": 0,
+        "class": "SATA controller",
+        "class_id": "0106",
+        "class_id_int": 262,
+        "vendor": "VMware",
+        "vendor_id": "15ad",
+        "vendor_id_int": 5549,
+        "device": "SATA AHCI controller",
+        "device_id": "07e0",
+        "device_id_int": 2016,
+        "svendor": "VMware",
+        "svendor_id": "15ad",
+        "svendor_id_int": 5549,
+        "sdevice": "SATA AHCI controller",
+        "sdevice_id": "07e0",
+        "sdevice_id_int": 2016,
+        "physlot": "37",
+        "physlot_int": 55,
+        "progif": "01",
+        "progif_int": 1
+      },
+      ...
+    ]
+
+    $ lspci -nnmmv | jc --lspci -p -r
+    [
+      {
+        "slot": "ff:02:05.0",
+        "domain": "ff",
+        "bus": "02",
+        "dev": "05",
+        "function": "0",
+        "class": "SATA controller",
+        "class_id": "0106",
+        "vendor": "VMware",
+        "vendor_id": "15ad",
+        "device": "SATA AHCI controller",
+        "device_id": "07e0",
+        "svendor": "VMware",
+        "svendor_id": "15ad",
+        "sdevice": "SATA AHCI controller",
+        "sdevice_id": "07e0",
+        "physlot": "37",
+        "progif": "01"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.lspci.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
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/lsusb.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.lsusb"></a>
 
 # jc.parsers.lsusb
-jc - JSON CLI output utility `lsusb` command output parser
+
+jc - JSON Convert `lsusb` command output parser
 
 Supports the `-v` option or no options.
 
@@ -9,19 +11,20 @@ Usage (cli):
 
     $ lsusb -v | jc --lsusb
 
-    or
+or
 
     $ jc lsusb -v
 
 Usage (module):
 
-    import jc.parsers.lsusb
-    result = jc.parsers.lsusb.parse(lsusb_command_output)
+    import jc
+    result = jc.parse('lsusb', lsusb_command_output)
 
 Schema:
 
-    Note: <item> object keynames are assigned directly from the lsusb output.
-          If there are duplicate <item> names in a section, only the last one is converted.
+> Note: <item> object keynames are assigned directly from the lsusb
+> output. If there are duplicate <item> names in a section, only the
+> last one is converted.
 
     [
       {
@@ -99,6 +102,46 @@ Schema:
                     ]
                   }
                 },
+                "cdc_mbim": {
+                  "<item>": {
+                    "value":                  string,
+                    "description":            string,
+                    "attributes": [
+                                              string
+                    ]
+                  }
+                },
+                "cdc_mbim_extended": {
+                  "<item>": {
+                    "value":                  string,
+                    "description":            string,
+                    "attributes": [
+                                              string
+                    ]
+                  }
+                },
+                "videocontrol_descriptors": [
+                  {
+                    "<item>": {
+                      "value":                string,
+                      "description":          string,
+                      "attributes": [
+                                              string
+                      ]
+                    }
+                  }
+                ],
+                "videostreaming_descriptors": [
+                  {
+                    "<item>": {
+                      "value":                string,
+                      "description":          string,
+                      "attributes": [
+                                              string
+                      ]
+                    }
+                  }
+                ],
                 "endpoint_descriptors": [
                   {
                     "<item>": {
@@ -131,6 +174,12 @@ Schema:
             }
           }
         },
+        "device_qualifier": {
+          "<item>": {
+            "value":                          string,
+            "description":                    string
+          }
+        },
         "device_status": {
           "value":                            string,
           "description":                      string
@@ -258,16 +307,12 @@ Examples:
       }
     ]
 
+<a id="jc.parsers.lsusb.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -275,14 +320,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux
 
-Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/m3u.md

@@ -0,0 +1,90 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.m3u"></a>
+
+# jc.parsers.m3u
+
+jc - JSON Convert M3U and M3U8 file parser
+
+This parser will make a best-effort to parse extended field information. If
+the extended fields cannot be successfully parsed, then an `unparsed_info`
+field will be added to the object. If not using `--quiet`, then a warning
+message also will be printed to `STDERR`.
+
+Usage (cli):
+
+    $ cat playlist.m3u | jc --m3u
+
+Usage (module):
+
+    import jc
+    result = jc.parse('m3u', m3u_file_output)
+
+Schema:
+
+    [
+      {
+        "runtime":              integer,
+        "display":              string,
+        "path":                 string,
+        <extended fields>:      string,  # [0]
+        "unparsed_info":        string,  # [1]
+      }
+    ]
+
+    [0] Field names are pulled directly from the #EXTINF: line
+    [1] Only added if the extended information cannot be parsed
+
+Examples:
+
+    $ cat playlist.m3u | jc --m3u -p
+    [
+      {
+        "runtime": 105,
+        "display": "Example artist - Example title",
+        "path": "C:\\Files\\My Music\\Example.mp3"
+      },
+      {
+        "runtime": 321,
+        "display": "Example Artist2 - Example title2",
+        "path": "C:\\Files\\My Music\\Favorites\\Example2.ogg"
+      }
+    ]
+
+    $ cat playlist.m3u | jc --m3u -p -r
+    [
+      {
+        "runtime": "105",
+        "display": "Example artist - Example title",
+        "path": "C:\\Files\\My Music\\Example.mp3"
+      },
+      {
+        "runtime": "321",
+        "display": "Example Artist2 - Example title2",
+        "path": "C:\\Files\\My Music\\Favorites\\Example2.ogg"
+      }
+    ]
+
+<a id="jc.parsers.m3u.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+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
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/mdadm.md

@@ -0,0 +1,252 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.mdadm"></a>
+
+# jc.parsers.mdadm
+
+jc - JSON Convert `mdadm` command output parser
+
+Supports the `--query` and `--examine` options in `mdadm`.
+
+Usage (cli):
+
+    $ mdadm --query --detail /dev/md0 | jc --mdadm
+
+or
+
+    $ mdadm --examine -E /dev/sdb1 | jc --mdadm
+
+or
+
+    $ jc mdadm --query --detail /dev/md0
+
+or
+
+    $ jc mdadm --examine -E /dev/sdb1
+
+Usage (module):
+
+    import jc
+    result = jc.parse('mdadm', mdadm_command_output)
+
+Schema:
+
+    {
+      "device":                       string,
+      "magic":                        string,
+      "version":                      string,
+      "feature_map":                  string,
+      "array_uuid":                   string,
+      "name":                         string,
+      "name_val":                     string,
+      "uuid":                         string,
+      "uuid_val":                     string,
+      "homehost":                     string,
+      "container":                    string,
+      "container_dev":                string,
+      "container_member":             integer,
+      "controller_guid":              string,
+      "container_guid":               string,
+      "seq":                          string,
+      "redundant_hdr":                string,
+      "virtual_disks":                integer,
+      "creation_time":                string,
+      "creation_time_epoch":          integer,  # naive timestamp
+      "raid_level":                   string,
+      "array_size":                   string,
+      "array_size_num":               integer,
+      "used_dev_size":                string,
+      "used_dev_size_num":            integer,
+      "raid_devices":                 integer,
+      "avail_dev_size":               string,
+      "avail_dev_size_num":           integer,
+      "data_offset":                  integer,
+      "super_offset":                 integer,
+      "unused_space":                 string,
+      "unused_space_before":          integer,
+      "unused_space_after":           integer,
+      "state":                        string,
+      "state_list": [
+                                      string
+      ],
+      "device_uuid":                  string,
+      "flags":                        string,
+      "flag_list": [
+                                      string
+      ],
+      "update_time":                  string,
+      "update_time_epoch":            integer,  # naive timestamp
+      "bad_block_log":                string,
+      "checksum":                     string,
+      "checksum_val":                 string,
+      "checksum_state":               string,
+      "events":                       string,
+      "events_num":                   integer,
+      "events_maj":                   integer,
+      "events_min":                   integer,
+      "chunk_size":                   string,
+      "chunk_size_num":               integer,
+      "device_role":                  string,
+      "array_state":                  string,
+      "array_state_list": [
+                                      string
+      ],
+      "member_arrays":                string,
+      "member_arrays_list": [
+                                      string
+      ],
+      "consistency_policy":           string,
+      "rebuild_status":               string,
+      "rebuild_status_percent":       integer,
+      "resync_status":                string,
+      "resync_status_percent":        integer,
+      "check_status":                 string,
+      "check_status_percent":         integer,
+      "total_devices":                integer,
+      "preferred_minor":              integer,
+      "persistence":                  string,
+      "active_devices":               integer,
+      "working_devices":              integer,
+      "failed_devices":               integer,
+      "spare_devices":                integer,
+      "physical_disks":               integer,
+      "device_table": [
+        {
+          "number":                   integer/null,
+          "major":                    integer/null,
+          "minor":                    integer/null,
+          "state": [
+                                      string
+          ],
+          "device":                   string,
+          "raid_device":              integer/null
+        }
+      ]
+    }
+
+    Any fields unspecified above will be string type.
+
+Examples:
+
+    $ mdadm --query --detail /dev/md0 | jc --mdadm -p
+    {
+      "device": "/dev/md0",
+      "version": "1.1",
+      "creation_time": "Tue Apr 13 23:22:16 2010",
+      "raid_level": "raid1",
+      "array_size": "5860520828 (5.46 TiB 6.00 TB)",
+      "used_dev_size": "5860520828 (5.46 TiB 6.00 TB)",
+      "raid_devices": 2,
+      "total_devices": 2,
+      "persistence": "Superblock is persistent",
+      "intent_bitmap": "Internal",
+      "update_time": "Tue Jul 26 20:16:31 2022",
+      "state": "clean",
+      "active_devices": 2,
+      "working_devices": 2,
+      "failed_devices": 0,
+      "spare_devices": 0,
+      "consistency_policy": "bitmap",
+      "name": "virttest:0",
+      "uuid": "85c5b164:d58a5ada:14f5fe07:d642e843",
+      "events": 2193679,
+      "device_table": [
+        {
+          "number": 3,
+          "major": 8,
+          "minor": 17,
+          "state": [
+            "active",
+            "sync"
+          ],
+          "device": "/dev/sdb1",
+          "raid_device": 0
+        },
+        {
+          "number": 2,
+          "major": 8,
+          "minor": 33,
+          "state": [
+            "active",
+            "sync"
+          ],
+          "device": "/dev/sdc1",
+          "raid_device": 1
+        }
+      ],
+      "array_size_num": 5860520828,
+      "used_dev_size_num": 5860520828,
+      "name_val": "virttest:0",
+      "uuid_val": "85c5b164:d58a5ada:14f5fe07:d642e843",
+      "state_list": [
+        "clean"
+      ],
+      "creation_time_epoch": 1271226136,
+      "update_time_epoch": 1658891791
+    }
+
+    $ mdadm --query --detail /dev/md0 | jc --mdadm -p -r
+    {
+      "device": "/dev/md0",
+      "version": "1.1",
+      "creation_time": "Tue Apr 13 23:22:16 2010",
+      "raid_level": "raid1",
+      "array_size": "5860520828 (5.46 TiB 6.00 TB)",
+      "used_dev_size": "5860520828 (5.46 TiB 6.00 TB)",
+      "raid_devices": "2",
+      "total_devices": "2",
+      "persistence": "Superblock is persistent",
+      "intent_bitmap": "Internal",
+      "update_time": "Tue Jul 26 20:16:31 2022",
+      "state": "clean",
+      "active_devices": "2",
+      "working_devices": "2",
+      "failed_devices": "0",
+      "spare_devices": "0",
+      "consistency_policy": "bitmap",
+      "name": "virttest:0",
+      "uuid": "85c5b164:d58a5ada:14f5fe07:d642e843",
+      "events": "2193679",
+      "device_table": [
+        {
+          "number": "3",
+          "major": "8",
+          "minor": "17",
+          "state": "active sync",
+          "device": "/dev/sdb1",
+          "raid_device": "0"
+        },
+        {
+          "number": "2",
+          "major": "8",
+          "minor": "33",
+          "state": "active sync",
+          "device": "/dev/sdc1",
+          "raid_device": "1"
+        }
+      ]
+    }
+
+<a id="jc.parsers.mdadm.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict
+```
+
+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
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/mount.md

@@ -1,20 +1,22 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.mount"></a>
 
 # jc.parsers.mount
-jc - JSON CLI output utility `mount` command output parser
+
+jc - JSON Convert `mount` command output parser
 
 Usage (cli):
 
     $ mount | jc --mount
 
-    or
+or
 
     $ jc mount
 
 Usage (module):
 
-    import jc.parsers.mount
-    result = jc.parsers.mount.parse(mount_command_output)
+    import jc
+    result = jc.parse('mount', mount_command_output)
 
 Schema:
 
@@ -23,7 +25,7 @@ Schema:
         "filesystem":       string,
         "mount_point":      string,
         "type":             string,
-        "access": [
+        "options": [
                             string
         ]
       }
@@ -37,7 +39,7 @@ Example:
         "filesystem": "sysfs",
         "mount_point": "/sys",
         "type": "sysfs",
-        "access": [
+        "options": [
           "rw",
           "nosuid",
           "nodev",
@@ -49,7 +51,7 @@ Example:
         "filesystem": "proc",
         "mount_point": "/proc",
         "type": "proc",
-        "access": [
+        "options": [
           "rw",
           "nosuid",
           "nodev",
@@ -61,7 +63,7 @@ Example:
         "filesystem": "udev",
         "mount_point": "/dev",
         "type": "devtmpfs",
-        "access": [
+        "options": [
           "rw",
           "nosuid",
           "relatime",
@@ -73,16 +75,12 @@ Example:
       ...
     ]
 
+<a id="jc.parsers.mount.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -90,14 +88,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    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, freebsd
+### Parser Information
+Compatibility:  linux, darwin, freebsd, aix
 
-Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.8 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/mpstat.md

@@ -0,0 +1,140 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.mpstat"></a>
+
+# jc.parsers.mpstat
+
+jc - JSON Convert `mpstat` command output parser
+
+> Note: Latest versions of `mpstat` support JSON output (v11.5.1+)
+
+Usage (cli):
+
+    $ mpstat | jc --mpstat
+
+or
+
+    $ jc mpstat
+
+Usage (module):
+
+    import jc
+    result = jc.parse('mpstat', mpstat_command_output)
+
+Schema:
+
+    [
+      {
+        "type":               string,
+        "time":               string,
+        "cpu":                string,
+        "node":               string,
+        "average":            boolean,
+        "percent_usr":        float,
+        "percent_nice":       float,
+        "percent_sys":        float,
+        "percent_iowait":     float,
+        "percent_irq":        float,
+        "percent_soft":       float,
+        "percent_steal":      float,
+        "percent_guest":      float,
+        "percent_gnice":      float,
+        "percent_idle":       float,
+        "intr_s":             float,
+        "<x>_s":              float,      # <x> is an integer
+        "nmi_s":              float,
+        "loc_s":              float,
+        "spu_s":              float,
+        "pmi_s":              float,
+        "iwi_s":              float,
+        "rtr_s":              float,
+        "res_s":              float,
+        "cal_s":              float,
+        "tlb_s":              float,
+        "trm_s":              float,
+        "thr_s":              float,
+        "dfr_s":              float,
+        "mce_s":              float,
+        "mcp_s":              float,
+        "err_s":              float,
+        "mis_s":              float,
+        "pin_s":              float,
+        "npi_s":              float,
+        "piw_s":              float,
+        "hi_s":               float,
+        "timer_s":            float,
+        "net_tx_s":           float,
+        "net_rx_s":           float,
+        "block_s":            float,
+        "irq_poll_s":         float,
+        "block_iopoll_s":     float,
+        "tasklet_s":          float,
+        "sched_s":            float,
+        "hrtimer_s":          float,
+        "rcu_s":              float
+      }
+    ]
+
+Examples:
+
+    $ mpstat | jc --mpstat -p
+    [
+      {
+        "cpu": "all",
+        "percent_usr": 12.94,
+        "percent_nice": 0.0,
+        "percent_sys": 26.42,
+        "percent_iowait": 0.43,
+        "percent_irq": 0.0,
+        "percent_soft": 0.16,
+        "percent_steal": 0.0,
+        "percent_guest": 0.0,
+        "percent_gnice": 0.0,
+        "percent_idle": 60.05,
+        "type": "cpu",
+        "time": "01:58:14 PM"
+      }
+    ]
+
+    $ mpstat | jc --mpstat -p -r
+    [
+      {
+        "cpu": "all",
+        "percent_usr": "12.94",
+        "percent_nice": "0.00",
+        "percent_sys": "26.42",
+        "percent_iowait": "0.43",
+        "percent_irq": "0.00",
+        "percent_soft": "0.16",
+        "percent_steal": "0.00",
+        "percent_guest": "0.00",
+        "percent_gnice": "0.00",
+        "percent_idle": "60.05",
+        "type": "cpu",
+        "time": "01:58:14 PM"
+      }
+    ]
+
+<a id="jc.parsers.mpstat.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+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
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/mpstat_s.md

@@ -0,0 +1,128 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.mpstat_s"></a>
+
+# jc.parsers.mpstat\_s
+
+jc - JSON Convert `mpstat` command output streaming parser
+
+> This streaming parser outputs JSON Lines (cli) or returns an Iterable of
+> Dictionaries (module)
+
+> Note: Latest versions of `mpstat` support JSON output (v11.5.1+)
+
+Usage (cli):
+
+    $ mpstat | jc --mpstat-s
+
+Usage (module):
+
+    import jc
+
+    result = jc.parse('mpstat_s', mpstat_command_output.splitlines())
+    for item in result:
+        # do something
+
+Schema:
+
+    {
+      "type":               string,
+      "time":               string,
+      "cpu":                string,
+      "node":               string,
+      "average":            boolean,
+      "percent_usr":        float,
+      "percent_nice":       float,
+      "percent_sys":        float,
+      "percent_iowait":     float,
+      "percent_irq":        float,
+      "percent_soft":       float,
+      "percent_steal":      float,
+      "percent_guest":      float,
+      "percent_gnice":      float,
+      "percent_idle":       float,
+      "intr_s":             float,
+      "<x>_s":              float,      # <x> is an integer
+      "nmi_s":              float,
+      "loc_s":              float,
+      "spu_s":              float,
+      "pmi_s":              float,
+      "iwi_s":              float,
+      "rtr_s":              float,
+      "res_s":              float,
+      "cal_s":              float,
+      "tlb_s":              float,
+      "trm_s":              float,
+      "thr_s":              float,
+      "dfr_s":              float,
+      "mce_s":              float,
+      "mcp_s":              float,
+      "err_s":              float,
+      "mis_s":              float,
+      "pin_s":              float,
+      "npi_s":              float,
+      "piw_s":              float,
+      "hi_s":               float,
+      "timer_s":            float,
+      "net_tx_s":           float,
+      "net_rx_s":           float,
+      "block_s":            float,
+      "irq_poll_s":         float,
+      "block_iopoll_s":     float,
+      "tasklet_s":          float,
+      "sched_s":            float,
+      "hrtimer_s":          float,
+      "rcu_s":              float,
+
+      # below object only exists if using -qq or ignore_exceptions=True
+      "_jc_meta": {
+        "success":          boolean,     # false if error parsing
+        "error":            string,      # exists if "success" is false
+        "line":             string       # exists if "success" is false
+      }
+    }
+
+Examples:
+
+    $ mpstat -A | jc --mpstat-s
+    {"cpu":"all","percent_usr":0.22,"percent_nice":0.0,"percent_sys":...}
+    {"cpu":"0","percent_usr":0.22,"percent_nice":0.0,"percent_sys":0....}
+    {"cpu":"all","intr_s":37.61,"type":"interrupts","time":"03:15:06 PM"}
+    ...
+
+    $ mpstat -A | jc --mpstat-s -r
+    {"cpu":"all","percent_usr":"0.22","percent_nice":"0.00","percent_...}
+    {"cpu":"0","percent_usr":"0.22","percent_nice":"0.00","percent_sy...}
+    {"cpu":"all","intr_s":"37.61","type":"interrupts","time":"03:15:06 PM"}
+    ...
+
+<a id="jc.parsers.mpstat_s.parse"></a>
+
+### parse
+
+```python
+@add_jc_meta
+def parse(data: Iterable[str],
+          raw: bool = False,
+          quiet: bool = False,
+          ignore_exceptions: bool = False) -> Union[Iterable[Dict], tuple]
+```
+
+Main text parsing generator function. Returns an iterable object.
+
+Parameters:
+
+    data:              (iterable)  line-based text data to parse
+                                   (e.g. sys.stdin or str.splitlines())
+
+    raw:               (boolean)   unprocessed output if True
+    quiet:             (boolean)   suppress warning messages if True
+    ignore_exceptions: (boolean)   ignore parsing exceptions if True
+
+Returns:
+
+    Iterable of Dictionaries
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/netstat.md

@@ -1,24 +1,27 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.netstat"></a>
 
 # jc.parsers.netstat
-jc - JSON CLI output utility `netstat` command output parser
+
+jc - JSON Convert `netstat` command output parser
 
 Caveats:
 - Use of multiple `l` options is not supported on OSX (e.g. `netstat -rlll`)
-- Use of the `A` option is not supported on OSX when using the `r` option (e.g. `netstat -rA`)
+- Use of the `A` option is not supported on OSX when using the `r` option
+  (e.g. `netstat -rA`)
 
 Usage (cli):
 
     $ netstat | jc --netstat
 
-    or
+or
 
     $ jc netstat
 
 Usage (module):
 
-    import jc.parsers.netstat
-    result = jc.parsers.netstat.parse(netstat_command_output)
+    import jc
+    result = jc.parse('netstat', netstat_command_output)
 
 Schema:
 
@@ -352,16 +355,12 @@ Examples:
       }
     ]
 
+<a id="jc.parsers.netstat.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -369,14 +368,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    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, freebsd
+### Parser Information
+Compatibility:  linux, darwin, freebsd, win32
 
-Version 1.12 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.15 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/nmcli.md

@@ -0,0 +1,171 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.nmcli"></a>
+
+# jc.parsers.nmcli
+
+jc - JSON Convert `nmcli` command output parser
+
+Supports the following `nmcli` subcommands:
+- `nmcli general`
+- `nmcli general permissions`
+- `nmcli connection`
+- `nmcli connection show <device_name>`
+- `nmcli device`
+- `nmcli device show`
+- `nmcli device show <device_name>`
+
+Usage (cli):
+
+    $ nmcli device show lo | jc --nmcli
+
+or
+
+    $ jc nmcli device show lo
+
+Usage (module):
+
+    import jc
+    result = jc.parse('nmcli', nmcli_command_output)
+
+Schema:
+
+Because there are so many options, the schema is not strictly defined.
+Integer and Float value conversions are attempted and the original
+values are kept if they fail. If you don't want automatic conversion,
+then use the `-r` or `raw=True` option to disable it.
+
+The structure is flat, for the most part, but there are a couple of
+"well-known" keys that are further parsed into objects for convenience.
+These are documented below.
+
+    [
+      {
+        "<key>":                  string/integer/float,   # [0]
+        "dhcp4_option_x": {
+          "name":                 string,
+          "value":                string/integer/float,
+        },
+        "dhcp6_option_x": {
+          "name":                 string,
+          "value":                string/integer/float,
+        },
+        "ip4_route_x": {
+          "dst":                  string,
+          "nh":                   string,
+          "mt":                   integer
+        },
+        "ip6_route_x": {
+          "dst":                  string,
+          "nh":                   string,
+          "mt":                   integer,
+          "table":                integer
+        }
+      }
+    ]
+
+    [0] all values of `---` are converted to null
+
+Examples:
+
+    $ nmcli connection show ens33 | jc --nmcli -p
+    [
+      {
+        "connection_id": "ens33",
+        "connection_uuid": "d92ece08-9e02-47d5-b2d2-92c80e155744",
+        "connection_stable_id": null,
+        "connection_type": "802-3-ethernet",
+        "connection_interface_name": "ens33",
+        "connection_autoconnect": "yes",
+        ...
+        "ip4_address_1": "192.168.71.180/24",
+        "ip4_gateway": "192.168.71.2",
+        "ip4_route_1": {
+          "dst": "0.0.0.0/0",
+          "nh": "192.168.71.2",
+          "mt": 100
+        },
+        "ip4_route_2": {
+          "dst": "192.168.71.0/24",
+          "nh": "0.0.0.0",
+          "mt": 100
+        },
+        "ip4_dns_1": "192.168.71.2",
+        "ip4_domain_1": "localdomain",
+        "dhcp4_option_1": {
+          "name": "broadcast_address",
+          "value": "192.168.71.255"
+        },
+        ...
+        "ip6_address_1": "fe80::c1cb:715d:bc3e:b8a0/64",
+        "ip6_gateway": null,
+        "ip6_route_1": {
+          "dst": "fe80::/64",
+          "nh": "::",
+          "mt": 100
+        }
+      }
+    ]
+
+    $ nmcli connection show ens33 | jc --nmcli -p -r
+    [
+      {
+        "connection_id": "ens33",
+        "connection_uuid": "d92ece08-9e02-47d5-b2d2-92c80e155744",
+        "connection_stable_id": null,
+        "connection_type": "802-3-ethernet",
+        "connection_interface_name": "ens33",
+        "connection_autoconnect": "yes",
+        ...
+        "ip4_address_1": "192.168.71.180/24",
+        "ip4_gateway": "192.168.71.2",
+        "ip4_route_1": {
+          "dst": "0.0.0.0/0",
+          "nh": "192.168.71.2",
+          "mt": "100"
+        },
+        "ip4_route_2": {
+          "dst": "192.168.71.0/24",
+          "nh": "0.0.0.0",
+          "mt": "100"
+        },
+        "ip4_dns_1": "192.168.71.2",
+        "ip4_domain_1": "localdomain",
+        "dhcp4_option_1": {
+          "name": "broadcast_address",
+          "value": "192.168.71.255"
+        },
+        ...
+        "ip6_address_1": "fe80::c1cb:715d:bc3e:b8a0/64",
+        "ip6_gateway": null,
+        "ip6_route_1": {
+          "dst": "fe80::/64",
+          "nh": "::",
+          "mt": "100"
+        }
+      }
+    ]
+
+<a id="jc.parsers.nmcli.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+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
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/nsd_control.md

@@ -0,0 +1,90 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.nsd_control"></a>
+
+# jc.parsers.nsd\_control
+
+jc - JSON Convert `nsd-control` command output parser
+
+Usage (cli):
+
+    $ nsd-control | jc --nsd-control
+
+or
+
+    $ jc nsd-control
+
+Usage (module):
+
+    import jc
+    result = jc.parse('nsd_control', nsd_control_command_output)
+
+Schema:
+
+    [
+      {
+        "version":          string,
+        "verbosity":        integer,
+        "ratelimit":        integer
+      }
+    ]
+
+    [
+      {
+        "zone":             string
+        "status": {
+          "state":          string,
+          "served-serial":  string,
+          "commit-serial":  string,
+          "wait":           string
+        }
+      }
+    ]
+
+Examples:
+
+    $ nsd-control | jc --nsd-control status
+    [
+      {
+        "version": "4.6.2",
+        "verbosity": "2",
+        "ratelimit": "0"
+      }
+    ]
+
+    $ nsd-control | jc --nsd-control zonestatus sunet.se
+    [
+      {
+        "zone": "sunet.se",
+        "status": {
+          "state": "ok",
+          "served-serial": "2023090704 since 2023-09-07T16:34:27",
+          "commit-serial": "2023090704 since 2023-09-07T16:34:27",
+          "wait": "28684 sec between attempts"
+        }
+      }
+    ]
+
+<a id="jc.parsers.nsd_control.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = 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:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Version 1.0 by Pettai (pettai@sunet.se)

docs/parsers/ntpq.md

@@ -1,20 +1,22 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.ntpq"></a>
 
 # jc.parsers.ntpq
-jc - JSON CLI output utility `ntpq -p` command output parser
+
+jc - JSON Convert `ntpq -p` command output parser
 
 Usage (cli):
 
     $ ntpq -p | jc --ntpq
 
-    or
+or
 
     $ jc ntpq -p
 
 Usage (module):
 
-    import jc.parsers.ntpq
-    result = jc.parsers.ntpq.parse(ntpq_command_output)
+    import jc
+    result = jc.parse('ntpq', ntpq_command_output)
 
 Schema:
 
@@ -204,16 +206,12 @@ Examples:
       }
     ]
 
+<a id="jc.parsers.ntpq.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -221,14 +219,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, freebsd
 
-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/openvpn.md

@@ -0,0 +1,178 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.openvpn"></a>
+
+# jc.parsers.openvpn
+
+jc - JSON Convert openvpn-status.log file parser
+
+The `*_epoch` calculated timestamp fields are naive. (i.e. based on
+the local time of the system the parser is run on)
+
+Usage (cli):
+
+    $ cat openvpn-status.log | jc --openvpn
+
+Usage (module):
+
+    import jc
+    result = jc.parse('openvpn', openvpn_status_log_file_output)
+
+Schema:
+
+    {
+      "clients": [
+        {
+          "common_name":                        string,
+          "real_address":                       string,
+          "real_address_prefix":                integer,  # [0]
+          "real_address_port":                  integer,  # [0]
+          "bytes_received":                     integer,
+          "bytes_sent":                         integer,
+          "connected_since":                    string,
+          "connected_since_epoch":              integer,
+          "updated":                            string,
+          "updated_epoch":                      integer,
+        }
+      ],
+      "routing_table": [
+        {
+          "virtual_address":                    string,
+          "virtual_address_prefix":             integer,  # [0]
+          "virtual_address_port":               integer,  # [0]
+          "common_name":                        string,
+          "real_address":                       string,
+          "real_address_prefix":                integer,  # [0]
+          "real_address_port":                  integer,  # [0]
+          "last_reference":                     string,
+          "last_reference_epoch":               integer,
+        }
+      ],
+      "global_stats": {
+        "max_bcast_mcast_queue_len":            integer
+      }
+    }
+
+    [0] null/None if not found
+
+Examples:
+
+    $ cat openvpn-status.log | jc --openvpn -p
+    {
+      "clients": [
+        {
+          "common_name": "foo@example.com",
+          "real_address": "10.10.10.10",
+          "bytes_received": 334948,
+          "bytes_sent": 1973012,
+          "connected_since": "Thu Jun 18 04:23:03 2015",
+          "updated": "Thu Jun 18 08:12:15 2015",
+          "real_address_prefix": null,
+          "real_address_port": 49502,
+          "connected_since_epoch": 1434626583,
+          "updated_epoch": 1434640335
+        },
+        {
+          "common_name": "foo@example.com",
+          "real_address": "10.10.10.10",
+          "bytes_received": 334948,
+          "bytes_sent": 1973012,
+          "connected_since": "Thu Jun 18 04:23:03 2015",
+          "updated": "Thu Jun 18 08:12:15 2015",
+          "real_address_prefix": null,
+          "real_address_port": 49503,
+          "connected_since_epoch": 1434626583,
+          "updated_epoch": 1434640335
+        }
+      ],
+      "routing_table": [
+        {
+          "virtual_address": "192.168.255.118",
+          "common_name": "baz@example.com",
+          "real_address": "10.10.10.10",
+          "last_reference": "Thu Jun 18 08:12:09 2015",
+          "virtual_address_prefix": null,
+          "virtual_address_port": null,
+          "real_address_prefix": null,
+          "real_address_port": 63414,
+          "last_reference_epoch": 1434640329
+        },
+        {
+          "virtual_address": "10.200.0.0",
+          "common_name": "baz@example.com",
+          "real_address": "10.10.10.10",
+          "last_reference": "Thu Jun 18 08:12:09 2015",
+          "virtual_address_prefix": 16,
+          "virtual_address_port": null,
+          "real_address_prefix": null,
+          "real_address_port": 63414,
+          "last_reference_epoch": 1434640329
+        }
+      ],
+      "global_stats": {
+        "max_bcast_mcast_queue_len": 0
+      }
+    }
+
+    $ cat openvpn-status.log | jc --openvpn -p -r
+    {
+      "clients": [
+        {
+          "common_name": "foo@example.com",
+          "real_address": "10.10.10.10:49502",
+          "bytes_received": "334948",
+          "bytes_sent": "1973012",
+          "connected_since": "Thu Jun 18 04:23:03 2015",
+          "updated": "Thu Jun 18 08:12:15 2015"
+        },
+        {
+          "common_name": "foo@example.com",
+          "real_address": "10.10.10.10:49503",
+          "bytes_received": "334948",
+          "bytes_sent": "1973012",
+          "connected_since": "Thu Jun 18 04:23:03 2015",
+          "updated": "Thu Jun 18 08:12:15 2015"
+        }
+      ],
+      "routing_table": [
+        {
+          "virtual_address": "192.168.255.118",
+          "common_name": "baz@example.com",
+          "real_address": "10.10.10.10:63414",
+          "last_reference": "Thu Jun 18 08:12:09 2015"
+        },
+        {
+          "virtual_address": "10.200.0.0/16",
+          "common_name": "baz@example.com",
+          "real_address": "10.10.10.10:63414",
+          "last_reference": "Thu Jun 18 08:12:09 2015"
+        }
+      ],
+      "global_stats": {
+        "max_bcast_mcast_queue_len": "0"
+      }
+    }
+
+<a id="jc.parsers.openvpn.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, darwin, cygwin, win32, aix, freebsd
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/os_prober.md

@@ -0,0 +1,66 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.os_prober"></a>
+
+# jc.parsers.os\_prober
+
+jc - JSON Convert `os-prober` command output parser
+
+Usage (cli):
+
+    $ os-prober | jc --os-prober
+
+or
+
+    $ jc os-prober
+
+Usage (module):
+
+    import jc
+    result = jc.parse('os_prober', os_prober_command_output)
+
+Schema:
+
+    {
+      "partition":              string,
+      "efi_bootmgr":            string,  # [0]
+      "name":                   string,
+      "short_name":             string,
+      "type":                   string
+    }
+
+    [0] only exists if an EFI boot manager is detected
+
+Examples:
+
+    $ os-prober | jc --os-prober -p
+    {
+      "partition": "/dev/sda1",
+      "name": "Windows 10",
+      "short_name": "Windows",
+      "type": "chain"
+    }
+
+<a id="jc.parsers.os_prober.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
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/os_release.md

@@ -0,0 +1,86 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.os_release"></a>
+
+# jc.parsers.os\_release
+
+jc - JSON Convert `/etc/os-release` file parser
+
+This parser is an alias to the Key/Value parser (`--kv`).
+
+Usage (cli):
+
+    $ cat /etc/os-release | jc --os-release
+
+Usage (module):
+
+    import jc
+    result = jc.parse('os_release', os_release_output)
+
+Schema:
+
+    {
+        "<key>":     string
+    }
+
+Examples:
+
+    $ cat /etc/os-release | jc --os-release -p
+    {
+      "NAME": "CentOS Linux",
+      "VERSION": "7 (Core)",
+      "ID": "centos",
+      "ID_LIKE": "rhel fedora",
+      "VERSION_ID": "7",
+      "PRETTY_NAME": "CentOS Linux 7 (Core)",
+      "ANSI_COLOR": "0;31",
+      "CPE_NAME": "cpe:/o:centos:centos:7",
+      "HOME_URL": "https://www.centos.org/",
+      "BUG_REPORT_URL": "https://bugs.centos.org/",
+      "CENTOS_MANTISBT_PROJECT": "CentOS-7",
+      "CENTOS_MANTISBT_PROJECT_VERSION": "7",
+      "REDHAT_SUPPORT_PRODUCT": "centos",
+      "REDHAT_SUPPORT_PRODUCT_VERSION": "7"
+    }
+
+    $ cat /etc/os-release | jc --os-release -p -r
+    {
+      "NAME": "\\"CentOS Linux\\"",
+      "VERSION": "\\"7 (Core)\\"",
+      "ID": "\\"centos\\"",
+      "ID_LIKE": "\\"rhel fedora\\"",
+      "VERSION_ID": "\\"7\\"",
+      "PRETTY_NAME": "\\"CentOS Linux 7 (Core)\\"",
+      "ANSI_COLOR": "\\"0;31\\"",
+      "CPE_NAME": "\\"cpe:/o:centos:centos:7\\"",
+      "HOME_URL": "\\"https://www.centos.org/\\"",
+      "BUG_REPORT_URL": "\\"https://bugs.centos.org/\\"",
+      "CENTOS_MANTISBT_PROJECT": "\\"CentOS-7\\"",
+      "CENTOS_MANTISBT_PROJECT_VERSION": "\\"7\\"",
+      "REDHAT_SUPPORT_PRODUCT": "\\"centos\\"",
+      "REDHAT_SUPPORT_PRODUCT_VERSION": "\\"7\\""
+    }
+
+<a id="jc.parsers.os_release.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, darwin, cygwin, win32, aix, freebsd
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/passwd.md

@@ -1,7 +1,9 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.passwd"></a>
 
 # jc.parsers.passwd
-jc - JSON CLI output utility `/etc/passwd` file Parser
+
+jc - JSON Convert `/etc/passwd` file Parser
 
 Usage (cli):
 
@@ -9,8 +11,8 @@ Usage (cli):
 
 Usage (module):
 
-    import jc.parsers.passwd
-    result = jc.parsers.passwd.parse(passwd_file_output)
+    import jc
+    result = jc.parse('passwd', passwd_file_output)
 
 Schema:
 
@@ -92,16 +94,12 @@ Examples:
       ...
     ]
 
+<a id="jc.parsers.passwd.parse"></a>
 
-## info
-```python
-info()
-```
-Provides parser metadata (version, author, etc.)
+### parse
 
-## parse
 ```python
-parse(data, raw=False, quiet=False)
+def parse(data, raw=False, quiet=False)
 ```
 
 Main text parsing function
@@ -109,14 +107,14 @@ Main text parsing function
 Parameters:
 
     data:        (string)  text data to parse
-    raw:         (boolean) output preprocessed JSON if True
+    raw:         (boolean) unprocessed output if True
     quiet:       (boolean) suppress warning messages if True
 
 Returns:
 
     List of Dictionaries. Raw or processed structured data.
 
-## Parser Information
+### Parser Information
 Compatibility:  linux, darwin, aix, freebsd
 
 Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/pci_ids.md

@@ -0,0 +1,99 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.pci_ids"></a>
+
+# jc.parsers.pci\_ids
+
+jc - JSON Convert `pci.ids` file parser
+
+This parser converts the pci.ids database file.
+
+https://raw.githubusercontent.com/pciutils/pciids/master/pci.ids
+
+A nested schema allows straightforward queries with tools like `jq`. Hex id
+numbers are prefixed with an underscore (`_`) so bracket notation is not
+necessary when referencing. For example:
+
+    $ cat pci.ids | jc --pci-ids | jq '.vendors._9005._0053._9005._ffff.subsystem_name'
+    "AIC-7896 SCSI Controller mainboard implementation"
+
+Here are the vendor and class mappings:
+
+    jq '.vendors._001c._0001._001c._0005.subsystem_name'
+                  |     |     |     |
+                  |     |     |     subdevice
+                  |     |     subvendor
+                  |     device
+                  vendor
+
+    jq '.classes._0c._03._40'
+                  |   |   |
+                  |   |   prog_if
+                  |   subclass
+                  class
+
+Usage (cli):
+
+    $ cat pci.ids | jc --pci-ids
+
+Usage (module):
+
+    import jc
+    result = jc.parse('pci_ids', pci_ids_file_output)
+
+Schema:
+
+    {
+      "vendors": {
+        "_<vendor_id>": {
+          "vendor_name":                 string,
+          "_<device_id>": {
+            "device_name":               string,
+            "_<subvendor_id>": {
+              "_<subdevice_id":          string
+            }
+          }
+        }
+      },
+      "classes": {
+        "_<class_id>": {
+          "class_name":                  string,
+          "_<subclass_id>": {
+            "subclass_name":             string,
+            "_<prog_if>":                string
+          }
+        }
+      }
+    }
+
+Examples:
+
+    $ cat pci.ids | jc --pci-ids | jq '.vendors._001c._0001._001c._0005.subsystem_name'
+    "2 Channel CAN Bus SJC1000 (Optically Isolated)"
+
+    $ cat pci.ids | jc --pci-ids | jq '.classes._0c._03._40'
+    "USB4 Host Interface"
+
+<a id="jc.parsers.pci_ids.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, darwin, cygwin, win32, aix, freebsd
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)