Merge pull request #266 from kellyjonbrazil/dev

Dev v1.20.3
formatting
2026-04-03 17:44:07 +02:00 · 2022-07-23 13:12:54 -07:00 · 2022-07-23 12:55:56 -07:00 · 2022-07-23 12:52:42 -07:00 · 2022-07-23 12:51:27 -07:00 · 2022-07-23 12:43:17 -07:00
244 changed files with 64299 additions and 722 deletions
--- a/23
+++ b/23
@@ -1,5 +1,28 @@
 jc changelog

+20220723 v1.20.3
+- Add URL string parser
+- Add Email Address string parser
+- Add JWT string parser
+- Add ISO 8601 Datetime string parser
+- Add UNIX Epoch Timestamp string parser
+- Add M3U/M3U8 file parser
+- Add pager functionality to help (parser documentation only)
+- Minor parser performance optimizations
+
+20220705 v1.20.2
+- Add `gpg --with-colons` parser tested on linux
+- Add DER and PEM encoded X.509 Certificate parser
+- Add Bash and Zsh completion scripts to DEB and RPM packages
+
+20220615 v1.20.1
+- Add `postconf -M` parser tested on linux
+- Update `asciitable` and `asciitable-m` parsers to preserve case in key
+  names when using the `-r` or `raw=True` options.
+- Add long options (e.g. `--help`, `--about`, `--pretty`, etc.)
+- Add shell completions for Bash and Zsh
+- Fix `id` parser for cases where the user or group name is not present
+
 20220531 v1.20.0
 - Add YAML output option with `-y`
 - Add `top -b` standard and streaming parsers tested on linux
--- a/EXAMPLES.md
+++ b/EXAMPLES.md
@@ -922,6 +922,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 +1133,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
@@ -1684,6 +1727,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 +1898,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 +2252,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 +2582,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 +2832,36 @@ pip show wrapt wheel | jc --pip-show -p          # or:  jc -p pip show wrapt whe
  }
 ]
 ```
+### postconf -M
+```bash
+postconf -M | jc --postconf -p          # or jc -p postconf -M
+```
+```json
+[
+  {
+    "service_name": "smtp",
+    "service_type": "inet",
+    "private": false,
+    "unprivileged": null,
+    "chroot": true,
+    "wake_up_time": null,
+    "process_limit": null,
+    "command": "smtpd",
+    "no_wake_up_before_first_use": null
+  },
+  {
+    "service_name": "pickup",
+    "service_type": "unix",
+    "private": false,
+    "unprivileged": null,
+    "chroot": true,
+    "wake_up_time": 60,
+    "process_limit": 1,
+    "command": "pickup",
+    "no_wake_up_before_first_use": false
+  }
+]
+```
 ### ps
 ```bash
 ps -ef | jc --ps -p          # or:  jc -p ps -ef
@@ -3465,6 +3599,146 @@ 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
+```
+```json
+[
+  {
+    "time": "11:20:43",
+    "uptime": 118,
+    "users": 2,
+    "load_1m": 0.0,
+    "load_5m": 0.01,
+    "load_15m": 0.05,
+    "tasks_total": 108,
+    "tasks_running": 2,
+    "tasks_sleeping": 106,
+    "tasks_stopped": 0,
+    "tasks_zombie": 0,
+    "cpu_user": 5.6,
+    "cpu_sys": 11.1,
+    "cpu_nice": 0.0,
+    "cpu_idle": 83.3,
+    "cpu_wait": 0.0,
+    "cpu_hardware": 0.0,
+    "cpu_software": 0.0,
+    "cpu_steal": 0.0,
+    "mem_total": 3.7,
+    "mem_free": 3.3,
+    "mem_used": 0.2,
+    "mem_buff_cache": 0.2,
+    "swap_total": 2.0,
+    "swap_free": 2.0,
+    "swap_used": 0.0,
+    "mem_available": 3.3,
+    "processes": [
+      {
+        "pid": 2225,
+        "user": "kbrazil",
+        "priority": 20,
+        "nice": 0,
+        "virtual_mem": 158.1,
+        "resident_mem": 2.2,
+        "shared_mem": 1.6,
+        "status": "running",
+        "percent_cpu": 12.5,
+        "percent_mem": 0.1,
+        "time_hundredths": "0:00.02",
+        "command": "top",
+        "parent_pid": 1884,
+        "uid": 1000,
+        "real_uid": 1000,
+        "real_user": "kbrazil",
+        "saved_uid": 1000,
+        "saved_user": "kbrazil",
+        "gid": 1000,
+        "group": "kbrazil",
+        "pgrp": 2225,
+        "tty": "pts/0",
+        "tty_process_gid": 2225,
+        "session_id": 1884,
+        "thread_count": 1,
+        "last_used_processor": 0,
+        "time": "0:00",
+        "swap": 0.0,
+        "code": 0.1,
+        "data": 1.0,
+        "major_page_fault_count": 0,
+        "minor_page_fault_count": 736,
+        "dirty_pages_count": 0,
+        "sleeping_in_function": null,
+        "flags": "..4.2...",
+        "cgroups": "1:name=systemd:/user.slice/user-1000.+",
+        "supplementary_gids": [
+          10,
+          1000
+        ],
+        "supplementary_groups": [
+          "wheel",
+          "kbrazil"
+        ],
+        "thread_gid": 2225,
+        "environment_variables": [
+          "XDG_SESSION_ID=2",
+          "HOSTNAME=localhost"
+        ],
+        "major_page_fault_count_delta": 0,
+        "minor_page_fault_count_delta": 4,
+        "used": 2.2,
+        "ipc_namespace_inode": 4026531839,
+        "mount_namespace_inode": 4026531840,
+        "net_namespace_inode": 4026531956,
+        "pid_namespace_inode": 4026531836,
+        "user_namespace_inode": 4026531837,
+        "nts_namespace_inode": 4026531838
+      }
+    ]
+  }
+]
+```
 ### tracepath
 ```bash
 tracepath6 3ffe:2400:0:109::2 | jc --tracepath -p
