Merge pull request #655 from kellyjonbrazil/dev

Dev v1.25.5

.github/workflows/pythonapp.yml

@@ -9,23 +9,80 @@ on:
     - "**/*.py"
 
 jobs:
-  build:
+  very_old_python:
+    if: github.event.pull_request.draft == false
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
-        os: [macos-latest, ubuntu-latest, windows-latest]
-        python-version: [3.6, 3.7, 3.8, 3.9]
+        os: [macos-13, windows-2019]
+        python-version: ["3.6"]
 
     steps:
-    - uses: actions/checkout@v2
+    - uses: actions/checkout@v3
     - name: "Set up timezone to America/Los_Angeles"
-      uses: szenius/set-timezone@v1.0
+      uses: szenius/set-timezone@v1.2
       with:
         timezoneLinux: "America/Los_Angeles"
         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
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+    - name: Test with unittest
+      run: |
+        python -m unittest discover tests
+
+  old_python:
+    if: github.event.pull_request.draft == false
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [macos-13, ubuntu-22.04, windows-2019]
+        python-version: ["3.7", "3.8", "3.9", "3.10"]
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: "Set up timezone to America/Los_Angeles"
+      uses: szenius/set-timezone@v1.2
+      with:
+        timezoneLinux: "America/Los_Angeles"
+        timezoneMacos: "America/Los_Angeles"
+        timezoneWindows: "Pacific Standard Time"
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
+      with:
+        python-version: ${{ matrix.python-version }}
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+    - name: Test with unittest
+      run: |
+        python -m unittest discover tests
+
+  latest_python:
+    if: github.event.pull_request.draft == false
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [macos-latest, ubuntu-latest, windows-latest]
+        python-version: ["3.11", "3.12"]
+
+    steps:
+    - uses: actions/checkout@v3
+    - name: "Set up timezone to America/Los_Angeles"
+      uses: szenius/set-timezone@v1.2
+      with:
+        timezoneLinux: "America/Los_Angeles"
+        timezoneMacos: "America/Los_Angeles"
+        timezoneWindows: "Pacific Standard Time"
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v4
       with:
         python-version: ${{ matrix.python-version }}
     - name: Install dependencies

.gitignore

@@ -4,3 +4,6 @@ dist/
 build/
 *.egg-info/
 .github/
+.vscode/
+_config.yml
+.venv

CHANGELOG

@@ -1,7 +1,539 @@
 jc changelog
 
