Merge pull request #292 from kellyjonbrazil/dev

Dev v1.22.0

CHANGELOG

@@ -1,5 +1,109 @@
 jc changelog
 
+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

EXAMPLES.md

@@ -265,6 +265,37 @@ blkid -o udev -ip /dev/sda2 | jc --blkid -p          # or:  jc -p blkid -o udev
   }
 ]
 ```
+### CEF strings
+```bash
+cat cef.log | jc --cef -p
+```
+```json
+[
+  {
+    "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
+  }
+]
+```
 ### chage --list
 ```bash
 chage --list joeuser | jc --chage -p          # or:  jc -p chage --list joeuser
@@ -922,6 +953,18 @@ du /usr | jc --du -p          # or:  jc -p du /usr
   }
 ]
 ```
+### Email Address string
+```bash
+echo 'joe.user@gmail.com' | jc --email-address -p
+```
+```json
+{
+  "username": "joe.user",
+  "domain": "gmail.com",
+  "local": "joe.user",
+  "local_plus_suffix": null
+}
+```
 ### env
 ```bash
 env | jc --env -p          # or:  jc -p env
@@ -1121,6 +1164,37 @@ git log --stat | jc --git-log -p          or:  jc -p git log --stat
   }
 ]
 ```
+### gpg --with-colons
+```bash
+gpg --with-colons --show-keys file.gpg | jc --gpg -p          # or  jc -p gpg --with-colons --show-keys file.gpg
+```
+```json
+[
+  {
+    "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
+  }
+]
+```
 ### /etc/group file
 ```bash
 cat /etc/group | jc --group -p
@@ -1563,18 +1637,18 @@ cat example.ini | jc --ini -p
 ```json
 {
   "bitbucket.org": {
-    "serveraliveinterval": "45",
-    "compression": "yes",
-    "compressionlevel": "9",
-    "forwardx11": "yes",
-    "user": "hg"
+    "ServeraLiveInterval": "45",
+    "Compression": "yes",
+    "CompressionLevel": "9",
+    "ForwardX11": "yes",
+    "User": "hg"
   },
   "topsecret.server.com": {
-    "serveraliveinterval": "45",
-    "compression": "yes",
-    "compressionlevel": "9",
-    "forwardx11": "no",
-    "port": "50022"
+    "ServeraLiveInterval": "45",
+    "Compression": "yes",
+    "CompressionLevel": "9",
+    "ForwardX11": "no",
+    "Port": "50022"
   }
 }
 ```
@@ -1622,6 +1696,65 @@ $ iostat | jc --iostat -p          # or:  jc -p iostat
   }
 ]
 ```
+### IP Address strings
+```bash
+echo 192.168.2.10/24 | jc --ip-address -p
+```
+```json
+{
+  "version": 4,
+  "max_prefix_length": 32,
+  "ip": "192.168.2.10",
+  "ip_compressed": "192.168.2.10",
+  "ip_exploded": "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"
+  }
+}
+```
 ### iptables
 ```bash
 iptables --line-numbers -v -L -t nat | jc --iptables -p          # or:  jc -p iptables --line-numbers -v -L -t nat
@@ -1684,6 +1817,31 @@ iptables --line-numbers -v -L -t nat | jc --iptables -p          # or:  jc -p ip
   }
 ]
 ```
+### ISO Datetime string
+```bash
+echo "2022-07-20T14:52:45Z" | jc --iso-datetime -p
+```
+```json
+{
+  "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
+}
+```
 ### iw dev `device` scan
 ```bash
 iw dev wlan0 scan | jc --iw-scan -p          # or:  jc -p iw dev wlan0 scan
@@ -1830,6 +1988,24 @@ jobs -l | jc --jobs -p
   }
 ]
 ```
+### JWT string
+```bash
+echo 'eyJhbGciOiJIUzI1N...' | jc --jwt -p
+```
+```json
+{
+  "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..."
+}
+```
 ### Key/Value files
 ```bash
 cat keyvalue.txt
@@ -2166,6 +2342,24 @@ lsusb -v | jc --lsusb -p          # or: jc -p lsusb -v
   }
 ]
 ```
+### M3U and M3U8 files
+```bash
+cat playlist.m3u | jc --m3u -p
+```
+```json
+[
+  {
+    "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"
+  }
+]
+```
 ### mount
 ```bash
 mount | jc --mount -p          # or:  jc -p mount
@@ -2478,40 +2672,40 @@ nmcli connection show ens33 | jc --nmcli -p          # or jc -p nmcli connection
 ```
 ```json
 [
-      {
-        "connection_id": "ens33",
-        "connection_uuid": "d92ece08-9e02-47d5-b2d2-92c80e155744",
-        "connection_stable_id": null,
-        "connection_type": "802-3-ethernet",
-        "connection_interface_name": "ens33",
-        "connection_autoconnect": "yes",
-        "ip4_address_1": "192.168.71.180/24",
-        "ip4_gateway": "192.168.71.2",
-        "ip4_route_1": {
-          "dst": "0.0.0.0/0",
-          "nh": "192.168.71.2",
-          "mt": 100
-        },
-        "ip4_route_2": {
-          "dst": "192.168.71.0/24",
-          "nh": "0.0.0.0",
-          "mt": 100
-        },
-        "ip4_dns_1": "192.168.71.2",
-        "ip4_domain_1": "localdomain",
-        "dhcp4_option_1": {
-          "name": "broadcast_address",
-          "value": "192.168.71.255"
-        },
-        "ip6_address_1": "fe80::c1cb:715d:bc3e:b8a0/64",
-        "ip6_gateway": null,
-        "ip6_route_1": {
-          "dst": "fe80::/64",
-          "nh": "::",
-          "mt": 100
-        }
-      }
-    ]
+  {
+    "connection_id": "ens33",
+    "connection_uuid": "d92ece08-9e02-47d5-b2d2-92c80e155744",
+    "connection_stable_id": null,
+    "connection_type": "802-3-ethernet",
+    "connection_interface_name": "ens33",
+    "connection_autoconnect": "yes",
+    "ip4_address_1": "192.168.71.180/24",
+    "ip4_gateway": "192.168.71.2",
+    "ip4_route_1": {
+      "dst": "0.0.0.0/0",
+      "nh": "192.168.71.2",
+      "mt": 100
+    },
+    "ip4_route_2": {
+      "dst": "192.168.71.0/24",
+      "nh": "0.0.0.0",
+      "mt": 100
+    },
+    "ip4_dns_1": "192.168.71.2",
+    "ip4_domain_1": "localdomain",
+    "dhcp4_option_1": {
+      "name": "broadcast_address",
+      "value": "192.168.71.255"
+    },
+    "ip6_address_1": "fe80::c1cb:715d:bc3e:b8a0/64",
+    "ip6_gateway": null,
+    "ip6_route_1": {
+      "dst": "fe80::/64",
+      "nh": "::",
+      "mt": 100
+    }
+  }
+]
 ```
 ### ntpq
 ```bash
@@ -2728,6 +2922,31 @@ pip show wrapt wheel | jc --pip-show -p          # or:  jc -p pip show wrapt whe
   }
 ]
 ```
+### PLIST files
+```bash
+cat info.plist | jc --plist -p
+```
+```json
+{
+  "NSAppleScriptEnabled": true,
+  "LSMultipleInstancesProhibited": true,
+  "CFBundleInfoDictionaryVersion": "6.0",
+  "DTPlatformVersion": "GM",
+  "CFBundleIconFile": "GarageBand.icns",
+  "CFBundleName": "GarageBand",
+  "DTSDKName": "macosx10.13internal",
+  "NSSupportsAutomaticGraphicsSwitching": true,
+  "RevisionDate": "2018-12-03_14:10:56",
+  "UTImportedTypeDeclarations": [
+    {
+      "UTTypeConformsTo": [
+        "public.data",
+        "public.content"
+      ]
+    }
+  ]
+}
+```
 ### postconf -M
 ```bash
 postconf -M | jc --postconf -p          # or jc -p postconf -M
@@ -3278,6 +3497,57 @@ sysctl -a | jc --sysctl -p          # or:  jc -p sysctl -a
   "user.expr_nest_max": 32
 }
 ```
+### Syslog strings (RFC 5424)
+```bash
+cat syslog.txt | jc --syslog -p
+```
+```json
+[
+  {
+    "priority": 35,
+    "version": 1,
+    "timestamp": "2003-10-11T22:14:15.003Z",
+    "hostname": "mymachine.example.com",
+    "appname": "evntslog",
+    "proc_id": null,
+    "msg_id": "ID47",
+    "structured_data": [
+      {
+        "identity": "exampleSDID@32473",
+        "parameters": {
+          "iut": "3",
+          "eventSource": "Application",
+          "eventID": "1011"
+        }
+      },
+      {
+        "identity": "examplePriority@32473",
+        "parameters": {
+          "class": "high"
+        }
+      }
+    ],
+    "message": "unauthorized attempt",
+    "timestamp_epoch": 1065935655,
+    "timestamp_epoch_utc": 1065910455
+  }
+]
+```
+### Syslog strings (RFC 3164)
+```bash
+cat syslog.txt | jc --syslog-bsd -p
+```
+```json
+[
+  {
+    "priority": 34,
+    "date": "Oct 11 22:14:15",
+    "hostname": "mymachine",
+    "tag": "su",
+    "content": "'su root' failed for lonvick on /dev/pts/8"
+  }
+]
+```
 ### systemctl
 ```bash
 systemctl -a | jc --systemctl -p          # or:  jc -p systemctl -a
@@ -3495,6 +3765,47 @@ timedatectl | jc --timedatectl -p          # or: jc -p timedatectl
   "epoch_utc": 1583888001
 }
 ```
+### Timestamp strings (UNIX Epoch)
+```bash
+echo '1658599410' | jc --timestamp -p
+```
+```json
+{
+  "naive": {
+    "year": 2022,
+    "month": "Jul",
+    "month_num": 7,
+    "day": 23,
+    "weekday": "Sat",
+    "weekday_num": 6,
+    "hour": 11,
+    "hour_24": 11,
+    "minute": 3,
+    "second": 30,
+    "period": "AM",
+    "day_of_year": 204,
+    "week_of_year": 29,
+    "iso": "2022-07-23T11:03:30"
+  },
+  "utc": {
+    "year": 2022,
+    "month": "Jul",
+    "month_num": 7,
+    "day": 23,
+    "weekday": "Sat",
+    "weekday_num": 6,
+    "hour": 6,
+    "hour_24": 18,
+    "minute": 3,
+    "second": 30,
+    "period": "PM",
+    "utc_offset": "+0000",
+    "day_of_year": 204,
+    "week_of_year": 29,
+    "iso": "2022-07-23T18:03:30+00:00"
+  }
+}
+```
 ### tob -b
 ```bash
 top -b -n 1 | jc --top -p          # or jc -p tob -b -n 1
@@ -3983,6 +4294,70 @@ uptime | jc --uptime -p          # or:  jc -p uptime
   "uptime_total_seconds": 273780
 }
 ```
+### URL string
+```bash
+echo "http://example.com/test/path?q1=foo&q1=bar&q2=baz#frag" \\
+     | jc --url -p
+```
+```json
+{
+  "url": "http://example.com/test/path?q1=foo&q1=bar&q2=baz#frag",
+  "scheme": "http",
+  "netloc": "example.com",
+  "path": "/test/path",
+  "path_list": [
+    "test",
+    "path"
+  ],
+  "query": "q1=foo&q1=bar&q2=baz",
+  "query_obj": {
+    "q1": [
+      "foo",
+      "bar"
+    ],
+    "q2": [
+      "baz"
+    ]
+  },
+  "fragment": "frag",
+  "username": null,
+  "password": null,
+  "hostname": "example.com",
+  "port": null,
+  "encoded": {
+    "url": "http://example.com/test/path?q1=foo&q1=bar&q2=baz#frag",
+    "scheme": "http",
+    "netloc": "example.com",
+    "path": "/test/path",
+    "path_list": [
+      "test",
+      "path"
+    ],
+    "query": "q1=foo&q1=bar&q2=baz",
+    "fragment": "frag",
+    "username": null,
+    "password": null,
+    "hostname": "example.com",
+    "port": null
+  },
+  "decoded": {
+    "url": "http://example.com/test/path?q1=foo&q1=bar&q2=baz#frag",
+    "scheme": "http",
+    "netloc": "example.com",
+    "path": "/test/path",
+    "path_list": [
+      "test",
+      "path"
+    ],
+    "query": "q1=foo&q1=bar&q2=baz",
+    "fragment": "frag",
+    "username": null,
+    "password": null,
+    "hostname": "example.com",
+    "port": null
+  }
+}
+```
 ### w
 ```bash
 w | jc --w -p          # or:  jc -p w
@@ -4091,6 +4466,85 @@ who -a | jc --who -p          # or:  jc -p who -a
   }
 ]
 ```
+### X.509 PEM and DER certificate files
+```bash
+cat entrust.pem | jc --x509-cert -p
+```
+```json
+[
+  {
+    "tbs_certificate": {
+      "version": "v3",
+      "serial_number": "a6:8b:79:29:00:00:00:00:50:d0:91:f9",
+      "signature": {
+        "algorithm": "sha384_ecdsa",
+        "parameters": null
+      },
+      "issuer": {
+        "country_name": "US",
+        "organization_name": "Entrust, Inc.",
+        "organizational_unit_name": [
+          "See www.entrust.net/legal-terms",
+          "(c) 2012 Entrust, Inc. - for authorized use only"
+        ],
+        "common_name": "Entrust Root Certification Authority - EC1"
+      },
+      "validity": {
+        "not_before": 1355844336,
+        "not_after": 2144764536,
+        "not_before_iso": "2012-12-18T15:25:36+00:00",
+        "not_after_iso": "2037-12-18T15:55:36+00:00"
+      },
+      "subject": {
+        "country_name": "US",
+        "organization_name": "Entrust, Inc.",
+        "organizational_unit_name": [
+          "See www.entrust.net/legal-terms",
+          "(c) 2012 Entrust, Inc. - for authorized use only"
+        ],
+        "common_name": "Entrust Root Certification Authority - EC1"
+      },
+      "subject_public_key_info": {
+        "algorithm": {
+          "algorithm": "ec",
+          "parameters": "secp384r1"
+        },
+        "public_key": "04:84:13:c9:d0:ba:6d:41:7b:e2:6c:d0:eb:55:5f:66:02:1a:24:f4:5b:89:69:47:e3:b8:c2:7d:f1:f2:02:c5:9f:a0:f6:5b:d5:8b:06:19:86:4f:53:10:6d:07:24:27:a1:a0:f8:d5:47:19:61:4c:7d:ca:93:27:ea:74:0c:ef:6f:96:09:fe:63:ec:70:5d:36:ad:67:77:ae:c9:9d:7c:55:44:3a:a2:63:51:1f:f5:e3:62:d4:a9:47:07:3e:cc:20"
+      },
+      "issuer_unique_id": null,
+      "subject_unique_id": null,
+      "extensions": [
+        {
+          "extn_id": "key_usage",
+          "critical": true,
+          "extn_value": [
+            "key_cert_sign",
+            "crl_sign"
+          ]
+        },
+        {
+          "extn_id": "basic_constraints",
+          "critical": true,
+          "extn_value": {
+            "ca": true,
+            "path_len_constraint": null
+          }
+        },
+        {
+          "extn_id": "key_identifier",
+          "critical": false,
+          "extn_value": "b7:63:e7:1a:dd:8d:e9:08:a6:55:83:a4:e0:6a:50:41:65:11:42:49"
+        }
+      ]
+    },
+    "signature_algorithm": {
+      "algorithm": "sha384_ecdsa",
+      "parameters": null
+    },
+    "signature_value": "30:64:02:30:61:79:d8:e5:42:47:df:1c:ae:53:99:17:b6:6f:1c:7d:e1:bf:11:94:d1:03:88:75:e4:8d:89:a4:8a:77:46:de:6d:61:ef:02:f5:fb:b5:df:cc:fe:4e:ff:fe:a9:e6:a7:02:30:5b:99:d7:85:37:06:b5:7b:08:fd:eb:27:8b:4a:94:f9:e1:fa:a7:8e:26:08:e8:7c:92:68:6d:73:d8:6f:26:ac:21:02:b8:99:b7:26:41:5b:25:60:ae:d0:48:1a:ee:06"
+  }
+]
+```
 ### XML files
 ```bash
 cat cd_catalog.xml