@@ -3854,6 +4128,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
@@ -3962,6 +4300,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
--- a/README.md
+++ b/README.md
@@ -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
@@ -144,128 +146,137 @@ 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)         |
-| `           --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)          |
+| `        --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)       |
+| `     --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` | 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)            |
+| `        --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)       |
+| `     --postconf` | `postconf -M` command parser                            | [details](https://kellyjonbrazil.github.io/jc/docs/parsers/postconf)       |
+| `           --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)         |
+| `    --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
- `-a` about `jc`. Prints information about `jc` and the parsers (in JSON or
-       YAML, of course!)
- `-C` force color output even when using pipes (overrides `-m` and the
-       `NO_COLOR` env variable)
- `-d` debug mode. Prints trace messages if parsing issues are encountered (use
-       `-dd` for verbose debugging)
- `-h` help. Use `jc -h --parser_name` for parser documentation
- `-m` monochrome JSON output
- `-p` pretty format the JSON output
- `-q` quiet mode. Suppresses parser warning messages (use `-qq` to ignore
-       streaming parser errors)
- `-r` raw output. Provides a more literal JSON output, typically with string
-       values and no additional semantic processing
- `-u` unbuffer output
- `-v` version information
- `-y` YAML output
+
+| 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 ([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
--- a/_config.yml
+++ b/_config.yml
@@ -1 +1,2 @@
-theme: jekyll-theme-cayman
+theme: jekyll-theme-cayman
+markdown: GFM
--- a/build-completions.py
+++ b/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)
--- a/completions/jc_bash_completion.sh
+++ b/completions/jc_bash_completion.sh
@@ -0,0 +1,84 @@
+_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 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 --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 --iptables --iso-datetime --iw-scan --jar-manifest --jobs --jwt --kv --last --ls --ls-s --lsblk --lsmod --lsof --lsusb --m3u --mount --mpstat --mpstat-s --netstat --nmcli --ntpq --passwd --pidstat --pidstat-s --ping --ping-s --pip-list --pip-show --postconf --ps --route --rpm-qi --rsync --rsync-s --sfdisk --shadow --ss --stat --stat-s --sysctl --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 --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 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
+
--- a/completions/jc_zsh_completion.sh
+++ b/completions/jc_zsh_completion.sh
@@ -0,0 +1,331 @@
+#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 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.'
+        '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 --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 --iptables --iso-datetime --iw-scan --jar-manifest --jobs --jwt --kv --last --ls --ls-s --lsblk --lsmod --lsof --lsusb --m3u --mount --mpstat --mpstat-s --netstat --nmcli --ntpq --passwd --pidstat --pidstat-s --ping --ping-s --pip-list --pip-show --postconf --ps --route --rpm-qi --rsync --rsync-s --sfdisk --shadow --ss --stat --stat-s --sysctl --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'
+        '--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'
+        '--iptables:`iptables` command parser'
+        '--iso-datetime:ISO 8601 Datetime string parser'
+        '--iw-scan:`iw dev [device] scan` command parser'
+        '--jar-manifest: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'
+        '--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'
+        '--postconf:`postconf -M` command 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'
+        '--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 --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'
+        '--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 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
+
--- a/docs/lib.md
+++ b/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,
@@ -67,9 +67,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

--- a/docs/parsers/acpi.md
+++ b/docs/parsers/acpi.md
@@ -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)
--- a/docs/parsers/airport.md
+++ b/docs/parsers/airport.md
@@ -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)
--- a/docs/parsers/airport_s.md
+++ b/docs/parsers/airport_s.md
@@ -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)
--- a/docs/parsers/arp.md
+++ b/docs/parsers/arp.md
@@ -140,4 +140,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, aix, freebsd, darwin

-Version 1.9 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.10 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/asciitable.md
+++ b/docs/parsers/asciitable.md
@@ -59,6 +59,9 @@ etc...
 Headers (keys) are converted to snake-case. All values are returned as
 strings, except empty strings, which are converted to None/null.

+> Note: To preserve the case of the keys use the `-r` cli option or
+> `raw=True` argument in `parse()`.
+
 Usage (cli):

    $ cat table.txt | jc --asciitable
@@ -141,4 +144,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)
--- a/docs/parsers/asciitable_m.md
+++ b/docs/parsers/asciitable_m.md
@@ -29,6 +29,9 @@ Headers (keys) are converted to snake-case and newlines between multi-line
 headers are joined with an underscore. All values are returned as strings,
 except empty strings, which are converted to None/null.

+> Note: To preserve the case of the keys use the `-r` cli option or
+> `raw=True` argument in `parse()`.
+
 > Note: table column separator characters (e.g. `|`) cannot be present
 > inside the cell data. If detected, a warning message will be printed to
 > `STDERR` and the line will be skipped. The warning message can be
@@ -126,4 +129,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)
--- a/docs/parsers/blkid.md
+++ b/docs/parsers/blkid.md
@@ -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)
--- a/docs/parsers/chage.md
+++ b/docs/parsers/chage.md
@@ -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)
--- a/docs/parsers/cksum.md
+++ b/docs/parsers/cksum.md
@@ -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)
--- a/docs/parsers/csv.md
+++ b/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

    [
      {
--- a/docs/parsers/csv_s.md
+++ b/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,
--- a/docs/parsers/date.md
+++ b/docs/parsers/date.md
@@ -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)
--- a/docs/parsers/df.md
+++ b/docs/parsers/df.md
@@ -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)
--- a/docs/parsers/dig.md
+++ b/docs/parsers/dig.md
@@ -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)
--- a/docs/parsers/dir.md
+++ b/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)
--- a/docs/parsers/dmidecode.md
+++ b/docs/parsers/dmidecode.md
@@ -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)
--- a/docs/parsers/dpkg_l.md
+++ b/docs/parsers/dpkg_l.md
@@ -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)
--- a/docs/parsers/du.md
+++ b/docs/parsers/du.md
@@ -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)
--- a/docs/parsers/email_address.md
+++ b/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)
--- a/docs/parsers/free.md
+++ b/docs/parsers/free.md
@@ -95,4 +95,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/fstab.md
+++ b/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)
--- a/docs/parsers/git_log.md
+++ b/docs/parsers/git_log.md
@@ -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)
--- a/docs/parsers/git_log_s.md
+++ b/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)
--- a/docs/parsers/gpg.md
+++ b/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)
--- a/docs/parsers/group.md
+++ b/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)
--- a/docs/parsers/hash.md
+++ b/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)
--- a/docs/parsers/hciconfig.md
+++ b/docs/parsers/hciconfig.md
@@ -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)
--- a/docs/parsers/id.md
+++ b/docs/parsers/id.md
@@ -128,4 +128,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)
--- a/docs/parsers/ifconfig.md
+++ b/docs/parsers/ifconfig.md
@@ -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)
--- a/docs/parsers/ini.md
+++ b/docs/parsers/ini.md
@@ -11,9 +11,10 @@ Parses standard `INI` files and files containing simple key/value pairs.
 - Comment prefix can be `#` or `;`. Comments must be on their own line.
 - If duplicate keys are found, only the last value will be used.

-> Note: Values starting and ending with quotation marks will have the marks
-> removed. If you would like to keep the quotation marks, use the `-r`
-> command-line argument or the `raw=True` argument in `parse()`.
+> Note: Values starting and ending with double or single quotation marks
+> will have the marks removed. If you would like to keep the quotation
+> marks, use the `-r` command-line argument or the `raw=True` argument in
+> `parse()`.

 Usage (cli):

@@ -91,4 +92,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, win32, aix, freebsd

-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/iostat.md
+++ b/docs/parsers/iostat.md
@@ -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)
--- a/docs/parsers/iostat_s.md
+++ b/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)
--- a/docs/parsers/iptables.md
+++ b/docs/parsers/iptables.md
@@ -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)
--- a/docs/parsers/iso_datetime.md
+++ b/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)
--- a/docs/parsers/jobs.md
+++ b/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)
--- a/docs/parsers/jwt.md
+++ b/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)
--- a/docs/parsers/ls.md
+++ b/docs/parsers/ls.md
@@ -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)
--- a/docs/parsers/ls_s.md
+++ b/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)
--- a/docs/parsers/lsblk.md
+++ b/docs/parsers/lsblk.md
@@ -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)
--- a/docs/parsers/lsmod.md
+++ b/docs/parsers/lsmod.md
@@ -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)
--- a/docs/parsers/lsof.md
+++ b/docs/parsers/lsof.md
@@ -142,4 +142,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/m3u.md
+++ b/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)
--- a/docs/parsers/mpstat.md
+++ b/docs/parsers/mpstat.md
@@ -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)
--- a/docs/parsers/mpstat_s.md
+++ b/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)
--- a/docs/parsers/netstat.md
+++ b/docs/parsers/netstat.md
@@ -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)
--- a/docs/parsers/ntpq.md
+++ b/docs/parsers/ntpq.md
@@ -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)
--- a/docs/parsers/pidstat.md
+++ b/docs/parsers/pidstat.md
@@ -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)
--- a/docs/parsers/pidstat_s.md
+++ b/docs/parsers/pidstat_s.md
@@ -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)
--- a/docs/parsers/ping.md
+++ b/docs/parsers/ping.md
@@ -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)
--- a/docs/parsers/ping_s.md
+++ b/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)
--- a/docs/parsers/postconf.md
+++ b/docs/parsers/postconf.md
@@ -0,0 +1,115 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.postconf"></a>
+
+# jc.parsers.postconf
+
+jc - JSON Convert `postconf -M` command output parser
+
+Usage (cli):
+
+    $ postconf -M | jc --postconf
+
+    or
+
+    $ jc postconf -M
+
+Usage (module):
+
+    import jc
+    result = jc.parse('postconf', postconf_command_output)
+
+Schema:
+
+    [
+      {
+        "service_name":                     string,
+        "service_type":                     string,
+        "private":                          boolean/null,  # [0]
+        "unprivileged":                     boolean/null,  # [0]
+        "chroot":                           boolean/null,  # [0]
+        "wake_up_time":                     integer/null,  # [0]
+        "no_wake_up_before_first_use":      boolean/null,  # [1]
+        "process_limit":                    integer/null,  # [0]
+        "command":                          string
+      }
+    ]
+
+    [0] '-' converted to null/None
+    [1] null/None if `wake_up_time` is null/None
+
+Examples:
+
+    $ postconf -M | jc --postconf -p
+    [
+      {
+        "service_name": "smtp",
+        "service_type": "inet",
+        "private": false,
+        "unprivileged": null,
+        "chroot": true,
+        "wake_up_time": null,
+        "process_limit": null,
+        "command": "smtpd",
+        "no_wake_up_before_first_use": null
+      },
+      {
+        "service_name": "pickup",
+        "service_type": "unix",
+        "private": false,
+        "unprivileged": null,
+        "chroot": true,
+        "wake_up_time": 60,
+        "process_limit": 1,
+        "command": "pickup",
+        "no_wake_up_before_first_use": false
+      }
+    ]
+
+    $ postconf -M | jc --postconf -p -r
+    [
+      {
+        "service_name": "smtp",
+        "service_type": "inet",
+        "private": "n",
+        "unprivileged": "-",
+        "chroot": "y",
+        "wake_up_time": "-",
+        "process_limit": "-",
+        "command": "smtpd"
+      },
+      {
+        "service_name": "pickup",
+        "service_type": "unix",
+        "private": "n",
+        "unprivileged": "-",
+        "chroot": "y",
+        "wake_up_time": "60",
+        "process_limit": "1",
+        "command": "pickup"
+      }
+    ]
+
+<a id="jc.parsers.postconf.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)
--- a/docs/parsers/ps.md
+++ b/docs/parsers/ps.md
@@ -229,4 +229,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd

-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/route.md
+++ b/docs/parsers/route.md
@@ -131,4 +131,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.8 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/rpm_qi.md
+++ b/docs/parsers/rpm_qi.md
@@ -184,4 +184,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/rsync.md
+++ b/docs/parsers/rsync.md
@@ -157,4 +157,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)
--- a/docs/parsers/rsync_s.md
+++ b/docs/parsers/rsync_s.md
@@ -114,4 +114,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)
--- a/docs/parsers/sfdisk.md
+++ b/docs/parsers/sfdisk.md
@@ -225,4 +225,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/shadow.md
+++ b/docs/parsers/shadow.md
@@ -124,4 +124,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)
--- a/docs/parsers/ss.md
+++ b/docs/parsers/ss.md
@@ -303,4 +303,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/stat.md
+++ b/docs/parsers/stat.md
@@ -193,4 +193,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, freebsd