+20250503 v1.25.5
+- Add `amixer` command parser
+- Enhance `iptables` command parser to add default policy statistics fields
+- Fix `bluetoothctl` parser failing to parse controllers with power state prop
+- Fix `lsblk` command parser to support multiple mountpoints. Also, added
+  byte conversions for size fields.
+- Fix `nmcli` command parser to support `team.config` JSON field
+- Fix `time` command parser for output that does not contain centiseconds
+- Fix `x509-cert` parser to handle IDNA2008 encoded email addresses with a warning
+- Fix typing for upcoming python v3.14
+- Fix timezone setting for tests to support minimal chrooted builds
+
+20241125 v1.25.4
+- Add `ipconfig` command parser (`ipconfig` for Windows)
+- Add `pacman` command parser
+- Add `wg show` command parser
+- Enhance `ethtool` parser to support `link_partner_advertised_link_modes`
+- Enhance `ifconfig` parser to support `utun` interfaces with assigned IPv4 addresses on macOS
+- Enhance `nsd-control` parser with additional state fields
+- Enhance `ping-s` streaming parser to support error replies
+- Fix `bluetoothctl` parser when extra attributes like `manufacturer` and `version` exist
+- Fix `df` parser to correctly output binary vs. decimal size outputs
+- Fix `ip-address` parser for Python 3.13 changes to IPv4 mapped IPv6 addresses
+- Fix `iw-scan` parser to output more fields (still beta quality)
+- Fix `mount` parser for cases where there are spaces in the filesystem name
+- Fix `netstat` parser for cases where there are spaces in the program name
+- Fix `pkg-index-deb`, `apt-cache-show`, and  `rpm-qi` parsers to correctly convert contiguous packages with the same name
+- Fix `traceroute` parser to support extreme IPv6 cases
+- Fix `uptime` parser for data that contains `user` instead of `users`
+- Fix `yaml` parser to support values that start with an equal sign
+- Enhance `jc.utils.convert_size_to_int()` to add `posix_mode` and `decimal_bias` parameters
+- Enhance cli to coerce any non-JSON-serializable objects to a string
+
+20240609 v1.25.3
+- Enhance `bluetoothctl` parser with added `battery_percentage` field
+- Enhance `git-log` standard and streaming parsers with added `lines_changed` field under `file_stats`
+- Fix `lspci` parser to handle `physlot` fields with a range value
+- Fix `pci-ids` parser to correctly handle multiple subdevices
+- Fix `pip-show` parser to handle multi-line fields with a beginning blank line
+- Fix `ss` parser to correctly handle the `Recv-Q` field being too close to the `Status` field
+- Fix `top` parsers to quiet uptime info parsing
+- Fix `traceroute` parser to correctly handle hops with multiple IPs
+- Fix `zpool-status` parser for config items lacking data values
+- Optimize some tests by removing timezone settings and using quiet=True
+- Documentation updates
+
+20240323 v1.25.2
+- Add `apt-cache-show` command parser
+- Add `apt-get-sqq` command parser
+- Add `ethtool` command parser
+- Add `needrestart` command parser
+- Enhance `df` parser to add human readable output support. Note: the `size`
+  field has been changed to an integer and all size values have been normalized
+  to bytes.
+- Enhance `free` parser to add human readable output support. All size values
+  have been normalizd to bytes.
+- Enhance `iptables` parser to handle -x output
+- Enhance `/proc/pid/stat` parser to support "Idle" state
+- Enhance `rpm_qi` and `pkg_index_deb` parsers to split list fields into arrays
+- Fix `iwconfig` parser to handle more special characters in the SSID name
+- Fix `xrandr` parser to ignore extra horizontal and vertical stats lines
+- Add aarch64 binaries to Releases for macOS and Linux
+- Documentation and doc build updates
+
+20240212 v1.25.1
+- Fix for crash when optional libraries are not installed (e.g. xmltodict)
+- Fix for `ini` parser crashing with some keys with no values
+- Fix `xrandr` parser to extract more EDID data
+- Enhance `uptime` parser to support output with no user information
+- Enhance `--quiet` CLI option to cover more warning messages
+- Add tests for missing optional libraries
+- Documentation updates
+
+20240204 v1.25.0
+- Add `--slurp` functionality to wrap output from multiple lines into a single array.
+  Note, this only works with single-line input parsers. (e.g. `date`, `ip-address`, `url`, etc.)
+  Streaming parsers are not supported. Use `jc -hhh` to find parsers compatible with the slurp option.
+- Enhance `/proc` file magic syntax to allow slurping when multiple files are selected
+  and to include the `_file` metadata field in the data
+- Enhance `--meta-out` functionality to include a list of the input data when using `--slurp`
+  or `/proc` file magic syntax. For slurpable parsers, this is a list of string inputs in order.
+  For `/proc` file magic syntax, this is a list of `/proc` filenames in order. This can help with
+  identifying which input matches to which output when using `--slurp` or when converting multiple
+  files via `/proc` file magic syntax.
+- Add `curl-head` command parser for `curl --head` or `curl -I` with verbose support
+- Add `efibootmgr` command parser
+- Add `http-headers` parser for plain HTTP header output
+- Add `kv-dup` parser for Key/Value files with duplicate keys
+- Add `path` string parser to parse posix path
+- Add `path-list` string parser to parse path list strings found in env variables
+- Add source link to online parser documentation
+- Add snap package build scripts
+- Add `remove_quotes` function to `utils.py`
+- Add `normalize_key` function to `utils.py`
+- Add `line_slice` function to `utils.py`
+- Add `get_parser` function to `lib.py`
+- Enhance `nsd-control` parser to support more zone information
+- Enhance `ping` and `ping-s` parsers to support the `-I` command option
+- Enhance `proc-net-tcp` parser to add opposite endian support for architectures
+  like the s390x
+- Enhance `url` parser to add `parent`, `filename`, `stem`, and `extension` fields
+- Fix `ini` and `ini-dup` parsers to consistently handle null values as empty strings
+- Fix line slicer to not skip blank lines
+- Refactor parser aliases for `kv`, `pkg_index_deb`, `lsb_release`, and `os-release`
+- Update copyright date
+
+20231216 v1.24.0
+- Add `debconf-show` command parser
+- Add `iftop` command parser
+- Add `pkg-index-apk` parser for Alpine Linux Package Index files
+- Add `pkg-index-deb` parser for Debian/Ubuntu Package Index files
+- Add `proc-cmdline` parser for `/proc/cmdline` file
+- Add `swapon` command parser
+- Add `tune2fs` command parser
+- Remove `iso-datetime` parser deprecated since v1.22.1. (use `datetime-iso` instead)
+- Update timezone change in Github Actions for node v16 requirement
+- Add Python 3.12 tests to Github Actions
+- Refactor `acpi` command parser for code cleanup
+- Refactor vendored libraries to remove Python 2 support
+- Fix `iptables` parser for cases where the `target` field is blank in a rule
+- Fix `vmstat` parsers for some cases where wide output is used
+- Fix `mount` parser for cases with spaces in the mount point name
+- Fix `xrandr` parser for infinite loop issues
+
+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
+
+20220103 v1.17.6
+- Add jar-manifest file parser (for MANIFEST.MF files)
+- Fix CSV parsers for some files that include doublequotes
+
+20211221 v1.17.5
+- Add zipinfo parser tested on linux and macOS
+
+20211207 v1.17.4
+- Add support for the NO_COLOR environment variable to set mono (http://no-color.org/)
+- Add -C option to force color output even when using pipes (overrides -m and NO_COLOR)
+
+20211202 v1.17.3
+- Update parsers to exit with error if non-string input is detected (raise TypeError)
+- Update streaming parsers to exit with error if non-iterable input is detected (raise TypeError)
+- Simplify quiet-checking in parsers
+- Add iostat parser tested on linux
+- Add iostat streaming parser tested on linux
+
+20211117 v1.17.2
+- Fix ping parser to add Alpine linux support
+- Fix netstat parser for older versions of netstat on linux
+- Fix df parser for cases where the filesystem field overflows the column length
+
+20211030 v1.17.1
+- Fix file parser for gzip files
+- Fix uname parser for cases where the 'processor' and/or 'hardware_platform' fields are missing on linux
+- Fix uname parser on FreeBSD
+- Add lsusb parser tested on linux
+- Add CSV file streaming parser
+- Add testing for Python 3.10.0
+
+20210923 v1.17.0
+- Note to Package Maintainers: please see note at 20210720 v1.16.0
+- Add wrapping of warning and error messages
+- Add vmstat parser tested on linux
+- Add support for streaming parsers
+- Add ls command streaming parser tested on linux, macOS, and freeBSD
+- Add ping command streaming parser tested on linux, macOS, and freeBSD
+- Add vmstat command streaming parser tested on linux
+- Add -u option to allow unbuffered output
+
+20210830 v1.16.2
+- Note to Package Maintainers: please see note at 20210720 v1.16.0
+- Update sfdisk parser to support the -F option and newer versions of sfdisk
+
+20210813 v1.16.1
+- Note to Package Maintainers: please see note at 20210720 v1.16.0
+- Fix issue with process substitution with the magic syntax
+- Fix issue with globs not including filenames with spaces with magic syntax
+- Fix stat parser to properly handle filenames with spaces on macOS/BSD
+
+20210720 v1.16.0
+- Note to Package Maintainers:
+    TL;DR: `/man/jc.1.gz` and `/jc/man/jc.1.gz` are deprecated and only `/man/jc.1` should be used.
+
+    The Man page in the PyPi source packages will be moving from `/jc/man/jc.1.gz` to `/man/jc.1`
+    in version 1.17.0. For now the Man pages will be available in both locations, but be aware that
+    the Man page at `/jc/man/jc.1.gz` is now considered deprecated.
+
+    Also, starting in v1.17.0, the Man page will no longer be compressed in the source package,
+    therefore `/man/jc.1.gz` should also be considered deprecated and will no longer be available
+    after v1.17.0. Please use `/man/jc.1` and compress downstream if you would like.
+- Include CHANGELOG in source distribution
+- Fix Man page location in source packages
+- Add sfdisk command parser tested on linux
+- Update unit test files to change the timezone when needed (POSIX only)
+- Binaries and DEB/RPM/MSI packages now include Python 3.9.5 interpreter
+
 20210628 v1.15.6
-- Fix issue to only load local plugin parsers that have filenames that end in .py 
+- Fix issue to only load local plugin parsers that have filenames that end in .py
 
 20210520 v1.15.5
 - Fix issue where help and about information would not display if a 3rd party parser library was missing. (e.g. xmltodict)
@@ -248,16 +780,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
 
@@ -265,27 +797,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
@@ -298,8 +830,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
 
@@ -312,7 +844,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
@@ -325,11 +857,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

CONTRIBUTING.md

@@ -1,5 +1,6 @@
 # Contributing to jc
-We love your input! We want to make contributing to this project as easy and transparent as possible, whether it's:
+We love your input! We want to make contributing to this project as easy and
+transparent as possible, whether it's:
 
 - Reporting a bug
 - Discussing the current state of the code
@@ -8,71 +9,154 @@ We love your input! We want to make contributing to this project as easy and tra
 - Proposing a new parser
 
 ## We Develop with Github
-We use github to host code, to track issues and feature requests, as well as accept pull requests.
+We use github to host code, to track issues and feature requests, as well as
+accept pull requests.
 
 ## We Use Github Flow, So All Code Changes Happen Through Pull Requests
-Pull requests are the best way to propose changes to the codebase (we use [Github Flow](https://guides.github.com/introduction/flow/index.html)). We actively welcome your pull requests:
+Pull requests are the best way to propose changes to the codebase (we use
+[Github Flow](https://guides.github.com/introduction/flow/index.html)). We
+actively welcome your pull requests:
 
-1. Open an issue to discuss the new feature, bug fix, or parser before opening a pull request. For new parsers, it is important to agree upon a schema before developing the parser.
-2. Fork the repo and create your branch from `dev`, if available, otherwise `master`.
-3. If you've added code that should be tested, add tests. All new parsers should have several sample outputs and tests.
-4. Documentation is auto-generated from docstrings, so ensure they are clear and accurate.
-5. Ensure the test suite passes. (Note: "**America/Los_Angeles**" timezone should be configured on the test system)
-6. Make sure your code lints.
-7. Issue that pull request!
+1. Open an issue to discuss the new feature, bug fix, or parser before opening
+   a pull request. For new parsers, it is important to agree upon a schema
+   before developing the parser.
+2. Fork the repo and create your branch from `dev`, if available, otherwise
+   `master`.
+3. For new parsers:
+   - Templates: Use the [`jc/parsers/foo.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/foo.py)
+     or [`jc/parsers/foo_s.py (streaming)`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/foo_s.py)
+     parsers as a template to get started.
+   - Local development: You can even place a new parser python module file in
+     the [parser plugin directory](https://github.com/kellyjonbrazil/jc#parser-plugins)
+     to get started right away with just a standard `jc` installation.
+   - Parser registry: Add the parser name to the [jc/lib.py](https://github.com/kellyjonbrazil/jc/blob/master/jc/lib.py)
+     file.
+4. If you've added code that should be tested, add tests. All new parsers should
+   have several sample outputs and tests.
+   - Templates:
+     - **Recommended:** [tests/templates/_test_foo_simple.py](https://github.com/kellyjonbrazil/jc/tree/master/tests/templates/_test_foo_simple.py) as a template if you only have test with fixtures.
+       Execute these steps for standard tests:
+       - Save this file as `test_{parser_name}.py` since the helper methods extract parser names from the filename. Use underscores instead of dashes for the parser name.
+       - Organize fixtures in `tests/fixtures` for optimal structure.
+       - Format fixtures as follows (using double dashes):
+           - `{parser_name}--{some_test_description}.out` for command output. (no dots in the filename except for the `.out` suffix)
+           - `{parser_name}--{some_test_description}.json` for expected JSON after parsing. (no dots in the filename except for the `.json` suffix)
+     - Custom: [tests/templates/_test_foo.py](https://github.com/kellyjonbrazil/jc/blob/master/tests/templates/_test_foo.py) as a template for tests.
+     - Custom: [tests/templates/_test_foo_s.py](https://github.com/kellyjonbrazil/jc/tree/master/tests/templates/_test_foo_s.py) as a template for **streaming parser** tests.
+   - Fixtures: Tests typically consist of an input file and an expected output
+     JSON file. Add the data files to the appropriate folder under [tests/fixtures](https://github.com/kellyjonbrazil/jc/tree/master/tests/fixtures)
+5. Documentation is auto-generated from docstrings, so ensure they are clear and
+   accurate.
+6. Ensure the test suite passes. (Note: "**America/Los_Angeles**" timezone
+   should be configured on the test system)
+7. Make sure your code lints.
+8. Issue that pull request!
+
+## Documentation And Completions
+
+No need to worry about documentation and completions as those are auto generated
+via the python doc strings.
 
 ## Parser Schema Guidelines
-- Try to keep the schema as flat as possible - typically a list of flat dictionaries
-- Keys should be lowercase, contain no special characters, and spaces should be converted to underscores
-- Keys should be static, if possible. If they have to be dynamic, then they should not contain lists or dictionaries
+- Try to keep the schema as flat as possible - typically a list of flat
+  dictionaries
+- Keys should be lowercase, contain no special characters, and spaces should be
+  converted to underscores
+- Keys should be static, if possible. If they have to be dynamic, then they
+  should not contain lists or dictionaries
 
-This will make it easier to use tools like `jq` without requiring escaping of special characters, encapsulating key names in [""], keeps paths predictable, and makes iterating and searching for values easier.
+This will make it easier to use tools like `jq` without requiring escaping of
+special characters, encapsulating key names in `[""]`, keeps paths predictable,
+and makes iterating and searching for values easier.
 
 **Examples**
 
 Bad:
-```
+```json
 {
   "Interface 1": [
-    192.168.1.1,
-    172.16.1.1
+    "192.168.1.1",
+    "172.16.1.1"
   ],
   "Wifi Interface 1": [
-    10.1.1.1
+    "10.1.1.1"
   ]
 }
 ```
 Good:
-```
+```json
 [
   {
     "interface": "Interface 1",
     "ip_addresses": [
-      192.168.1.1,
-      172.16.1.1
+      "192.168.1.1",
+      "172.16.1.1"
     ]
   },
   {
     "interface": "Wifi Interface 1",
     "ip_addresses": [
-      10.1.1.1
+      "10.1.1.1"
     ]
   }
 ]
 ```
 
-## Tests
-It is essential to have good command output sample coverage and tests to keep the `jc` parser quality high.
+## Development Environment
+Use the following steps to set up the development environment.
 
-Many parsers include calculated timestamp fields using the `jc.utils.timestamp` class. Naive timestamps created with this class should be generated on a system configured with the "**America/Los_Angeles**" timezone on linux/macOS/unix and "**Pacific Standard Time**" timezone on Windows for tests to pass on the Github Actions CI tests. This timezone should be configured on your local system before running the tests locally, as well.
+### Virtual Environment
+Set up a Python virtual environment for `jc` development so you won't have to
+worry about library conflicts. This can be done with something like
+[pyenv](https://github.com/pyenv/pyenv) and/or
+[venv](https://docs.python.org/3/library/venv.html)
+
+### Clone the repo
+Once the virtual environment is set up, clone the `jc` repository inside:
+
+```bash
+git clone https://github.com/kellyjonbrazil/jc.git
+```
+
+### Install In Developer Mode
+Next, use the `./install.sh` script to install `jc` and the requirements in
+developer mode (code chages take effect immediately). This will install the
+console-script entry point to `$HOME/.local/bin` so you may need to add this
+to your path.
+
+## Tests
+It is essential to have good command output sample coverage and tests to keep
+the `jc` parser quality high.
+
+Many parsers include calculated timestamp fields using the `jc.utils.timestamp`
+class. Naive timestamps created with this class should be generated on a system
+configured with the "**America/Los_Angeles**" timezone on linux/macOS/unix and
+"**Pacific Standard Time**" timezone on Windows for tests to pass on the Github
+Actions CI tests. This timezone should be configured on your local system before
+running the tests locally, as well.
+
+You can run all tests by running the `./runtests.sh` script.
+
+## Debug Messages
+
+Use `--debug` or `-d` to see debug error messages (double to see more):
+
+```shell
+echo 'abc' | jc --parser-with-error -dd
+```
 
 ## Any contributions you make will be under the MIT Software License
-In short, when you submit code changes, your submissions are understood to be under the same [MIT License](http://choosealicense.com/licenses/mit/) that covers the project. Feel free to contact the maintainers if that's a concern.
+In short, when you submit code changes, your submissions are understood to be
+under the same [MIT License](http://choosealicense.com/licenses/mit/) that
+covers the project. Feel free to contact the maintainers if that's a concern.
 
 ## Report bugs using Github's Issues
-We use GitHub issues to track public bugs. Report a bug by [opening a new issue](https://github.com/kellyjonbrazil/jc/issues); it's that easy!
+We use GitHub issues to track public bugs. Report a bug by
+[opening a new issue](https://github.com/kellyjonbrazil/jc/issues); it's that
+easy!
 
 ## Write bug reports with detail, background, and sample code
+
 **Great Bug Reports** tend to have:
 
 - A quick summary and/or background
@@ -81,8 +165,10 @@ We use GitHub issues to track public bugs. Report a bug by [opening a new issue]
   - Give sample code if you can.
 - What you expected would happen
 - What actually happens
-- Notes (possibly including why you think this might be happening, or stuff you tried that didn't work)
+- Notes (possibly including why you think this might be happening, or stuff you
+  tried that didn't work)
 
 ## Use a Consistent Coding Style
+
 * 4 spaces for indentation rather than tabs
 * Use a Python linter that will enforce PEP 8 and other best practices

MANIFEST.in

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

README-snap.md

@@ -0,0 +1,75 @@
+# How to use `jc` with `snap`
+
+## How to build `snap` package
+
+- Install `snapd`. [One](https://snapcraft.io/docs/installing-snapd) or [two](https://github.com/don-rumata/ansible-role-install-snap).
+
+- Install `snapcraft`:
+
+```bash
+$ sudo snap install snapcraft --classic
+```
+
+- Update snapd:
+
+```bash
+$ sudo snap refresh snapcraft --edge
+```
+
+- Clone the repo:
+
+```bash
+$ git clone https://github.com/kellyjonbrazil/jc
+```
+
+- Change the directory:
+
+```bash
+$ cd ./jc
+```
+
+- Select branch:
+
+```bash
+$ git checkout snap-support
+```
+
+- Initialize LXD:
+
+```bash
+$ lxd init --auto
+```
+
+- Build `.snap` file:
+
+```bash
+$ snapcraft
+```
+
+## How to install local snap file
+
+```bash
+$ snap install --dangerous ./jc_*_amd64.snap
+```
+
+## How to use `jc` with plugins
+
+- Put your plugin in the `"$HOME/.local/share/jc"` directory.
+
+- To connect the directory, run:
+
+```bash
+snap connect jc:dot-jc-plugins snapd
+```
+
+## Urls
+
+- <https://snapcraft.io/docs/supported-interfaces>
+
+- <https://snapcraft.io/docs/interface-management>
+
+- <https://snapcraft.io/docs/personal-files-interface>
+
+- <https://snapcraft.io/docs/python-apps>
+
+- <https://documentation.ubuntu.com/lxd/en/latest/getting_started/>

_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 amixer apt-cache apt-get arp blkid bluetoothctl cbt certbot chage cksum crontab curl date debconf-show df dig dmidecode dpkg du efibootmgr env ethtool file findmnt finger free git gpg hciconfig host id ifconfig iostat ip ipconfig iptables iw iwconfig jobs last lastb ls lsattr lsb_release lsblk lsmod lsof lspci lsusb md5 md5sum mdadm mount mpstat needrestart netstat nmcli nsd-control ntpq os-prober pacman pidstat ping ping6 pip pip3 postconf printenv ps route rpm rsync sfdisk sha1sum sha224sum sha256sum sha384sum sha512sum shasum ss ssh sshd stat sum swapon sysctl systemctl systeminfo timedatectl top tracepath tracepath6 traceroute traceroute6 tune2fs udevadm ufw uname update-alternatives upower uptime vdir veracrypt vmstat w wc wg who xrandr zipinfo zpool)
+    jc_parsers=(--acpi --airport --airport-s --amixer --apt-cache-show --apt-get-sqq --arp --asciitable --asciitable-m --blkid --bluetoothctl --cbt --cef --cef-s --certbot --chage --cksum --clf --clf-s --crontab --crontab-u --csv --csv-s --curl-head --date --datetime-iso --debconf-show --df --dig --dir --dmidecode --dpkg-l --du --efibootmgr --email-address --env --ethtool --file --find --findmnt --finger --free --fstab --git-log --git-log-s --git-ls-remote --gpg --group --gshadow --hash --hashsum --hciconfig --history --host --hosts --http-headers --id --ifconfig --ini --ini-dup --iostat --iostat-s --ip-address --ipconfig --iptables --ip-route --iw-scan --iwconfig --jar-manifest --jobs --jwt --kv --kv-dup --last --ls --ls-s --lsattr --lsb-release --lsblk --lsmod --lsof --lspci --lsusb --m3u --mdadm --mount --mpstat --mpstat-s --needrestart --netstat --nmcli --nsd-control --ntpq --openvpn --os-prober --os-release --pacman --passwd --path --path-list --pci-ids --pgpass --pidstat --pidstat-s --ping --ping-s --pip-list --pip-show --pkg-index-apk --pkg-index-deb --plist --postconf --proc --proc-buddyinfo --proc-cmdline --proc-consoles --proc-cpuinfo --proc-crypto --proc-devices --proc-diskstats --proc-filesystems --proc-interrupts --proc-iomem --proc-ioports --proc-loadavg --proc-locks --proc-meminfo --proc-modules --proc-mtrr --proc-pagetypeinfo --proc-partitions --proc-slabinfo --proc-softirqs --proc-stat --proc-swaps --proc-uptime --proc-version --proc-vmallocinfo --proc-vmstat --proc-zoneinfo --proc-driver-rtc --proc-net-arp --proc-net-dev --proc-net-dev-mcast --proc-net-if-inet6 --proc-net-igmp --proc-net-igmp6 --proc-net-ipv6-route --proc-net-netlink --proc-net-netstat --proc-net-packet --proc-net-protocols --proc-net-route --proc-net-tcp --proc-net-unix --proc-pid-fdinfo --proc-pid-io --proc-pid-maps --proc-pid-mountinfo --proc-pid-numa-maps --proc-pid-smaps --proc-pid-stat --proc-pid-statm --proc-pid-status --ps --resolve-conf --route --rpm-qi --rsync --rsync-s --semver --sfdisk --shadow --srt --ss --ssh-conf --sshd-conf --stat --stat-s --swapon --sysctl --syslog --syslog-s --syslog-bsd --syslog-bsd-s --systemctl --systemctl-lj --systemctl-ls --systemctl-luf --systeminfo --time --timedatectl --timestamp --toml --top --top-s --tracepath --traceroute --tune2fs --udevadm --ufw --ufw-appinfo --uname --update-alt-gs --update-alt-q --upower --uptime --url --ver --veracrypt --vmstat --vmstat-s --w --wc --wg-show --who --x509-cert --x509-csr --xml --xrandr --yaml --zipinfo --zpool-iostat --zpool-status)
+    jc_options=(--force-color -C --debug -d --monochrome -m --meta-out -M --pretty -p --quiet -q --raw -r --slurp -s --unbuffer -u --yaml-out -y)
+    jc_about_options=(--about -a)
+    jc_about_mod_options=(--pretty -p --yaml-out -y --monochrome -m --force-color -C)
+    jc_help_options=(--help -h)
+    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,486 @@
+#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 amixer apt-cache apt-get arp blkid bluetoothctl cbt certbot chage cksum crontab curl date debconf-show df dig dmidecode dpkg du efibootmgr env ethtool file findmnt finger free git gpg hciconfig host id ifconfig iostat ip ipconfig iptables iw iwconfig jobs last lastb ls lsattr lsb_release lsblk lsmod lsof lspci lsusb md5 md5sum mdadm mount mpstat needrestart netstat nmcli nsd-control ntpq os-prober pacman pidstat ping ping6 pip pip3 postconf printenv ps route rpm rsync sfdisk sha1sum sha224sum sha256sum sha384sum sha512sum shasum ss ssh sshd stat sum swapon sysctl systemctl systeminfo timedatectl top tracepath tracepath6 traceroute traceroute6 tune2fs udevadm ufw uname update-alternatives upower uptime vdir veracrypt vmstat w wc wg who xrandr zipinfo zpool)
+    jc_commands_describe=(
+        'acpi:run "acpi" command with magic syntax.'
+        'airport:run "airport" command with magic syntax.'
+        'amixer:run "amixer" command with magic syntax.'
+        'apt-cache:run "apt-cache" command with magic syntax.'
+        'apt-get:run "apt-get" 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.'
+        'curl:run "curl" command with magic syntax.'
+        'date:run "date" command with magic syntax.'
+        'debconf-show:run "debconf-show" command with magic syntax.'
+        'df:run "df" command with magic syntax.'
+        '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.'
+        'efibootmgr:run "efibootmgr" command with magic syntax.'
+        'env:run "env" command with magic syntax.'
+        'ethtool:run "ethtool" 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.'
+        'ipconfig:run "ipconfig" 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.'
+        'needrestart:run "needrestart" 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.'
+        'pacman:run "pacman" 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.'
+        'swapon:run "swapon" 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.'
+        'tune2fs:run "tune2fs" 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.'
+        'wg:run "wg" 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 --amixer --apt-cache-show --apt-get-sqq --arp --asciitable --asciitable-m --blkid --bluetoothctl --cbt --cef --cef-s --certbot --chage --cksum --clf --clf-s --crontab --crontab-u --csv --csv-s --curl-head --date --datetime-iso --debconf-show --df --dig --dir --dmidecode --dpkg-l --du --efibootmgr --email-address --env --ethtool --file --find --findmnt --finger --free --fstab --git-log --git-log-s --git-ls-remote --gpg --group --gshadow --hash --hashsum --hciconfig --history --host --hosts --http-headers --id --ifconfig --ini --ini-dup --iostat --iostat-s --ip-address --ipconfig --iptables --ip-route --iw-scan --iwconfig --jar-manifest --jobs --jwt --kv --kv-dup --last --ls --ls-s --lsattr --lsb-release --lsblk --lsmod --lsof --lspci --lsusb --m3u --mdadm --mount --mpstat --mpstat-s --needrestart --netstat --nmcli --nsd-control --ntpq --openvpn --os-prober --os-release --pacman --passwd --path --path-list --pci-ids --pgpass --pidstat --pidstat-s --ping --ping-s --pip-list --pip-show --pkg-index-apk --pkg-index-deb --plist --postconf --proc --proc-buddyinfo --proc-cmdline --proc-consoles --proc-cpuinfo --proc-crypto --proc-devices --proc-diskstats --proc-filesystems --proc-interrupts --proc-iomem --proc-ioports --proc-loadavg --proc-locks --proc-meminfo --proc-modules --proc-mtrr --proc-pagetypeinfo --proc-partitions --proc-slabinfo --proc-softirqs --proc-stat --proc-swaps --proc-uptime --proc-version --proc-vmallocinfo --proc-vmstat --proc-zoneinfo --proc-driver-rtc --proc-net-arp --proc-net-dev --proc-net-dev-mcast --proc-net-if-inet6 --proc-net-igmp --proc-net-igmp6 --proc-net-ipv6-route --proc-net-netlink --proc-net-netstat --proc-net-packet --proc-net-protocols --proc-net-route --proc-net-tcp --proc-net-unix --proc-pid-fdinfo --proc-pid-io --proc-pid-maps --proc-pid-mountinfo --proc-pid-numa-maps --proc-pid-smaps --proc-pid-stat --proc-pid-statm --proc-pid-status --ps --resolve-conf --route --rpm-qi --rsync --rsync-s --semver --sfdisk --shadow --srt --ss --ssh-conf --sshd-conf --stat --stat-s --swapon --sysctl --syslog --syslog-s --syslog-bsd --syslog-bsd-s --systemctl --systemctl-lj --systemctl-ls --systemctl-luf --systeminfo --time --timedatectl --timestamp --toml --top --top-s --tracepath --traceroute --tune2fs --udevadm --ufw --ufw-appinfo --uname --update-alt-gs --update-alt-q --upower --uptime --url --ver --veracrypt --vmstat --vmstat-s --w --wc --wg-show --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'
+        '--amixer:`amixer` command parser'
+        '--apt-cache-show:`apt-cache show` command parser'
+        '--apt-get-sqq:`apt-get -sqq` 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'
+        '--curl-head:`curl --head` command parser'
+        '--date:`date` command parser'
+        '--datetime-iso:ISO 8601 Datetime string parser'
+        '--debconf-show:`debconf-show` command 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'
+        '--efibootmgr:`efibootmgr` command parser'
+        '--email-address:Email Address string parser'
+        '--env:`env` command parser'
+        '--ethtool:`ethtool` 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'
+        '--http-headers:HTTP headers 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'
+        '--ipconfig:`ipconfig` Windows command 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'
+        '--kv-dup:Key/Value with duplicate key file and string parser'
+        '--last:`last` and `lastb` command parser'
+        '--ls:`ls` command parser'
+        '--ls-s:`ls` command streaming parser'
+        '--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'
+        '--needrestart:`needrestart -b` command 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'
+        '--pacman:`pacman` command parser'
+        '--passwd:`/etc/passwd` file parser'
+        '--path:POSIX path string parser'
+        '--path-list:POSIX path list string parser'
+        '--pci-ids:`pci.ids` file parser'
+        '--pgpass:PostgreSQL password file parser'
+        '--pidstat:`pidstat -H` command parser'
+        '--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'
+        '--pkg-index-apk:Alpine Linux Package Index file parser'
+        '--pkg-index-deb:Debian Package Index file parser'
+        '--plist:PLIST file parser'
+        '--postconf:`postconf -M` command parser'
+        '--proc:`/proc/` file parser'
+        '--proc-buddyinfo:`/proc/buddyinfo` file parser'
+        '--proc-cmdline:`/proc/cmdline` 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'
+        '--swapon:`swapon` command 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'
+        '--tune2fs:`tune2fs -l` 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'
+        '--wg-show:`wg show` 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 --slurp -s --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'
+        '--slurp:slurp multiple lines into an array'
+        '-s:slurp multiple lines into an array'
+        '--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
+

doc2md.py

@@ -0,0 +1,86 @@
+#!/usr/bin/env python3
+
+"""
+Convert parser doc string to markdown
+"""
+import sys
+import importlib
+from inspect import isfunction, signature, cleandoc
+import yapf  # type: ignore
+
+ignore_lib_functions = [
+    'cast',
+    'wraps',
+    'lru_cache',
+    'namedtuple'
+]
+
+mod_path = sys.argv[1]
+mod_name = mod_path.split('.')[-1]
+module = importlib.import_module(f'{mod_path}')
+
+######## HEADER ########
+header = f'''[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="{mod_path}"></a>
+
+# {mod_path}
+'''
+
+summary = module.__doc__ or ''
+
+functions = []
+for attribute in dir(module):
+    if isfunction(getattr(module, attribute)) \
+        and not getattr(module, attribute).__name__.startswith('_'):
+
+        if 'jc.parsers.' in mod_path and not 'universal' in mod_path:
+            if attribute == 'parse':
+                functions.append(attribute)
+
+        else:
+            if not attribute in ignore_lib_functions:
+                functions.append(attribute)
+
+######## TABLE OF CONTENTS ########
+toc = f'## Table of Contents\n\n* [{mod_path}](#{mod_path})\n'
+for api in functions:
+    toc = f'{toc}  * [{api}](#{mod_path}.{api})\n'
+
+######## API DOCS ########
+api_docs = ''
+for api in functions:
+    api_function = getattr(module, api)
+
+    this_header = f'<a id="{mod_path}.{api}"></a>\n\n### {api}\n'
+    this_sig = str(signature(api_function))
+    formatted_sig = yapf.yapf_api.FormatCode(f'def {api_function.__name__}{this_sig}:\n    pass' )
+    formatted_sig = formatted_sig[0].split(':\n    pass')[0]
+    this_name_and_sig = f'{this_header}\n```python\n{formatted_sig}\n```'
+
+    this_doc = cleandoc(api_function.__doc__)
+    api_docs = api_docs + this_name_and_sig + '\n\n' + this_doc + '\n\n'
+
+######## FOOTER ########
+footer = ''
+if 'jc.parsers.' in mod_path and not 'universal' in mod_path:
+    footer = '### Parser Information\n'
+    comp = ', '.join(module.info.compatible)
+    ver = module.info.version
+    author = module.info.author
+    author_email = module.info.author_email
+    slurpable = 'slurpable' in module.info.tags
+    footer = footer + f'Compatibility:  {comp}\n\n'
+    footer = footer + f'Source: [`jc/parsers/{mod_name}.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/{mod_name}.py)\n\n'
+    if slurpable:
+        footer = footer + 'This parser can be used with the `--slurp` command-line option.\n\n'
+    footer = footer + f'Version {ver} by {author} ({author_email})'
+
+final_doc = ''
+if 'jc.parsers.' in mod_path and not 'universal' in mod_path:
+    final_doc = header + '\n' + summary + '\n' + api_docs + footer
+elif mod_path == 'jc':
+    final_doc = header + '\n' + summary
+else:
+    final_doc = header + '\n' + toc + '\n' + summary + '\n\n' + api_docs
+
+print(final_doc)

docgen.sh

@@ -1,37 +1,53 @@
 #!/bin/bash
-# Generate docs.md
-# requires pydoc-markdown 2.1.0.post1
+# Generate markdown document files (*.md)
+# Requires the yapf python library
+# use ./docgen all to generate all docs
 
 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
+    ../doc2md.py jc > ../docs/readme.md && echo "+++ package docs complete" || echo "*** PACKAGE DOCS FAILED ***"
+) &
+
+(
+    echo Building docs for: lib
+    ../doc2md.py jc.lib > ../docs/lib.md && echo "+++ lib docs complete" || echo "*** LIB DOCS FAILED ***"
+) &
+
+(
+    echo Building docs for: utils
+    ../doc2md.py jc.utils > ../docs/utils.md && echo "+++ utils docs complete" || echo "*** UTILS DOCS FAILED ***"
+) &
+
+(
+    echo Building docs for: streaming
+    ../doc2md.py jc.streaming > ../docs/streaming.md && echo "+++ streaming docs complete" || echo "*** STREAMING DOCS FAILED ***"
+) &
+
+(
+    echo Building docs for: universal parser
+    ../doc2md.py jc.parsers.universal > ../docs/parsers/universal.md && echo "+++ universal parser docs complete" || echo "*** UNIVERSAL PARSER DOCS FAILED ***"
+) &
 
 # 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")
-
-    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
+        {
+            if [[ $1 == "all" ]] || ! git diff --quiet --exit-code HEAD~5 -- "parsers/${parser_name}.py"; then
+                echo "Building docs for: ${parser_name}"
+                ../doc2md.py jc.parsers."${parser_name}" > ../docs/parsers/"${parser_name}".md && echo "+++ ${parser_name} docs complete" || echo "*** ${parser_name} DOCS FAILED ***"
+            fi
+        } &
 done
+wait
+echo "Document Generation Complete"

docs/_config.yml

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

docs/lib.md

@@ -0,0 +1,274 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.lib"></a>
+
+# jc.lib
+
+## Table of Contents
+
+* [jc.lib](#jc.lib)
+  * [all_parser_info](#jc.lib.all_parser_info)
+  * [get_help](#jc.lib.get_help)
+  * [get_parser](#jc.lib.get_parser)
+  * [parse](#jc.lib.parse)
+  * [parser_info](#jc.lib.parser_info)
+  * [parser_mod_list](#jc.lib.parser_mod_list)
+  * [plugin_parser_mod_list](#jc.lib.plugin_parser_mod_list)
+  * [slurpable_parser_mod_list](#jc.lib.slurpable_parser_mod_list)
+  * [standard_parser_mod_list](#jc.lib.standard_parser_mod_list)
+  * [streaming_parser_mod_list](#jc.lib.streaming_parser_mod_list)
+
+jc - JSON Convert lib module
+
+<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[jc.jc_types.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, module]) -> 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.
+
+<a id="jc.lib.get_parser"></a>
+
+### get_parser
+
+```python
+def get_parser(parser_mod_name: Union[str, module]) -> module
+```
+
+Return the parser module object and check that the module is a valid
+parser module.
+
+Parameters:
+
+    parser_mod_name:    (string or   Name of the parser module. This
+                        Module)      function will accept module_name,
+                                     cli-name, and --argument-name
+                                     variants of the module name.
+
+                                     If a Module is given and the Module
+                                     is a valid parser Module, then the
+                                     same Module is returned.
+
+Returns:
+
+    Module:  the parser Module object
+
+Raises:
+
+    ModuleNotFoundError:  If the Module is not found or is not a valid
+                          parser Module, then a ModuleNotFoundError
+                          exception is raised.
+
+<a id="jc.lib.parse"></a>
+
+### parse
+
+```python
+def parse(
+    parser_mod_name: Union[str, module],
+    data: Union[str, bytes, Iterable[str]],
+    quiet: bool = False,
+    raw: bool = False,
+    ignore_exceptions: Optional[bool] = None,
+    **kwargs
+) -> Union[Dict[str, Any], List[Dict[str, Any]], Iterator[Dict[str, Any]]]
+```
+
+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
+    >>> jc_date = jc.get_parser('date')
+    >>> date_obj = jc.parse(jc_date, 'Tue Jan 18 10:23:07 PST 2022')
+    >>> print(f'The year is: {date_obj["year"]}')
+    The year is: 2022
+
+You can also use the parser modules directly via `get_parser()`:
+
+    >>> import jc
+    >>> jc_date = jc.get_parser('date')
+    >>> date_obj = jc_date.parse('Tue Jan 18 10:23:07 PST 2022')
+    >>> print(f'The year is: {date_obj["year"]}')
+    The year is: 2022
+
+Finally, you can access the low-level parser modules manually:
+
+    >>> import jc.parsers.date
+    >>> date_obj = jc.parsers.date.parse('Tue Jan 18 10:23:07 PST 2022')
+    >>> print(f'The year is: {date_obj["year"]}')
+    The year is: 2022
+
+Though, accessing plugin parsers directly is a bit more cumbersome, so
+this higher-level API is recommended. Here is how you can access plugin
+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_info"></a>
+
+### parser_info
+
+```python
+def parser_info(parser_mod_name: Union[str, module],
+                documentation: bool = False) -> jc.jc_types.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.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.slurpable_parser_mod_list"></a>
+
+### slurpable_parser_mod_list
+
+```python
+def slurpable_parser_mod_list(show_hidden: bool = False,
+                              show_deprecated: bool = False) -> List[str]
+```
+
+Returns a list of slurpable parser module names. This function is a
+subset of `parser_mod_list()`.
+
+<a id="jc.lib.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()`.
+
+

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,16 @@ 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)
+Source: [`jc/parsers/acpi.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/acpi.py)
+
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,16 @@ 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.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/airport.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/airport.py)
+
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

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 - 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,16 @@ 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.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/airport_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/airport_s.py)
+
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/amixer.md

@@ -0,0 +1,117 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.amixer"></a>
+
+# jc.parsers.amixer
+
+jc - JSON Convert `amixer sget` command output parser
+
+Usage (cli):
+
+    $ amixer sget <control_name> | jc --amixer
+    $ amixer sget Master | jc --amixer
+    $ amixer sget Capture | jc --amixer
+    $ amixer sget Speakers | jc --amixer
+
+Usage (module):
+
+    import jc
+    result = jc.parse('amixer', <amixer_sget_command_output>)
+
+Schema:
+
+    {
+        "control_name":                     string,
+        "capabilities": [
+                                            string
+        ],
+        "playback_channels": [
+                                            string
+        ],
+        "limits": {
+            "playback_min":                 integer,
+            "playback_max":                 integer
+        },
+        "mono": {
+            "playback_value":               integer,
+            "percentage":                   integer,
+            "db":                           float,
+            "status":                       boolean
+        }
+    }
+
+Examples:
+
+    $ amixer sget Master | jc --amixer -p
+    {
+      "control_name": "Capture",
+      "capabilities": [
+        "cvolume",
+        "cswitch"
+      ],
+      "playback_channels": [],
+      "limits": {
+        "playback_min": 0,
+        "playback_max": 63
+      },
+      "front_left": {
+        "playback_value": 63,
+        "percentage": 100,
+        "db": 30.0,
+        "status": true
+      },
+      "front_right": {
+        "playback_value": 63,
+        "percentage": 100,
+        "db": 30.0,
+        "status": true
+      }
+    }
+
+    $ amixer sget Master | jc --amixer -p -r
+    {
+        "control_name": "Master",
+        "capabilities": [
+            "pvolume",
+            "pvolume-joined",
+            "pswitch",
+            "pswitch-joined"
+        ],
+        "playback_channels": [
+            "Mono"
+        ],
+        "limits": {
+            "playback_min": "0",
+            "playback_max": "87"
+        },
+        "mono": {
+            "playback_value": "87",
+            "percentage": "100%",
+            "db": "0.00db",
+            "status": "on"
+        }
+    }
+
+<a id="jc.parsers.amixer.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
+
+Source: [`jc/parsers/amixer.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/amixer.py)
+
+Version 1.0 by Eden Refael (edenraf@hotmail.com)

docs/parsers/apt_cache_show.md

@@ -0,0 +1,180 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.apt_cache_show"></a>
+
+# jc.parsers.apt_cache_show
+
+jc - JSON Convert `apt-cache show` command parser
+
+Usage (cli):
+
+    $ apt-cache show | jc --apt-cache-show
+
+Usage (module):
+
+    import jc
+    result = jc.parse('apt_cache_show', apt_cache_show_output)
+
+Schema:
+
+    [
+      {
+        "package":                string,
+        "version":                string,
+        "installed_size":         integer,
+        "maintainer":             string,
+        "architecture":           string,
+        "depends": [
+                                  string
+        ],
+        "pre_depends": [
+                                  string
+        ],
+        "recommends": [
+                                  string
+        ],
+        "suggests": [
+                                  string
+        ],
+        "conflicts": [
+                                  string
+        ],
+        "breaks": [
+                                  string
+        ],
+        "description_md5":        string,
+        "multi_arch":             string,
+        "homepage":               string,
+        "section":                string,
+        "priority":               string,
+        "filename":               string,
+        "size":                   integer,
+        "sha256":                 string,
+        "description":            string
+      }
+    ]
+
+Examples:
+
+    $ apt-cache show | jc --apt-cache-show -p
+    [
+      {
+        "package": "systemd",
+        "version": "247.3-6~bpo10+1",
+        "installed_size": 16121,
+        "maintainer": "Debian systemd Maintainers <pkg-systemd-maintaine..",
+        "architecture": "amd64",
+        "depends": [
+          "libacl1 (>= 2.2.23)",
+          "libapparmor1 (>= 2.13)",
+          "libaudit1 (>= 1:2.2.1)",
+          "libcap2 (>= 1:2.10)",
+          "libcryptsetup12 (>= 2:2.0.1)",
+          "libgnutls30 (>= 3.6.6)",
+          "libgpg-error0 (>= 1.14)",
+          "libip4tc0 (>= 1.6.0+snapshot20161117)",
+          "libkmod2 (>= 5~)",
+          "liblz4-1 (>= 0.0~r130)",
+          "libmount1 (>= 2.30)",
+          "libpam0g (>= 0.99.7.1)",
+          "libseccomp2 (>= 2.3.1)",
+          "libsystemd0 (= 247.3-6~bpo10+1)",
+          "systemd-timesyncd | time-daemon",
+          "util-linux (>= 2.27.1)",
+          "mount (>= 2.26)",
+          "adduser"
+        ],
+        "pre_depends": [
+          "libblkid1 (>= 2.24)",
+          "libc6 (>= 2.28)",
+          "libgcrypt20 (>= 1.8.0)",
+          "liblz4-1 (>= 0.0~r122)",
+          "liblzma5 (>= 5.1.1alpha+20120614)",
+          "libselinux1 (>= 2.1.9)",
+          "libzstd1 (>= 1.4.0)"
+        ],
+        "recommends": [
+          "dbus"
+        ],
+        "suggests": [
+          "systemd-container",
+          "policykit-1"
+        ],
+        "conflicts": [
+          "consolekit",
+          "libpam-ck-connector"
+        ],
+        "breaks": [
+          "python-dbusmock (<< 0.18)",
+          "python3-dbusmock (<< 0.18)",
+          "resolvconf (<< 1.83~)",
+          "systemd-shim (<< 10-4~)",
+          "udev (<< 247~)"
+        ],
+        "description_md5": "19399579cbc0c47a303288bf15eadcd4",
+        "multi_arch": "foreign",
+        "homepage": "https://www.freedesktop.org/wiki/Software/systemd",
+        "section": "admin",
+        "priority": "important",
+        "filename": "pool/main/s/systemd/systemd_247.3-6~bpo10+1_amd64.deb",
+        "size": 4382056,
+        "sha256": "2035450655ad02faa0f75dc952128b503e51df5795c67273c0f6...",
+        "description": "system and service manager  systemd is a system..."
+      },
+      ...
+    ]
+
+    $ apt-cache show | jc --apt-cache-show -p -r
+    [
+      {
+        "package": "systemd",
+        "version": "247.3-6~bpo10+1",
+        "installed_size": "16121",
+        "maintainer": "Debian systemd Maintainers <pkg-systemd-maintain...",
+        "architecture": "amd64",
+        "depends": "libacl1 (>= 2.2.23), libapparmor1 (>= 2.13), libaud...",
+        "pre_depends": "libblkid1 (>= 2.24), libc6 (>= 2.28), libgcrypt...",
+        "recommends": "dbus",
+        "suggests": "systemd-container, policykit-1",
+        "conflicts": "consolekit, libpam-ck-connector",
+        "breaks": "python-dbusmock (<< 0.18), python3-dbusmock (<< 0.18...",
+        "description_md5": "19399579cbc0c47a303288bf15eadcd4",
+        "multi_arch": "foreign",
+        "homepage": "https://www.freedesktop.org/wiki/Software/systemd",
+        "section": "admin",
+        "priority": "important",
+        "filename": "pool/main/s/systemd/systemd_247.3-6~bpo10+1_amd64.deb",
+        "size": "4382056",
+        "sha256": "2035450655ad02faa0f75dc952128b503e51df5795c67273c0f6...",
+        "description": "system and service manager  systemd is a system..."
+      },
+      ...
+    ]
+
+<a id="jc.parsers.apt_cache_show.parse"></a>
+
+### parse
+
+```python
+def parse(data: str,
+          raw: bool = False,
+          quiet: bool = False) -> List[Dict[str, Any]]
+```
+
+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
+
+Source: [`jc/parsers/apt_cache_show.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/apt_cache_show.py)
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/apt_get_sqq.md

@@ -0,0 +1,201 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.apt_get_sqq"></a>
+
+# jc.parsers.apt_get_sqq
+
+jc - JSON Convert `apt-get -sqq` command output parser
+
+Requires the `-sqq` options in `apt-get`.
+
+Usage (cli):
+
+    $ apt-get -sqq upgrade | jc --apt-get-sqq
+
+or
+
+    $ jc apt-get -sqq full-upgrade
+
+Usage (module):
+
+    import jc
+    result = jc.parse('apt_get_sqq', apt_get_sqq_command_output)
+
+Schema:
+
+    [
+      {
+        "operation":            string,       # configure, remove, or unpack
+        "package":              string,
+        "broken":               string/null,
+        "proposed_pkg_ver":     string,
+        "existing_pkg_ver":     string/null,
+        "architecture":         string
+      }
+    ]
+
+Examples:
+
+    $ apt-get -sqq upgrade | jc --apt-get-sqq -p
+    [
+      {
+        "operation": "unpack",
+        "package": "dpkg",
+        "broken": "1.19.7",
+        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
+        "architecture": "amd64"
+      },
+      {
+        "operation": "unpack",
+        "package": "dpkg",
+        "broken": null,
+        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
+        "architecture": "amd64"
+      },
+      {
+        "operation": "configure",
+        "package": "dpkg",
+        "broken": "1.19.7",
+        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
+        "architecture": "amd64"
+      },
+      {
+        "operation": "remove",
+        "package": "dpkg",
+        "broken": "1.19.7",
+        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
+        "architecture": "amd64"
+      },
+      {
+        "operation": "unpack",
+        "package": "base-files",
+        "broken": "10.3+deb10u4",
+        "proposed_pkg_ver": "10.3+deb10u13 Debian:10.13/oldstable",
+        "existing_pkg_ver": null,
+        "architecture": "amd64"
+      },
+      {
+        "operation": "configure",
+        "package": "base-files",
+        "broken": null,
+        "proposed_pkg_ver": "10.3+deb10u13 Debian:10.13/oldstable",
+        "existing_pkg_ver": null,
+        "architecture": "amd64"
+      },
+      {
+        "operation": "unpack",
+        "package": "dpkg",
+        "broken": "1.19.7",
+        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
+        "architecture": "amd64"
+      },
+      {
+        "operation": "configure",
+        "package": "dpkg",
+        "broken": null,
+        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
+        "architecture": "amd64"
+      }
+    ]
+
+    $ apt-get -sqq upgrade | jc --apt-get-sqq -p -r
+    [
+      {
+        "operation": "Inst",
+        "package": "dpkg",
+        "broken": "1.19.7",
+        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
+        "architecture": "amd64"
+      },
+      {
+        "operation": "Inst",
+        "package": "dpkg",
+        "broken": null,
+        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
+        "architecture": "amd64"
+      },
+      {
+        "operation": "Conf",
+        "package": "dpkg",
+        "broken": "1.19.7",
+        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
+        "architecture": "amd64"
+      },
+      {
+        "operation": "Remv",
+        "package": "dpkg",
+        "broken": "1.19.7",
+        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
+        "architecture": "amd64"
+      },
+      {
+        "operation": "Inst",
+        "package": "base-files",
+        "broken": "10.3+deb10u4",
+        "proposed_pkg_ver": "10.3+deb10u13 Debian:10.13/oldstable",
+        "existing_pkg_ver": null,
+        "architecture": "amd64"
+      },
+      {
+        "operation": "Conf",
+        "package": "base-files",
+        "broken": null,
+        "proposed_pkg_ver": "10.3+deb10u13 Debian:10.13/oldstable",
+        "existing_pkg_ver": null,
+        "architecture": "amd64"
+      },
+      {
+        "operation": "Inst",
+        "package": "dpkg",
+        "broken": "1.19.7",
+        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
+        "architecture": "amd64"
+      },
+      {
+        "operation": "Conf",
+        "package": "dpkg",
+        "broken": null,
+        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
+        "architecture": "amd64"
+      }
+    ]
+
+<a id="jc.parsers.apt_get_sqq.parse"></a>
+
+### parse
+
+```python
+def parse(data: str,
+          raw: bool = False,
+          quiet: bool = False) -> List[Dict[str, Any]]
+```
+
+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
+
+Source: [`jc/parsers/apt_get_sqq.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/apt_get_sqq.py)
+
+Version 1.1 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,16 @@ 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.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/arp.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/arp.py)
+
+Version 1.12 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/asciitable.md

@@ -0,0 +1,149 @@
+[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
+
+Source: [`jc/parsers/asciitable.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/asciitable.py)
+
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/asciitable_m.md

@@ -0,0 +1,134 @@
+[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
+
+Source: [`jc/parsers/asciitable_m.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/asciitable_m.py)
+
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,16 @@ 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)
+Source: [`jc/parsers/blkid.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/blkid.py)
+
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/bluetoothctl.md

@@ -0,0 +1,139 @@
+[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:
+    [
+        {
+            "manufacturer":         string,
+            "version":              string,
+            "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,
+            "battery_percentage":   int
+        }
+    ]
+
+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,
+            "battery_percentage": 70
+        }
+    ]
+
+<a id="jc.parsers.bluetoothctl.parse"></a>
+
+### parse
+
+```python
+def parse(data: str,
+          raw: bool = False,
+          quiet: bool = False) -> List[Dict[str, Any]]
+```
+
+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
+
+Source: [`jc/parsers/bluetoothctl.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/bluetoothctl.py)
+
+Version 1.4 by Jake Ob (iakopap at gmail.com)

docs/parsers/cbt.md

@@ -0,0 +1,127 @@
+[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[Dict[str, Any]]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Source: [`jc/parsers/cbt.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/cbt.py)
+
+Version 1.0 by Andreas Weiden (andreas.weiden@gmail.com)

docs/parsers/cef.md

@@ -0,0 +1,148 @@
+[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
+
+Source: [`jc/parsers/cef.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/cef.py)
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/cef_s.md

@@ -0,0 +1,125 @@
+[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
+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
+
+Source: [`jc/parsers/cef_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/cef_s.py)
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/certbot.md

@@ -0,0 +1,163 @@
+[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) -> Dict[str, Any]
+```
+
+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
+
+Source: [`jc/parsers/certbot.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/certbot.py)
+
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/chage.md

@@ -0,0 +1,84 @@
+[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
+
+Source: [`jc/parsers/chage.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/chage.py)
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,16 @@ 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)
+Source: [`jc/parsers/cksum.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/cksum.py)
+
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/clf.md

@@ -0,0 +1,201 @@
+[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[Dict[str, Any]]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Source: [`jc/parsers/clf.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/clf.py)
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/clf_s.md

@@ -0,0 +1,120 @@
+[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
+def parse(
+    data: Iterable[str],
+    raw: bool = False,
+    quiet: bool = False,
+    ignore_exceptions: bool = False
+) -> Iterator[Union[Dict[str, Any], Tuple[BaseException, str]]]
+```
+
+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
+
+Source: [`jc/parsers/clf_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/clf_s.py)
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,25 +12,26 @@ 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:
 
     {
       "variables": [
-        "name":               string,
-        "value":              string
+        {
+          "name":             string,
+          "value":            string
+        }
       ],
       "schedule": [
         {
-          "occurrence"        string,
           "minute": [
                               string
           ],
@@ -168,16 +172,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
@@ -185,14 +185,16 @@ 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.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/crontab.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/crontab.py)
+
+Version 1.9 by Kelly Brazil (kellyjonbrazil@gmail.com)

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
 
-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,19 +15,20 @@ 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:
 
     {
       "variables": [
-        "name":               string,
-        "value":              string
+        {
+          "name":             string,
+          "value":            string
+        }
       ],
       "schedule": [
         {
-          "occurrence"        string,
           "minute": [
                               string
           ],
@@ -53,7 +58,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",
@@ -78,7 +83,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": [
@@ -97,7 +102,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": [
@@ -116,7 +121,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 ..."
         }
       ]
     }
@@ -126,7 +131,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",
@@ -141,7 +146,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",
@@ -150,7 +155,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",
@@ -159,21 +164,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
@@ -181,14 +182,16 @@ 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)
+Source: [`jc/parsers/crontab_u.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/crontab_u.py)
+
+Version 1.10 by Kelly Brazil (kellyjonbrazil@gmail.com)

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[Dict[str, Any]]
 ```
 
 Main text parsing function
@@ -89,14 +92,16 @@ 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.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/csv.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/csv.py)
+
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/csv_s.md

@@ -0,0 +1,90 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.csv_s"></a>
+
+# jc.parsers.csv_s
+
+jc - JSON Convert `csv` file streaming parser
+
+> This streaming parser outputs JSON Lines (cli) or returns an Iterable of
+> Dictionaries (module)
+
+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):
+
+    $ cat file.csv | jc --csv-s
+
+Usage (module):
+
+    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
+
+    {
+      "column_name1":     string,
+      "column_name2":     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
+      }
+    }
+
+Examples:
+
+    $ cat homes.csv
+    "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"...}
+    {"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>
+
+### parse
+
+```python
+def parse(data, raw=False, quiet=False, ignore_exceptions=False)
+```
+
+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
+
+Source: [`jc/parsers/csv_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/csv_s.py)
+
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/curl_head.md

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

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,18 @@ 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.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/date.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/date.py)
+
+This parser can be used with the `--slurp` command-line option.
+
+Version 2.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/datetime_iso.md

@@ -0,0 +1,95 @@
+[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
+
+Source: [`jc/parsers/datetime_iso.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/datetime_iso.py)
+
+This parser can be used with the `--slurp` command-line option.
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/debconf_show.md

@@ -0,0 +1,107 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.debconf_show"></a>
+
+# jc.parsers.debconf_show
+
+jc - JSON Convert `debconf-show` command output parser
+
+Usage (cli):
+
+    $ debconf-show onlyoffice-documentserver | jc --debconf-show
+
+or
+
+    $ jc debconf-show onlyoffice-documentserver
+
+Usage (module):
+
+    import jc
+    result = jc.parse('debconf_show', debconf_show_command_output)
+
+Schema:
+
+    [
+      {
+        "asked":              boolean,
+        "packagename":        string,
+        "name":               string,
+        "value":              string
+      }
+    ]
+
+Examples:
+
+    $ debconf-show onlyoffice-documentserver | jc --debconf-show -p
+    [
+      {
+        "asked": true,
+        "packagename": "onlyoffice",
+        "name": "jwt_secret",
+        "value": "aL8ei2iereuzee7cuJ6Cahjah1ixee2ah"
+      },
+      {
+        "asked": false,
+        "packagename": "onlyoffice",
+        "name": "db_pwd",
+        "value": "(password omitted)"
+      },
+      {
+        "asked": true,
+        "packagename": "onlyoffice",
+        "name": "rabbitmq_pwd",
+        "value": "(password omitted)"
+      },
+      {
+        "asked": true,
+        "packagename": "onlyoffice",
+        "name": "db_port",
+        "value": "5432"
+      },
+      {
+        "asked": true,
+        "packagename": "onlyoffice",
+        "name": "db_user",
+        "value": "onlyoffice"
+      },
+      {
+        "asked": true,
+        "packagename": "onlyoffice",
+        "name": "rabbitmq_proto",
+        "value": "amqp"
+      },
+      {
+        "asked": true,
+        "packagename": "onlyoffice",
+        "name": "cluster_mode",
+        "value": "false"
+      }
+    ]
+
+<a id="jc.parsers.debconf_show.parse"></a>
+
+### parse
+
+```python
+def parse(data: str,
+          raw: bool = False,
+          quiet: bool = False) -> List[Dict[str, Any]]
+```
+
+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
+
+Source: [`jc/parsers/debconf_show.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/debconf_show.py)
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/df.md

@@ -1,27 +1,31 @@
 [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
+
+Values are normalized to bytes when using `df -h`.
 
 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:
 
     [
       {
         "filesystem":        string,
-        "size":              string,
+        "size":              integer,
         "1k_blocks":         integer,
         "512_blocks":        integer,
         "used":              integer,
@@ -95,16 +99,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 +112,16 @@ 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.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/df.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/df.py)
+
+Version 2.1 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,16 @@ 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.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/dig.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/dig.py)
+
+Version 2.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,16 @@ 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.3 by Rasheed Elsaleh (rasheed@rebelliondefense.com)
+Source: [`jc/parsers/dir.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/dir.py)
+
+Version 1.6 by Rasheed Elsaleh (rasheed@rebelliondefense.com)

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,16 @@ 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)
+Source: [`jc/parsers/dmidecode.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/dmidecode.py)
+
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

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
 
-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,16 @@ 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)
+Source: [`jc/parsers/dpkg_l.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/dpkg_l.py)
+
+Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,16 @@ 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)
+Source: [`jc/parsers/du.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/du.py)
+
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/efibootmgr.md

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

docs/parsers/email_address.md

@@ -0,0 +1,71 @@
+[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
+
+Source: [`jc/parsers/email_address.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/email_address.py)
+
+This parser can be used with the `--slurp` command-line option.
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,17 @@ 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.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/env.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/env.py)
+
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ethtool.md

@@ -0,0 +1,197 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.ethtool"></a>
+
+# jc.parsers.ethtool
+
+jc - JSON Convert `ethtool` command output parser
+
+Supports standard `ethtool` output and the `--module-info` option.
+
+Usage (cli):
+
+    $ ethtool <interface> | jc --ethtool
+    $ ethtool --module-info <interface> | jc --ethtool
+
+or
+
+    $ jc ethtool <interface>
+    $ jc ethtool --module-info <interface>
+
+Usage (module):
+
+    import jc
+    result = jc.parse('ethtool', ethtool_command_output)
+
+Schema:
+
+Note: many units fields are converted to integers and floats
+when detected. Use raw output for the original string values.
+
+    {
+      "name":                               string,
+      "supported_ports": [
+                                            string
+      ],
+      "supported_link_modes": [
+                                            string
+      ],
+      "supported_pause_frame_use":          string,
+      "supports_auto_negotiation":          boolean,
+      "supported_fec_modes": [
+                                            string
+      ],
+      "advertised_link_modes": [
+                                            string
+      ],
+      "advertised_pause_frame_use":         boolean,
+      "advertised_auto_negotiation":        boolean,
+      "advertised_fec_modes": [
+                                            string
+      ],
+      "speed":                              string,
+      "speed_bps":                          integer,
+      "duplex":                             string,
+      "auto_negotiation":                   boolean,
+      "port":                               string,
+      "phyad":                              string,
+      "mdi_x":                              string,
+      "transceiver":                        string,
+      "supports_wake_on":                   string,
+      "wake_on":                            string,
+      "current_message_level": [
+                                            string
+      ],
+      "link_detected":                      boolean,
+      "identifier":                         string,
+      "extended_identifier":                string,
+      "connector":                          string,
+      "transceiver_codes":                  string,
+      "transceiver_type": [
+                                            string
+      ],
+      "encoding":                           string,
+      "br_nominal":                         string,
+      "rate_identifier":                    string,
+      "length_smf_km":                      string,
+      "length_smf":                         string,
+      "length_50um":                        string,
+      "length_62_5um":                      string,
+      "length_copper":                      string,
+      "length_om3":                         string,
+      "passive_cu_cmplnce":                 string,
+      "vendor_name":                        string,
+      "vendor_oui":                         string,
+      "vendor_pn":                          string,
+      "vendor_rev":                         string,
+      "option_values":                      string,
+      "br_margin_max":                      string,
+      "br_margin_min":                      string
+    }
+
+Examples:
+
+    $ ethtool enp0s3 | jc --ethtool -p
+    {
+      "name": "enp0s3",
+      "supported_pause_frame_use": "No",
+      "supports_auto_negotiation": true,
+      "supported_fec_modes": "Not reported",
+      "advertised_pause_frame_use": false,
+      "advertised_auto_negotiation": true,
+      "advertised_fec_modes": "Not reported",
+      "speed": "1000Mb/s",
+      "duplex": "Full",
+      "port": "Twisted Pair",
+      "phyad": "0",
+      "transceiver": "internal",
+      "auto_negotiation": false,
+      "mdi_x": "off (auto)",
+      "supports_wake_on": "umbg",
+      "wake_on": "d",
+      "link_detected": true,
+      "supported_ports": [
+        "TP"
+      ],
+      "supported_link_modes": [
+        "10baseT/Half",
+        "10baseT/Full",
+        "100baseT/Half",
+        "100baseT/Full",
+        "1000baseT/Full"
+      ],
+      "advertised_link_modes": [
+        "10baseT/Half",
+        "10baseT/Full",
+        "100baseT/Half",
+        "100baseT/Full",
+        "1000baseT/Full"
+      ],
+      "current_message_level": [
+        "0x00000007 (7)",
+        "drv probe link"
+      ],
+      "speed_bps": 1000000000
+    }
+
+    $ ethtool --module-info enp0s3 | jc --ethtool -p
+    {
+      "identifier": "0x03 (SFP)",
+      "extended_identifier": "0x04 (GBIC/SFP defined by 2-wire interface ID)",
+      "connector": "0x21 (Copper pigtail)",
+      "transceiver_codes": "0x01 0x00 0x00 0x04 0x00 0x04 0x80 0xd5 0x00",
+      "transceiver_type": [
+        "Infiniband: 1X Copper Passive",
+        "Ethernet: 1000BASE-CX",
+        "Passive Cable",
+        "FC: Twin Axial Pair (TW)",
+        "FC: 1200 MBytes/sec",
+        "FC: 800 MBytes/sec",
+        "FC: 400 MBytes/sec",
+        "FC: 200 MBytes/sec",
+        "FC: 100 MBytes/sec"
+      ],
+      "encoding": "0x00 (unspecified)",
+      "br_nominal": "10300MBd",
+      "rate_identifier": "0x00 (unspecified)",
+      "length_smf_km": "0km",
+      "length_smf": "0m",
+      "length_50um": "0m",
+      "length_62_5um": "0m",
+      "length_copper": "2m",
+      "length_om3": "0m",
+      "passive_cu_cmplnce": "0x01 (SFF-8431 appendix E) [SFF-8472 rev10.4 only]",
+      "vendor_name": "UbiquitiNetworks",
+      "vendor_oui": "00:40:20",
+      "vendor_pn": "UDC-2",
+      "vendor_rev": "",
+      "option_values": "0x00 0x00",
+      "br_margin_max": "0%",
+      "br_margin_min": "0%"
+    }
+
+<a id="jc.parsers.ethtool.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict[str, Any]
+```
+
+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
+
+Source: [`jc/parsers/ethtool.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ethtool.py)
+
+Version 1.1 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,16 @@ 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.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/file.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/file.py)
+
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/find.md

@@ -0,0 +1,84 @@
+[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
+
+Source: [`jc/parsers/find.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/find.py)
+
+Version 1.0 by Solomon Leang (solomonleang@gmail.com)

docs/parsers/findmnt.md

@@ -0,0 +1,119 @@
+[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[Dict[str, Any]]
+```
+
+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
+
+Source: [`jc/parsers/findmnt.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/findmnt.py)
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,16 @@ 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.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/finger.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/finger.py)
+
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/free.md

@@ -1,32 +1,36 @@
 [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
+
+Values are normalized to bytes when using `free -h`.
 
 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:
 
     [
       {
-        "type":         string,
-        "total":        integer,
-        "used":         integer,
-        "free":         integer,
-        "shared":       integer,
-        "buff_cache":   integer,
-        "available":    integer
+        "type":                 string,
+        "total":                integer,
+        "used":                 integer,
+        "free":                 integer,
+        "shared":               integer,
+        "buff_cache":           integer,
+        "available":            integer
       }
     ]
 
@@ -70,16 +74,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 +87,16 @@ 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)
+Source: [`jc/parsers/free.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/free.py)
+
+Version 1.8 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,16 @@ 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.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/fstab.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/fstab.py)
+
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/git_log.md

@@ -0,0 +1,247 @@
+[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
+          ],
+          "file_stats": [
+            {
+              "name":           string,
+              "lines_changed":  integer
+            }
+          ]
+        }
+      }
+    ]
+
+    [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"
+          ],
+          "file_stats": [
+            {
+              "name": "docs/parsers/git_log.md",
+              "lines_changed": 3
+            },
+            {
+              "name": "jc/parsers/git_log.py",
+              "lines_changed": 7
+            }
+          ]
+        },
+        "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"
+          ],
+          "file_stats": [
+            {
+              "name": "docs/parsers/git_log.md",
+              "lines_changed": 3
+            },
+            {
+              "name": "docs/utils.md",
+              "lines_changed": 7
+            },
+            {
+              "name": "jc/parsers/git_log.py",
+              "lines_changed": 1
+            },
+            {
+              "name": "jc/utils.py",
+              "lines_changed": 12
+            },
+            {
+              "name": "man/jc.1",
+              "lines_changed": 14
+            }
+          ]
+        },
+        "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"
+          ],
+          "file_stats": [
+            {
+              "name": "docs/parsers/git_log.md",
+              "lines_changed": "3"
+            },
+            {
+              "name": "jc/parsers/git_log.py",
+              "lines_changed": "7"
+            }
+          ]
+        },
+        "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"
+          ],
+          "file_stats": [
+            {
+              "name": "docs/parsers/git_log.md",
+              "lines_changed": "3"
+            },
+            {
+              "name": "docs/utils.md",
+              "lines_changed": "7"
+            },
+            {
+              "name": "jc/parsers/git_log.py",
+              "lines_changed": "1"
+            },
+            {
+              "name": "jc/utils.py",
+              "lines_changed": "12"
+            },
+            {
+              "name": "man/jc.1",
+              "lines_changed": "14"
+            }
+          ]
+        },
+        "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
+
+Source: [`jc/parsers/git_log.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/git_log.py)
+
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/git_log_s.md

@@ -0,0 +1,118 @@
+[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
+        ],
+        "file_stats": [
+          {
+            "name":           string,
+            "lines_changed":  integer
+          }
+        ]
+      }
+
+      # 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
+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
+
+Source: [`jc/parsers/git_log_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/git_log_s.py)
+
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/git_ls_remote.md