README.md

@@ -13,9 +13,9 @@ for an example.
 # JC
 JSON Convert
 
-`jc` JSONifies the output of many CLI tools and file-types for easier parsing in
-scripts. See the [**Parsers**](#parsers) section for supported commands and
-file-types.
+`jc` JSONifies the output of many CLI tools, file-types, and common strings
+for easier parsing in scripts. See the [**Parsers**](#parsers) section for
+supported commands, file-types, and strings.
 ```bash
 dig example.com | jc --dig
 ```
@@ -44,8 +44,10 @@ $ jc dig example.com | jq -r '.[].answer[].data'
 93.184.216.34
 ```
 
-The `jc` parsers can also be used as python modules. In this case the output
-will be a python dictionary, or list of dictionaries, instead of JSON:
+`jc` can also be used as a python library. In this case the output will be
+a python dictionary, a list of dictionaries, or even a
+[lazy iterable of dictionaries](#using-streaming-parsers-as-python-modules)
+instead of JSON:
 ```python
 >>> import subprocess
 >>> import jc
@@ -68,7 +70,7 @@ values are converted, and, in some cases, additional semantic context fields are
 added.
 
 To access the raw, pre-processed JSON, use the `-r` cli option or the `raw=True`
-function parameter in `parse()`.
+function parameter in `parse()` when using `jc` as a python library.
 
 Schemas for each parser can be found at the documentation link beside each
 [**Parser**](#parsers) below.
@@ -91,6 +93,7 @@ Use Cases:
 - [Ansible command output parsing](https://blog.kellybrazil.com/2020/08/30/parsing-command-output-in-ansible-with-jc/)
 - [Saltstack command output parsing](https://blog.kellybrazil.com/2020/09/15/parsing-command-output-in-saltstack-with-jc/)
 - [Nornir command output parsing](https://blog.kellybrazil.com/2020/12/09/parsing-command-output-in-nornir-with-jc/)
+- [FortiSOAR command output parsing](https://docs.fortinet.com/document/fortisoar/1.0.0/jc-parse-command-output/323/jc-parse-command-output-v1-0-0)
 
 ## Installation
 There are several ways to get `jc`. You can install via `pip`, OS package
@@ -118,6 +121,7 @@ pip3 install jc
 | macOS                                | `brew install jc`                                                             |
 | FreeBSD                              | `portsnap fetch update && cd /usr/ports/textproc/py-jc && make install clean` |
 | Ansible filter plugin                | `ansible-galaxy collection install community.general`                         |
+| FortiSOAR connector                  | Install from FortiSOAR Connector Marketplace                                  |
 
 > For more OS Packages, see https://repology.org/project/jc/versions.
 
@@ -129,14 +133,18 @@ on Github.
 `jc` accepts piped input from `STDIN` and outputs a JSON representation of the
 previous command's output to `STDOUT`.
 ```bash
-COMMAND | jc PARSER [OPTIONS]
+COMMAND | jc [OPTIONS] PARSER
+cat FILE | jc [OPTIONS] PARSER
+echo STRING | jc [OPTIONS] PARSER
 ```
 
 Alternatively, the "magic" syntax can be used by prepending `jc` to the command
-to be converted. Options can be passed to `jc` immediately before the command is
-given. (Note: command aliases and shell builtins are not supported)
+to be converted or in front of the absolute path for Proc files. Options can be
+passed to `jc` immediately before the command or Proc file path is given.
+(Note: command aliases and shell builtins are not supported)
 ```bash
 jc [OPTIONS] COMMAND
+jc [OPTIONS] /proc/<path-to-procfile>
 ```
 
 The JSON output can be compact (default) or pretty formatted with the `-p`
@@ -144,132 +152,154 @@ option.
 
 ### Parsers
 
-| Argument          | Command or Filetype                                     | Documentation                                                           |
-|-------------------|---------------------------------------------------------|-------------------------------------------------------------------------|
-| `         --acpi` | `acpi` command parser                                   | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/acpi)             |
-| `      --airport` | `airport -I` command parser                             | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/airport)          |
-| `    --airport-s` | `airport -s` command parser                             | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/airport_s)        |
-| `          --arp` | `arp` command parser                                    | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/arp)              |
-| `   --asciitable` | ASCII and Unicode table parser                          | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/asciitable)       |
-| ` --asciitable-m` | multi-line ASCII and Unicode table parser               | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/asciitable_m)     |
-| `        --blkid` | `blkid` command parser                                  | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/blkid)            |
-| `        --chage` | `chage --list` command parser                           | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/chage)            |
-| `        --cksum` | `cksum` and `sum` command parser                        | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/cksum)            |
-| `      --crontab` | `crontab` command and file parser                       | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/crontab)          |
-| `    --crontab-u` | `crontab` file parser with user support                 | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/crontab_u)        |
-| `          --csv` | CSV file parser                                         | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/csv)              |
-| `        --csv-s` | CSV file streaming parser                               | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/csv_s)            |
-| `         --date` | `date` command parser                                   | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/date)             |
-| `           --df` | `df` command parser                                     | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/df)               |
-| `          --dig` | `dig` command parser                                    | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/dig)              |
-| `          --dir` | `dir` command parser                                    | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/dir)              |
-| `    --dmidecode` | `dmidecode` command parser                              | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/dmidecode)        |
-| `       --dpkg-l` | `dpkg -l` command parser                                | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/dpkg_l)           |
-| `           --du` | `du` command parser                                     | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/du)               |
-| `          --env` | `env` command parser                                    | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/env)              |
-| `         --file` | `file` command parser                                   | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/file)             |
-| `       --finger` | `finger` command parser                                 | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/finger)           |
-| `         --free` | `free` command parser                                   | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/free)             |
-| `        --fstab` | `/etc/fstab` file parser                                | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/fstab)            |
-| `      --git-log` | `git log` command parser                                | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/git_log)          |
-| `    --git-log-s` | `git log` command streaming parser                      | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/git_log_s)        |
-| `        --group` | `/etc/group` file parser                                | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/group)            |
-| `      --gshadow` | `/etc/gshadow` file parser                              | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/gshadow)          |
-| `         --hash` | `hash` command parser                                   | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/hash)             |
-| `      --hashsum` | hashsum command parser (`md5sum`, `shasum`, etc.)       | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/hashsum)          |
-| `    --hciconfig` | `hciconfig` command parser                              | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/hciconfig)        |
-| `      --history` | `history` command parser                                | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/history)          |
-| `        --hosts` | `/etc/hosts` file parser                                | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/hosts)            |
-| `           --id` | `id` command parser                                     | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/id)               |
-| `     --ifconfig` | `ifconfig` command parser                               | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/ifconfig)         |
-| `          --ini` | INI file parser                                         | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/ini)              |
-| `       --iostat` | `iostat` command parser                                 | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/iostat)           |
-| `     --iostat-s` | `iostat` command streaming parser                       | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/iostat_s)         |
-| `     --iptables` | `iptables` command parser                               | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/iptables)         |
-| `      --iw-scan` | `iw dev [device] scan` command parser                   | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/iw_scan)          |
-| ` --jar-manifest` | MANIFEST.MF file parser                                 | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/jar_manifest)     |
-| `         --jobs` | `jobs` command parser                                   | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/jobs)             |
-| `           --kv` | Key/Value file parser                                   | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/kv)               |
-| `         --last` | `last` and `lastb` command parser                       | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/last)             |
-| `           --ls` | `ls` command parser                                     | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/ls)               |
-| `         --ls-s` | `ls` command streaming parser                           | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/ls_s)             |
-| `        --lsblk` | `lsblk` command parser                                  | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/lsblk)            |
-| `        --lsmod` | `lsmod` command parser                                  | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/lsmod)            |
-| `         --lsof` | `lsof` command parser                                   | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/lsof)             |
-| `        --lsusb` | `lsusb` command parser                                  | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/lsusb)            |
-| `        --mount` | `mount` command parser                                  | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/mount)            |
-| `       --mpstat` | `mpstat` command parser                                 | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/mpstat)           |
-| `     --mpstat-s` | `mpstat` command streaming parser                       | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/mpstat_s)         |
-| `      --netstat` | `netstat` command parser                                | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/netstat)          |
-| `        --nmcli` | `nmcli` command parser                                  | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/nmcli)            |
-| `         --ntpq` | `ntpq -p` command parser                                | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/ntpq)             |
-| `       --passwd` | `/etc/passwd` file parser                               | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/passwd)           |
-| `      --pidstat` | `pidstat -h` command parser                             | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/pidstat)          |
-| `    --pidstat-s` | `pidstat -h` command streaming parser                   | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/pidstat_s)        |
-| `         --ping` | `ping` and `ping6` command parser                       | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/ping)             |
-| `       --ping-s` | `ping` and `ping6` command streaming parser             | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/ping_s)           |
-| `     --pip-list` | `pip list` command parser                               | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/pip_list)         |
-| `     --pip-show` | `pip show` command parser                               | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/pip_show)         |
-| `     --postconf` | `postconf -M` command parser                            | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/postconf)         |
-| `           --ps` | `ps` command parser                                     | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/ps)               |
-| `        --route` | `route` command parser                                  | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/route)            |
-| `       --rpm-qi` | `rpm -qi` command parser                                | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/rpm_qi)           |
-| `        --rsync` | `rsync` command parser                                  | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/rsync)            |
-| `      --rsync-s` | `rsync` command streaming parser                        | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/rsync_s)          |
-| `       --sfdisk` | `sfdisk` command parser                                 | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/sfdisk)           |
-| `       --shadow` | `/etc/shadow` file parser                               | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/shadow)           |
-| `           --ss` | `ss` command parser                                     | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/ss)               |
-| `         --stat` | `stat` command parser                                   | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/stat)             |
-| `       --stat-s` | `stat` command streaming parser                         | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/stat_s)           |
-| `       --sysctl` | `sysctl` command parser                                 | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/sysctl)           |
-| `    --systemctl` | `systemctl` command parser                              | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl)        |
-| ` --systemctl-lj` | `systemctl list-jobs` command parser                    | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl_lj)     |
-| ` --systemctl-ls` | `systemctl list-sockets` command parser                 | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl_ls)     |
-| `--systemctl-luf` | `systemctl list-unit-files` command parser              | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl_luf)    |
-| `   --systeminfo` | `systeminfo` command parser                             | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/systeminfo)       |
-| `         --time` | `/usr/bin/time` command parser                          | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/time)             |
-| `  --timedatectl` | `timedatectl status` command parser                     | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/timedatectl)      |
-| `          --top` | `top -b` command parser                                 | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/top)              |
-| `        --top-s` | `top -b` command streaming parser                       | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/top_s)            |
-| `    --tracepath` | `tracepath` and `tracepath6` command parser             | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/tracepath)        |
-| `   --traceroute` | `traceroute` and `traceroute6` command parser           | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/traceroute)       |
-| `          --ufw` | `ufw status` command parser                             | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/ufw)              |
-| `  --ufw-appinfo` | `ufw app info [application]` command parser             | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/ufw_appinfo)      |
-| `        --uname` | `uname -a` command parser                               | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/uname)            |
-| `--update-alt-gs` | `update-alternatives --get-selections` command parser   | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/update_alt_gs)    |
-| ` --update-alt-q` | `update-alternatives --query` command parser            | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/update_alt_q)     |
-| `       --upower` | `upower` command parser                                 | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/upower)           |
-| `       --uptime` | `uptime` command parser                                 | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/uptime)           |
-| `       --vmstat` | `vmstat` command parser                                 | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/vmstat)           |
-| `     --vmstat-s` | `vmstat` command streaming parser                       | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/vmstat_s)         |
-| `            --w` | `w` command parser                                      | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/w)                |
-| `           --wc` | `wc` command parser                                     | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/wc)               |
-| `          --who` | `who` command parser                                    | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/who)              |
-| `          --xml` | XML file parser                                         | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/xml)              |
-| `       --xrandr` | `xrandr` command parser                                 | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/xrandr)           |
-| `         --yaml` | YAML file parser                                        | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/yaml)             |
-| `      --zipinfo` | `zipinfo` command parser                                | [📃](https://kellyjonbrazil.github.io/jc/docs/parsers/zipinfo)          |
+| Argument          | Command or Filetype                                     | Documentation                                                              |
+|-------------------|---------------------------------------------------------|----------------------------------------------------------------------------|
+| `         --acpi` | `acpi` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/acpi)           |
+| `      --airport` | `airport -I` command parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/airport)        |
+| `    --airport-s` | `airport -s` command parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/airport_s)      |
+| `          --arp` | `arp` command parser                                    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/arp)            |
+| `   --asciitable` | ASCII and Unicode table parser                          | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/asciitable)     |
+| ` --asciitable-m` | multi-line ASCII and Unicode table parser               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/asciitable_m)   |
+| `        --blkid` | `blkid` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/blkid)          |
+| `          --cef` | CEF string parser                                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/cef)            |
+| `        --cef-s` | CEF string streaming parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/cef_s)          |
+| `        --chage` | `chage --list` command parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/chage)          |
+| `        --cksum` | `cksum` and `sum` command parser                        | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/cksum)          |
+| `      --crontab` | `crontab` command and file parser                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/crontab)        |
+| `    --crontab-u` | `crontab` file parser with user support                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/crontab_u)      |
+| `          --csv` | CSV file parser                                         | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/csv)            |
+| `        --csv-s` | CSV file streaming parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/csv_s)          |
+| `         --date` | `date` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/date)           |
+| `           --df` | `df` command parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/df)             |
+| `          --dig` | `dig` command parser                                    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/dig)            |
+| `          --dir` | `dir` command parser                                    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/dir)            |
+| `    --dmidecode` | `dmidecode` command parser                              | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/dmidecode)      |
+| `       --dpkg-l` | `dpkg -l` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/dpkg_l)         |
+| `           --du` | `du` command parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/du)             |
+| `--email-address` | Email Address string parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/email_address)  |
+| `          --env` | `env` command parser                                    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/env)            |
+| `         --file` | `file` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/file)           |
+| `       --finger` | `finger` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/finger)         |
+| `         --free` | `free` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/free)           |
+| `        --fstab` | `/etc/fstab` file parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/fstab)          |
+| `      --git-log` | `git log` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/git_log)        |
+| `    --git-log-s` | `git log` command streaming parser                      | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/git_log_s)      |
+| `          --gpg` | `gpg --with-colons` command parser                      | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/gpg)            |
+| `        --group` | `/etc/group` file parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/group)          |
+| `      --gshadow` | `/etc/gshadow` file parser                              | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/gshadow)        |
+| `         --hash` | `hash` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/hash)           |
+| `      --hashsum` | hashsum command parser (`md5sum`, `shasum`, etc.)       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/hashsum)        |
+| `    --hciconfig` | `hciconfig` command parser                              | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/hciconfig)      |
+| `      --history` | `history` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/history)        |
+| `        --hosts` | `/etc/hosts` file parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/hosts)          |
+| `           --id` | `id` command parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/id)             |
+| `     --ifconfig` | `ifconfig` command parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ifconfig)       |
+| `          --ini` | INI file parser                                         | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ini)            |
+| `       --iostat` | `iostat` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/iostat)         |
+| `     --iostat-s` | `iostat` command streaming parser                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/iostat_s)       |
+| `   --ip-address` | IPv4 and IPv6 Address string parser                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ip_address)     |
+| `     --iptables` | `iptables` command parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/iptables)       |
+| ` --iso-datetime` | ISO 8601 Datetime string parser                         | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/iso_datetime)   |
+| `      --iw-scan` | `iw dev [device] scan` command parser                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/iw_scan)        |
+| ` --jar-manifest` | Java MANIFEST.MF file parser                            | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/jar_manifest)   |
+| `         --jobs` | `jobs` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/jobs)           |
+| `          --jwt` | JWT string parser                                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/jwt)            |
+| `           --kv` | Key/Value file parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/kv)             |
+| `         --last` | `last` and `lastb` command parser                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/last)           |
+| `           --ls` | `ls` command parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ls)             |
+| `         --ls-s` | `ls` command streaming parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ls_s)           |
+| `        --lsblk` | `lsblk` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/lsblk)          |
+| `        --lsmod` | `lsmod` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/lsmod)          |
+| `         --lsof` | `lsof` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/lsof)           |
+| `        --lsusb` | `lsusb` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/lsusb)          |
+| `          --m3u` | M3U and M3U8 file parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/m3u)            |
+| `        --mdadm` | `mdadm` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/mdadm)          |
+| `        --mount` | `mount` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/mount)          |
+| `       --mpstat` | `mpstat` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/mpstat)         |
+| `     --mpstat-s` | `mpstat` command streaming parser                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/mpstat_s)       |
+| `      --netstat` | `netstat` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/netstat)        |
+| `        --nmcli` | `nmcli` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/nmcli)          |
+| `         --ntpq` | `ntpq -p` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ntpq)           |
+| `       --passwd` | `/etc/passwd` file parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/passwd)         |
+| `      --pidstat` | `pidstat -H` command parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/pidstat)        |
+| `    --pidstat-s` | `pidstat -H` command streaming parser                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/pidstat_s)      |
+| `         --ping` | `ping` and `ping6` command parser                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ping)           |
+| `       --ping-s` | `ping` and `ping6` command streaming parser             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ping_s)         |
+| `     --pip-list` | `pip list` command parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/pip_list)       |
+| `     --pip-show` | `pip show` command parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/pip_show)       |
+| `        --plist` | PLIST file parser                                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/plist)          |
+| `     --postconf` | `postconf -M` command parser                            | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/postconf)       |
+| `         --proc` | `/proc/` file parser                                    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/proc)           |
+| `           --ps` | `ps` command parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ps)             |
+| `        --route` | `route` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/route)          |
+| `       --rpm-qi` | `rpm -qi` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/rpm_qi)         |
+| `        --rsync` | `rsync` command parser                                  | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/rsync)          |
+| `      --rsync-s` | `rsync` command streaming parser                        | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/rsync_s)        |
+| `       --sfdisk` | `sfdisk` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/sfdisk)         |
+| `       --shadow` | `/etc/shadow` file parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/shadow)         |
+| `           --ss` | `ss` command parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ss)             |
+| `         --stat` | `stat` command parser                                   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/stat)           |
+| `       --stat-s` | `stat` command streaming parser                         | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/stat_s)         |
+| `       --sysctl` | `sysctl` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/sysctl)         |
+| `       --syslog` | Syslog RFC 5424 string parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/syslog)         |
+| `     --syslog-s` | Syslog RFC 5424 string streaming parser                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/syslog_s)       |
+| `   --syslog-bsd` | Syslog RFC 3164 string parser                           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/syslog_bsd)     |
+| ` --syslog-bsd-s` | Syslog RFC 3164 string streaming parser                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/syslog_bsd_s)   |
+| `    --systemctl` | `systemctl` command parser                              | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl)      |
+| ` --systemctl-lj` | `systemctl list-jobs` command parser                    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl_lj)   |
+| ` --systemctl-ls` | `systemctl list-sockets` command parser                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl_ls)   |
+| `--systemctl-luf` | `systemctl list-unit-files` command parser              | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/systemctl_luf)  |
+| `   --systeminfo` | `systeminfo` command parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/systeminfo)     |
+| `         --time` | `/usr/bin/time` command parser                          | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/time)           |
+| `  --timedatectl` | `timedatectl status` command parser                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/timedatectl)    |
+| `    --timestamp` | Unix Epoch Timestamp string parser                      | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/timestamp)      |
+| `          --top` | `top -b` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/top)            |
+| `        --top-s` | `top -b` command streaming parser                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/top_s)          |
+| `    --tracepath` | `tracepath` and `tracepath6` command parser             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/tracepath)      |
+| `   --traceroute` | `traceroute` and `traceroute6` command parser           | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/traceroute)     |
+| `          --ufw` | `ufw status` command parser                             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ufw)            |
+| `  --ufw-appinfo` | `ufw app info [application]` command parser             | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/ufw_appinfo)    |
+| `        --uname` | `uname -a` command parser                               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/uname)          |
+| `--update-alt-gs` | `update-alternatives --get-selections` command parser   | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/update_alt_gs)  |
+| ` --update-alt-q` | `update-alternatives --query` command parser            | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/update_alt_q)   |
+| `       --upower` | `upower` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/upower)         |
+| `       --uptime` | `uptime` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/uptime)         |
+| `          --url` | URL string parser                                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/url)            |
+| `       --vmstat` | `vmstat` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/vmstat)         |
+| `     --vmstat-s` | `vmstat` command streaming parser                       | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/vmstat_s)       |
+| `            --w` | `w` command parser                                      | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/w)              |
+| `           --wc` | `wc` command parser                                     | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/wc)             |
+| `          --who` | `who` command parser                                    | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/who)            |
+| `    --x509-cert` | X.509 PEM and DER certificate file parser               | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/x509_cert)      |
+| `          --xml` | XML file parser                                         | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/xml)            |
+| `       --xrandr` | `xrandr` command parser                                 | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/xrandr)         |
+| `         --yaml` | YAML file parser                                        | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/yaml)           |
+| `      --zipinfo` | `zipinfo` command parser                                | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/zipinfo)        |
 
 ### Options