-Version 1.11 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.12 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/stat_s.md
+++ b/docs/parsers/stat_s.md
@@ -104,4 +104,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)
--- a/docs/parsers/systemctl_lj.md
+++ b/docs/parsers/systemctl_lj.md
@@ -98,4 +98,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/systeminfo.md
+++ b/docs/parsers/systeminfo.md
@@ -234,4 +234,4 @@ Returns:
 ### Parser Information
 Compatibility:  win32

-Version 1.2 by Jon Smith (jon@rebelliondefense.com)
+Version 1.3 by Jon Smith (jon@rebelliondefense.com)
--- a/docs/parsers/time.md
+++ b/docs/parsers/time.md
@@ -155,4 +155,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)
--- a/docs/parsers/timedatectl.md
+++ b/docs/parsers/timedatectl.md
@@ -87,4 +87,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/timestamp.md
+++ b/docs/parsers/timestamp.md
@@ -0,0 +1,122 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.timestamp"></a>
+
+# jc.parsers.timestamp
+
+jc - JSON Convert UNIX Epoch Timestamp string parser
+
+The naive fields are based on the local time of the system the parser is
+run on.
+
+The utc fields are timezone-aware, based on the UTC timezone.
+
+Usage (cli):
+
+    $ echo "2022-07-20T14:52:45Z" | jc --timestamp
+
+Usage (module):
+
+    import jc
+    result = jc.parse('timestamp', timestamp_string)
+
+Schema:
+
+    {
+      "naive": {
+        "year":                 integer,
+        "month":                string,
+        "month_num":            integer,
+        "day":                  integer,
+        "weekday":              string,
+        "weekday_num":          integer,
+        "hour":                 integer,
+        "hour_24":              integer,
+        "minute":               integer,
+        "second":               integer,
+        "period":               string,
+        "day_of_year":          integer,
+        "week_of_year":         integer,
+        "iso":                  string
+      },
+      "utc": {
+        "year":                 integer,
+        "month":                string,
+        "month_num":            integer,
+        "day":                  integer,
+        "weekday":              string,
+        "weekday_num":          integer,
+        "hour":                 integer,
+        "hour_24":              integer,
+        "minute":               integer,
+        "second":               integer,
+        "period":               string,
+        "utc_offset":           string,
+        "day_of_year":          integer,
+        "week_of_year":         integer,
+        "iso":                  string
+      }
+    }
+
+Examples:
+
+    $ echo '1658599410' | jc --timestamp -p
+    {
+      "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"
+      }
+    }
+
+<a id="jc.parsers.timestamp.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)
--- a/docs/parsers/top.md
+++ b/docs/parsers/top.md
@@ -336,4 +336,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/top_s.md
+++ b/docs/parsers/top_s.md
@@ -177,4 +177,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/tracepath.md
+++ b/docs/parsers/tracepath.md
@@ -154,4 +154,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/traceroute.md
+++ b/docs/parsers/traceroute.md
@@ -143,4 +143,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, freebsd

-Version 1.4 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.5 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/ufw.md
+++ b/docs/parsers/ufw.md
@@ -223,4 +223,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/ufw_appinfo.md
+++ b/docs/parsers/ufw_appinfo.md
@@ -161,4 +161,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/update_alt_q.md
+++ b/docs/parsers/update_alt_q.md
@@ -154,4 +154,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/uptime.md
+++ b/docs/parsers/uptime.md
@@ -88,4 +88,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd

-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/url.md
+++ b/docs/parsers/url.md
@@ -0,0 +1,223 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.url"></a>
+
+# jc.parsers.url
+
+jc - JSON Convert URL string parser
+
+Normalized, Encoded, and Decoded versions of the original URL and URL parts
+are included in the output. Encoding and Decoding is best effort.
+
+> Note: Do not use the Encoded fields for a URL that has already been
+> Encoded. Similarly, do not use the Decoded fields for a URL that has
+> already been Decoded.
+
+This parser will work with naked and wrapped URL strings:
+
+- `scheme://host/path`
+- `URL:scheme://host/path`
+- `<scheme://host/path>`
+- `<URL:scheme://host/path>`
+
+Usage (cli):
+
+    $ echo "http://example.com/test/path?q1=foo&q2=bar#frag" | jc --url
+
+Usage (module):
+
+    import jc
+    result = jc.parse('url', url_string)
+
+Schema:
+
+    {
+      "url":                       string,
+      "scheme":                    string or null,
+      "netloc":                    string or null,
+      "path":                      string or null,
+      "path_list": [               array or null
+                                   string
+      ],
+      "query":                     string or null,
+      "query_obj": {               object or null
+        <query-key>: [             array or null
+          <query-value>            string            # [0]
+        ]
+      },
+      "fragment":                  string or null,
+      "username":                  string or null,
+      "password":                  string or null,
+      "hostname":                  string or null,
+      "port":                      integer or null,  # [1]
+      "encoded": {
+        "url":                     string,
+        "scheme":                  string or null,
+        "netloc":                  string or null,
+        "path":                    string or null,
+        "path_list": [             array or null
+                                   string
+        ],
+        "query":                   string or null,
+        "fragment":                string or null,
+        "username":                string or null,
+        "password":                string or null,
+        "hostname":                string or null,
+        "port":                    integer or null,  # [1]
+      },
+      "decoded": {
+        "url":                     string,
+        "scheme":                  string or null,
+        "netloc":                  string or null,
+        "path":                    string or null,
+        "path_list": [             array or null
+                                   string
+        ],
+        "query":                   string or null,
+        "fragment":                string or null,
+        "username":                string or null,
+        "password":                string or null,
+        "hostname":                string or null,
+        "port":                    integer or null,  # [1]
+      }
+    }
+
+    [0] Duplicate query-keys will have their values consolidated into the
+        array of query-values
+
+    [1] Invalid port values will be converted to null/None and a warning
+        message will be printed to `STDERR` if quiet=False
+
+Examples:
+
+    $ echo "http://example.com/test/path?q1=foo&q1=bar&q2=baz#frag" \\
+           | jc --url -p
+    {
+      "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
+      }
+    }
+
+    $ echo "ftp://localhost/filepath" | jc --url -p
+    {
+      "url": "ftp://localhost/filepath",
+      "scheme": "ftp",
+      "netloc": "localhost",
+      "path": "/filepath",
+      "path_list": [
+        "filepath"
+      ],
+      "query": null,
+      "query_obj": null,
+      "fragment": null,
+      "username": null,
+      "password": null,
+      "hostname": "localhost",
+      "port": null,
+      "encoded": {
+        "url": "ftp://localhost/filepath",
+        "scheme": "ftp",
+        "netloc": "localhost",
+        "path": "/filepath",
+        "path_list": [
+          "filepath"
+        ],
+        "query": null,
+        "fragment": null,
+        "username": null,
+        "password": null,
+        "hostname": "localhost",
+        "port": null
+      },
+      "decoded": {
+        "url": "ftp://localhost/filepath",
+        "scheme": "ftp",
+        "netloc": "localhost",
+        "path": "/filepath",
+        "path_list": [
+          "filepath"
+        ],
+        "query": null,
+        "fragment": null,
+        "username": null,
+        "password": null,
+        "hostname": "localhost",
+        "port": null
+      }
+    }
+
+<a id="jc.parsers.url.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)
--- a/docs/parsers/vmstat.md
+++ b/docs/parsers/vmstat.md
@@ -149,4 +149,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.3 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/vmstat_s.md
+++ b/docs/parsers/vmstat_s.md
@@ -123,4 +123,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux

-Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.1 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/w.md
+++ b/docs/parsers/w.md
@@ -126,4 +126,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)
--- a/docs/parsers/wc.md
+++ b/docs/parsers/wc.md
@@ -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)
--- a/docs/parsers/who.md
+++ b/docs/parsers/who.md
@@ -158,4 +158,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin, cygwin, aix, freebsd

-Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
+Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/x509_cert.md
+++ b/docs/parsers/x509_cert.md
@@ -0,0 +1,431 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.x509_cert"></a>
+
+# jc.parsers.x509\_cert
+
+jc - JSON Convert X.509 Certificate format file parser
+
+This parser will convert DER and PEM encoded X.509 certificate files.
+
+You can convert other certificate formats (e.g. PKCS #7, PKCS #12, etc.) by
+processing them through a program like `openssl` and sending the output to
+`jc`. (See examples below)
+
+> Note: `jc` does not verify the integrity of the certificate, which
+> requires calculating the hash of the certificate body and comparing it to
+> the the hash in the certificate's signature after it is decrypted with the
+> issuer certificate's public key.
+
+Usage (cli):
+
+    $ cat certificate.pem | jc --x509-cert
+
+Usage (module):
+
+    import jc
+    result = jc.parse('x509_cert', x509_cert_file_output)
+
+Schema:
+
+    [
+      {
+        "tbs_certificate": {
+          "version":                      string,
+          "serial_number":                string,  # [0]
+          "signature": {
+            "algorithm":                  string,
+            "parameters":                 string/null,
+          },
+          "issuer": {
+            "country_name":               string,
+            "state_or_province_name"      string,
+            "locality_name":              string,
+            "organization_name":          array/string,
+            "organizational_unit_name":   array/string,
+            "common_name":                string,
+            "email_address":              string
+          },
+          "validity": {
+            "not_before":                 integer,  # [1]
+            "not_after":                  integer,  # [1]
+            "not_before_iso":             string,
+            "not_after_iso":              string
+          },
+          "subject": {
+            "country_name":               string,
+            "state_or_province_name":     string,
+            "locality_name":              string,
+            "organization_name":          array/string,
+            "organizational_unit_name":   array/string,
+            "common_name":                string,
+            "email_address":              string
+          },
+          "subject_public_key_info": {
+            "algorithm": {
+              "algorithm":                string,
+              "parameters":               string/null,
+            },
+            "public_key": {
+              "modulus":                  string,  # [0]
+              "public_exponent":          integer
+            }
+          },
+          "issuer_unique_id":             string/null,
+          "subject_unique_id":            string/null,
+          "extensions": [
+            {
+              "extn_id":                  string,
+              "critical":                 boolean,
+              "extn_value":               array/object/string/integer  # [2]
+            }
+          ]
+        },
+        "signature_algorithm": {
+          "algorithm":                    string,
+          "parameters":                   string/null
+        },
+        "signature_value":                string  # [0]
+      }
+    ]
+
+    [0] in colon-delimited hex notation
+    [1] time-zone-aware (UTC) epoch timestamp
+    [2] See below for well-known Extension schemas:
+
+        Basic Constraints:
+        {
+          "extn_id":                          "basic_constraints",
+          "critical":                         boolean,
+          "extn_value": {
+            "ca":                             boolean,
+            "path_len_constraint":            string/null
+          }
+        }
+
+        Key Usage:
+        {
+          "extn_id":                          "key_usage",
+          "critical":                         boolean,
+          "extn_value": [
+                                              string
+          ]
+        }
+
+        Key Identifier:
+        {
+          "extn_id":                          "key_identifier",
+          "critical":                         boolean,
+          "extn_value":                       string  # [0]
+        }
+
+        Authority Key Identifier:
+        {
+          "extn_id":                          "authority_key_identifier",
+          "critical":                         boolean,
+          "extn_value": {
+            "key_identifier":                 string,  # [0]
+            "authority_cert_issuer":          string/null,
+            "authority_cert_serial_number":   string/null
+          }
+        }
+
+        Subject Alternative Name:
+        {
+          "extn_id":                          "subject_alt_name",
+          "critical":                         boolean,
+          "extn_value": [
+                                              string
+          ]
+        }
+
+        Certificate Policies:
+        {
+          "extn_id":                          "certificate_policies",
+          "critical":                         boolean,
+          "extn_value": [
+            {
+              "policy_identifier":            string,
+              "policy_qualifiers": [          array or null
+                {
+                  "policy_qualifier_id":      string,
+                  "qualifier":                string
+                }
+              ]
+            }
+          ]
+        }
+
+        Signed Certificate Timestamp List
+        {
+          "extn_id":                    "signed_certificate_timestamp_list",
+          "critical":                   boolean,
+          "extn_value":                 string  # [0]
+        }
+
+Examples:
+
+    $ cat entrust-ec1.pem | jc --x509-cert -p
+    [
+      {
+        "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:..."
+          },
+          "issuer_unique_id": null,
+          "subject_unique_id": null,
+          "extensions": [
+            {
+              "extn_id": "key_usage",
+              "critical": true,
+              "extn_value": [
+                "crl_sign",
+                "key_cert_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:..."
+            }
+          ]
+        },
+        "signature_algorithm": {
+          "algorithm": "sha384_ecdsa",
+          "parameters": null
+        },
+        "signature_value": "30:64:02:30:61:79:d8:e5:42:47:df:1c:ae:53:..."
+      }
+    ]
+
+    $ openssl pkcs7 -in thawte.p7b -inform der -print_certs | \\
+              jc --x509-cert -p
+    [
+      {
+        "tbs_certificate": {
+          "version": "v3",
+          "serial_number": "34:4e:d5:57:20:d5:ed:ec:49:f4:2f:ce:37:db...",
+          "signature": {
+            "algorithm": "sha1_rsa",
+            "parameters": null
+          },
+          "issuer": {
+            "country_name": "US",
+            "organization_name": "thawte, Inc.",
+            "organizational_unit_name": [
+              "Certification Services Division",
+              "(c) 2006 thawte, Inc. - For authorized use only"
+            ],
+            "common_name": "thawte Primary Root CA"
+          },
+          "validity": {
+            "not_before": 1163721600,
+            "not_after": 2099865599,
+            "not_before_iso": "2006-11-17T00:00:00+00:00",
+            "not_after_iso": "2036-07-16T23:59:59+00:00"
+          },
+          "subject": {
+            "country_name": "US",
+            "organization_name": "thawte, Inc.",
+            "organizational_unit_name": [
+              "Certification Services Division",
+              "(c) 2006 thawte, Inc. - For authorized use only"
+            ],
+            "common_name": "thawte Primary Root CA"
+          },
+          "subject_public_key_info": {
+            "algorithm": {
+              "algorithm": "rsa",
+              "parameters": null
+            },
+            "public_key": {
+              "modulus": "ac:a0:f0:fb:80:59:d4:9c:c7:a4:cf:9d:a1:59:73...",
+              "public_exponent": 65537
+            }
+          },
+          "issuer_unique_id": null,
+          "subject_unique_id": null,
+          "extensions": [
+            {
+              "extn_id": "basic_constraints",
+              "critical": true,
+              "extn_value": {
+                "ca": true,
+                "path_len_constraint": null
+              }
+            },
+            {
+              "extn_id": "key_usage",
+              "critical": true,
+              "extn_value": [
+                "crl_sign",
+                "key_cert_sign"
+              ]
+            },
+            {
+              "extn_id": "key_identifier",
+              "critical": false,
+              "extn_value": "7b:5b:45:cf:af:ce:cb:7a:fd:31:92:1a:6a:b6:..."
+            }
+          ]
+        },
+        "signature_algorithm": {
+          "algorithm": "sha1_rsa",
+          "parameters": null
+        },
+        "signature_value": "79:11:c0:4b:b3:91:b6:fc:f0:e9:67:d4:0d:6e..."
+      }
+    ]
+
+    $ openssl pkcs12 -info -in certificate.pfx \\
+              -passin pass: -passout pass: | \\
+              jc --x509-cert -p
+    [
+      {
+        "tbs_certificate": {
+          "version": "v3",
+          "serial_number": "01",
+          "signature": {
+            "algorithm": "sha1_rsa",
+            "parameters": null
+          },
+          "issuer": {
+            "country_name": "FR",
+            "state_or_province_name": "Alsace",
+            "locality_name": "Strasbourg",
+            "organization_name": "www.freelan.org",
+            "organizational_unit_name": "freelan",
+            "common_name": "Freelan Sample Certificate Authority",
+            "email_address": "contact@freelan.org"
+          },
+          "validity": {
+            "not_before": 1335522678,
+            "not_after": 1650882678,
+            "not_before_iso": "2012-04-27T10:31:18+00:00",
+            "not_after_iso": "2022-04-25T10:31:18+00:00"
+          },
+          "subject": {
+            "country_name": "FR",
+            "state_or_province_name": "Alsace",
+            "organization_name": "www.freelan.org",
+            "organizational_unit_name": "freelan",
+            "common_name": "alice",
+            "email_address": "contact@freelan.org"
+          },
+          "subject_public_key_info": {
+            "algorithm": {
+              "algorithm": "rsa",
+              "parameters": null
+            },
+            "public_key": {
+              "modulus": "dd:6d:bd:f8:80:fa:d7:de:1b:1f:a7:a3:2e:b2:02...",
+              "public_exponent": 65537
+            }
+          },
+          "issuer_unique_id": null,
+          "subject_unique_id": null,
+          "extensions": [
+            {
+              "extn_id": "basic_constraints",
+              "critical": false,
+              "extn_value": {
+                "ca": false,
+                "path_len_constraint": null
+              }
+            },
+            {
+              "extn_id": "2.16.840.1.113730.1.13",
+              "critical": false,
+              "extn_value": "16:1d:4f:70:65:6e:53:53:4c:20:47:65:6e:65..."
+            },
+            {
+              "extn_id": "key_identifier",
+              "critical": false,
+              "extn_value": "59:5f:c9:13:ba:1b:cc:b9:a8:41:4a:8a:49:79..."
+            },
+            {
+              "extn_id": "authority_key_identifier",
+              "critical": false,
+              "extn_value": {
+                "key_identifier": "23:6c:2d:3d:3e:29:5d:78:b8:6c:3e:aa...",
+                "authority_cert_issuer": null,
+                "authority_cert_serial_number": null
+              }
+            }
+          ]
+        },
+        "signature_algorithm": {
+          "algorithm": "sha1_rsa",
+          "parameters": null
+        },
+        "signature_value": "13:e7:02:45:3e:a7:ab:bd:b8:da:e7:ef:74:88..."
+      }
+    ]
+
+<a id="jc.parsers.x509_cert.parse"></a>
+
+### parse
+
+```python
+def parse(data: Union[str, bytes],
+          raw: bool = False,
+          quiet: bool = False) -> List[Dict]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string or bytes) text or binary 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)
--- a/docs/parsers/zipinfo.md
+++ b/docs/parsers/zipinfo.md
@@ -99,4 +99,4 @@ Returns:
 ### Parser Information
 Compatibility:  linux, darwin

-Version 1.0 by Matt J (https://github.com/listuser)
+Version 1.1 by Matt J (https://github.com/listuser)
--- a/docs/readme.md
+++ b/docs/readme.md
@@ -30,7 +30,7 @@ https://github.com/kellyjonbrazil/jc/tree/master/docs

 > Replace `<full_version_number>` - e.g. `1.18.0`:

-Specific versions can also be selected by tag in the branch Github dropdown
+Specific versions can also be selected by tag in the Github branch dropdown
 menu.

 ## Usage Example
@@ -64,7 +64,7 @@ Use `help(jc.lib)` for details.

    parse(
        parser_module_name: str,
-        data: str | Iterable
+        data: str | bytes | Iterable
    ) -> dict | list[dict] | Iterable[dict]

 High-level API to easily access the parser. This API will find both
--- a/docs/utils.md
+++ b/docs/utils.md
@@ -80,7 +80,8 @@ def compatibility(mod_name: str,
 ```

 Checks for the parser's compatibility with the running OS platform and