@@ -0,0 +1,94 @@
+[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[Dict[str, Any], List[Dict[str, Any]]]
+```
+
+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
+
+Source: [`jc/parsers/git_ls_remote.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/git_ls_remote.py)
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/gpg.md

@@ -0,0 +1,147 @@
+[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
+
+Source: [`jc/parsers/gpg.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/gpg.py)
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,16 @@ 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.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/group.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/group.py)
+
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,16 @@ 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.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/gshadow.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/gshadow.py)
+
+Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,16 @@ 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)
+Source: [`jc/parsers/hash.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/hash.py)
+
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,16 @@ 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.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/hashsum.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/hashsum.py)
+
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,16 @@ 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)
+Source: [`jc/parsers/hciconfig.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/hciconfig.py)
+
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,9 @@ 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.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/history.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/history.py)
+
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/host.md

@@ -0,0 +1,115 @@
+[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
+
+Source: [`jc/parsers/host.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/host.py)
+
+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,16 @@ 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.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/hosts.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/hosts.py)
+
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/http_headers.md

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

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,18 @@ 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.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/id.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/id.py)
+
+This parser can be used with the `--slurp` command-line option.
+
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

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[Dict[str, Any]]
 ```
 
 Main text parsing function
@@ -201,14 +230,16 @@ 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.10 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/ifconfig.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ifconfig.py)
+
+Version 2.4 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,16 @@ 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.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/ini.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ini.py)
+
+Version 2.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ini_dup.md

@@ -0,0 +1,123 @@
+[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
+
+Source: [`jc/parsers/ini_dup.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ini_dup.py)
+
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/iostat.md