-| Short | Long            | Description                                                                                                  |
-|-------|-----------------|--------------------------------------------------------------------------------------------------------------|
-| `-a`  | `--about`       | About `jc`. Prints information about `jc` and the parsers (in JSON or YAML, of course!)                      |
-| `-C`  | `--force-color` | Force color output even when using pipes (overrides `-m` and the `NO_COLOR` env variable)                    |
-| `-d`  | `--debug`       | Debug mode. Prints trace messages if parsing issues are encountered (use`-dd` for verbose debugging)         |
-| `-h`  | `--help`        | Help. Use `jc -h --parser_name` for parser documentation                                                     |
-| `-m`  | `--monochrome`  | Monochrome output                                                                                            |
-| `-p`  | `--pretty`      | Pretty format the JSON output                                                                                |
-| `-q`  | `--quiet`       | Quiet mode. Suppresses parser warning messages (use `-qq` to ignore streaming parser errors)                 |
-| `-r`  | `--raw`         | Raw output. Provides more literal output, typically with string values and no additional semantic processing |
-| `-u`  | `--unbuffer`    | Unbuffer output                                                                                              |
-| `-v`  | `--version`     | Version information                                                                                          |
-| `-y`  | `--yaml-out`    | YAML output                                                                                                  |
-| `-B`  | `--bash-comp`   | Generate Bash shell completion script                                                                        |
-| `-Z`  | `--zsh-comp`    | Generate Zsh shell completion script                                                                         |
+
+| Short | Long            | Description                                                                                                         |
+|-------|-----------------|---------------------------------------------------------------------------------------------------------------------|
+| `-a`  | `--about`       | About `jc`. Prints information about `jc` and the parsers (in JSON or YAML, of course!)                             |
+| `-C`  | `--force-color` | Force color output even when using pipes (overrides `-m` and the `NO_COLOR` env variable)                           |
+| `-d`  | `--debug`       | Debug mode. Prints trace messages if parsing issues are encountered (use`-dd` for verbose debugging)                |
+| `-h`  | `--help`        | Help. Use `jc -h --parser_name` for parser documentation. Use twice to show hidden parsers (e.g. `-hh`)             |
+| `-m`  | `--monochrome`  | Monochrome output                                                                                                   |
+| `-M`  | `--meta-out`    | Add metadata to output including timestamp, parser name, magic command, magic command exit code, etc.               |                                                                        |
+| `-p`  | `--pretty`      | Pretty format the JSON output                                                                                       |
+| `-q`  | `--quiet`       | Quiet mode. Suppresses parser warning messages (use `-qq` to ignore streaming parser errors)                        |
+| `-r`  | `--raw`         | Raw output. Provides more literal output, typically with string values and no additional semantic processing        |
+| `-u`  | `--unbuffer`    | Unbuffer output                                                                                                     |
+| `-v`  | `--version`     | Version information                                                                                                 |
+| `-y`  | `--yaml-out`    | YAML output                                                                                                         |
+| `-B`  | `--bash-comp`   | Generate Bash shell completion script ([more info](https://github.com/kellyjonbrazil/jc/wiki/Shell-Completions))    |
+| `-Z`  | `--zsh-comp`    | Generate Zsh shell completion script ([more info](https://github.com/kellyjonbrazil/jc/wiki/Shell-Completions))     |
 
 ### Exit Codes
 Any fatal errors within `jc` will generate an exit code of `100`, otherwise the
-exit code will be `0`. When using the "magic" syntax (e.g. `jc ifconfig eth0`),
+exit code will be `0`.
+
+When using the "magic" syntax (e.g. `jc ifconfig eth0`),
 `jc` will store the exit code of the program being parsed and add it to the `jc`
 exit code. This way it is easier to determine if an error was from the parsed
 program or `jc`.
@@ -283,6 +313,44 @@ Consider the following examples using `ifconfig`:
 | `0`                  | `100`          | `100`              | Error in  `jc`                     |
 | `1`                  | `100`          | `101`              | Error in  both `ifconfig` and `jc` |
 
+When using the "magic" syntax you can also retrieve the exit code of the called
+program by using the `--meta-out` or `-M` option. This will append a `_jc_meta`
+object to the output that will include the magic command information, including
+the exit code.
+
+Here is an example with `ping`:
+```bash
+$ jc --meta-out -p ping -c2 192.168.1.252
+{
+  "destination_ip": "192.168.1.252",
+  "data_bytes": 56,
+  "pattern": null,
+  "destination": "192.168.1.252",
+  "packets_transmitted": 2,
+  "packets_received": 0,
+  "packet_loss_percent": 100.0,
+  "duplicates": 0,
+  "responses": [
+    {
+      "type": "timeout",
+      "icmp_seq": 0,
+      "duplicate": false
+    }
+  ],
+  "_jc_meta": {
+    "parser": "ping",
+    "timestamp": 1661357115.27949,
+    "magic_command": [
+      "ping",
+      "-c2",
+      "192.168.1.252"
+    ],
+    "magic_command_exit": 2
+  }
+}
+$ echo $?
+2
+```
 
 ### Setting Custom Colors via Environment Variable
 You can specify custom colors via the `JC_COLORS` environment variable. The
@@ -421,15 +489,16 @@ Local plugins may override default parsers.
 
 #### Locale
 
-For best results set the `LANG` locale environment variable to `C` or
-`en_US.UTF-8`. For example, either by setting directly on the command-line:
+For best results set the locale environment variables to `C` or
+`en_US.UTF-8` by modifying the `LC_ALL` variable:
 ```
-$ LANG=C date | jc --date
+$ LC_ALL=C date | jc --date
 ```
 
-or by exporting to the environment before running commands:
+You can also set the locale variables individually:
 ```
 $ export LANG=C
+$ export LC_NUMERIC=C
 ```
 
 On some older systems UTF-8 output will be downgraded to ASCII with `\\u`
@@ -473,12 +542,12 @@ that case you can suppress the warning message with the `-q` cli option or the
 
 macOS:
 ```bash
-cat lsof.out | jc --lsof -q
+cat lsof.out | jc -q --lsof
 ```
 
 or Windows:
 ```bash
-type lsof.out | jc --lsof -q
+type lsof.out | jc -q --lsof
 ```
 
 Tested on:
@@ -522,7 +591,7 @@ documentation.
 
 ### arp
 ```bash
-arp | jc --arp -p          # or:  jc -p arp
+arp | jc -p --arp          # or:  jc -p arp
 ```
 ```json
 [
@@ -561,7 +630,7 @@ cat homes.csv
 ...
 ```
 ```bash
-cat homes.csv | jc --csv -p
+cat homes.csv | jc -p --csv
 ```
 ```json
 [
@@ -602,7 +671,7 @@ cat homes.csv | jc --csv -p
 ```
 ### /etc/hosts file
 ```bash
-cat /etc/hosts | jc --hosts -p
+cat /etc/hosts | jc -p --hosts
 ```
 ```json
 [
@@ -629,7 +698,7 @@ cat /etc/hosts | jc --hosts -p
 ```
 ### ifconfig
 ```bash
-ifconfig | jc --ifconfig -p          # or:  jc -p ifconfig
+ifconfig | jc -p --ifconfig          # or:  jc -p ifconfig
 ```
 ```json
 [
@@ -687,29 +756,29 @@ Port = 50022
 ForwardX11 = no
 ```
 ```bash
-cat example.ini | jc --ini -p
+cat example.ini | jc -p --ini
 ```
 ```json
 {
   "bitbucket.org": {
-    "serveraliveinterval": "45",
-    "compression": "yes",
-    "compressionlevel": "9",
-    "forwardx11": "yes",
-    "user": "hg"
+    "ServeraLiveInterval": "45",
+    "Compression": "yes",
+    "CompressionLevel": "9",
+    "ForwardX11": "yes",
+    "User": "hg"
   },
   "topsecret.server.com": {
-    "serveraliveinterval": "45",
-    "compression": "yes",
-    "compressionlevel": "9",
-    "forwardx11": "no",
-    "port": "50022"
+    "ServeraLiveInterval": "45",
+    "Compression": "yes",
+    "CompressionLevel": "9",
+    "ForwardX11": "no",
+    "Port": "50022"
   }
 }
 ```
 ### ls
 ```bash
-$ ls -l /usr/bin | jc --ls -p          # or:  jc -p ls -l /usr/bin
+$ ls -l /usr/bin | jc -p --ls          # or:  jc -p ls -l /usr/bin
 ```
 ```json
 [
@@ -745,7 +814,7 @@ $ ls -l /usr/bin | jc --ls -p          # or:  jc -p ls -l /usr/bin
 ```
 ### netstat
 ```bash
-netstat -apee | jc --netstat -p          # or:  jc -p netstat -apee
+netstat -apee | jc -p --netstat          # or:  jc -p netstat -apee
 ```
 ```json
 [
@@ -833,7 +902,7 @@ netstat -apee | jc --netstat -p          # or:  jc -p netstat -apee
 ```
 ### /etc/passwd file
 ```bash
-cat /etc/passwd | jc --passwd -p
+cat /etc/passwd | jc -p --passwd
 ```
 ```json
 [
@@ -859,7 +928,7 @@ cat /etc/passwd | jc --passwd -p
 ```
 ### ping
 ```bash
-ping 8.8.8.8 -c 3 | jc --ping -p          # or:  jc -p ping 8.8.8.8 -c 3
+ping 8.8.8.8 -c 3 | jc -p --ping          # or:  jc -p ping 8.8.8.8 -c 3
 ```
 ```json
 {
@@ -912,7 +981,7 @@ ping 8.8.8.8 -c 3 | jc --ping -p          # or:  jc -p ping 8.8.8.8 -c 3
 ```
 ### ps
 ```bash
-ps axu | jc --ps -p          # or:  jc -p ps axu
+ps axu | jc -p --ps          # or:  jc -p ps axu
 ```
 ```json
 [
@@ -959,7 +1028,7 @@ ps axu | jc --ps -p          # or:  jc -p ps axu
 ```
 ### traceroute
 ```bash
-traceroute -m 2 8.8.8.8 | jc --traceroute -p
+traceroute -m 2 8.8.8.8 | jc -p --traceroute
 # or:  jc -p traceroute -m 2 8.8.8.8
 ```
 ```json
@@ -1024,7 +1093,7 @@ traceroute -m 2 8.8.8.8 | jc --traceroute -p
 ```
 ### uptime
 ```bash
-uptime | jc --uptime -p          # or:  jc -p uptime
+uptime | jc -p --uptime          # or:  jc -p uptime
 ```
 ```json
 {
@@ -1069,7 +1138,7 @@ cat cd_catalog.xml
   ...
 ```
 ```bash
-cat cd_catalog.xml | jc --xml -p
+cat cd_catalog.xml | jc -p --xml
 ```
 ```json
 {
@@ -1121,7 +1190,7 @@ spec:
       mode: ISTIO_MUTUAL
 ```
 ```bash
-cat istio.yaml | jc --yaml -p
+cat istio.yaml | jc -p --yaml
 ```
 ```json
 [

_config.yml

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

build-completions.py

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

completions/jc_bash_completion.sh

@@ -0,0 +1,90 @@
+_jc()
+{
+    local cur prev words cword jc_commands jc_parsers jc_options \
+          jc_about_options jc_about_mod_options jc_help_options jc_special_options
+
+    jc_commands=(acpi airport arp blkid chage cksum crontab date df dig dmidecode dpkg du env file finger free git gpg hciconfig id ifconfig iostat iptables iw jobs last lastb ls lsblk lsmod lsof lsusb md5 md5sum mdadm mount mpstat netstat nmcli ntpq pidstat ping ping6 pip pip3 postconf printenv ps route rpm rsync sfdisk sha1sum sha224sum sha256sum sha384sum sha512sum shasum ss stat sum sysctl systemctl systeminfo timedatectl top tracepath tracepath6 traceroute traceroute6 ufw uname update-alternatives upower uptime vdir vmstat w wc who xrandr zipinfo)
+    jc_parsers=(--acpi --airport --airport-s --arp --asciitable --asciitable-m --blkid --cef --cef-s --chage --cksum --crontab --crontab-u --csv --csv-s --date --df --dig --dir --dmidecode --dpkg-l --du --email-address --env --file --finger --free --fstab --git-log --git-log-s --gpg --group --gshadow --hash --hashsum --hciconfig --history --hosts --id --ifconfig --ini --iostat --iostat-s --ip-address --iptables --iso-datetime --iw-scan --jar-manifest --jobs --jwt --kv --last --ls --ls-s --lsblk --lsmod --lsof --lsusb --m3u --mdadm --mount --mpstat --mpstat-s --netstat --nmcli --ntpq --passwd --pidstat --pidstat-s --ping --ping-s --pip-list --pip-show --plist --postconf --proc --proc-buddyinfo --proc-consoles --proc-cpuinfo --proc-crypto --proc-devices --proc-diskstats --proc-filesystems --proc-interrupts --proc-iomem --proc-ioports --proc-loadavg --proc-locks --proc-meminfo --proc-modules --proc-mtrr --proc-pagetypeinfo --proc-partitions --proc-slabinfo --proc-softirqs --proc-stat --proc-swaps --proc-uptime --proc-version --proc-vmallocinfo --proc-vmstat --proc-zoneinfo --proc-driver-rtc --proc-net-arp --proc-net-dev --proc-net-dev-mcast --proc-net-if-inet6 --proc-net-igmp --proc-net-igmp6 --proc-net-ipv6-route --proc-net-netlink --proc-net-netstat --proc-net-packet --proc-net-protocols --proc-net-route --proc-net-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 --route --rpm-qi --rsync --rsync-s --sfdisk --shadow --ss --stat --stat-s --sysctl --syslog --syslog-s --syslog-bsd --syslog-bsd-s --systemctl --systemctl-lj --systemctl-ls --systemctl-luf --systeminfo --time --timedatectl --timestamp --top --top-s --tracepath --traceroute --ufw --ufw-appinfo --uname --update-alt-gs --update-alt-q --upower --uptime --url --vmstat --vmstat-s --w --wc --who --x509-cert --xml --xrandr --yaml --zipinfo)
+    jc_options=(--force-color -C --debug -d --monochrome -m --meta-out -M --pretty -p --quiet -q --raw -r --unbuffer -u --yaml-out -y)
+    jc_about_options=(--about -a)
+    jc_about_mod_options=(--pretty -p --yaml-out -y --monochrome -m --force-color -C)
+    jc_help_options=(--help -h)
+    jc_special_options=(--version -v --bash-comp -B --zsh-comp -Z)
+
+    COMPREPLY=()
+    _get_comp_words_by_ref cur prev words cword
+
+    # if jc_about_options are found anywhere in the line, then only complete from jc_about_mod_options
+    for i in "${words[@]::${#words[@]}-1}"; do
+        if [[ " ${jc_about_options[*]} " =~ " ${i} " ]]; then
+            COMPREPLY=( $( compgen -W "${jc_about_mod_options[*]}" \
+            -- "${cur}" ) )
+            return 0
+        fi
+    done
+
+    # if jc_help_options and a parser are found anywhere in the line, then no more completions
+    if
+        (
+            for i in "${words[@]::${#words[@]}-1}"; do
+                if [[ " ${jc_help_options[*]} " =~ " ${i} " ]]; then
+                    return 0
+                fi
+            done
+            return 1
+        ) && (
+            for i in "${words[@]::${#words[@]}-1}"; do
+                if [[ " ${jc_parsers[*]} " =~ " ${i} " ]]; then
+                    return 0
+                fi
+            done
+            return 1
+        ); then
+        return 0
+    fi
+
+    # if jc_help_options are found anywhere in the line, then only complete with parsers
+    for i in "${words[@]::${#words[@]}-1}"; do
+        if [[ " ${jc_help_options[*]} " =~ " ${i} " ]]; then
+            COMPREPLY=( $( compgen -W "${jc_parsers[*]}" \
+            -- "${cur}" ) )
+            return 0
+        fi
+    done
+
+    # if special options are found anywhere in the line, then no more completions
+    for i in "${words[@]::${#words[@]}-1}"; do
+        if [[ " ${jc_special_options[*]} " =~ " ${i} " ]]; then
+            return 0
+        fi
+    done
+
+    # if magic command is found anywhere in the line, use called command's autocompletion
+    for i in "${words[@]::${#words[@]}-1}"; do
+        if [[ " ${jc_commands[*]} " =~ " ${i} " ]]; then
+            _command
+            return 0
+        fi
+    done
+
+    # if "/pr[oc]" (magic for Procfile parsers) is in the current word, complete with files/directories in the path
+    if [[ "${cur}" =~ "/pr" ]]; then
+        _filedir
+        return 0
+    fi
+
+    # if a parser arg is found anywhere in the line, only show options and help options
+    for i in "${words[@]::${#words[@]}-1}"; do
+        if [[ " ${jc_parsers[*]} " =~ " ${i} " ]]; then
+            COMPREPLY=( $( compgen -W "${jc_options[*]} ${jc_help_options[*]}" \
+            -- "${cur}" ) )
+            return 0
+        fi
+    done
+
+    # default completion
+    COMPREPLY=( $( compgen -W "${jc_options[*]} ${jc_about_options[*]} ${jc_help_options[*]} ${jc_special_options[*]} ${jc_parsers[*]} ${jc_commands[*]}" \
+        -- "${cur}" ) )
+} &&
+complete -F _jc jc
+

completions/jc_zsh_completion.sh

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

docgen.sh

@@ -1,6 +1,9 @@
 #!/bin/bash
 # Generate docs.md
 # requires pydoc-markdown 4.6.1
+
+# use ./docgen all to generate all docs
+
 readme_config=$(cat <<'EOF'
 {
     "processors": [
@@ -112,23 +115,25 @@ do
     parsers+=("$value")
 done < <(jc -a | jq -c '.parsers[] | select(.plugin != true)')
 
-for parser in "${parsers[@]}"
-do (
+for parser in "${parsers[@]}"; do
     parser_name=$(jq -r '.name' <<< "$parser")
-    compatible=$(jq -r '.compatible | join(", ")' <<< "$parser")
-    version=$(jq -r '.version' <<< "$parser")
-    author=$(jq -r '.author' <<< "$parser")
-    author_email=$(jq -r '.author_email' <<< "$parser")
+        {
+            if [[ $1 == "all" ]] || ! git diff --quiet --exit-code HEAD~5 -- "parsers/${parser_name}.py"; then
+                compatible=$(jq -r '.compatible | join(", ")' <<< "$parser")
+                version=$(jq -r '.version' <<< "$parser")
+                author=$(jq -r '.author' <<< "$parser")
+                author_email=$(jq -r '.author_email' <<< "$parser")
 
-    echo "Building docs for: ${parser_name}"
-    echo "[Home](https://kellyjonbrazil.github.io/jc/)" > ../docs/parsers/"${parser_name}".md
-    pydoc-markdown -m jc.parsers."${parser_name}" "${parser_config}" >> ../docs/parsers/"${parser_name}".md
-    echo "### Parser Information" >> ../docs/parsers/"${parser_name}".md
-    echo "Compatibility:  ${compatible}" >> ../docs/parsers/"${parser_name}".md
-    echo >> ../docs/parsers/"${parser_name}".md
-    echo "Version ${version} by ${author} (${author_email})" >> ../docs/parsers/"${parser_name}".md
-    echo "+++ ${parser_name} docs complete"
-) &
+                echo "Building docs for: ${parser_name}"
+                echo "[Home](https://kellyjonbrazil.github.io/jc/)" > ../docs/parsers/"${parser_name}".md
+                pydoc-markdown -m jc.parsers."${parser_name}" "${parser_config}" >> ../docs/parsers/"${parser_name}".md
+                echo "### Parser Information" >> ../docs/parsers/"${parser_name}".md
+                echo "Compatibility:  ${compatible}" >> ../docs/parsers/"${parser_name}".md
+                echo >> ../docs/parsers/"${parser_name}".md
+                echo "Version ${version} by ${author} (${author_email})" >> ../docs/parsers/"${parser_name}".md
+                echo "+++ ${parser_name} docs complete"
+            fi
+        } &
 done
 wait
 echo "Document Generation Complete"

docs/lib.md

@@ -22,7 +22,7 @@ jc - JSON Convert lib module
 
 ```python
 def parse(parser_mod_name: str,
-          data: Union[str, Iterable[str]],
+          data: Union[str, bytes, Iterable[str]],
           quiet: bool = False,
           raw: bool = False,
           ignore_exceptions: bool = None,
@@ -34,11 +34,22 @@ Parse the string data using the supplied parser module.
 This function provides a high-level API to simplify parser use. This
 function will call built-in parsers and custom plugin parsers.
 
-Example:
+Example (standard parsers):
 
     >>> import jc
-    >>> jc.parse('date', 'Tue Jan 18 10:23:07 PST 2022')
-    {'year': 2022, 'month': 'Jan', 'month_num': 1, 'day'...}
+    >>> 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()`.
 
@@ -67,9 +78,9 @@ Parameters:
                                      cli-name, and --argument-name
                                      variants of the module name.
 
-    data:               (string or   data to parse (string for normal
-                        iterable)    parsers, iterable of strings for
-                                     streaming parsers)
+    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
 
@@ -151,7 +162,8 @@ Parameters:
 ### all\_parser\_info
 
 ```python
-def all_parser_info(documentation: bool = False) -> List[Dict]
+def all_parser_info(documentation: bool = False,
+                    show_hidden: bool = False) -> List[Dict]
 ```
 
 Returns a list of dictionaries that includes metadata for all parser
@@ -160,6 +172,8 @@ modules.
 Parameters:
 
     documentation:      (boolean)    include parser docstrings if True
+    show_hidden:        (boolean)    also show parsers marked as hidden
+                                     in their info metadata.
 
 <a id="jc.lib.get_help"></a>
 

docs/parsers/acpi.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ acpi -V | jc --acpi
 
-    or
+or
 
     $ jc acpi -V
 
@@ -250,4 +250,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/airport.md

@@ -11,7 +11,7 @@ Usage (cli):
 
     $ airport -I | jc --airport
 
-    or
+or
 
     $ jc airport -I
 
@@ -103,4 +103,4 @@ Returns:
 ### Parser Information
 Compatibility:  darwin
 
-Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/airport_s.md

@@ -11,7 +11,7 @@ Usage (cli):
 
     $ airport -s | jc --airport-s
 
-    or
+or
 
     $ jc airport -s
 
@@ -131,4 +131,4 @@ Returns:
 ### Parser Information
 Compatibility:  darwin
 
-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/arp.md

@@ -11,7 +11,7 @@ Usage (cli):
 
     $ arp | jc --arp
 
-    or
+or
 
     $ jc arp
 
@@ -140,4 +140,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, aix, freebsd, darwin
 
-Version 1.9 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.11 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/blkid.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ blkid | jc --blkid
 
-    or
+or
 
     $ jc blkid
 
@@ -143,4 +143,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/cef.md

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

docs/parsers/cef_s.md

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

docs/parsers/chage.md

@@ -11,7 +11,7 @@ Usage (cli):
 
     $ chage -l johndoe | jc --chage
 
-    or
+or
 
     $ jc chage -l johndoe
 
@@ -79,4 +79,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/cksum.md

@@ -13,7 +13,7 @@ Usage (cli):
 
     $ cksum file.txt | jc --cksum
 
-    or
+or
 
     $ jc cksum file.txt
 
@@ -77,4 +77,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd
 
-Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/crontab.md

@@ -12,7 +12,7 @@ Usage (cli):
 
     $ crontab -l | jc --crontab
 
-    or
+or
 
     $ jc crontab -l
 

docs/parsers/csv.md

@@ -20,8 +20,8 @@ Usage (module):
 
 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
 
     [
       {

docs/parsers/csv_s.md

@@ -29,8 +29,8 @@ Usage (module):
 
 Schema:
 
-    csv file converted to a Dictionary:
-    https://docs.python.org/3/library/csv.html
+CSV file converted to a Dictionary:
+https://docs.python.org/3/library/csv.html
 
     {
       "column_name1":     string,

docs/parsers/date.md

@@ -15,7 +15,7 @@ Usage (cli):
 
     $ date | jc --date
 
-    or
+or
 
     $ jc date
 
@@ -100,4 +100,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, freebsd
 
-Version 2.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 2.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/df.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ df | jc --df
 
-    or
+or
 
     $ jc df
 
@@ -120,4 +120,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, freebsd
 
-Version 1.10 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.11 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/dig.md

@@ -20,7 +20,7 @@ Usage (cli):
 
     $ dig example.com | jc --dig
 
-    or
+or
 
     $ jc dig example.com
 
@@ -345,4 +345,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, aix, freebsd, darwin, win32, cygwin
 
-Version 2.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 2.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/dir.md

@@ -143,4 +143,4 @@ Returns:
 ### Parser Information
 Compatibility:  win32
 
-Version 1.5 by Rasheed Elsaleh (rasheed@rebelliondefense.com)
+Version 1.6 by Rasheed Elsaleh (rasheed@rebelliondefense.com)

docs/parsers/dmidecode.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ dmidecode | jc --dmidecode
 
-    or
+or
 
     $ jc dmidecode
 
@@ -148,4 +148,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/dpkg_l.md

@@ -14,7 +14,7 @@ Usage (cli):
 
     $ dpkg -l | jc --dpkg-l
 
-    or
+or
 
     $ jc dpkg -l
 
@@ -154,4 +154,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/du.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ du | jc --du
 
-    or
+or
 
     $ jc du
 
@@ -110,4 +110,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, aix, freebsd
 
-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/email_address.md

@@ -0,0 +1,67 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.email_address"></a>
+
+# jc.parsers.email\_address
+
+jc - JSON Convert Email Address string parser
+
+Usage (cli):
+
+    $ echo "username@example.com" | jc --email-address
+
+Usage (module):
+
+    import jc
+    result = jc.parse('email_address', email_address_string)
+
+Schema:
+
+    {
+      "username":             string,
+      "domain":               string,
+      "local":                string,
+      "local_plus_suffix":    string or null
+    }
+
+Examples:
+
+    $ echo 'joe.user@gmail.com' | jc --email-address -p
+    {
+      "username": "joe.user",
+      "domain": "gmail.com",
+      "local": "joe.user",
+      "local_plus_suffix": null
+    }
+
+    $ echo 'joe.user+spam@gmail.com' | jc --email-address -p
+    {
+      "username": "joe.user",
+      "domain": "gmail.com",
+      "local": "joe.user+spam",
+      "local_plus_suffix": "spam"
+    }
+
+<a id="jc.parsers.email_address.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    Dictionary. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/env.md

@@ -14,7 +14,7 @@ Usage (cli):
 
     $ env | jc --env
 
-    or
+or
 
     $ jc env
 

docs/parsers/file.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ file * | jc --file
 
-    or
+or
 
     $ jc file *
 

docs/parsers/finger.md

@@ -11,7 +11,7 @@ Usage (cli):
 
     $ finger | jc --finger
 
-    or
+or
 
     $ jc finger
 

docs/parsers/free.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ free | jc --free
 
-    or
+or
 
     $ jc free
 
@@ -95,4 +95,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/fstab.md

@@ -108,4 +108,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, freebsd
 
-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/git_log.md

@@ -26,7 +26,7 @@ Usage (cli):
 
     $ git log | jc --git-log
 
-    or
+or
 
     $ jc git log
 
@@ -172,4 +172,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
 
-Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/git_log_s.md

@@ -108,4 +108,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
 
-Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/gpg.md

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

docs/parsers/group.md

@@ -132,4 +132,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, aix, freebsd
 
-Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/hash.md

@@ -60,4 +60,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd
 
-Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/hashsum.md

@@ -19,7 +19,7 @@ Usage (cli):
 
     $ md5sum file.txt | jc --hashsum
 
-    or
+or
 
     $ jc md5sum file.txt
 

docs/parsers/hciconfig.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ hciconfig | jc --hciconfig
 
-    or
+or
 
     $ jc hciconfig
 
@@ -340,4 +340,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/id.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ id | jc --id
 
-    or
+or
 
     $ jc id
 
@@ -128,4 +128,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, aix, freebsd
 
-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ifconfig.md

@@ -11,7 +11,7 @@ Usage (cli):
 
     $ ifconfig | jc --ifconfig
 
-    or
+or
 
     $ jc ifconfig
 
@@ -209,4 +209,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, aix, freebsd, darwin
 
-Version 1.11 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.12 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ini.md

@@ -54,18 +54,18 @@ Examples:
     $ cat example.ini | jc --ini -p
     {
       "bitbucket.org": {
-        "serveraliveinterval": "45",
-        "compression": "yes",
-        "compressionlevel": "9",
-        "forwardx11": "yes",
-        "user": "hg"
+        "ServerAliveInterval": "45",
+        "Compression": "yes",
+        "CompressionLevel": "9",
+        "ForwardX11": "yes",
+        "User": "hg"
       },
       "topsecret.server.com": {
-        "serveraliveinterval": "45",
-        "compression": "yes",
-        "compressionlevel": "9",
-        "forwardx11": "no",
-        "port": "50022"
+        "ServerAliveInterval": "45",
+        "Compression": "yes",
+        "CompressionLevel": "9",
+        "ForwardX11": "no",
+        "Port": "50022"
       }
     }
 
@@ -92,4 +92,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
 
-Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.8 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/iostat.md

@@ -11,7 +11,7 @@ Usage (cli):
 
     $ iostat | jc --iostat
 
-    or
+or
 
     $ jc iostat
 
@@ -182,4 +182,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/iostat_s.md

@@ -130,4 +130,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ip_address.md

@@ -0,0 +1,490 @@
+[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,
+      "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",
+      "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",
+      "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%128",
+      "ip_exploded": "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.0.0.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": "000000010010011100000000000000000000000011011110000000...",
+        "network": "0000000100100111000000000000000000000000110111100...",
+        "broadcast": "00000001001001110000000000000000000000001101111...",
+        "hostmask": "000000000000000000000000000000000000000000000000...",
+        "netmask": "1111111111111111111111111111111111111111111111111...",
+        "first_host": "0000000100100111000000000000000000000000110111...",
+        "last_host": "00000001001001110000000000000000000000001101111..."
+      }
+    }
+
+    $ 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",
+      "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": "0000000100100111000000000000000000000000110111100000000...",
+        "network": "00000001001001110000000000000000000000001101111000...",
+        "broadcast": "000000010010011100000000000000000000000011011110...",
+        "hostmask": "0000000000000000000000000000000000000000000000000...",
+        "netmask": "11111111111111111111111111111111111111111111111111...",
+        "first_host": "00000001001001110000000000000000000000001101111...",
+        "last_host": "000000010010011100000000000000000000000011011110..."
+      }
+    }
+
+    # 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",
+      "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.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": "0000000000000000000000000000000000000000000000000000000...",
+        "network": "00000000000000000000000000000000000000000000000000...",
+        "broadcast": "000000000000000000000000000000000000000000000000...",
+        "hostmask": "0000000000000000000000000000000000000000000000000...",
+        "netmask": "11111111111111111111111111111111111111111111111111...",
+        "first_host": "00000000000000000000000000000000000000000000000...",
+        "last_host": "000000000000000000000000000000000000000000000000..."
+      }
+    }
+
+    # 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",
+      "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.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": "0010000000000010110000000000000000000010000001000000000...",
+        "network": "00100000000000101100000000000000000000100000010000...",
+        "broadcast": "001000000000001011000000000000000000001000000100...",
+        "hostmask": "0000000000000000000000000000000000000000000000001...",
+        "netmask": "11111111111111111111111111111111111111111111111100...",
+        "first_host": "00100000000000101100000000000000000000100000010...",
+        "last_host": "001000000000001011000000000000000000001000000100..."
+      }
+    }
+
+    # 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",
+      "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....0.0.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": "001000000000000100000000000000000100000100110110111000...",
+        "network": "0010000000000001000000000000000001000001001101101...",
+        "broadcast": "00100000000000010000000000000000010000010011011...",
+        "hostmask": "000000000000000000000000000000000000000000000000...",
+        "netmask": "1111111111111111111111111111111111111111111111111...",
+        "first_host": "0010000000000001000000000000000001000001001101...",
+        "last_host": "00100000000000010000000000000000010000010011011..."
+      }
+    }
+
+<a id="jc.parsers.ip_address.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    Dictionary. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/iptables.md

@@ -11,7 +11,7 @@ Usage (cli):
 
     $ sudo iptables -L -t nat | jc --iptables
 
-    or
+or
 
     $ jc iptables -L -t nat
 
@@ -186,4 +186,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.8 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/iso_datetime.md

@@ -0,0 +1,91 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.iso_datetime"></a>
+
+# jc.parsers.iso\_datetime
+
+jc - JSON Convert ISO 8601 Datetime string parser
+
+This parser supports standard ISO 8601 strings that include both date and
+time. If no timezone or offset information is available in the sring, 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.iso_datetime.parse"></a>
+
+### parse
+
+```python
+def parse(data, raw=False, quiet=False)
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    Dictionary. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux, aix, freebsd, darwin, win32, cygwin
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/iw_scan.md

@@ -12,7 +12,7 @@ Usage (cli):
 
     $ iw dev wlan0 scan | jc --iw-scan
 
-    or
+or
 
     $ jc iw dev wlan0 scan
 

docs/parsers/jar_manifest.md

@@ -3,7 +3,7 @@
 
 # jc.parsers.jar\_manifest
 
-jc - JSON Convert `MANIFEST.MF` file parser
+jc - JSON Convert Java `MANIFEST.MF` file parser
 
 Usage (cli):
 

docs/parsers/jobs.md

@@ -116,4 +116,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd
 
-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/jwt.md

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

docs/parsers/last.md

@@ -15,7 +15,7 @@ Usage (cli):
 
     $ last | jc --last
 
-    or
+or
 
     $ jc last
 

docs/parsers/ls.md

@@ -26,7 +26,7 @@ Usage (cli):
 
     $ ls | jc --ls
 
-    or
+or
 
     $ jc ls
 
@@ -140,4 +140,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd
 
-Version 1.11 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.12 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ls_s.md

@@ -99,4 +99,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd
 
-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/lsblk.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ lsblk | jc --lsblk
 
-    or
+or
 
     $ jc lsblk
 
@@ -297,4 +297,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.8 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.9 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/lsmod.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ lsmod | jc --lsmod
 
-    or
+or
 
     $ jc lsmod
 
@@ -148,4 +148,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/lsof.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ lsof | jc --lsof
 
-    or
+or
 
     $ jc lsof
 
@@ -140,6 +140,6 @@ Returns:
     List of Dictionaries. Raw or processed structured data.
 
 ### Parser Information
-Compatibility:  linux
+Compatibility:  linux, darwin, aix, freebsd
 
-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/lsusb.md

@@ -11,7 +11,7 @@ Usage (cli):
 
     $ lsusb -v | jc --lsusb
 
-    or
+or
 
     $ jc lsusb -v
 
@@ -134,6 +134,12 @@ Schema:
             }
           }
         },
+        "device_qualifier": {
+          "<item>": {
+            "value":                          string,
+            "description":                    string
+          }
+        },
         "device_status": {
           "value":                            string,
           "description":                      string
@@ -284,4 +290,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/m3u.md

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

docs/parsers/mdadm.md

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

docs/parsers/mount.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ mount | jc --mount
 
-    or
+or
 
     $ jc mount
 

docs/parsers/mpstat.md

@@ -11,7 +11,7 @@ Usage (cli):
 
     $ mpstat | jc --mpstat
 
-    or
+or
 
     $ jc mpstat
 
@@ -137,4 +137,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/mpstat_s.md

@@ -125,4 +125,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/netstat.md

@@ -14,7 +14,7 @@ Usage (cli):
 
     $ netstat | jc --netstat
 
-    or
+or
 
     $ jc netstat
 
@@ -378,4 +378,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, freebsd
 
-Version 1.12 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.13 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/nmcli.md

@@ -18,7 +18,7 @@ Usage (cli):
 
     $ nmcli device show lo | jc --nmcli
 
-    or
+or
 
     $ jc nmcli device show lo
 

docs/parsers/ntpq.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ ntpq -p | jc --ntpq
 
-    or
+or
 
     $ jc ntpq -p
 
@@ -229,4 +229,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, freebsd
 
-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/pidstat.md

@@ -3,18 +3,18 @@
 
 # jc.parsers.pidstat
 
-jc - JSON Convert `pidstat -h` command output parser
+jc - JSON Convert `pidstat -H` command output parser
 
-Must use the `-h` option in `pidstat`. All other `pidstat` options are
-supported in combination with `-h`.
+Must use the `-H` (or `-h`, if `-H` is not available) option in `pidstat`.
+All other `pidstat` options are supported in combination with this option.
 
 Usage (cli):
 
-    $ pidstat -h | jc --pidstat
+    $ pidstat -H | jc --pidstat
 
-    or
+or
 
-    $ jc pidstat -h
+    $ jc pidstat -H
 
 Usage (module):
 
@@ -51,7 +51,7 @@ Schema:
 
 Examples:
 
-    $ pidstat -hl | jc --pidstat -p
+    $ pidstat -Hl | jc --pidstat -p
     [
       {
         "time": 1646859134,
@@ -88,7 +88,7 @@ Examples:
       }
     ]
 
-    $ pidstat -hl | jc --pidstat -p -r
+    $ pidstat -Hl | jc --pidstat -p -r
     [
       {
         "time": "1646859134",
@@ -148,4 +148,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/pidstat_s.md

@@ -3,17 +3,17 @@
 
 # jc.parsers.pidstat\_s
 
-jc - JSON Convert `pidstat -h` command output streaming parser
+jc - JSON Convert `pidstat -H` command output streaming parser
 
 > This streaming parser outputs JSON Lines (cli) or returns an Iterable of
 > Dictionaries (module)
 
-Must use the `-h` option in `pidstat`. All other `pidstat` options are
-supported in combination with `-h`.
+Must use the `-H` (or `-h`, if `-H` is not available) option in `pidstat`.
+All other `pidstat` options are supported in combination with this option.
 
 Usage (cli):
 
-    $ pidstat | jc --pidstat-s
+    $ pidstat -H | jc --pidstat-s
 
 > Note: When piping `jc` converted `pidstat` output to other processes it
 > may appear the output is hanging due to the OS pipe buffers. This is
@@ -65,13 +65,13 @@ Schema:
 
 Examples:
 
-    $ pidstat -hl | jc --pidstat-s
+    $ pidstat -Hl | jc --pidstat-s
     {"time":1646859134,"uid":0,"pid":1,"percent_usr":0.0,"percent_syste...}
     {"time":1646859134,"uid":0,"pid":6,"percent_usr":0.0,"percent_syste...}
     {"time":1646859134,"uid":0,"pid":9,"percent_usr":0.0,"percent_syste...}
     ...
 
-    $ pidstat -hl | jc --pidstat-s -r
+    $ pidstat -Hl | jc --pidstat-s -r
     {"time":"1646859134","uid":"0","pid":"1","percent_usr":"0.00","perc...}
     {"time":"1646859134","uid":"0","pid":"6","percent_usr":"0.00","perc...}
     {"time":"1646859134","uid":"0","pid":"9","percent_usr":"0.00","perc...}
@@ -107,4 +107,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux
 
-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ping.md

@@ -14,7 +14,7 @@ Usage (cli):
 
     $ ping -c 3 1.2.3.4 | jc --ping
 
-    or
+or
 
     $ jc ping -c 3 1.2.3.4
 
@@ -185,4 +185,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, freebsd
 
-Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.8 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/ping_s.md

@@ -106,4 +106,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, freebsd
 
-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/pip_list.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ pip list | jc --pip-list
 
-    or
+or
 
     $ jc pip list
 

docs/parsers/pip_show.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ pip show | jc --pip-show
 
-    or
+or
 
     $ jc pip show
 

docs/parsers/plist.md

@@ -0,0 +1,77 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.plist"></a>
+
+# jc.parsers.plist
+
+jc - JSON Convert PLIST file parser
+
+Converts binary and XML PLIST files.
+
+Binary values are converted into an ASCII hex representation.
+
+Datetime objects are converted into Unix epoch timestamps and ISO strings.
+The timestamp and ISO string will maintain the same naive or timezone-aware
+properties as the object in the original PLIST file.
+
+Usage (cli):
+
+    $ cat file.plist | jc --plist
+
+Usage (module):
+
+    import jc
+    result = jc.parse('plist', plist_file_output)
+
+Schema:
+
+    {
+      "<key>":            string/integer/float/boolean/object/array/null
+    }
+
+Examples:
+
+    $ cat info.plist | jc --plist -p
+    {
+      "NSAppleScriptEnabled": true,
+      "LSMultipleInstancesProhibited": true,
+      "CFBundleInfoDictionaryVersion": "6.0",
+      "DTPlatformVersion": "GM",
+      "CFBundleIconFile": "GarageBand.icns",
+      "CFBundleName": "GarageBand",
+      "DTSDKName": "macosx10.13internal",
+      "NSSupportsAutomaticGraphicsSwitching": true,
+      "RevisionDate": "2018-12-03_14:10:56",
+      "UTImportedTypeDeclarations": [
+        {
+          "UTTypeConformsTo": [
+            "public.data",
+            "public.content"
+      ...
+    }
+
+<a id="jc.parsers.plist.parse"></a>
+
+### parse
+
+```python
+def parse(data: Union[str, bytes],
+          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:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux, darwin, cygwin, win32, aix, freebsd
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/postconf.md

@@ -9,7 +9,7 @@ Usage (cli):
 
     $ postconf -M | jc --postconf
 
-    or
+or
 
     $ jc postconf -M
 

docs/parsers/proc.md

@@ -0,0 +1,142 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc"></a>
+
+# jc.parsers.proc
+
+jc - JSON Convert Proc file output parser
+
+This parser automatically identifies the Proc file and calls the
+corresponding parser to peform the parsing.
+
+Magic syntax for converting `/proc` files is also supported by running
+`jc /proc/<path to file>`. Any `jc` options must be specified before the
+`/proc` path.
+
+specific Proc file parsers can also be called directly, if desired and have
+a naming convention of `proc-<name>` (cli) or `proc_<name>` (module).
+
+Usage (cli):
+
+    $ cat /proc/meminfo | jc --proc
+
+or
+
+    $ jc /proc/meminfo
+
+or
+
+    $ cat /proc/meminfo | jc --proc-memifno
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_file)
+
+Schema:
+
+See the specific Proc parser for the schema:
+
+    $ jc --help --proc-<name>
+
+For example:
+
+    $ jc --help --proc-meminfo
+
+Specific Proc file parser names can be found with `jc -hh` or `jc -a`.
+
+Schemas can also be found online at:
+
+    https://kellyjonbrazil.github.io/jc/docs/parsers/proc_<name>
+
+For example:
+
+    https://kellyjonbrazil.github.io/jc/docs/parsers/proc_meminfo
+
+Examples:
+
+    $ cat /proc/modules | jc --proc -p
+    [
+      {
+        "module": "binfmt_misc",
+        "size": 24576,
+        "used": 1,
+        "used_by": [],
+        "status": "Live",
+        "location": "0xffffffffc0ab4000"
+      },
+      {
+        "module": "vsock_loopback",
+        "size": 16384,
+        "used": 0,
+        "used_by": [],
+        "status": "Live",
+        "location": "0xffffffffc0a14000"
+      },
+      {
+        "module": "vmw_vsock_virtio_transport_common",
+        "size": 36864,
+        "used": 1,
+        "used_by": [
+          "vsock_loopback"
+        ],
+        "status": "Live",
+        "location": "0xffffffffc0a03000"
+      },
+      ...
+    ]
+
+    $ proc_modules | jc --proc_modules -p -r
+    [
+      {
+        "module": "binfmt_misc",
+        "size": "24576",
+        "used": "1",
+        "used_by": [],
+        "status": "Live",
+        "location": "0xffffffffc0ab4000"
+      },
+      {
+        "module": "vsock_loopback",
+        "size": "16384",
+        "used": "0",
+        "used_by": [],
+        "status": "Live",
+        "location": "0xffffffffc0a14000"
+      },
+      {
+        "module": "vmw_vsock_virtio_transport_common",
+        "size": "36864",
+        "used": "1",
+        "used_by": [
+          "vsock_loopback"
+        ],
+        "status": "Live",
+        "location": "0xffffffffc0a03000"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_buddyinfo.md

@@ -0,0 +1,128 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_buddyinfo"></a>
+
+# jc.parsers.proc\_buddyinfo
+
+jc - JSON Convert `/proc/buddyinfo` file parser
+
+Usage (cli):
+
+    $ cat /proc/buddyinfo | jc --proc
+
+or
+
+    $ jc /proc/buddyinfo
+
+or
+
+    $ cat /proc/buddyinfo | jc --proc-buddyinfo
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_buddyinfo_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_buddyinfo', proc_buddyinfo_file)
+
+Schema:
+
+All values are integers.
+
+    [
+      {
+        "node":               integer,
+        "zone":               string,
+        "free_chunks": [
+                              integer  # [0]
+        ]
+      }
+    ]
+
+    [0] array index correlates to the Order number.
+        E.g. free_chunks[0] is the value for Order 0
+
+
+Examples:
+
+    $ cat /proc/buddyinfo | jc --proc -p
+    [
+      {
+        "node": 0,
+        "zone": "DMA",
+        "free_chunks": [
+          0,
+          0,
+          0,
+          1,
+          1,
+          1,
+          1,
+          1,
+          0,
+          1,
+          3
+        ]
+      },
+      {
+        "node": 0,
+        "zone": "DMA32",
+        "free_chunks": [
+          78,
+          114,
+          82,
+          52,
+          38,
+          25,
+          13,
+          9,
+          3,
+          4,
+          629
+        ]
+      },
+      {
+        "node": 0,
+        "zone": "Normal",
+        "free_chunks": [
+          0,
+          22,
+          8,
+          10,
+          1,
+          1,
+          2,
+          11,
+          13,
+          0,
+          0
+        ]
+      }
+    ]
+
+<a id="jc.parsers.proc_buddyinfo.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_consoles.md

@@ -0,0 +1,111 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_consoles"></a>
+
+# jc.parsers.proc\_consoles
+
+jc - JSON Convert `/proc/consoles` file parser
+
+Usage (cli):
+
+    $ cat /proc/consoles | jc --proc
+
+or
+
+    $ jc /proc/consoles
+
+or
+
+    $ cat /proc/consoles | jc --proc-consoles
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_consoles_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_consoles', proc_consoles_file)
+
+Schema:
+
+    [
+      {
+        "device":                     string,
+        "operations":                 string,
+        "operations_list": [
+                                      string  # [0]
+        ],
+        "flags":                      string,
+        "flags_list": [
+                                      string  # [1]
+        ],
+        "major":                      integer,
+        "minor":                      integer
+      }
+    ]
+
+    [0] Values: read, write, unblank
+    [1] Values: enabled, preferred, primary boot, prink buffer,
+                braille device, safe when CPU offline
+
+Examples:
+
+    $ cat /proc/consoles | jc --proc -p
+    [
+      {
+        "device": "tty0",
+        "operations": "-WU",
+        "operations_list": [
+          "write",
+          "unblank"
+        ],
+        "flags": "ECp",
+        "flags_list": [
+          "enabled",
+          "preferred",
+          "printk buffer"
+        ],
+        "major": 4,
+        "minor": 7
+      },
+      {
+        "device": "ttyS0",
+        "operations": "-W-",
+        "operations_list": [
+          "write"
+        ],
+        "flags": "Ep",
+        "flags_list": [
+          "enabled",
+          "printk buffer"
+        ],
+        "major": 4,
+        "minor": 64
+      }
+    ]
+
+<a id="jc.parsers.proc_consoles.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_cpuinfo.md

@@ -0,0 +1,247 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_cpuinfo"></a>
+
+# jc.parsers.proc\_cpuinfo
+
+jc - JSON Convert `/proc/cpuinfo` file parser
+
+Usage (cli):
+
+    $ cat /proc/cpuinfo | jc --proc
+
+or
+
+    $ jc /proc/cpuinfo
+
+or
+
+    $ cat /proc/cpuinfo | jc --proc-cpuinfo
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_cpuinfo_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_cpuinfo', proc_cpuinfo_file)
+
+Schema:
+
+Integer, float, and boolean ("yes"/"no") conversions are attempted. Blank
+strings are converted to `null`.
+
+"Well-known" keys like `cache size`, `address types`, `bugs`, and `flags`
+are processed into sensible data types. (see below)
+
+If this is not desired, then use the `--raw` (CLI) or `raw=True` (Module)
+option.
+
+    [
+      {
+        "processor":                  integer,
+        "address sizes":              string,
+        "address_size_physical":      integer,  # in bits
+        "address_size_virtual":       integer,  # in bits
+        "cache size":                 string,
+        "cache_size_num":             integer,
+        "cache_size_unit":            string,
+        "flags": [
+                                      string
+        ],
+        "bugs": [
+                                      string
+        ],
+        "bogomips":                   float,
+        <key>:                        string/int/float/boolean/null
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/cpuinfo | jc --proc -p
+    [
+      {
+        "processor": 0,
+        "vendor_id": "GenuineIntel",
+        "cpu family": 6,
+        "model": 142,
+        "model name": "Intel(R) Core(TM) i5-8279U CPU @ 2.40GHz",
+        "stepping": 10,
+        "cpu MHz": 2400.0,
+        "cache size": "6144 KB",
+        "physical id": 0,
+        "siblings": 1,
+        "core id": 0,
+        "cpu cores": 1,
+        "apicid": 0,
+        "initial apicid": 0,
+        "fpu": true,
+        "fpu_exception": true,
+        "cpuid level": 22,
+        "wp": true,
+        "bogomips": 4800.0,
+        "clflush size": 64,
+        "cache_alignment": 64,
+        "address sizes": "45 bits physical, 48 bits virtual",
+        "power management": null,
+        "address_size_physical": 45,
+        "address_size_virtual": 48,
+        "cache_size_num": 6144,
+        "cache_size_unit": "KB",
+        "flags": [
+          "fpu",
+          "vme",
+          "de",
+          "pse",
+          "tsc",
+          "msr",
+          "pae",
+          "mce",
+          "cx8",
+          "apic",
+          "sep",
+          "mtrr",
+          "pge",
+          "mca",
+          "cmov",
+          "pat",
+          "pse36",
+          "clflush",
+          "mmx",
+          "fxsr",
+          "sse",
+          "sse2",
+          "ss",
+          "syscall",
+          "nx",
+          "pdpe1gb",
+          "rdtscp",
+          "lm",
+          "constant_tsc",
+          "arch_perfmon",
+          "nopl",
+          "xtopology",
+          "tsc_reliable",
+          "nonstop_tsc",
+          "cpuid",
+          "pni",
+          "pclmulqdq",
+          "ssse3",
+          "fma",
+          "cx16",
+          "pcid",
+          "sse4_1",
+          "sse4_2",
+          "x2apic",
+          "movbe",
+          "popcnt",
+          "tsc_deadline_timer",
+          "aes",
+          "xsave",
+          "avx",
+          "f16c",
+          "rdrand",
+          "hypervisor",
+          "lahf_lm",
+          "abm",
+          "3dnowprefetch",
+          "cpuid_fault",
+          "invpcid_single",
+          "pti",
+          "ssbd",
+          "ibrs",
+          "ibpb",
+          "stibp",
+          "fsgsbase",
+          "tsc_adjust",
+          "bmi1",
+          "avx2",
+          "smep",
+          "bmi2",
+          "invpcid",
+          "rdseed",
+          "adx",
+          "smap",
+          "clflushopt",
+          "xsaveopt",
+          "xsavec",
+          "xgetbv1",
+          "xsaves",
+          "arat",
+          "md_clear",
+          "flush_l1d",
+          "arch_capabilities"
+        ],
+        "bugs": [
+          "cpu_meltdown",
+          "spectre_v1",
+          "spectre_v2",
+          "spec_store_bypass",
+          "l1tf",
+          "mds",
+          "swapgs",
+          "itlb_multihit",
+          "srbds"
+        ]
+      },
+      ...
+    ]
+
+    $ cat /proc/cpuinfo | jc --proc_cpuinfo -p -r
+    [
+      {
+        "processor": "0",
+        "vendor_id": "GenuineIntel",
+        "cpu family": "6",
+        "model": "142",
+        "model name": "Intel(R) Core(TM) i5-8279U CPU @ 2.40GHz",
+        "stepping": "10",
+        "cpu MHz": "2400.000",
+        "cache size": "6144 KB",
+        "physical id": "0",
+        "siblings": "1",
+        "core id": "0",
+        "cpu cores": "1",
+        "apicid": "0",
+        "initial apicid": "0",
+        "fpu": "yes",
+        "fpu_exception": "yes",
+        "cpuid level": "22",
+        "wp": "yes",
+        "flags": "fpu vme de pse tsc msr pae mce cx8 apic sep mtrr pge ...",
+        "bugs": "cpu_meltdown spectre_v1 spectre_v2 spec_store_bypass ...",
+        "bogomips": "4800.00",
+        "clflush size": "64",
+        "cache_alignment": "64",
+        "address sizes": "45 bits physical, 48 bits virtual",
+        "power management": ""
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc_cpuinfo.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_crypto.md

@@ -0,0 +1,143 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_crypto"></a>
+
+# jc.parsers.proc\_crypto
+
+jc - JSON Convert `/proc/crypto` file parser
+
+Usage (cli):
+
+    $ cat /proc/crypto | jc --proc
+
+or
+
+    $ jc /proc/crypto
+
+or
+
+    $ cat /proc/crypto | jc --proc-crypto
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_crypto_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_crypto', proc_crypto_file)
+
+Schema:
+
+"Well-known" keys like `priority` and `refcnt` are converted to integers.
+Also, keynames ending in "size" are converted to integers.
+
+If this is not desired, then use the `--raw` (CLI) or `raw=True` (Module)
+option.
+
+    [
+      {
+        "name":                   string,
+        "driver":                 string,
+        "module":                 string,
+        "priority":               integer,
+        "refcnt":                 integer,
+        "selftest":               string,
+        "internal":               string,
+        "type":                   string,
+        "*size":                  integer
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/crypto | jc --proc -p
+    [
+      {
+        "name": "ecdh",
+        "driver": "ecdh-generic",
+        "module": "ecdh_generic",
+        "priority": 100,
+        "refcnt": 1,
+        "selftest": "passed",
+        "internal": "no",
+        "type": "kpp"
+      },
+      {
+        "name": "blake2b-512",
+        "driver": "blake2b-512-generic",
+        "module": "blake2b_generic",
+        "priority": 100,
+        "refcnt": 1,
+        "selftest": "passed",
+        "internal": "no",
+        "type": "shash",
+        "blocksize": 128,
+        "digestsize": 64
+      },
+      ...
+    ]
+
+    $ cat /proc/crypto | jc --proc_crypto -p -r
+    [
+      {
+        "name": "ecdh",
+        "driver": "ecdh-generic",
+        "module": "ecdh_generic",
+        "priority": "100",
+        "refcnt": "1",
+        "selftest": "passed",
+        "internal": "no",
+        "type": "kpp"
+      },
+      {
+        "name": "blake2b-512",
+        "driver": "blake2b-512-generic",
+        "module": "blake2b_generic",
+        "priority": "100",
+        "refcnt": "1",
+        "selftest": "passed",
+        "internal": "no",
+        "type": "shash",
+        "blocksize": "128",
+        "digestsize": "64"
+      },
+      {
+        "name": "blake2b-384",
+        "driver": "blake2b-384-generic",
+        "module": "blake2b_generic",
+        "priority": "100",
+        "refcnt": "1",
+        "selftest": "passed",
+        "internal": "no",
+        "type": "shash",
+        "blocksize": "128",
+        "digestsize": "48"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc_crypto.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_devices.md

@@ -0,0 +1,103 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_devices"></a>
+
+# jc.parsers.proc\_devices
+
+jc - JSON Convert `/proc/devices` file parser
+
+Usage (cli):
+
+    $ cat /proc/devices | jc --proc
+
+or
+
+    $ jc /proc/devices
+
+or
+
+    $ cat /proc/devices | jc --proc-devices
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_devices_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_devices', proc_devices_file)
+
+Schema:
+
+Since devices can be members of multiple groups, the value for each device
+is a list.
+
+    {
+      "character": {
+        "<device number>": [
+                                    string
+        ]
+      },
+      "block": {
+        "<device number>": [
+                                    string
+        ]
+      }
+    }
+
+Examples:
+
+    $ cat /proc/devices | jc --proc -p
+    {
+      "character": {
+        "1": [
+          "mem"
+        ],
+        "4": [
+          "/dev/vc/0",
+          "tty",
+          "ttyS"
+        ],
+        "5": [
+          "/dev/tty",
+          "/dev/console",
+          "/dev/ptmx",
+          "ttyprintk"
+        ],
+      "block": {
+        "7": [
+          "loop"
+        ],
+        "8": [
+          "sd"
+        ],
+        "9": [
+          "md"
+        ]
+      }
+    }
+
+<a id="jc.parsers.proc_devices.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    Dictionary. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_diskstats.md

@@ -0,0 +1,202 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_diskstats"></a>
+
+# jc.parsers.proc\_diskstats
+
+jc - JSON Convert `/proc/diskstats` file parser
+
+Usage (cli):
+
+    $ cat /proc/diskstats | jc --proc
+
+or
+
+    $ jc /proc/diskstats
+
+or
+
+    $ cat /proc/diskstats | jc --proc-diskstats
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_diskstats_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_diskstats', proc_diskstats_file)
+
+Schema:
+
+    [
+      {
+        "maj":                                          integer,
+        "min":                                          integer,
+        "device":                                       string,
+        "reads_completed":                              integer,
+        "reads_merged":                                 integer,
+        "sectors_read":                                 integer,
+        "read_time_ms":                                 integer,
+        "writes_completed":                             integer,
+        "writes_merged":                                integer,
+        "sectors_written":                              integer,
+        "write_time_ms":                                integer,
+        "io_in_progress":                               integer,
+        "io_time_ms":                                   integer,
+        "weighted_io_time_ms":                          integer,
+        "discards_completed_successfully":              integer,
+        "discards_merged":                              integer,
+        "sectors_discarded":                            integer,
+        "discarding_time_ms":                           integer,
+        "flush_requests_completed_successfully":        integer,
+        "flushing_time_ms":                             integer
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/diskstats | jc --proc -p
+    [
+      {
+        "maj": 7,
+        "min": 0,
+        "device": "loop0",
+        "reads_completed": 48,
+        "reads_merged": 0,
+        "sectors_read": 718,
+        "read_time_ms": 19,
+        "writes_completed": 0,
+        "writes_merged": 0,
+        "sectors_written": 0,
+        "write_time_ms": 0,
+        "io_in_progress": 0,
+        "io_time_ms": 36,
+        "weighted_io_time_ms": 19,
+        "discards_completed_successfully": 0,
+        "discards_merged": 0,
+        "sectors_discarded": 0,
+        "discarding_time_ms": 0,
+        "flush_requests_completed_successfully": 0,
+        "flushing_time_ms": 0
+      },
+      {
+        "maj": 7,
+        "min": 1,
+        "device": "loop1",
+        "reads_completed": 41,
+        "reads_merged": 0,
+        "sectors_read": 688,
+        "read_time_ms": 17,
+        "writes_completed": 0,
+        "writes_merged": 0,
+        "sectors_written": 0,
+        "write_time_ms": 0,
+        "io_in_progress": 0,
+        "io_time_ms": 28,
+        "weighted_io_time_ms": 17,
+        "discards_completed_successfully": 0,
+        "discards_merged": 0,
+        "sectors_discarded": 0,
+        "discarding_time_ms": 0,
+        "flush_requests_completed_successfully": 0,
+        "flushing_time_ms": 0
+      },
+      ...
+    ]
+
+    $ cat /proc/diskstats | jc --proc_diskstats -p -r
+    [
+      {
+        "maj": "7",
+        "min": "0",
+        "device": "loop0",
+        "reads_completed": "48",
+        "reads_merged": "0",
+        "sectors_read": "718",
+        "read_time_ms": "19",
+        "writes_completed": "0",
+        "writes_merged": "0",
+        "sectors_written": "0",
+        "write_time_ms": "0",
+        "io_in_progress": "0",
+        "io_time_ms": "36",
+        "weighted_io_time_ms": "19",
+        "discards_completed_successfully": "0",
+        "discards_merged": "0",
+        "sectors_discarded": "0",
+        "discarding_time_ms": "0",
+        "flush_requests_completed_successfully": "0",
+        "flushing_time_ms": "0"
+      },
+      {
+        "maj": "7",
+        "min": "1",
+        "device": "loop1",
+        "reads_completed": "41",
+        "reads_merged": "0",
+        "sectors_read": "688",
+        "read_time_ms": "17",
+        "writes_completed": "0",
+        "writes_merged": "0",
+        "sectors_written": "0",
+        "write_time_ms": "0",
+        "io_in_progress": "0",
+        "io_time_ms": "28",
+        "weighted_io_time_ms": "17",
+        "discards_completed_successfully": "0",
+        "discards_merged": "0",
+        "sectors_discarded": "0",
+        "discarding_time_ms": "0",
+        "flush_requests_completed_successfully": "0",
+        "flushing_time_ms": "0"
+      },
+      {
+        "maj": "7",
+        "min": "2",
+        "device": "loop2",
+        "reads_completed": "119",
+        "reads_merged": "0",
+        "sectors_read": "2956",
+        "read_time_ms": "18",
+        "writes_completed": "0",
+        "writes_merged": "0",
+        "sectors_written": "0",
+        "write_time_ms": "0",
+        "io_in_progress": "0",
+        "io_time_ms": "56",
+        "weighted_io_time_ms": "18",
+        "discards_completed_successfully": "0",
+        "discards_merged": "0",
+        "sectors_discarded": "0",
+        "discarding_time_ms": "0",
+        "flush_requests_completed_successfully": "0",
+        "flushing_time_ms": "0"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc_diskstats.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_driver_rtc.md

@@ -0,0 +1,126 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_driver_rtc"></a>
+
+# jc.parsers.proc\_driver\_rtc
+
+jc - JSON Convert `/proc/driver/rtc` file parser
+
+Usage (cli):
+
+    $ cat /proc/driver/rtc | jc --proc
+
+or
+
+    $ jc /proc/driver/rtc
+
+or
+
+    $ cat /proc/driver/rtc | jc --proc-driver-rtc
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_driver_rtc_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_driver_rtc', proc_driver_rtc_file)
+
+Schema:
+
+"yes" and "no" values are converted to `true`/`false`. Integer conversions
+are attempted. If you do not want this behavior, then use `--raw` (cli) or
+`raw=True` (module).
+
+    {
+      "rtc_time":                       string,
+      "rtc_date":                       string,
+      "alrm_time":                      string,
+      "alrm_date":                      string,
+      "alarm_IRQ":                      boolean,
+      "alrm_pending":                   boolean,
+      "update IRQ enabled":             boolean,
+      "periodic IRQ enabled":           boolean,
+      "periodic IRQ frequency":         integer,
+      "max user IRQ frequency":         integer,
+      "24hr":                           boolean,
+      "periodic_IRQ":                   boolean,
+      "update_IRQ":                     boolean,
+      "HPET_emulated":                  boolean,
+      "BCD":                            boolean,
+      "DST_enable":                     boolean,
+      "periodic_freq":                  integer,
+      "batt_status":                    string
+    }
+
+Examples:
+
+    $ cat /proc/driver/rtc | jc --proc -p
+    {
+      "rtc_time": "16:09:21",
+      "rtc_date": "2022-09-03",
+      "alrm_time": "00:00:00",
+      "alrm_date": "2022-09-03",
+      "alarm_IRQ": false,
+      "alrm_pending": false,
+      "update IRQ enabled": false,
+      "periodic IRQ enabled": false,
+      "periodic IRQ frequency": 1024,
+      "max user IRQ frequency": 64,
+      "24hr": true,
+      "periodic_IRQ": false,
+      "update_IRQ": false,
+      "HPET_emulated": true,
+      "BCD": true,
+      "DST_enable": false,
+      "periodic_freq": 1024,
+      "batt_status": "okay"
+    }
+
+    $ cat /proc/driver/rtc | jc --proc -p -r
+    {
+      "rtc_time": "16:09:21",
+      "rtc_date": "2022-09-03",
+      "alrm_time": "00:00:00",
+      "alrm_date": "2022-09-03",
+      "alarm_IRQ": "no",
+      "alrm_pending": "no",
+      "update IRQ enabled": "no",
+      "periodic IRQ enabled": "no",
+      "periodic IRQ frequency": "1024",
+      "max user IRQ frequency": "64",
+      "24hr": "yes",
+      "periodic_IRQ": "no",
+      "update_IRQ": "no",
+      "HPET_emulated": "yes",
+      "BCD": "yes",
+      "DST_enable": "no",
+      "periodic_freq": "1024",
+      "batt_status": "okay"
+    }
+
+<a id="jc.parsers.proc_driver_rtc.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    Dictionary. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_filesystems.md

@@ -0,0 +1,81 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_filesystems"></a>
+
+# jc.parsers.proc\_filesystems
+
+jc - JSON Convert `/proc/filesystems` file parser
+
+Usage (cli):
+
+    $ cat /proc/filesystems | jc --proc
+
+or
+
+    $ jc /proc/filesystems
+
+or
+
+    $ cat /proc/filesystems | jc --proc-filesystems
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_filesystems_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_filesystems', proc_filesystems_file)
+
+Schema:
+
+    [
+      {
+        "filesystem":               string,
+        "nodev":                    boolean
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/filesystems | jc --proc -p
+    [
+      {
+          "filesystem": "sysfs",
+          "nodev": true
+      },
+      {
+          "filesystem": "tmpfs",
+          "nodev": true
+      },
+      {
+          "filesystem": "bdev",
+          "nodev": true
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc_filesystems.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_interrupts.md

@@ -0,0 +1,133 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_interrupts"></a>
+
+# jc.parsers.proc\_interrupts
+
+jc - JSON Convert `/proc/interrupts` file parser
+
+Usage (cli):
+
+    $ cat /proc/interrupts | jc --proc
+
+or
+
+    $ jc /proc/interrupts
+
+or
+
+    $ cat /proc/interrupts | jc --proc-interrupts
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_interrupts_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_interrupts', proc_interrupts_file)
+
+Schema:
+
+    [
+      {
+        "irq":                      string,
+        "cpu_num":                  integer,
+        "interrupts": [
+                                    integer
+        ],
+        "type":                     string,
+        "device": [
+                                    string
+        ]
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/interrupts | jc --proc -p
+    [
+      {
+        "irq": "0",
+        "cpu_num": 2,
+        "interrupts": [
+          18,
+          0
+        ],
+        "type": "IO-APIC",
+        "device": [
+          "2-edge",
+          "timer"
+        ]
+      },
+      {
+        "irq": "1",
+        "cpu_num": 2,
+        "interrupts": [
+          0,
+          73
+        ],
+        "type": "IO-APIC",
+        "device": [
+          "1-edge",
+          "i8042"
+        ]
+      },
+      ...
+    ]
+
+    $ cat /proc/interrupts | jc --proc-interrupts -p -r
+    [
+      {
+        "irq": "0",
+        "cpu_num": 2,
+        "interrupts": [
+          "18",
+          "0"
+        ],
+        "type": "IO-APIC",
+        "device": [
+          "2-edge",
+          "timer"
+        ]
+      },
+      {
+        "irq": "1",
+        "cpu_num": 2,
+        "interrupts": [
+          "0",
+          "73"
+        ],
+        "type": "IO-APIC",
+        "device": [
+          "1-edge",
+          "i8042"
+        ]
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc_interrupts.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_iomem.md

@@ -0,0 +1,85 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_iomem"></a>
+
+# jc.parsers.proc\_iomem
+
+jc - JSON Convert `/proc/iomem` file parser
+
+Usage (cli):
+
+    $ cat /proc/iomem | jc --proc
+
+or
+
+    $ jc /proc/iomem
+
+or
+
+    $ cat /proc/iomem | jc --proc-iomem
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_iomem_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_iomem', proc_iomem_file)
+
+Schema:
+
+    [
+      {
+        "start":                   string,
+        "end":                     string,
+        "device":                  string
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/iomem | jc --proc -p
+    [
+      {
+        "start": "00000000",
+        "end": "00000fff",
+        "device": "Reserved"
+      },
+      {
+        "start": "00001000",
+        "end": "0009e7ff",
+        "device": "System RAM"
+      },
+      {
+        "start": "0009e800",
+        "end": "0009ffff",
+        "device": "Reserved"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc_iomem.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_ioports.md

@@ -0,0 +1,85 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_ioports"></a>
+
+# jc.parsers.proc\_ioports
+
+jc - JSON Convert `/proc/ioports` file parser
+
+Usage (cli):
+
+    $ cat /proc/ioports | jc --proc
+
+or
+
+    $ jc /proc/ioports
+
+or
+
+    $ cat /proc/ioports | jc --proc-ioports
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_ioports_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_ioports', proc_ioports_file)
+
+Schema:
+
+    [
+      {
+        "start":                   string,
+        "end":                     string,
+        "device":                  string
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/ioports | jc --proc -p
+    [
+      {
+        "start": "0000",
+        "end": "0cf7",
+        "device": "PCI Bus 0000:00"
+      },
+      {
+        "start": "0000",
+        "end": "001f",
+        "device": "dma1"
+      },
+      {
+        "start": "0020",
+        "end": "0021",
+        "device": "PNP0001:00"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc_ioports.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_loadavg.md

@@ -0,0 +1,88 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_loadavg"></a>
+
+# jc.parsers.proc\_loadavg
+
+jc - JSON Convert `/proc/loadavg` file parser
+
+Usage (cli):
+
+    $ cat /proc/loadavg | jc --proc
+
+or
+
+    $ jc /proc/loadavg
+
+or
+
+    $ cat /proc/loadavg | jc --proc-loadavg
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_loadavg_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_loadavg', proc_loadavg_file)
+
+Schema:
+
+All values are integers.
+
+    {
+      "load_1m":              float,
+      "load_5m":              float,
+      "load_15m":             float,
+      "running":              integer,
+      "available":            integer,
+      "last_pid":             integer
+    }
+
+Examples:
+
+    $ cat /proc/loadavg | jc --proc -p
+    {
+      "load_1m": 0.0,
+      "load_5m": 0.01,
+      "load_15m": 0.03,
+      "running": 2,
+      "available": 111,
+      "last_pid": 2039
+    }
+
+    $ cat /proc/loadavg | jc --proc -p -r
+    {
+      "load_1m": "0.00",
+      "load_5m": "0.01",
+      "load_15m": "0.03",
+      "running": "2",
+      "available": "111",
+      "last_pid": "2039"
+    }
+
+<a id="jc.parsers.proc_loadavg.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    Dictionary. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_locks.md

@@ -0,0 +1,130 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_locks"></a>
+
+# jc.parsers.proc\_locks
+
+jc - JSON Convert `/proc/locks` file parser
+
+Usage (cli):
+
+    $ cat /proc/locks | jc --proc
+
+or
+
+    $ jc /proc/locks
+
+or
+
+    $ cat /proc/locks | jc --proc-locks
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_locks_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_locks', proc_locks_file)
+
+Schema:
+
+    [
+      {
+        "id":                   integer,
+        "class":                string,
+        "type":                 string,
+        "access":               string,
+        "pid":                  integer,
+        "maj":                  string,
+        "min":                  string,
+        "inode":                integer,
+        "start":                string,
+        "end":                  string
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/locks | jc --proc -p
+    [
+      {
+        "id": 1,
+        "class": "POSIX",
+        "type": "ADVISORY",
+        "access": "WRITE",
+        "pid": 877,
+        "maj": "00",
+        "min": "19",
+        "inode": 812,
+        "start": "0",
+        "end": "EOF"
+      },
+      {
+        "id": 2,
+        "class": "FLOCK",
+        "type": "ADVISORY",
+        "access": "WRITE",
+        "pid": 854,
+        "maj": "00",
+        "min": "19",
+        "inode": 805,
+        "start": "0",
+        "end": "EOF"
+      },
+      ...
+    ]
+
+    $ cat /proc/locks | jc --proc-locks -p -r
+    [
+      {
+        "id": "1",
+        "class": "POSIX",
+        "type": "ADVISORY",
+        "access": "WRITE",
+        "pid": "877",
+        "maj": "00",
+        "min": "19",
+        "inode": "812",
+        "start": "0",
+        "end": "EOF"
+      },
+      {
+        "id": "2",
+        "class": "FLOCK",
+        "type": "ADVISORY",
+        "access": "WRITE",
+        "pid": "854",
+        "maj": "00",
+        "min": "19",
+        "inode": "805",
+        "start": "0",
+        "end": "EOF"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc_locks.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_meminfo.md

@@ -0,0 +1,118 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_meminfo"></a>
+
+# jc.parsers.proc\_meminfo
+
+jc - JSON Convert `/proc/meminfo` file parser
+
+Usage (cli):
+
+    $ cat /proc/meminfo | jc --proc
+
+or
+
+    $ jc /proc/meminfo
+
+or
+
+    $ cat /proc/meminfo | jc --proc-meminfo
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_meminfo_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_meminfo', proc_meminfo_file)
+
+Schema:
+
+All values are integers.
+
+    {
+      <keyName>             integer
+    }
+
+Examples:
+
+    $ cat /proc/meminfo | jc --proc -p
+    {
+      "MemTotal": 3997272,
+      "MemFree": 2760316,
+      "MemAvailable": 3386876,
+      "Buffers": 40452,
+      "Cached": 684856,
+      "SwapCached": 0,
+      "Active": 475816,
+      "Inactive": 322064,
+      "Active(anon)": 70216,
+      "Inactive(anon)": 148,
+      "Active(file)": 405600,
+      "Inactive(file)": 321916,
+      "Unevictable": 19476,
+      "Mlocked": 19476,
+      "SwapTotal": 3996668,
+      "SwapFree": 3996668,
+      "Dirty": 152,
+      "Writeback": 0,
+      "AnonPages": 92064,
+      "Mapped": 79464,
+      "Shmem": 1568,
+      "KReclaimable": 188216,
+      "Slab": 288096,
+      "SReclaimable": 188216,
+      "SUnreclaim": 99880,
+      "KernelStack": 5872,
+      "PageTables": 1812,
+      "NFS_Unstable": 0,
+      "Bounce": 0,
+      "WritebackTmp": 0,
+      "CommitLimit": 5995304,
+      "Committed_AS": 445240,
+      "VmallocTotal": 34359738367,
+      "VmallocUsed": 21932,
+      "VmallocChunk": 0,
+      "Percpu": 107520,
+      "HardwareCorrupted": 0,
+      "AnonHugePages": 0,
+      "ShmemHugePages": 0,
+      "ShmemPmdMapped": 0,
+      "FileHugePages": 0,
+      "FilePmdMapped": 0,
+      "HugePages_Total": 0,
+      "HugePages_Free": 0,
+      "HugePages_Rsvd": 0,
+      "HugePages_Surp": 0,
+      "Hugepagesize": 2048,
+      "Hugetlb": 0,
+      "DirectMap4k": 192320,
+      "DirectMap2M": 4001792,
+      "DirectMap1G": 2097152
+    }
+
+<a id="jc.parsers.proc_meminfo.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    Dictionary. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_modules.md

@@ -0,0 +1,132 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_modules"></a>
+
+# jc.parsers.proc\_modules
+
+jc - JSON Convert `/proc/modules` file parser
+
+Usage (cli):
+
+    $ cat /proc/modules | jc --proc
+
+or
+
+    $ jc /proc/modules
+
+or
+
+    $ cat /proc/modules | jc --proc-modules
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_modules_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_modules', proc_modules_file)
+
+Schema:
+
+    [
+      {
+        "module":                   string,
+        "size":                     integer,
+        "used":                     integer,
+        "used_by": [
+                                    string
+        ],
+        "status":                   string,
+        "location":                 string
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/modules | jc --proc -p
+    [
+      {
+        "module": "binfmt_misc",
+        "size": 24576,
+        "used": 1,
+        "used_by": [],
+        "status": "Live",
+        "location": "0xffffffffc0ab4000"
+      },
+      {
+        "module": "vsock_loopback",
+        "size": 16384,
+        "used": 0,
+        "used_by": [],
+        "status": "Live",
+        "location": "0xffffffffc0a14000"
+      },
+      {
+        "module": "vmw_vsock_virtio_transport_common",
+        "size": 36864,
+        "used": 1,
+        "used_by": [
+          "vsock_loopback"
+        ],
+        "status": "Live",
+        "location": "0xffffffffc0a03000"
+      },
+      ...
+    ]
+
+    $ cat /proc/modules | jc --proc-modules -p -r
+    [
+      {
+        "module": "binfmt_misc",
+        "size": "24576",
+        "used": "1",
+        "used_by": [],
+        "status": "Live",
+        "location": "0xffffffffc0ab4000"
+      },
+      {
+        "module": "vsock_loopback",
+        "size": "16384",
+        "used": "0",
+        "used_by": [],
+        "status": "Live",
+        "location": "0xffffffffc0a14000"
+      },
+      {
+        "module": "vmw_vsock_virtio_transport_common",
+        "size": "36864",
+        "used": "1",
+        "used_by": [
+          "vsock_loopback"
+        ],
+        "status": "Live",
+        "location": "0xffffffffc0a03000"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc_modules.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_mtrr.md

@@ -0,0 +1,111 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_mtrr"></a>
+
+# jc.parsers.proc\_mtrr
+
+jc - JSON Convert `/proc/mtrr` file parser
+
+Usage (cli):
+
+    $ cat /proc/mtrr | jc --proc
+
+or
+
+    $ jc /proc/mtrr
+
+or
+
+    $ cat /proc/mtrr | jc --proc-mtrr
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_mtrr_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_mtrr', proc_mtrr_file)
+
+Schema:
+
+    [
+      {
+        "register":             string,
+        "type":                 string,
+        "base":                 string,
+        "base_mb":              integer,
+        "size":                 integer,
+        "count":                integer,
+        "<key>":                string  # additional key/values are strings
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/mtrr | jc --proc -p
+    [
+      {
+        "register": "reg00",
+        "type": "write-back",
+        "base": "0x000000000",
+        "base_mb": 0,
+        "size": 2048,
+        "count": 1
+      },
+      {
+        "register": "reg01",
+        "type": "write-back",
+        "base": "0x080000000",
+        "base_mb": 2048,
+        "size": 1024,
+        "count": 1
+      },
+      ...
+    ]
+
+    $ cat /proc/mtrr | jc --proc-mtrr -p -r
+    [
+      {
+        "register": "reg00",
+        "type": "write-back",
+        "base": "0x000000000",
+        "base_mb": "0",
+        "size": "2048MB",
+        "count": "1"
+      },
+      {
+        "register": "reg01",
+        "type": "write-back",
+        "base": "0x080000000",
+        "base_mb": "2048",
+        "size": "1024MB",
+        "count": "1"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc_mtrr.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_net_arp.md

@@ -0,0 +1,81 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_net_arp"></a>
+
+# jc.parsers.proc\_net\_arp
+
+jc - JSON Convert `/proc/net/arp` file parser
+
+Usage (cli):
+
+    $ cat /proc/net/arp | jc --proc
+
+or
+
+    $ jc /proc/net/arp
+
+or
+
+    $ cat /proc/net/arp | jc --proc-net-arp
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_net_arp_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_net_arp', proc_net_arp_file)
+
+Schema:
+
+    [
+      {
+        "IP_address":           string,
+        "HW_type":              string,
+        "Flags":                string,
+        "HW_address":           string,
+        "Mask":                 string,
+        "Device":               string
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/net/arp | jc --proc -p
+    [
+      {
+        "IP_address": "192.168.71.254",
+        "HW_type": "0x1",
+        "Flags": "0x2",
+        "HW_address": "00:50:56:f3:2f:ae",
+        "Mask": "*",
+        "Device": "ens33"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc_net_arp.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_net_dev.md

@@ -0,0 +1,127 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_net_dev"></a>
+
+# jc.parsers.proc\_net\_dev
+
+jc - JSON Convert `/proc/net/dev` file parser
+
+Usage (cli):
+
+    $ cat /proc/net/dev | jc --proc
+
+or
+
+    $ jc /proc/net/dev
+
+or
+
+    $ cat /proc/net/dev | jc --proc-net-dev
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_net_dev_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_net_dev', proc_net_dev_file)
+
+Schema:
+
+    [
+      {
+        "interface":                  string,
+        "r_bytes":                    integer,
+        "r_packets":                  integer,
+        "r_errs":                     integer,
+        "r_drop":                     integer,
+        "r_fifo":                     integer,
+        "r_frame":                    integer,
+        "r_compressed":               integer,
+        "r_multicast":                integer,
+        "t_bytes":                    integer,
+        "t_packets":                  integer,
+        "t_errs":                     integer,
+        "t_drop":                     integer,
+        "t_fifo":                     integer,
+        "t_colls":                    integer,
+        "t_carrier":                  integer,
+        "t_compressed":               integer
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/net/dev | jc --proc -p
+    [
+      {
+        "interface": "lo",
+        "r_bytes": 13222,
+        "r_packets": 152,
+        "r_errs": 0,
+        "r_drop": 0,
+        "r_fifo": 0,
+        "r_frame": 0,
+        "r_compressed": 0,
+        "r_multicast": 0,
+        "t_bytes": 13222,
+        "t_packets": 152,
+        "t_errs": 0,
+        "t_drop": 0,
+        "t_fifo": 0,
+        "t_colls": 0,
+        "t_carrier": 0,
+        "t_compressed": 0
+      },
+      ...
+    ]
+
+    $ cat /proc/net/dev | jc --proc-net-dev -p -r
+    [
+      {
+        "interface": "lo:",
+        "r_bytes": "13222",
+        "r_packets": "152",
+        "r_errs": "0",
+        "r_drop": "0",
+        "r_fifo": "0",
+        "r_frame": "0",
+        "r_compressed": "0",
+        "r_multicast": "0",
+        "t_bytes": "13222",
+        "t_packets": "152",
+        "t_errs": "0",
+        "t_drop": "0",
+        "t_fifo": "0",
+        "t_colls": "0",
+        "t_carrier": "0",
+        "t_compressed": "0"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc_net_dev.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_net_dev_mcast.md

@@ -0,0 +1,105 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_net_dev_mcast"></a>
+
+# jc.parsers.proc\_net\_dev\_mcast
+
+jc - JSON Convert `/proc/net/dev_mcast` file parser
+
+Usage (cli):
+
+    $ cat /proc/net/dev_mcast | jc --proc
+
+or
+
+    $ jc /proc/net/dev_mcast
+
+or
+
+    $ cat /proc/net/dev_mcast | jc --proc-net-dev-mcast
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_net_dev_mcast_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_net_dev_mcast', proc_net_dev_mcast_file)
+
+Schema:
+
+    [
+      {
+        "index":                      integer,
+        "interface":                  string,
+        "dmi_u":                      integer,
+        "dmi_g":                      integer,
+        "dmi_address":                string
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/net/dev_mcast | jc --proc -p
+    [
+      {
+        "index": 2,
+        "interface": "ens33",
+        "dmi_u": 1,
+        "dmi_g": 0,
+        "dmi_address": "333300000001"
+      },
+      {
+        "index": 2,
+        "interface": "ens33",
+        "dmi_u": 1,
+        "dmi_g": 0,
+        "dmi_address": "01005e000001"
+      },
+      ...
+    ]
+
+    $ cat /proc/net/dev_mcast | jc --proc-net-dev-mcast -p -r
+    [
+      {
+        "index": "2",
+        "interface": "ens33",
+        "dmi_u": "1",
+        "dmi_g": "0",
+        "dmi_address": "333300000001"
+      },
+      {
+        "index": "2",
+        "interface": "ens33",
+        "dmi_u": "1",
+        "dmi_g": "0",
+        "dmi_address": "01005e000001"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc_net_dev_mcast.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_net_if_inet6.md

@@ -0,0 +1,88 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_net_if_inet6"></a>
+
+# jc.parsers.proc\_net\_if\_inet6
+
+jc - JSON Convert `/proc/net/if_inet6` file parser
+
+Usage (cli):
+
+    $ cat /proc/net/if_inet6 | jc --proc
+
+or
+
+    $ jc /proc/net/if_inet6
+
+or
+
+    $ cat /proc/net/if_inet6 | jc --proc-net-if-inet6
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_net_if_inet6_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_net_if_inet6', proc_net_if_inet6_file)
+
+Schema:
+
+    [
+      {
+        "address":              string,
+        "index":                string,
+        "prefix":               string,
+        "scope":                string,
+        "flags":                string,
+        "name":                 string
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/net/if_inet6 | jc --proc -p
+    [
+      {
+        "address": "fe80000000000000020c29fffea4e315",
+        "index": "02",
+        "prefix": "40",
+        "scope": "20",
+        "flags": "80",
+        "name": "ens33"
+      },
+      {
+        "address": "00000000000000000000000000000001",
+        "index": "01",
+        "prefix": "80",
+        "scope": "10",
+        "flags": "80",
+        "name": "lo"
+      }
+    ]
+
+<a id="jc.parsers.proc_net_if_inet6.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_net_igmp.md

@@ -0,0 +1,152 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_net_igmp"></a>
+
+# jc.parsers.proc\_net\_igmp
+
+jc - JSON Convert `/proc/net/igmp` file parser
+
+Usage (cli):
+
+    $ cat /proc/net/igmp | jc --proc
+
+or
+
+    $ jc /proc/net/igmp
+
+or
+
+    $ cat /proc/net/igmp | jc --proc-net-igmp
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_net_igmp_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_net_igmp', proc_net_igmp_file)
+
+Schema:
+
+    [
+      {
+        "index":                      integer,
+        "device":                     string,
+        "count":                      integer,
+        "querier":                    string,
+        "groups": [
+          {
+            "address":                string,
+            "users":                  integer,
+            "timer":                  string,
+            "reporter":               integer
+          }
+        ]
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/net/igmp | jc --proc -p
+    [
+      {
+        "index": 0,
+        "device": "lo",
+        "count": 0,
+        "querier": "V3",
+        "groups": [
+          {
+            "address": "010000E0",
+            "users": 1,
+            "timer": "0:00000000",
+            "reporter": 0
+          }
+        ]
+      },
+      {
+        "index": 2,
+        "device": "eth0",
+        "count": 26,
+        "querier": "V2",
+        "groups": [
+          {
+            "address": "260301E0",
+            "users": 1,
+            "timer": "0:00000000",
+            "reporter": 1
+          },
+          {
+            "address": "9B0101E0",
+            "users": 1,
+            "timer": "0:00000000",
+            "reporter": 1
+          },
+        ]
+      }
+      ...
+    ]
+
+    $ cat /proc/net/igmp | jc --proc-net-igmp -p -r
+    [
+      {
+        "index": "0",
+        "device": "lo",
+        "count": "0",
+        "querier": "V3",
+        "groups": [
+          {
+            "address": "010000E0",
+            "users": "1",
+            "timer": "0:00000000",
+            "reporter": "0"
+          }
+        ]
+      },
+      {
+        "index": "2",
+        "device": "eth0",
+        "count": "26",
+        "querier": "V2",
+        "groups": [
+          {
+            "address": "260301E0",
+            "users": "1",
+            "timer": "0:00000000",
+            "reporter": "1"
+          },
+          {
+            "address": "9B0101E0",
+            "users": "1",
+            "timer": "0:00000000",
+            "reporter": "1"
+          },
+        ]
+      }
+      ...
+    }
+
+<a id="jc.parsers.proc_net_igmp.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_net_igmp6.md

@@ -0,0 +1,125 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_net_igmp6"></a>
+
+# jc.parsers.proc\_net\_igmp6
+
+jc - JSON Convert `/proc/net/igmp6` file parser
+
+Usage (cli):
+
+    $ cat /proc/net/igmp6 | jc --proc
+
+or
+
+    $ jc /proc/net/igmp6
+
+or
+
+    $ cat /proc/net/igmp6 | jc --proc-net-igmp6
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_net_igmp6_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_net_igmp6', proc_net_igmp6_file)
+
+Schema:
+
+    [
+      {
+        "index":                    integer,
+        "name":                     string,
+        "address":                  string,
+        "users":                    integer,
+        "group":                    string,
+        "reporters":                integer
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/net/igmp6 | jc --proc -p
+    [
+      {
+        "index": 1,
+        "name": "lo",
+        "address": "ff020000000000000000000000000001",
+        "users": 1,
+        "group": "0000000C",
+        "reporters": 0
+      },
+      {
+        "index": 1,
+        "name": "lo",
+        "address": "ff010000000000000000000000000001",
+        "users": 1,
+        "group": "00000008",
+        "reporters": 0
+      },
+      {
+        "index": 2,
+        "name": "ens33",
+        "address": "ff0200000000000000000001ffa4e315",
+        "users": 1,
+        "group": "00000004",
+        "reporters": 0
+      },
+      ...
+    ]
+
+    $ cat /proc/net/igmp6 | jc --proc-net-igmp6 -p -r
+    [
+      {
+        "index": "1",
+        "name": "lo",
+        "address": "ff020000000000000000000000000001",
+        "users": "1",
+        "group": "0000000C",
+        "reporters": "0"
+      },
+      {
+        "index": "1",
+        "name": "lo",
+        "address": "ff010000000000000000000000000001",
+        "users": "1",
+        "group": "00000008",
+        "reporters": "0"
+      },
+      {
+        "index": "2",
+        "name": "ens33",
+        "address": "ff0200000000000000000001ffa4e315",
+        "users": "1",
+        "group": "00000004",
+        "reporters": "0"
+      }
+    ]
+
+<a id="jc.parsers.proc_net_igmp6.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)

docs/parsers/proc_net_ipv6_route.md

@@ -0,0 +1,89 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.proc_net_ipv6_route"></a>
+
+# jc.parsers.proc\_net\_ipv6\_route
+
+jc - JSON Convert `/proc/net/ipv6_route` file parser
+
+Usage (cli):
+
+    $ cat /proc/net/ipv6_route | jc --proc
+
+or
+
+    $ jc /proc/net/ipv6_route
+
+or
+
+    $ cat /proc/net/ipv6_route | jc --proc-net-ipv6-route
+
+Usage (module):
+
+    import jc
+    result = jc.parse('proc', proc_net_ipv6_route_file)
+
+or
+
+    import jc
+    result = jc.parse('proc_net_ipv6_route', proc_net_ipv6_route_file)
+
+Schema:
+
+    [
+      {
+        "dest_net":                 string,
+        "dest_prefix":              string,
+        "source_net":               string,
+        "source_prefix":            string,
+        "next_hop":                 string,
+        "metric":                   string,
+        "ref_count":                string,
+        "use_count":                string,
+        "flags":                    string,
+        "device":                   string
+      }
+    ]
+
+Examples:
+
+    $ cat /proc/net/ipv6_route | jc --proc -p
+    [
+      {
+        "dest_net": "00000000000000000000000000000001",
+        "dest_prefix": "80",
+        "source_net": "00000000000000000000000000000000",
+        "source_prefix": "00",
+        "next_hop": "00000000000000000000000000000000",
+        "metric": "00000100",
+        "ref_count": "00000001",
+        "use_count": "00000000",
+        "flags": "00000001",
+        "device": "lo"
+      },
+      ...
+    ]
+
+<a id="jc.parsers.proc_net_ipv6_route.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of Dictionaries. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)