-prints a warning message to `STDERR` if not compatible and quiet=False.
+prints a warning message to `STDERR` if not compatible and
+`quiet=False.`

 Parameters:

@@ -101,20 +102,23 @@ Returns:
 ### has\_data

 ```python
-def has_data(data: str) -> bool
+def has_data(data: Union[str, bytes]) -> bool
 ```

-Checks if the input contains data. If there are any non-whitespace
-characters then return True, else return False.
+Checks if the string input contains data. If there are any
+non-whitespace characters then return `True`, else return `False`.
+
+For bytes, returns True if there is any data.

 Parameters:

-    data:        (string) input to check whether it contains data
+    data:        (string, bytes) input to check whether it contains data

 Returns:

    Boolean      True if input string (data) contains non-whitespace
-                 characters, otherwise False
+                 characters, otherwise False. For bytes data, returns
+                 True if there is any data, otherwise False.

 <a id="jc.utils.convert_to_int"></a>

--- a/jc/init.py
+++ b/jc/init.py
@@ -26,7 +26,7 @@ https://github.com/kellyjonbrazil/jc/tree/master/docs

 > Replace `<full_version_number>` - e.g. `1.18.0`:

-Specific versions can also be selected by tag in the branch Github dropdown
+Specific versions can also be selected by tag in the Github branch dropdown
 menu.

 ## Usage Example
@@ -60,7 +60,7 @@ Use `help(jc.lib)` for details.

    parse(
        parser_module_name: str,
-        data: str | Iterable
+        data: str | bytes | Iterable
    ) -> dict | list[dict] | Iterable[dict]

 High-level API to easily access the parser. This API will find both
--- a/jc/cli.py
+++ b/jc/cli.py
@@ -9,10 +9,13 @@ import textwrap
 import signal
 import shlex
 import subprocess
+from typing import List, Dict
 from .lib import (__version__, parser_info, all_parser_info, parsers,
                  _get_parser, _parser_is_streaming, standard_parser_mod_list,
                  plugin_parser_mod_list, streaming_parser_mod_list)
 from . import utils
+from .cli_data import long_options_map, new_pygments_colors, old_pygments_colors
+from .shell_completions import bash_completion, zsh_completion
 from . import tracebackplus
 from .exceptions import LibraryNotInstalled, ParseError

@@ -45,43 +48,9 @@ class info():
 # startswith is sufficient and avoids potential exceptions from split and int.
 if PYGMENTS_INSTALLED:
    if pygments.__version__.startswith('2.3.'):
-        PYGMENT_COLOR = {
-            'black': '#ansiblack',
-            'red': '#ansidarkred',
-            'green': '#ansidarkgreen',
-            'yellow': '#ansibrown',
-            'blue': '#ansidarkblue',
-            'magenta': '#ansipurple',
-            'cyan': '#ansiteal',
-            'gray': '#ansilightgray',
-            'brightblack': '#ansidarkgray',
-            'brightred': '#ansired',
-            'brightgreen': '#ansigreen',
-            'brightyellow': '#ansiyellow',
-            'brightblue': '#ansiblue',
-            'brightmagenta': '#ansifuchsia',
-            'brightcyan': '#ansiturquoise',
-            'white': '#ansiwhite',
-        }
+        PYGMENT_COLOR = old_pygments_colors
    else:
-        PYGMENT_COLOR = {
-            'black': 'ansiblack',
-            'red': 'ansired',
-            'green': 'ansigreen',
-            'yellow': 'ansiyellow',
-            'blue': 'ansiblue',
-            'magenta': 'ansimagenta',
-            'cyan': 'ansicyan',
-            'gray': 'ansigray',
-            'brightblack': 'ansibrightblack',
-            'brightred': 'ansibrightred',
-            'brightgreen': 'ansibrightgreen',
-            'brightyellow': 'ansibrightyellow',
-            'brightblue': 'ansibrightblue',
-            'brightmagenta': 'ansibrightmagenta',
-            'brightcyan': 'ansibrightcyan',
-            'white': 'ansiwhite',
-        }
+        PYGMENT_COLOR = new_pygments_colors


 def set_env_colors(env_colors=None):
@@ -166,6 +135,22 @@ def parsers_text(indent=0, pad=0):
    return ptext