@@ -0,0 +1,187 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.iostat"></a>
+
+# jc.parsers.iostat
+
+jc - JSON Convert `iostat` command output parser
+
+> Note: `iostat` version 11 and higher include a JSON output option
+
+Usage (cli):
+
+    $ iostat | jc --iostat
+
+or
+
+    $ jc iostat
+
+Usage (module):
+
+    import jc
+    result = jc.parse('iostat', iostat_command_output)
+
+Schema:
+
+    [
+      {
+        "type":             string,
+        "percent_user":     float,
+        "percent_nice":     float,
+        "percent_system":   float,
+        "percent_iowait":   float,
+        "percent_steal":    float,
+        "percent_idle":     float,
+        "device":           string,
+        "tps":              float,
+        "kb_read_s":        float,
+        "mb_read_s":        float,
+        "kb_wrtn_s":        float,
+        "mb_wrtn_s":        float,
+        "kb_read":          integer,
+        "mb_read":          integer,
+        "kb_wrtn":          integer,
+        "mb_wrtn":          integer,
+        'kb_dscd':          integer,
+        'mb_dscd':          integer,
+        "rrqm_s":           float,
+        "wrqm_s":           float,
+        "r_s":              float,
+        "w_s":              float,
+        "rmb_s":            float,
+        "rkb_s":            float,
+        "wmb_s":            float,
+        "wkb_s":            float,
+        "avgrq_sz":         float,
+        "avgqu_sz":         float,
+        "await":            float,
+        "r_await":          float,
+        "w_await":          float,
+        "svctm":            float,
+        "aqu_sz":           float,
+        "rareq_sz":         float,
+        "wareq_sz":         float,
+        "d_s":              float,
+        "dkb_s":            float,
+        "dmb_s":            float,
+        "drqm_s":           float,
+        "percent_drqm":     float,
+        "d_await":          float,
+        "dareq_sz":         float,
+        "f_s":              float,
+        "f_await":          float,
+        "kb_dscd_s":        float,
+        "mb_dscd_s":        float,
+        "percent_util":     float,
+        "percent_rrqm":     float,
+        "percent_wrqm":     float
+      }
+    ]
+
+Examples:
+
+    $ iostat | jc --iostat -p
+    [
+      {
+          "percent_user": 0.15,
+          "percent_nice": 0.0,
+          "percent_system": 0.18,
+          "percent_iowait": 0.0,
+          "percent_steal": 0.0,
+          "percent_idle": 99.67,
+          "type": "cpu"
+      },
+      {
+          "device": "sda",
+          "tps": 0.29,
+          "kb_read_s": 7.22,
+          "kb_wrtn_s": 1.25,
+          "kb_read": 194341,
+          "kb_wrtn": 33590,
+          "type": "device"
+      },
+      {
+          "device": "dm-0",
+          "tps": 0.29,
+          "kb_read_s": 5.99,
+          "kb_wrtn_s": 1.17,
+          "kb_read": 161361,
+          "kb_wrtn": 31522,
+          "type": "device"
+      },
+      {
+          "device": "dm-1",
+          "tps": 0.0,
+          "kb_read_s": 0.08,
+          "kb_wrtn_s": 0.0,
+          "kb_read": 2204,
+          "kb_wrtn": 0,
+          "type": "device"
+      }
+    ]
+
+    $ iostat | jc --iostat -p -r
+    [
+      {
+        "percent_user": "0.15",
+        "percent_nice": "0.00",
+        "percent_system": "0.18",
+        "percent_iowait": "0.00",
+        "percent_steal": "0.00",
+        "percent_idle": "99.67",
+        "type": "cpu"
+      },
+      {
+        "device": "sda",
+        "tps": "0.29",
+        "kb_read_s": "7.22",
+        "kb_wrtn_s": "1.25",
+        "kb_read": "194341",
+        "kb_wrtn": "33590",
+        "type": "device"
+      },
+      {
+        "device": "dm-0",
+        "tps": "0.29",
+        "kb_read_s": "5.99",
+        "kb_wrtn_s": "1.17",
+        "kb_read": "161361",
+        "kb_wrtn": "31522",
+        "type": "device"
+      },
+      {
+        "device": "dm-1",
+        "tps": "0.00",
+        "kb_read_s": "0.08",
+        "kb_wrtn_s": "0.00",
+        "kb_read": "2204",
+        "kb_wrtn": "0",
+        "type": "device"
+      }
+    ]
+
+<a id="jc.parsers.iostat.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 Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Source: [`jc/parsers/iostat.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/iostat.py)
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/iostat_s.md

@@ -0,0 +1,134 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.iostat_s"></a>
+
+# jc.parsers.iostat_s
+
+jc - JSON Convert `iostat` command output streaming parser
+
+> 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
+
+    result = jc.parse('iostat_s', iostat_command_output.splitlines())
+    for item in result:
+        # do something
+
+Schema:
+
+    {
+      "type":             string,
+      "percent_user":     float,
+      "percent_nice":     float,
+      "percent_system":   float,
+      "percent_iowait":   float,
+      "percent_steal":    float,
+      "percent_idle":     float,
+      "device":           string,
+      "tps":              float,
+      "kb_read_s":        float,
+      "mb_read_s":        float,
+      "kb_wrtn_s":        float,
+      "mb_wrtn_s":        float,
+      "kb_read":          integer,
+      "mb_read":          integer,
+      "kb_wrtn":          integer,
+      "mb_wrtn":          integer,
+      'kb_dscd':          integer,
+      'mb_dscd':          integer,
+      "rrqm_s":           float,
+      "wrqm_s":           float,
+      "r_s":              float,
+      "w_s":              float,
+      "rmb_s":            float,
+      "rkb_s":            float,
+      "wmb_s":            float,
+      "wkb_s":            float,
+      "avgrq_sz":         float,
+      "avgqu_sz":         float,
+      "await":            float,
+      "r_await":          float,
+      "w_await":          float,
+      "svctm":            float,
+      "aqu_sz":           float,
+      "rareq_sz":         float,
+      "wareq_sz":         float,
+      "d_s":              float,
+      "dkb_s":            float,
+      "dmb_s":            float,
+      "drqm_s":           float,
+      "percent_drqm":     float,
+      "d_await":          float,
+      "dareq_sz":         float,
+      "f_s":              float,
+      "f_await":          float,
+      "kb_dscd_s":        float,
+      "mb_dscd_s":        float,
+      "percent_util":     float,
+      "percent_rrqm":     float,
+      "percent_wrqm":     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:
+
+    $ iostat | jc --iostat-s
+    {"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"...}
+    {"device":"sda","tps":"0.24","kb_read_s":"5.28","kb_wrtn_s":"1.10"...}
+    ...
+
+<a id="jc.parsers.iostat_s.parse"></a>
+
+### parse
+
+```python
+def parse(data, raw=False, quiet=False, ignore_exceptions=False)
+```
+
+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
+
+Source: [`jc/parsers/iostat_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/iostat_s.py)
+
+Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ip_address.md

@@ -0,0 +1,559 @@
+[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
+
+Source: [`jc/parsers/ip_address.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ip_address.py)
+
+This parser can be used with the `--slurp` command-line option.
+
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ip_route.md

@@ -0,0 +1,76 @@
+[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
+
+Source: [`jc/parsers/ip_route.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ip_route.py)
+
+Version 1.0 by Julian Jackson (jackson.julian55@yahoo.com)

docs/parsers/ipconfig.md

@@ -0,0 +1,461 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.ipconfig"></a>
+
+# jc.parsers.ipconfig
+
+jc - JSON Convert `ipconfig` Windows command output parser
+
+Usage (cli):
+
+    $ ipconfig /all | jc --ipconfig
+    $ ipconfig | jc --ipconfig
+    $ jc ipconfig /all
+
+Usage (module):
+
+    import jc
+    result = jc.parse('ipconfig', ipconfig_command_output)
+
+Schema:
+
+    {
+      "host_name":                             string,
+      "primary_dns_suffix":                    string,
+      "node_type":                             string,
+      "ip_routing_enabled":                    boolean,
+      "wins_proxy_enabled":                    boolean,
+      "dns_suffix_search_list": [
+                                               string
+      ],
+      "adapters": [
+        {
+          "name_long":                         string,
+          "name":                              string,
+          "type":                              string,
+          "connection_specific_dns_suffix":    string,
+          "connection_specific_dns_suffix_search_list": [
+                                               string
+          ]
+          "description":                       string,
+          "physical_address":                  string,
+          "dhcp_enabled":                      boolean,
+          "autoconfiguration_enabled":         boolean,
+          "ipv6_addresses": [
+            {
+              "address":                       string,
+              "status":                        string,
+            },
+          ],
+          "temporary_ipv6_addresses": [
+            {
+              "address":                       string,
+              "status":                        string,
+            },
+          ],
+          "link_local_ipv6_addresses": [
+            {
+              "address":                       string,
+              "status":                        string,
+              "prefix_length":                 integer,
+            }
+          ],
+          "ipv4_addresses": [
+            {
+              "address":                       string,     # [2]
+              "subnet_mask":                   string,
+              "status":                        string,
+              "autoconfigured":                boolean     # [1]
+            }
+          ],
+          "default_gateways": [
+                                               string
+          ],
+          "dhcp_server": null,
+          "dhcpv6_iaid":                       string,
+          "dhcpv6_client_duid":                string,
+          "dns_servers": [
+                                               string
+          ],
+          "primary_wins_server":               string,
+          "lease_expires":                     string,
+          "lease_expires_epoch":               integer,    # [0]
+          "lease_expires_iso":                 string,
+          "lease_obtained":                    string,
+          "lease_obtained_epoch":              integer,    # [0]
+          "lease_obtained_iso":                string,
+          "netbios_over_tcpip":                boolean,
+          "media_state":                       string,
+          "extras": [
+            <string>:                          string
+          ]
+        }
+      ],
+      "extras": []
+    }
+
+    Notes:
+      [0] - The epoch calculated timestamp field is naive. (i.e. based on
+            the local time of the system the parser is run on)
+      [1] - 'autoconfigured' under 'ipv4_address' is only providing
+            indication if the ipv4 address was labeled as "Autoconfiguration
+            IPv4 Address" vs "IPv4 Address". It does not infer any
+            information from other fields
+      [2] - Windows XP uses 'IP Address' instead of 'IPv4 Address'. Both
+            values are parsed to the 'ipv4_address' object for consistency
+
+Examples:
+
+    $ ipconfig /all | jc --ipconfig -p
+    {
+      "host_name": "DESKTOP-WIN11-HOME",
+      "primary_dns_suffix": null,
+      "node_type": "Hybrid",
+      "ip_routing_enabled": false,
+      "wins_proxy_enabled": false,
+      "dns_suffix_search_list": [
+        "localdomain"
+      ],
+      "adapters": [
+        {
+          "name_long": "Ethernet adapter Ethernet",
+          "name": "Ethernet",
+          "type": "Ethernet",
+          "connection_specific_dns_suffix": null,
+          "connection_specific_dns_suffix_search_list": [],
+          "description": "Intel(R) I211 Gigabit Network Connection",
+          "physical_address": "24-4B-FE-AB-43-C3",
+          "dhcp_enabled": true,
+          "autoconfiguration_enabled": true,
+          "ipv6_addresses": [],
+          "temporary_ipv6_addresses": [],
+          "link_local_ipv6_addresses": [],
+          "ipv4_addresses": [],
+          "default_gateways": [],
+          "dhcp_server": null,
+          "dhcpv6_iaid": null,
+          "dhcpv6_client_duid": null,
+          "dns_servers": [],
+          "primary_wins_server": null,
+          "lease_expires": null,
+          "lease_obtained": null,
+          "netbios_over_tcpip": null,
+          "media_state": "Media disconnected",
+          "extras": []
+        },
+        {
+          "name_long": "Ethernet adapter Ethernet 2",
+          "name": "Ethernet 2",
+          "type": "Ethernet",
+          "connection_specific_dns_suffix": null,
+          "connection_specific_dns_suffix_search_list": [],
+          "description": "Realtek PCIe 2.5GbE Family Controller",
+          "physical_address": "24-4B-FE-57-3D-F2",
+          "dhcp_enabled": true,
+          "autoconfiguration_enabled": true,
+          "ipv6_addresses": [],
+          "temporary_ipv6_addresses": [],
+          "link_local_ipv6_addresses": [],
+          "ipv4_addresses": [],
+          "default_gateways": [],
+          "dhcp_server": null,
+          "dhcpv6_iaid": null,
+          "dhcpv6_client_duid": null,
+          "dns_servers": [],
+          "primary_wins_server": null,
+          "lease_expires": null,
+          "lease_obtained": null,
+          "netbios_over_tcpip": null,
+          "media_state": "Media disconnected",
+          "extras": []
+        },
+        {
+          "name_long": "Unknown adapter OpenVPN Data Channel Offload for NordVPN",
+          "name": "OpenVPN Data Channel Offload for NordVPN",
+          "type": "Unknown",
+          "connection_specific_dns_suffix": null,
+          "connection_specific_dns_suffix_search_list": [],
+          "description": "OpenVPN Data Channel Offload",
+          "physical_address": null,
+          "dhcp_enabled": true,
+          "autoconfiguration_enabled": true,
+          "ipv6_addresses": [],
+          "temporary_ipv6_addresses": [],
+          "link_local_ipv6_addresses": [],
+          "ipv4_addresses": [],
+          "default_gateways": [],
+          "dhcp_server": null,
+          "dhcpv6_iaid": null,
+          "dhcpv6_client_duid": null,
+          "dns_servers": [],
+          "primary_wins_server": null,
+          "lease_expires": null,
+          "lease_obtained": null,
+          "netbios_over_tcpip": null,
+          "media_state": "Media disconnected",
+          "extras": []
+        },
+        {
+          "name_long": "Unknown adapter Local Area Connection",
+          "name": "Local Area Connection",
+          "type": "Unknown",
+          "connection_specific_dns_suffix": null,
+          "connection_specific_dns_suffix_search_list": [],
+          "description": "TAP-NordVPN Windows Adapter V9",
+          "physical_address": "00-FF-4C-F4-5E-49",
+          "dhcp_enabled": true,
+          "autoconfiguration_enabled": true,
+          "ipv6_addresses": [],
+          "temporary_ipv6_addresses": [],
+          "link_local_ipv6_addresses": [],
+          "ipv4_addresses": [],
+          "default_gateways": [],
+          "dhcp_server": null,
+          "dhcpv6_iaid": null,
+          "dhcpv6_client_duid": null,
+          "dns_servers": [],
+          "primary_wins_server": null,
+          "lease_expires": null,
+          "lease_obtained": null,
+          "netbios_over_tcpip": null,
+          "media_state": "Media disconnected",
+          "extras": []
+        },
+        {
+          "name_long": "Wireless LAN adapter Local Area Connection* 1",
+          "name": "Local Area Connection* 1",
+          "type": "Wireless LAN",
+          "connection_specific_dns_suffix": null,
+          "connection_specific_dns_suffix_search_list": [],
+          "description": "Microsoft Wi-Fi Direct Virtual Adapter",
+          "physical_address": "A8-7E-EA-5A-7F-DE",
+          "dhcp_enabled": true,
+          "autoconfiguration_enabled": true,
+          "ipv6_addresses": [],
+          "temporary_ipv6_addresses": [],
+          "link_local_ipv6_addresses": [],
+          "ipv4_addresses": [],
+          "default_gateways": [],
+          "dhcp_server": null,
+          "dhcpv6_iaid": null,
+          "dhcpv6_client_duid": null,
+          "dns_servers": [],
+          "primary_wins_server": null,
+          "lease_expires": null,
+          "lease_obtained": null,
+          "netbios_over_tcpip": null,
+          "media_state": "Media disconnected",
+          "extras": []
+        },
+        {
+          "name_long": "Wireless LAN adapter Local Area Connection* 2",
+          "name": "Local Area Connection* 2",
+          "type": "Wireless LAN",
+          "connection_specific_dns_suffix": null,
+          "connection_specific_dns_suffix_search_list": [],
+          "description": "Microsoft Wi-Fi Direct Virtual Adapter #2",
+          "physical_address": "AA-7E-EA-F3-64-C3",
+          "dhcp_enabled": true,
+          "autoconfiguration_enabled": true,
+          "ipv6_addresses": [],
+          "temporary_ipv6_addresses": [],
+          "link_local_ipv6_addresses": [],
+          "ipv4_addresses": [],
+          "default_gateways": [],
+          "dhcp_server": null,
+          "dhcpv6_iaid": null,
+          "dhcpv6_client_duid": null,
+          "dns_servers": [],
+          "primary_wins_server": null,
+          "lease_expires": null,
+          "lease_obtained": null,
+          "netbios_over_tcpip": null,
+          "media_state": "Media disconnected",
+          "extras": []
+        },
+        {
+          "name_long": "Ethernet adapter VMware Network Adapter VMnet1",
+          "name": "VMware Network Adapter VMnet1",
+          "type": "Ethernet",
+          "connection_specific_dns_suffix": null,
+          "connection_specific_dns_suffix_search_list": [],
+          "description": "VMware Virtual Ethernet Adapter for VMnet1",
+          "physical_address": "00-50-56-CC-27-73",
+          "dhcp_enabled": true,
+          "autoconfiguration_enabled": true,
+          "ipv6_addresses": [],
+          "temporary_ipv6_addresses": [],
+          "link_local_ipv6_addresses": [
+            {
+              "address": "fe80::f47d:9c7f:69dc:591e",
+              "prefix_length": 8,
+              "status": "Preferred"
+            }
+          ],
+          "ipv4_addresses": [
+            {
+              "address": "192.168.181.1",
+              "subnet_mask": "255.255.255.0",
+              "status": "Preferred",
+              "autoconfigured": false
+            }
+          ],
+          "default_gateways": [],
+          "dhcp_server": "192.168.181.254",
+          "dhcpv6_iaid": "771772502",
+          "dhcpv6_client_duid": "00-01-00-01-2C-CF-19-EB-24-4B-FE-5B-9B-E6",
+          "dns_servers": [],
+          "primary_wins_server": null,
+          "lease_expires": "2024-09-19T18:01:29",
+          "lease_obtained": "2024-09-19T08:31:29",
+          "netbios_over_tcpip": true,
+          "media_state": null,
+          "extras": []
+        },
+        {
+          "name_long": "Ethernet adapter VMware Network Adapter VMnet8",
+          "name": "VMware Network Adapter VMnet8",
+          "type": "Ethernet",
+          "connection_specific_dns_suffix": null,
+          "connection_specific_dns_suffix_search_list": [],
+          "description": "VMware Virtual Ethernet Adapter for VMnet8",
+          "physical_address": "00-50-56-C9-A3-78",
+          "dhcp_enabled": true,
+          "autoconfiguration_enabled": true,
+          "ipv6_addresses": [],
+          "temporary_ipv6_addresses": [],
+          "link_local_ipv6_addresses": [
+            {
+              "address": "fe80::4551:bf0d:59dd:a4f0",
+              "prefix_length": 10,
+              "status": "Preferred"
+            }
+          ],
+          "ipv4_addresses": [
+            {
+              "address": "192.168.213.1",
+              "subnet_mask": "255.255.255.0",
+              "status": "Preferred",
+              "autoconfigured": false
+            }
+          ],
+          "default_gateways": [],
+          "dhcp_server": "192.168.213.254",
+          "dhcpv6_iaid": "788549718",
+          "dhcpv6_client_duid": "00-01-00-01-2C-CF-19-EB-24-4B-FE-5B-9B-E6",
+          "dns_servers": [],
+          "primary_wins_server": "192.168.213.2",
+          "lease_expires": "2024-09-19T18:01:29",
+          "lease_obtained": "2024-09-19T08:31:29",
+          "netbios_over_tcpip": true,
+          "media_state": null,
+          "extras": []
+        },
+        {
+          "name_long": "Wireless LAN adapter Wi-Fi",
+          "name": "Wi-Fi",
+          "type": "Wireless LAN",
+          "connection_specific_dns_suffix": "localdomain",
+          "connection_specific_dns_suffix_search_list": [],
+          "description": "Intel(R) Wi-Fi 6 AX200 160MHz",
+          "physical_address": "A8-7E-EA-55-26-B0",
+          "dhcp_enabled": true,
+          "autoconfiguration_enabled": true,
+          "ipv6_addresses": [
+            {
+              "address": "fd63:cc9c:65eb:3f95:57c2:aa:10d8:db08",
+              "status": "Preferred"
+            }
+          ],
+          "temporary_ipv6_addresses": [
+            {
+              "address": "fd63:cc9c:65eb:3f95:8928:348e:d692:b7ef",
+              "status": "Preferred"
+            }
+          ],
+          "link_local_ipv6_addresses": [
+            {
+              "address": "fe80::4fae:1380:5a1b:8b6b",
+              "prefix_length": 11,
+              "status": "Preferred"
+            }
+          ],
+          "ipv4_addresses": [
+            {
+              "address": "192.168.1.169",
+              "subnet_mask": "255.255.255.0",
+              "status": "Preferred",
+              "autoconfigured": false
+            }
+          ],
+          "default_gateways": [
+            "192.168.1.1"
+          ],
+          "dhcp_server": "192.168.1.1",
+          "dhcpv6_iaid": "162037482",
+          "dhcpv6_client_duid": "00-01-00-01-2C-CF-19-EB-24-4B-FE-5B-9B-E6",
+          "dns_servers": [
+            "192.168.1.1"
+          ],
+          "primary_wins_server": null,
+          "lease_expires": "2024-09-20T08:31:30",
+          "lease_obtained": "2024-09-19T08:31:30",
+          "netbios_over_tcpip": true,
+          "media_state": null,
+          "extras": []
+        },
+        {
+          "name_long": "Ethernet adapter Bluetooth Network Connection",
+          "name": "Bluetooth Network Connection",
+          "type": "Ethernet",
+          "connection_specific_dns_suffix": null,
+          "connection_specific_dns_suffix_search_list": [],
+          "description": "Bluetooth Device (Personal Area Network)",
+          "physical_address": "A8-7E-EA-43-23-14",
+          "dhcp_enabled": true,
+          "autoconfiguration_enabled": true,
+          "ipv6_addresses": [],
+          "temporary_ipv6_addresses": [],
+          "link_local_ipv6_addresses": [],
+          "ipv4_addresses": [],
+          "default_gateways": [],
+          "dhcp_server": null,
+          "dhcpv6_iaid": null,
+          "dhcpv6_client_duid": null,
+          "dns_servers": [],
+          "primary_wins_server": null,
+          "lease_expires": null,
+          "lease_obtained": null,
+          "netbios_over_tcpip": null,
+          "media_state": "Media disconnected",
+          "extras": []
+        }
+      ],
+      "extras": []
+    }
+
+<a id="jc.parsers.ipconfig.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:
+
+    Parsed dictionary. The raw and processed data structures are the same.
+
+### Parser Information
+Compatibility:  windows
+
+Source: [`jc/parsers/ipconfig.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ipconfig.py)
+
+Version 1.0 by joehacksalot (joehacksalot@gmail.com)

docs/parsers/iptables.md

@@ -1,34 +1,39 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.iptables"></a>
 
 # jc.parsers.iptables
-jc - JSON CLI output utility `ipables` command output parser
 
-Supports `-vLn` and `--line-numbers` for all tables.
+jc - JSON Convert `iptables` command output parser
+
+Supports `-vLnx` and `--line-numbers` for all tables.
 
 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:
 
     [
       {
         "chain":                string,
+        "default_policy":       string,
+        "default_packets":      integer,
+        "default_bytes":        integer,
         "rules": [
           {
             "num"               integer,
             "pkts":             integer,
             "bytes":            integer,  # converted based on suffix
-            "target":           string,
+            "target":           string,   # Null if blank
             "prot":             string,
             "opt":              string,   # "--" = Null
             "in":               string,
@@ -47,6 +52,9 @@ Examples:
     [
       {
         "chain": "PREROUTING",
+        "default_policy": "DROP",
+        "default_packets": 0,
+        "default_bytes": 0,
         "rules": [
           {
             "num": 1,
@@ -106,6 +114,9 @@ Examples:
     [
       {
         "chain": "PREROUTING",
+        "default_policy": "DROP",
+        "default_packets": "0",
+        "default_bytes": "0",
         "rules": [
           {
             "num": "1",
@@ -161,16 +172,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 +185,16 @@ 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)
+Source: [`jc/parsers/iptables.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/iptables.py)
+
+Version 1.12 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
 
-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,16 @@ 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.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/iw_scan.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/iw_scan.py)
+
+Version 0.75 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/iwconfig.md

@@ -0,0 +1,113 @@
+[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[Dict[str, Any]]
+```
+
+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
+
+Source: [`jc/parsers/iwconfig.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/iwconfig.py)
+
+Version 1.2 by Thomas Vincent (vrince@gmail.com)

docs/parsers/jar_manifest.md

@@ -0,0 +1,105 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.jar_manifest"></a>
+
+# jc.parsers.jar_manifest
+
+jc - JSON Convert Java `MANIFEST.MF` file parser
+
+Usage (cli):
+
+    $ cat MANIFEST.MF | jc --jar-manifest
+
+Usage (module):
+
+    import jc
+    result = jc.parse('jar_manifest', jar_manifest_file_output)
+
+Schema:
+
+    [
+      {
+        "key1":     string,
+        "key2":     string
+      }
+    ]
+
+Examples:
+
+    $ cat 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;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",
+        "Built_By": "matt",
+        "Bnd_LastModified": "1639373735804",
+        "Implementation_Vendor_Id": "org.apache.logging.log4j",
+        "Specification_Title": "Apache Log4j Core",
+        "Log4jReleaseManager": "Matt Sicker",
+        ...
+      }
+    ]
+
+    $ 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-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-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-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",
+        ...
+      }
+      ...
+    ]
+
+<a id="jc.parsers.jar_manifest.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 Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Source: [`jc/parsers/jar_manifest.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/jar_manifest.py)
+
+Version 0.01 by Matt J (https://github.com/listuser)

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,16 @@ 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.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/jobs.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/jobs.py)
+
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/jwt.md

@@ -0,0 +1,77 @@
+[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
+
+Source: [`jc/parsers/jwt.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/jwt.py)
+
+This parser can be used with the `--slurp` command-line option.
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,13 +41,14 @@ 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
     # but can be preserved with the -r argument
     occupation:"Engineer"
 
-    $ cat keyvalue.txt | jc --ini -p
+    $ cat keyvalue.txt | jc --kv -p
     {
       "name": "John Doe",
       "address": "555 California Drive",
@@ -46,33 +56,29 @@ 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)
+Source: [`jc/parsers/kv.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/kv.py)
+
+Version 2.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/kv_dup.md

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

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,16 @@ 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.9 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/ls.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ls.py)
+
+Version 1.12 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ls_s.md

@@ -0,0 +1,103 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.ls_s"></a>
+
+# jc.parsers.ls_s
+
+jc - JSON Convert `ls` and `vdir` command output streaming parser
+
+> This streaming parser outputs JSON Lines (cli) or returns an Iterable of
+> Dictionaries (module)
+
+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 `jc` `-qq` option can be used to ignore parsing errors. (e.g. filenames
+with newline characters, but `-b` was not used)
+
+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):
+
+    $ ls | jc --ls-s
+
+Usage (module):
+
+    import jc
+
+    result = jc.parse('ls_s', ls_command_output.splitlines())
+    for item in result:
+        # do something
+
+Schema:
+
+    {
+      "filename":       string,
+      "flags":          string,
+      "links":          integer,
+      "parent":         string,
+      "owner":          string,
+      "group":          string,
+      "size":           integer,
+      "date":           string,
+      "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","...}
+    {"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":"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>
+
+### parse
+
+```python
+def parse(data, raw=False, quiet=False, ignore_exceptions=False)
+```
+
+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, aix, freebsd
+
+Source: [`jc/parsers/ls_s.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/ls_s.py)
+
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/lsattr.md

@@ -0,0 +1,91 @@
+[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[Dict[str, Any]]
+```
+
+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
+
+Source: [`jc/parsers/lsattr.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/lsattr.py)
+
+Version 1.0 by Mark Rotner (rotner.mr@gmail.com)

docs/parsers/lsb_release.md

@@ -0,0 +1,63 @@
+[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) -> Dict[str, Any]
+```
+
+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
+
+Source: [`jc/parsers/lsb_release.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/lsb_release.py)
+
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/lsblk.md

@@ -1,65 +1,74 @@
 [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:
 
     [
       {
-        "name":         string,
-        "maj_min":      string,
-        "rm":           boolean,
-        "size":         string,
-        "ro":           boolean,
-        "type":         string,
-        "mountpoint":   string,
-        "kname":        string,
-        "fstype":       string,
-        "label":        string,
-        "uuid":         string,
-        "partlabel":    string,
-        "partuuid":     string,
-        "ra":           integer,
-        "model":        string,
-        "serial":       string,
-        "state":        string,
-        "owner":        string,
-        "group":        string,
-        "mode":         string,
-        "alignment":    integer,
-        "min_io":       integer,
-        "opt_io":       integer,
-        "phy_sec":      integer,
-        "log_sec":      integer,
-        "rota":         boolean,
-        "sched":        string,
-        "rq_size":      integer,
-        "disc_aln":     integer,
-        "disc_gran":    string,
-        "disc_max":     string,
-        "disc_zero":    boolean,
-        "wsame":        string,
-        "wwn":          string,
-        "rand":         boolean,
-        "pkname":       string,
-        "hctl":         string,
-        "tran":         string,
-        "rev":          string,
-        "vendor":       string
+        "name":             string,
+        "maj_min":          string,
+        "rm":               boolean,
+        "size":             string,
+        "size_bytes":       integer
+        "ro":               boolean,
+        "type":             string,
+        "mountpoint":       string,
+        "mountpoints": [
+                            string
+        ],
+        "kname":            string,
+        "fstype":           string,
+        "label":            string,
+        "uuid":             string,
+        "partlabel":        string,
+        "partuuid":         string,
+        "ra":               integer,
+        "model":            string,
+        "serial":           string,
+        "state":            string,
+        "owner":            string,
+        "group":            string,
+        "mode":             string,
+        "alignment":        integer,
+        "min_io":           integer,
+        "opt_io":           integer,
+        "phy_sec":          integer,
+        "log_sec":          integer,
+        "rota":             boolean,
+        "sched":            string,
+        "rq_size":          integer,
+        "disc_aln":         integer,
+        "disc_gran":        string,
+        "disc_gran_bytes":  integer,
+        "disc_max":         string,
+        "disc_max_bytes":   integer,
+        "disc_zero":        boolean,
+        "wsame":            string,
+        "wsame_bytes":      integer,
+        "wwn":              string,
+        "rand":             boolean,
+        "pkname":           string,
+        "hctl":             string,
+        "tran":             string,
+        "rev":              string,
+        "vendor":           string
       }
     ]
 
@@ -72,6 +81,7 @@ Examples:
         "maj_min": "8:0",
         "rm": false,
         "size": "20G",
+        "size_bytes": 20000000000,
         "ro": false,
         "type": "disk",
         "mountpoint": null
@@ -81,6 +91,7 @@ Examples:
         "maj_min": "8:1",
         "rm": false,
         "size": "1G",
+        "size_bytes": 1000000000
         "ro": false,
         "type": "part",
         "mountpoint": "/boot"
@@ -88,13 +99,17 @@ 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",
         "maj_min": "8:0",
         "rm": false,
         "size": "20G",
+        "size_bytes": 20000000000,
         "ro": false,
         "type": "disk",
         "mountpoint": null,
@@ -121,9 +136,12 @@ Examples:
         "rq_size": 128,
         "disc_aln": 0,
         "disc_gran": "0B",
+        "disc_gran_bytes": 0,
         "disc_max": "0B",
+        "disc_max_bytes": 0,
         "disc_zero": false,
         "wsame": "32M",
+        "wsame_bytes": 32000000,
         "wwn": null,
         "rand": true,
         "pkname": null,
@@ -137,6 +155,7 @@ Examples:
         "maj_min": "8:1",
         "rm": false,
         "size": "1G",
+        "size_bytes": 1000000000
         "ro": false,
         "type": "part",
         "mountpoint": "/boot",
@@ -163,9 +182,12 @@ Examples:
         "rq_size": 128,
         "disc_aln": 0,
         "disc_gran": "0B",
+        "disc_gran_bytes": 0,
         "disc_max": "0B",
+        "disc_max_bytes": 0,
         "disc_zero": false,
         "wsame": "32M",
+        "wsame_bytes": 32000000,
         "wwn": null,
         "rand": true,
         "pkname": "sda",
@@ -177,13 +199,17 @@ 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",
         "maj_min": "8:0",
         "rm": "0",
         "size": "20G",
+        "size_bytes": 20000000000,
         "ro": "0",
         "type": "disk",
         "mountpoint": null,
@@ -210,9 +236,12 @@ Examples:
         "rq_size": "128",
         "disc_aln": "0",
         "disc_gran": "0B",
+        "disc_gran_bytes": 0,
         "disc_max": "0B",
+        "disc_max_bytes": 0,
         "disc_zero": "0",
         "wsame": "32M",
+        "wsame_bytes": 32000000,
         "wwn": null,
         "rand": "1",
         "pkname": null,
@@ -226,6 +255,7 @@ Examples:
         "maj_min": "8:1",
         "rm": "0",
         "size": "1G",
+        "size_bytes": 1000000000
         "ro": "0",
         "type": "part",
         "mountpoint": "/boot",
@@ -252,9 +282,12 @@ Examples:
         "rq_size": "128",
         "disc_aln": "0",
         "disc_gran": "0B",
+        "disc_gran_bytes": 0,
         "disc_max": "0B",
+        "disc_max_bytes": 0,
         "disc_zero": "0",
         "wsame": "32M",
+        "wsame_bytes": 32000000,
         "wwn": null,
         "rand": "1",
         "pkname": "sda",
@@ -266,16 +299,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 +312,16 @@ 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)
+Source: [`jc/parsers/lsblk.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/lsblk.py)
+
+Version 1.10 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,16 @@ 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)
+Source: [`jc/parsers/lsmod.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/lsmod.py)
+
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,16 @@ 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.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Source: [`jc/parsers/lsof.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/lsof.py)
+
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

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,
+        "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",
+        "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[Dict[str, Any]]
+```
+
+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
+
+Source: [`jc/parsers/lspci.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/lspci.py)
+
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/lsusb.md

@@ -0,0 +1,335 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.lsusb"></a>
+
+# jc.parsers.lsusb
+
+jc - JSON Convert `lsusb` command output parser
+
+Supports the `-v` option or no options.
+
+Usage (cli):
+
+    $ lsusb -v | jc --lsusb
+
+or
+
+    $ jc lsusb -v
+
+Usage (module):
+
+    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.
+
+    [
+      {
+        "bus":                                string,
+        "device":                             string,
+        "id":                                 string,
+        "description":                        string,
+        "device_descriptor": {
+          "<item>": {
+            "value":                          string,
+            "description":                    string,
+            "attributes": [
+                                              string
+            ]
+          },
+          "configuration_descriptor": {
+            "<item>": {
+              "value":                        string,
+              "description":                  string,
+              "attributes": [
+                                              string
+              ]
+            },
+            "interface_association": {
+              "<item>": {
+                "value":                      string,
+                "description":                string,
+                "attributes": [
+                                              string
+                ]
+              }
+            },
+            "interface_descriptors": [
+              {
+                "<item>": {
+                  "value":                    string,
+                  "description":              string,
+                  "attributes": [
+                                              string
+                  ]
+                },
+                "cdc_header": {
+                  "<item>": {
+                    "value":                  string,
+                    "description":            string,
+                    "attributes": [
+                                              string
+                    ]
+                  }
+                },
+                "cdc_call_management": {
+                  "<item>": {
+                    "value":                  string,
+                    "description":            string,
+                    "attributes": [
+                                              string
+                    ]
+                  }
+                },
+                "cdc_acm": {
+                  "<item>": {
+                    "value":                  string,
+                    "description":            string,
+                    "attributes": [
+                                              string
+                    ]
+                  }
+                },
+                "cdc_union": {
+                  "<item>": {
+                    "value":                  string,
+                    "description":            string,
+                    "attributes": [
+                                              string
+                    ]
+                  }
+                },
+                "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>": {
+                      "value":                string,
+                      "description":          string,
+                      "attributes": [
+                                              string
+                      ]
+                    }
+                  }
+                ]
+              }
+            ]
+          }
+        },
+        "hub_descriptor": {
+          "<item>": {
+            "value":                          string,
+            "description":                    string,
+            "attributes": [
+                                              string,
+            ]
+          },
+          "hub_port_status": {
+            "<item>": {
+              "value":                        string,
+              "attributes": [
+                                              string
+              ]
+            }
+          }
+        },
+        "device_qualifier": {
+          "<item>": {
+            "value":                          string,
+            "description":                    string
+          }
+        },
+        "device_status": {
+          "value":                            string,
+          "description":                      string
+        }
+      }
+    ]
+
+Examples:
+
+    $ lsusb -v | jc --lsusb -p
+    [
+      {
+        "bus": "002",
+        "device": "001",
+        "id": "1d6b:0001",
+        "description": "Linux Foundation 1.1 root hub",
+        "device_descriptor": {
+          "bLength": {
+            "value": "18"
+          },
+          "bDescriptorType": {
+            "value": "1"
+          },
+          "bcdUSB": {
+            "value": "1.10"
+          },
+          ...
+          "bNumConfigurations": {
+            "value": "1"
+          },
+          "configuration_descriptor": {
+            "bLength": {
+              "value": "9"
+            },
+            ...
+            "iConfiguration": {
+              "value": "0"
+            },
+            "bmAttributes": {
+              "value": "0xe0",
+              "attributes": [
+                "Self Powered",
+                "Remote Wakeup"
+              ]
+            },
+            "MaxPower": {
+              "description": "0mA"
+            },
+            "interface_descriptors": [
+              {
+                "bLength": {
+                  "value": "9"
+                },
+                ...
+                "bInterfaceProtocol": {
+                  "value": "0",
+                  "description": "Full speed (or root) hub"
+                },
+                "iInterface": {
+                  "value": "0"
+                },
+                "endpoint_descriptors": [
+                  {
+                    "bLength": {
+                      "value": "7"
+                    },
+                    ...
+                    "bmAttributes": {
+                      "value": "3",
+                      "attributes": [
+                        "Transfer Type  Interrupt",
+                        "Synch Type  None",
+                        "Usage Type  Data"
+                      ]
+                    },
+                    "wMaxPacketSize": {
+                      "value": "0x0002",
+                      "description": "1x 2 bytes"
+                    },
+                    "bInterval": {
+                      "value": "255"
+                    }
+                  }
+                ]
+              }
+            ]
+          }
+        },
+        "hub_descriptor": {
+          "bLength": {
+            "value": "9"
+          },
+          ...
+          "wHubCharacteristic": {
+            "value": "0x000a",
+            "attributes": [
+              "No power switching (usb 1.0)",
+              "Per-port overcurrent protection"
+            ]
+          },
+          ...
+          "hub_port_status": {
+            "Port 1": {
+              "value": "0000.0103",
+              "attributes": [
+                "power",
+                "enable",
+                "connect"
+              ]
+            },
+            "Port 2": {
+              "value": "0000.0103",
+              "attributes": [
+                "power",
+                "enable",
+                "connect"
+              ]
+            }
+          }
+        },
+        "device_status": {
+          "value": "0x0001",
+          "description": "Self Powered"
+        }
+      }
+    ]
+
+<a id="jc.parsers.lsusb.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 Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Source: [`jc/parsers/lsusb.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/lsusb.py)
+
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/m3u.md

@@ -0,0 +1,92 @@
+[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
+
+Source: [`jc/parsers/m3u.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/m3u.py)
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)