+def options_text(indent=0, pad=0):
+    """Return the argument and description information from each option"""
+    otext = ''
+    padding_char = ' '
+    for option in long_options_map:
+        o_short = '-' + long_options_map[option][0]
+        o_desc = long_options_map[option][1]
+        o_combined = o_short + ',  ' + option
+        padding = pad - len(o_combined)
+        indent_text = padding_char * indent
+        padding_text = padding_char * padding
+        otext += indent_text + o_combined + padding_text + o_desc + '\n'
+
+    return otext
+
+
 def about_jc():
    """Return jc info and the contents of each parser.info as a dictionary"""
    return {
@@ -189,43 +174,35 @@ def about_jc():

 def helptext():
    """Return the help text with the list of parsers"""
-    parsers_string = parsers_text(indent=12, pad=17)
+    parsers_string = parsers_text(indent=4, pad=20)
+    options_string = options_text(indent=4, pad=20)

    helptext_string = f'''\
-    jc converts the output of many commands and file-types to JSON
+jc converts the output of many commands and file-types to JSON or YAML

-    Usage:  COMMAND | jc PARSER [OPTIONS]
+Usage:
+    COMMAND | jc PARSER [OPTIONS]

-            or magic syntax:
+    or magic syntax:

-            jc [OPTIONS] COMMAND
+    jc [OPTIONS] COMMAND

-    Parsers:
+Parsers:
 {parsers_string}
-    Options:
-            -a    about jc
-            -C    force color output even when using pipes (overrides -m)
-            -d    debug (-dd for verbose debug)
-            -h    help (-h --parser_name for parser documentation)
-            -m    monochrome output
-            -p    pretty print output
-            -q    quiet - suppress parser warnings (-qq to ignore streaming errors)
-            -r    raw JSON output
-            -u    unbuffer output
-            -v    version info
-            -y    YAML output
+Options:
+{options_string}
+Examples:
+    Standard Syntax:
+        $ dig www.google.com | jc --dig --pretty

-    Examples:
-            Standard Syntax:
-                $ dig www.google.com | jc --dig -p
+    Magic Syntax:
+        $ jc --pretty dig www.google.com

-            Magic Syntax:
-                $ jc -p dig www.google.com
+    Parser Documentation:
+        $ jc --help --dig
+'''

-            Parser Documentation:
-                $ jc -h --dig
-    '''
-    return textwrap.dedent(helptext_string)
+    return helptext_string


 def help_doc(options):
@@ -248,9 +225,11 @@ def help_doc(options):
                f'Compatibility:  {compatible}\n\n'\
                f'Version {version} by {author} ({author_email})\n'

-            return doc_text
+            utils._safe_pager(doc_text)
+            return

-    return helptext()
+    utils._safe_print(helptext())
+    return


 def versiontext():
@@ -285,7 +264,7 @@ def yaml_out(data, pretty=False, env_colors=None, mono=False, piped_out=False, a
        # ruamel.yaml versions prior to 0.17.0 the use of __file__ in the
        # plugin code is incompatible with the pyoxidizer packager
        YAML.official_plug_ins = lambda a: []
-        yaml=YAML()
+        yaml = YAML()
        yaml.default_flow_style = False
        yaml.explicit_start = True
        yaml.allow_unicode = not ascii_only
@@ -381,7 +360,7 @@ def magic_parser(args):
        jc_options    (list)  list of jc options
    """
    # bail immediately if there are no args or a parser is defined
-    if len(args) <= 1 or args[1].startswith('--'):
+    if len(args) <= 1 or (args[1].startswith('--') and args[1] not in long_options_map):
        return False, None, None, []

    args_given = args[1:]
@@ -389,6 +368,12 @@ def magic_parser(args):

    # find the options
    for arg in list(args_given):
+        # long option found - populate option list
+        if arg in long_options_map:
+            options.extend(long_options_map[arg][0])
+            args_given.pop(0)
+            continue
+
        # parser found - use standard syntax
        if arg.startswith('--'):
            return False, None, None, []
@@ -483,6 +468,9 @@ def main():
    # find options if magic_parser did not find a command
    if not valid_command:
        for opt in sys.argv:
+            if opt in long_options_map:
+                options.extend(long_options_map[opt][0])
+
            if opt.startswith('-') and not opt.startswith('--'):
                options.extend(opt[1:])

@@ -499,6 +487,8 @@ def main():
    unbuffer = 'u' in options
    version_info = 'v' in options
    yaml_out = 'y' in options
+    bash_comp = 'B' in options
+    zsh_comp = 'Z' in options

    if verbose_debug:
        tracebackplus.enable(context=11)
@@ -516,13 +506,21 @@ def main():
        sys.exit(0)

    if help_me:
-        utils._safe_print(help_doc(sys.argv))
+        help_doc(sys.argv)
        sys.exit(0)

    if version_info:
        utils._safe_print(versiontext())
        sys.exit(0)

+    if bash_comp:
+        utils._safe_print(bash_completion())
+        sys.exit(0)
+
+    if zsh_comp:
+        utils._safe_print(zsh_completion())
+        sys.exit(0)
+
    # if magic syntax used, try to run the command and error if it's not found, etc.
    magic_stdout, magic_stderr, magic_exit_code = None, None, 0
    if run_command:
@@ -592,7 +590,7 @@ def main():
    try:
        # differentiate between regular and streaming parsers

-        # streaming
+        # streaming (only supports UTF-8 string data for now)
        if _parser_is_streaming(parser):
            result = parser.parse(sys.stdin,
                                  raw=raw,
@@ -609,9 +607,17 @@ def main():

            sys.exit(combined_exit_code(magic_exit_code, 0))

-        # regular
+        # regular (supports binary and UTF-8 string data)
        else:
-            data = magic_stdout or sys.stdin.read()
+            data = magic_stdout or sys.stdin.buffer.read()
+
+            # convert to UTF-8, if possible. Otherwise, leave as bytes
+            try:
+                if isinstance(data, bytes):
+                    data = data.decode('utf-8')
+            except UnicodeDecodeError:
+                pass
+
            result = parser.parse(data,
                                  raw=raw,
                                  quiet=quiet)
--- a/jc/cli_data.py
+++ b/jc/cli_data.py
@@ -0,0 +1,56 @@
+"""jc - JSON Convert cli_data module"""
+from typing import List, Dict
+
+long_options_map: Dict[str, List[str]] = {
+    '--about': ['a', 'about jc'],
+    '--force-color': ['C', 'force color output even when using pipes (overrides -m)'],
+    '--debug': ['d', 'debug (double for verbose debug)'],
+    '--help': ['h', 'help (--help --parser_name for parser documentation)'],
+    '--monochrome': ['m', 'monochrome output'],
+    '--pretty': ['p', 'pretty print output'],
+    '--quiet': ['q', 'suppress warnings (double to ignore streaming errors)'],
+    '--raw': ['r', 'raw output'],
+    '--unbuffer': ['u', 'unbuffer output'],
+    '--version': ['v', 'version info'],
+    '--yaml-out': ['y', 'YAML output'],
+    '--bash-comp': ['B', 'gen Bash completion: jc -B > /etc/bash_completion.d/jc'],
+    '--zsh-comp': ['Z', 'gen Zsh completion: jc -Z > "${fpath[1]}/_jc"']
+}
+
+new_pygments_colors = {
+    'black': 'ansiblack',
+    'red': 'ansired',
+    'green': 'ansigreen',
+    'yellow': 'ansiyellow',
+    'blue': 'ansiblue',
+    'magenta': 'ansimagenta',
+    'cyan': 'ansicyan',
+    'gray': 'ansigray',
+    'brightblack': 'ansibrightblack',
+    'brightred': 'ansibrightred',
+    'brightgreen': 'ansibrightgreen',
+    'brightyellow': 'ansibrightyellow',
+    'brightblue': 'ansibrightblue',
+    'brightmagenta': 'ansibrightmagenta',
+    'brightcyan': 'ansibrightcyan',
+    'white': 'ansiwhite',
+}
+
+old_pygments_colors = {
+    'black': '#ansiblack',
+    'red': '#ansidarkred',
+    'green': '#ansidarkgreen',
+    'yellow': '#ansibrown',
+    'blue': '#ansidarkblue',
+    'magenta': '#ansipurple',
+    'cyan': '#ansiteal',
+    'gray': '#ansilightgray',
+    'brightblack': '#ansidarkgray',
+    'brightred': '#ansired',
+    'brightgreen': '#ansigreen',
+    'brightyellow': '#ansiyellow',
+    'brightblue': '#ansiblue',
+    'brightmagenta': '#ansifuchsia',
+    'brightcyan': '#ansiturquoise',
+    'white': '#ansiwhite',
+}
--- a/jc/lib.py
+++ b/jc/lib.py
@@ -6,7 +6,7 @@ import importlib
 from typing import Dict, List, Iterable, Union, Iterator
 from jc import appdirs

-__version__ = '1.20.0'
+__version__ = '1.20.3'

 parsers = [
    'acpi',
@@ -29,6 +29,7 @@ parsers = [
    'dmidecode',
    'dpkg-l',
    'du',
+    'email-address',
    'env',
    'file',
    'finger',
@@ -36,6 +37,7 @@ parsers = [
    'fstab',
    'git-log',
    'git-log-s',
+    'gpg',
    'group',
    'gshadow',
    'hash',
@@ -49,9 +51,11 @@ parsers = [
    'iostat',
    'iostat-s',
    'iptables',
+    'iso-datetime',
    'iw-scan',
    'jar-manifest',
    'jobs',
+    'jwt',
    'kv',
    'last',
    'ls',
@@ -60,6 +64,7 @@ parsers = [
    'lsmod',
    'lsof',
    'lsusb',
+    'm3u',
    'mount',
    'mpstat',
    'mpstat-s',
@@ -73,6 +78,7 @@ parsers = [
    'ping-s',
    'pip-list',
    'pip-show',
+    'postconf',
    'ps',
    'route',
    'rpm-qi',
@@ -91,6 +97,7 @@ parsers = [
    'systeminfo',
    'time',
    'timedatectl',
+    'timestamp',
    'top',
    'top-s',
    'tracepath',
@@ -102,11 +109,13 @@ parsers = [
    'update-alt-q',
    'upower',
    'uptime',
+    'url',
    'vmstat',
    'vmstat-s',
    'w',
    'wc',
    'who',
+    'x509-cert',
    'xml',
    'xrandr',
    'yaml',
@@ -167,7 +176,7 @@ def _parser_is_streaming(parser):

 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,
@@ -212,9 +221,9 @@ def parse(
                                         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

--- a/jc/parsers/acpi.py
+++ b/jc/parsers/acpi.py
@@ -227,7 +227,7 @@ import jc.utils

 class info():
    """Provides parser metadata (version, author, etc.)"""
-    version = '1.3'
+    version = '1.4'
    description = '`acpi` command parser'
    author = 'Kelly Brazil'
    author_email = 'kellyjonbrazil@gmail.com'
@@ -250,9 +250,9 @@ def _process(proc_data):

        List of Dictionaries. Structured data to conform to the schema.
    """
-    int_list = ['id', 'charge_percent', 'design_capacity_mah', 'last_full_capacity',
-                'last_full_capacity_percent']
-    float_list = ['temperature']
+    int_list = {'id', 'charge_percent', 'design_capacity_mah', 'last_full_capacity',
+                'last_full_capacity_percent'}
+    float_list = {'temperature'}

    for entry in proc_data:
        for key in entry:
--- a/jc/parsers/airport.py
+++ b/jc/parsers/airport.py
@@ -80,7 +80,7 @@ import jc.utils

 class info():
    """Provides parser metadata (version, author, etc.)"""
-    version = '1.4'
+    version = '1.5'
    description = '`airport -I` command parser'
    author = 'Kelly Brazil'
    author_email = 'kellyjonbrazil@gmail.com'
@@ -103,9 +103,9 @@ def _process(proc_data):

        Dictionary. Structured data to conform to the schema.
    """
-    # integer changes
-    int_list = ['agrctlrssi', 'agrextrssi', 'agrctlnoise', 'agrextnoise',
-                'lasttxrate', 'maxrate', 'lastassocstatus', 'mcs']
+    int_list = {'agrctlrssi', 'agrextrssi', 'agrctlnoise', 'agrextnoise',
+                'lasttxrate', 'maxrate', 'lastassocstatus', 'mcs'}
+
    for key in proc_data:
        if key in int_list:
            proc_data[key] = jc.utils.convert_to_int(proc_data[key])
--- a/jc/parsers/airport_s.py
+++ b/jc/parsers/airport_s.py
@@ -109,7 +109,7 @@ import jc.parsers.universal

 class info():
    """Provides parser metadata (version, author, etc.)"""
-    version = '1.5'
+    version = '1.6'
    description = '`airport -s` command parser'
    author = 'Kelly Brazil'
    author_email = 'kellyjonbrazil@gmail.com'
@@ -135,8 +135,8 @@ def _process(proc_data):
    for entry in proc_data:

        # convert integers and booleans
-        int_list = ['rssi']
-        bool_list = ['ht']
+        int_list = {'rssi'}
+        bool_list = {'ht'}
        for key in entry:
            if key in int_list:
                entry[key] = jc.utils.convert_to_int(entry[key])
--- a/jc/parsers/arp.py
+++ b/jc/parsers/arp.py
@@ -119,7 +119,7 @@ import jc.parsers.universal

 class info():
    """Provides parser metadata (version, author, etc.)"""
-    version = '1.9'
+    version = '1.10'
    description = '`arp` command parser'
    author = 'Kelly Brazil'
    author_email = 'kellyjonbrazil@gmail.com'
@@ -142,13 +142,13 @@ def _process(proc_data: List[Dict]) -> List[Dict]:

        List of Dictionaries. Structured data to conform to the schema:
    """
+    int_list = {'expires'}

    # in BSD style, change name to null if it is a question mark
    for entry in proc_data:
        if 'name' in entry and entry['name'] == '?':
            entry['name'] = None

-        int_list = ['expires']
        for key in entry:
            if key in int_list:
                entry[key] = jc.utils.convert_to_int(entry[key])
--- a/Show More
+++ b/Show More
Author	SHA1	Message	Date
Kelly Brazil	2683dbb20a	Merge pull request #266 from kellyjonbrazil/dev Dev v1.20.3	2022-07-23 13:12:54 -07:00
Kelly Brazil	8b3228797e	formatting	2022-07-23 12:55:56 -07:00
Kelly Brazil	947b37397f	doc update	2022-07-23 12:52:42 -07:00
Kelly Brazil	f5f0e00e8d	add timestamp tests	2022-07-23 12:51:27 -07:00
Kelly Brazil	73ab7da665	add timestamp parser	2022-07-23 12:43:17 -07:00
Kelly Brazil	6f00b6fd61	doc update	2022-07-23 10:57:46 -07:00
Kelly Brazil	8ada8b79c1	doc update	2022-07-23 10:45:11 -07:00
Kelly Brazil	cd293d4786	new email address schema	2022-07-23 10:45:04 -07:00
Kelly Brazil	b7d59bdd85	update tests for new email-address schema	2022-07-23 10:44:44 -07:00
Kelly Brazil	894f599f79	add tests for iso_datetime and jwt	2022-07-22 15:58:39 -07:00
Kelly Brazil	29bb10b8ff	add url and email_address tests	2022-07-22 15:41:59 -07:00
Kelly Brazil	7224c7183b	docfix: scheme can be string or null	2022-07-22 14:58:21 -07:00
Kelly Brazil	81301357e4	schema update: netloc can be string or null	2022-07-22 11:46:52 -07:00
Kelly Brazil	ddca18f25a	remove unused import	2022-07-22 11:43:21 -07:00
Kelly Brazil	d1164290a6	formatting	2022-07-22 11:42:00 -07:00
Kelly Brazil	3949edc169	doc update	2022-07-22 11:37:00 -07:00
Kelly Brazil	a296ac2e8f	fix port integer handling	2022-07-22 11:36:23 -07:00
Kelly Brazil	551f4b097d	doc update	2022-07-22 09:28:27 -07:00
Kelly Brazil	8d42f747a7	schema update for normalized, encoded, and decoded fields	2022-07-22 09:28:18 -07:00
Kelly Brazil	163a76dd10	add microsecond field	2022-07-21 10:16:58 -07:00
Kelly Brazil	7389ed5d0c	doc update	2022-07-21 09:52:03 -07:00
Kelly Brazil	5905058e97	clarify quoting rules	2022-07-21 09:51:58 -07:00
Kelly Brazil	2a11fefe45	add timestamp info	2022-07-20 23:02:16 -07:00
Kelly Brazil	e27ed0743c	formatting	2022-07-20 22:31:04 -07:00
Kelly Brazil	9f6a788a98	doc update	2022-07-20 22:28:12 -07:00
Kelly Brazil	a15d20b400	add final encoded fields	2022-07-20 22:27:29 -07:00
Kelly Brazil	55ae836a43	add encoded fields	2022-07-20 21:46:06 -07:00
Kelly Brazil	c4fc5409e3	doc update	2022-07-20 17:09:09 -07:00
Kelly Brazil	956ad75168	add iso_datetime string parser	2022-07-20 17:06:29 -07:00
Kelly Brazil	71494a53ca	doc update	2022-07-20 16:53:54 -07:00
Kelly Brazil	bc211b7c36	fix plus signs in quoted query	2022-07-20 16:39:31 -07:00
Kelly Brazil	2eaef09770	fixup schema and examples	2022-07-20 16:31:59 -07:00
Kelly Brazil	641d63604b	doc fix	2022-07-20 15:59:33 -07:00
Kelly Brazil	750a3906c7	doc fix	2022-07-20 15:58:29 -07:00
Kelly Brazil	bd8e69ce98	initialize query variables	2022-07-20 15:57:05 -07:00
Kelly Brazil	16b17dd7aa	remove unneded unwrap step	2022-07-20 15:51:34 -07:00
Kelly Brazil	d5a6c22cc6	add normalized fields	2022-07-20 15:43:08 -07:00
Kelly Brazil	b2271713e1	add to docs	2022-07-20 07:56:39 -07:00
Kelly Brazil	f0b9662c5e	add docs	2022-07-20 07:54:50 -07:00
Kelly Brazil	720c6b5d42	add note about jc not checking the certificate integrity	2022-07-19 17:15:54 -07:00
Kelly Brazil	c30d44ea13	doc update	2022-07-19 15:24:38 -07:00
Kelly Brazil	b5788134b6	add jwt string parser	2022-07-19 15:23:42 -07:00
Kelly Brazil	790103fb48	doc update	2022-07-19 13:02:09 -07:00
Kelly Brazil	e56944dc24	formatting	2022-07-19 12:58:49 -07:00
Kelly Brazil	ed04951ed7	add email_address string parser	2022-07-19 12:58:44 -07:00
Kelly Brazil	84337fe3d1	change description	2022-07-19 08:46:34 -07:00
Kelly Brazil	da631c8b22	add username, password, hostname, and port	2022-07-19 08:23:27 -07:00
Kelly Brazil	450d0d5ddf	document schema	2022-07-19 07:45:13 -07:00
Kelly Brazil	0ed47fc7ce	fix query for non-http schemes. Set null for empty fields	2022-07-19 07:39:01 -07:00
Kelly Brazil	d57a00e8be	fix up query object	2022-07-19 07:29:09 -07:00
Kelly Brazil	fa7721c31d	add initial URL parser	2022-07-19 07:16:28 -07:00
Kelly Brazil	0f72d46050	add extension docs	2022-07-18 14:47:48 -07:00
Kelly Brazil	fe3b5bc2ed	doc update	2022-07-18 14:31:13 -07:00
Kelly Brazil	4f7f8dd82b	doc update	2022-07-18 14:23:52 -07:00
Kelly Brazil	81fb294859	add m3u example	2022-07-17 11:30:53 -07:00
Kelly Brazil	c04fd5bbf9	simplify single quote handling	2022-07-16 21:16:29 -07:00
Kelly Brazil	d6ed5a0eba	doc update	2022-07-16 20:52:19 -07:00
Kelly Brazil	33b996f6be	process optimizations	2022-07-16 20:51:18 -07:00
Kelly Brazil	26d4bbe9a4	add m3u tests	2022-07-16 19:43:19 -07:00
Kelly Brazil	5abea6d0c5	fix issue with single quotes in extended info	2022-07-16 19:32:23 -07:00
Kelly Brazil	afce7cdbd7	remove auto import	2022-07-16 11:43:41 -07:00
Kelly Brazil	8c3cff59c6	make parser more robust for non-standard extension fields	2022-07-16 11:27:58 -07:00
Kelly Brazil	bc15a636f1	optimizations up to netstat	2022-07-15 17:28:08 -07:00
Kelly Brazil	1564533161	formatting	2022-07-15 15:19:56 -07:00
Kelly Brazil	27fd6843cc	add m3u file parser	2022-07-15 15:14:49 -07:00
Kelly Brazil	8c8d5552c8	version bump	2022-07-15 11:18:13 -07:00
Kelly Brazil	a7ee414c67	add pager functionality to parser documentation	2022-07-15 11:18:02 -07:00
Kelly Brazil	6573b355cc	Merge pull request #262 from kellyjonbrazil/master sync to dev	2022-07-15 10:53:37 -07:00
Kelly Brazil	eaa36a6a31	formatting	2022-07-07 12:56:18 -07:00
Kelly Brazil	8b1c4f923e	doc fix	2022-07-07 09:23:02 -07:00
Kelly Brazil	89c36e4996	add pkcs12 example	2022-07-07 09:13:06 -07:00
Kelly Brazil	0ea5c9585a	formatting	2022-07-06 20:27:41 -07:00
Kelly Brazil	5fa2fe3992	fix example	2022-07-06 17:20:56 -07:00
Kelly Brazil	014437298c	add pkcs7 example	2022-07-06 17:08:12 -07:00
Kelly Brazil	04d91516e8	add license	2022-07-05 19:56:22 -07:00
Kelly Brazil	9b33a50bb0	Merge pull request #260 from kellyjonbrazil/dev Dev v1.20.2	2022-07-05 19:39:40 -07:00
Kelly Brazil	b0e9d9fa9d	fix encodings for windows tests	2022-07-05 19:23:22 -07:00
Kelly Brazil	991b612b62	add colon seperators to hex strings in python 3.6 and 3.7	2022-07-05 19:19:06 -07:00
Kelly Brazil	855c9363a5	add hexlify compatibility for python 3.6 and 3.7	2022-07-05 19:12:44 -07:00
Kelly Brazil	625544f53e	add x509-cert tests	2022-07-05 18:59:55 -07:00
Kelly Brazil	f179da8cd1	sort set to list conversion	2022-07-05 18:59:47 -07:00
Kelly Brazil	eeee776555	add shell completion build scripts	2022-07-05 16:41:23 -07:00
Kelly Brazil	d0bde14a2a	version bump	2022-07-05 16:15:35 -07:00
Kelly Brazil	69b0e407ad	move pygments colors to cli_data.py	2022-07-05 16:15:26 -07:00
Kelly Brazil	ad2b9ab76c	doc update	2022-07-05 15:07:10 -07:00
Kelly Brazil	32483de4f2	doc update	2022-07-05 14:59:21 -07:00
Kelly Brazil	ec713cfa1b	doc update	2022-07-05 13:33:57 -07:00
Kelly Brazil	eac8c1c1a0	only attempt to decode certificate type	2022-07-05 12:55:38 -07:00
Kelly Brazil	4e15ab7924	fix _fix_objects: catch all sets and OrderedDicts	2022-07-05 11:33:56 -07:00
Kelly Brazil	5882755e7c	convert larg integers to ascii-hex. simplify _fix_objects. add iso date strings. allow multiple certs in a PEM bundle	2022-07-05 11:29:24 -07:00
Kelly Brazil	13388df603	initial working x509 cert parser	2022-07-01 15:48:29 -07:00
Kelly Brazil	430385fa63	doc update	2022-06-30 09:25:01 -07:00
Kelly Brazil	7bfebdcfeb	remove unnecessary list initialization	2022-06-30 09:24:05 -07:00
Kelly Brazil	e472c3b140	add gpg tests	2022-06-29 18:56:15 -07:00
Kelly Brazil	43ac3d951c	doc update	2022-06-29 18:36:06 -07:00
Kelly Brazil	207fa232c3	add examples	2022-06-29 18:34:20 -07:00
Kelly Brazil	667dc1976a	add support for special field types	2022-06-29 18:26:38 -07:00
Kelly Brazil	7437750de5	initial working gpg parser	2022-06-29 11:01:25 -07:00
Kelly Brazil	aab47c9e80	Merge pull request #258 from kellyjonbrazil/master sync to dev	2022-06-28 16:07:05 -07:00
Kelly Brazil	f1ed803525	formatting	2022-06-16 18:03:51 -07:00
Kelly Brazil	093c1703d7	formatting	2022-06-16 18:00:40 -07:00
Kelly Brazil	1f2e16aeea	formatting	2022-06-16 17:54:40 -07:00
Kelly Brazil	6f89745a58	formatting	2022-06-16 17:51:59 -07:00
Kelly Brazil	9b710b0b6f	formatting	2022-06-16 17:51:20 -07:00
Kelly Brazil	992120b861	spelling	2022-06-16 17:48:07 -07:00
Kelly Brazil	229bef5f82	update anchor link	2022-06-16 07:52:58 -07:00
Kelly Brazil	c8a4890fc7	fix anchor link	2022-06-16 07:50:37 -07:00
Kelly Brazil	10a9848ac8	Merge branch 'master' of https://github.com/kellyjonbrazil/jc	2022-06-16 07:48:46 -07:00
Kelly Brazil	95189e37ba	add streaming parsers link	2022-06-16 07:48:44 -07:00
Kelly Brazil	fe1f09f08d	use github markdown renderer	2022-06-15 20:15:24 -07:00
Kelly Brazil	6adfa15742	formatting	2022-06-15 20:10:55 -07:00
Kelly Brazil	edef264f17	formatting	2022-06-15 20:04:39 -07:00
Kelly Brazil	9911b3fc9d	formatting	2022-06-15 16:11:22 -07:00
Kelly Brazil	1675aa7a59	add shell completion wiki link	2022-06-15 16:08:31 -07:00
Kelly Brazil	7fd67fda13	Merge pull request #256 from kellyjonbrazil/dev v1.20.1	2022-06-15 22:16:07 +00:00
Kelly Brazil	7583f315ce	add long options tests	2022-06-15 13:21:37 -07:00
Kelly Brazil	7fd70d2088	doc update	2022-06-15 13:10:12 -07:00
Kelly Brazil	337ee73844	doc update	2022-06-15 12:51:42 -07:00
Kelly Brazil	43702a260b	strip single quotes just like double quotes	2022-06-15 12:50:58 -07:00
Kelly Brazil	40208a9f76	doc update	2022-06-15 11:25:21 -07:00
Kelly Brazil	b958358389	update _snake_case comment	2022-06-15 11:15:26 -07:00
Kelly Brazil	c23aacedad	doc update	2022-06-15 11:12:49 -07:00
Kelly Brazil	4f148469d7	preserve keyname case with -r	2022-06-15 11:12:43 -07:00
Kelly Brazil	247c43278c	add postconf tests	2022-06-15 09:22:09 -07:00
Kelly Brazil	45f45e0511	add examples	2022-06-15 09:18:11 -07:00
Kelly Brazil	c0c469ae9b	add comments	2022-06-14 17:03:54 -07:00
Kelly Brazil	4b86fd8d8a	manipulate words and CURRENT to fix magic completions in Zsh	2022-06-14 16:51:45 -07:00
Kelly Brazil	8fba47f449	doc update	2022-06-14 12:42:30 -07:00
Kelly Brazil	f9ae964280	reuse arrays in zsh completions	2022-06-14 08:49:26 -07:00
Kelly Brazil	ca95615d7f	partially working _normal completion for zsh	2022-06-14 07:42:55 -07:00
Kelly Brazil	747b255e34	zsh working same as bash except for magic command completions	2022-06-13 21:09:37 -07:00
Kelly Brazil	c0da9ebd6c	only check previous words in bash completion	2022-06-10 17:25:19 -07:00
Kelly Brazil	5c40b38a05	fix help bash completions so they don't repeat parsers	2022-06-10 12:02:04 -07:00
Kelly Brazil	7bc03dcf06	add local vars to bash completion	2022-06-08 08:51:23 -07:00
Kelly Brazil	f62e6168fd	fix help completions for bash	2022-06-08 08:50:20 -07:00
Kelly Brazil	39c1470ea6	add special options to bash completion	2022-06-07 11:57:48 -07:00
Kelly Brazil	e48b99f1c1	fix bash completion behavior	2022-06-07 11:02:05 -07:00
Kelly Brazil	71ae545907	better working bash completion	2022-06-06 16:24:52 -07:00
Kelly Brazil	b9a5eda187	formatting	2022-06-06 10:52:40 -07:00
Kelly Brazil	231a2039c2	update options	2022-06-06 10:49:17 -07:00
Kelly Brazil	a415bc23fa	man page update	2022-06-06 10:32:18 -07:00
Kelly Brazil	79add35fc1	split long and short options	2022-06-05 18:09:44 -07:00
Kelly Brazil	901763fc39	fix hyphens	2022-06-05 18:06:38 -07:00
Kelly Brazil	1034cb1ea2	Merge branch 'dev' of https://github.com/kellyjonbrazil/jc into dev	2022-06-05 18:04:42 -07:00
Kelly Brazil	020093fd67	revert non-breaking hyphens	2022-06-05 18:04:35 -07:00
Kelly Brazil	f17b3fbd32	add non-breaking hyphens	2022-06-05 17:54:34 -07:00
Kelly Brazil	15b58e3a6b	add long-options	2022-06-05 17:52:14 -07:00
Kelly Brazil	da6c98826b	doc update	2022-06-05 17:40:05 -07:00
Kelly Brazil	26415e2978	formatting	2022-06-05 17:17:13 -07:00
Kelly Brazil	d849bd3b66	add bash and zsh completions to cli	2022-06-05 16:23:55 -07:00
Kelly Brazil	5996192455	remove indent at end of help text	2022-06-05 12:16:30 -07:00
Kelly Brazil	a38b6b5522	add long options	2022-06-05 12:12:58 -07:00
Kelly Brazil	1d6bc40bff	fix no_wake_up_before_first_use to allow None	2022-06-03 10:35:49 -07:00
Kelly Brazil	437fa62cb1	update schema	2022-06-03 10:29:55 -07:00
Kelly Brazil	6cde26d9ed	add process logic	2022-06-02 14:53:31 -07:00
Kelly Brazil	f6dd5a68cd	doc update	2022-06-02 09:28:00 -07:00
Kelly Brazil	b1507dc576	initial postconf parser	2022-06-02 09:14:02 -07:00
Kelly Brazil	a5d5b1554f	change variable name from list to my_list	2022-06-02 08:34:51 -07:00
Kelly Brazil	ec8efebc94	move _get_item outside of parse function	2022-06-02 08:31:28 -07:00
Kelly Brazil	f86cbf5527	Merge pull request #250 from pbrezina/id id: parse output without name	2022-06-02 15:27:07 +00:00
Pavel Březina	57142d899c	id: parse output without name If a group does not exist only gid is present in the command output.	2022-06-02 12:51:11 +02:00
Kelly Brazil	504a04279e	version bump	2022-06-01 12:13:50 -07:00
Kelly Brazil	3b4ef4a814	formatting	2022-06-01 12:13:41 -07:00
Kelly Brazil	a7e3d2fc86	Merge pull request #251 from kellyjonbrazil/master sync to dev	2022-06-01 17:35:52 +00:00