Merge branch 'dev' into xrandr_fix_schema

2025-07-09 01:05:53 +02:00 · 2024-03-18 10:05:29 -07:00
parent a3ca2814b3 ee1135003b
commit ebd0432b82
388 changed files with 1606 additions and 1437 deletions
--- a/4
+++ b/4
@ -1,6 +1,6 @@
 jc changelog

-20240301 v1.25.2
+20240315 v1.25.2
 - Add `apt-cache-show` command parser
 - Add `apt-get-sqq` command parser
 - Add `ethtool` command parser
@ -13,7 +13,7 @@ jc changelog
 - Enhance `/proc/pid/stat` parser to support "Idle" state
 - Enhance `rpm_qi` and `pkg_index_deb` parsers to split list fields into arrays
 - Fix `iwconfig` parser to handle more special characters in the SSID name
- Documentation updates
+- Documentation and doc build updates

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

-readme_config=$(cat <<'EOF'
-{
-    "processors": [
-        {
-            "type": "filter"
-        },
-        {
-            "type": "pydocmd"
-        }
-    ],
-    "renderer": {
-        "type": "markdown",
-        "header_level_by_type": {
-            "Module": 1,
-            "Class": 3,
-            "Method": 3,
-            "Function": 3,
-            "Variable": 3
-        }
-    }
-}
-EOF
-)
-
-toc_config=$(cat <<'EOF'
-{
-    "processors": [
-        {
-            "type": "filter"
-        },
-        {
-            "type": "pydocmd"
-        }
-    ],
-    "renderer": {
-        "type": "markdown",
-        "render_toc": true,
-        "header_level_by_type": {
-            "Module": 1,
-            "Class": 3,
-            "Method": 3,
-            "Function": 3,
-            "Variable": 3
-        }
-    }
-}
-EOF
-)
-
-parser_config=$(cat <<'EOF'
-{
-    "processors": [
-        {
-            "type": "filter",
-            "expression": "not name == \"info\" and not name.startswith(\"_\") and default()"
-        },
-        {
-            "type": "pydocmd"
-        }
-    ],
-    "renderer": {
-        "type": "markdown",
-        "header_level_by_type": {
-            "Module": 1,
-            "Class": 3,
-            "Method": 3,
-            "Function": 3,
-            "Variable": 3
-        }
-    }
-}
-EOF
-)
-
 cd jc
 (
    echo Building docs for: package
-    pydoc-markdown -m jc "${readme_config}" > ../docs/readme.md; echo "+++ package docs complete"
+    ../doc2md.py jc > ../docs/readme.md && echo "+++ package docs complete" || echo "*** PACKAGE DOCS FAILED ***"
 ) &

 (
    echo Building docs for: lib
-    pydoc-markdown -m jc.lib "${toc_config}" > ../docs/lib.md; echo "+++ lib docs complete"
+    ../doc2md.py jc.lib > ../docs/lib.md && echo "+++ lib docs complete" || echo "*** LIB DOCS FAILED ***"
 ) &

 (
    echo Building docs for: utils
-    pydoc-markdown -m jc.utils "${toc_config}" > ../docs/utils.md; echo "+++ utils docs complete"
+    ../doc2md.py jc.utils > ../docs/utils.md && echo "+++ utils docs complete" || echo "*** UTILS DOCS FAILED ***"
 ) &

 (
    echo Building docs for: streaming
-    pydoc-markdown -m jc.streaming "${toc_config}" > ../docs/streaming.md; echo "+++ streaming docs complete"
+    ../doc2md.py jc.streaming > ../docs/streaming.md && echo "+++ streaming docs complete" || echo "*** STREAMING DOCS FAILED ***"
 ) &

 (
    echo Building docs for: universal parser
-    pydoc-markdown -m jc.parsers.universal "${toc_config}" > ../docs/parsers/universal.md; echo "+++ universal parser docs complete"
+    ../doc2md.py jc.parsers.universal > ../docs/parsers/universal.md && echo "+++ universal parser docs complete" || echo "*** UNIVERSAL PARSER DOCS FAILED ***"
 ) &

 # a bit of inception here... jc is being used to help
@ -119,27 +44,8 @@ for parser in "${parsers[@]}"; do
    parser_name=$(jq -r '.name' <<< "$parser")
        {
            if [[ $1 == "all" ]] || ! git diff --quiet --exit-code HEAD~5 -- "parsers/${parser_name}.py"; then
-                compatible=$(jq -r '.compatible | join(", ")' <<< "$parser")
-                version=$(jq -r '.version' <<< "$parser")
-                author=$(jq -r '.author' <<< "$parser")
-                author_email=$(jq -r '.author_email' <<< "$parser")
-
                echo "Building docs for: ${parser_name}"
-                echo "[Home](https://kellyjonbrazil.github.io/jc/)" > ../docs/parsers/"${parser_name}".md
-                pydoc-markdown -m jc.parsers."${parser_name}" "${parser_config}" >> ../docs/parsers/"${parser_name}".md
-                echo "### Parser Information" >> ../docs/parsers/"${parser_name}".md
-                echo "Compatibility:  ${compatible}" >> ../docs/parsers/"${parser_name}".md
-                echo >> ../docs/parsers/"${parser_name}".md
-                echo "Source: [\`jc/parsers/${parser_name}.py\`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/${parser_name}.py)" >> ../docs/parsers/"${parser_name}".md
-                echo >> ../docs/parsers/"${parser_name}".md
-
-                if $(jq -e '.tags | contains(["slurpable"])' <<< "$parser"); then
-                    echo "This parser can be used with the \`--slurp\` command-line option." >> ../docs/parsers/"${parser_name}".md
-                    echo >> ../docs/parsers/"${parser_name}".md
-                fi
-
-                echo "Version ${version} by ${author} (${author_email})" >> ../docs/parsers/"${parser_name}".md
-                echo "+++ ${parser_name} docs complete"
+                ../doc2md.py jc.parsers."${parser_name}" > ../docs/parsers/"${parser_name}".md && echo "+++ ${parser_name} docs complete" || echo "*** ${parser_name} DOCS FAILED ***"
            fi
        } &
 done
--- a/docs/lib.md
+++ b/docs/lib.md
@ -1,29 +1,67 @@
-# Table of Contents
-
-* [jc.lib](#jc.lib)
-  * [get\_parser](#jc.lib.get_parser)
-  * [parse](#jc.lib.parse)
-  * [parser\_mod\_list](#jc.lib.parser_mod_list)
-  * [plugin\_parser\_mod\_list](#jc.lib.plugin_parser_mod_list)
-  * [standard\_parser\_mod\_list](#jc.lib.standard_parser_mod_list)
-  * [streaming\_parser\_mod\_list](#jc.lib.streaming_parser_mod_list)
-  * [slurpable\_parser\_mod\_list](#jc.lib.slurpable_parser_mod_list)
-  * [parser\_info](#jc.lib.parser_info)
-  * [all\_parser\_info](#jc.lib.all_parser_info)
-  * [get\_help](#jc.lib.get_help)
-
+[Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.lib"></a>

 # jc.lib

+## Table of Contents
+
+* [jc.lib](#jc.lib)
+  * [all_parser_info](#jc.lib.all_parser_info)
+  * [get_help](#jc.lib.get_help)
+  * [get_parser](#jc.lib.get_parser)
+  * [parse](#jc.lib.parse)
+  * [parser_info](#jc.lib.parser_info)
+  * [parser_mod_list](#jc.lib.parser_mod_list)
+  * [plugin_parser_mod_list](#jc.lib.plugin_parser_mod_list)
+  * [slurpable_parser_mod_list](#jc.lib.slurpable_parser_mod_list)
+  * [standard_parser_mod_list](#jc.lib.standard_parser_mod_list)
+  * [streaming_parser_mod_list](#jc.lib.streaming_parser_mod_list)
+
 jc - JSON Convert lib module

+<a id="jc.lib.all_parser_info"></a>
+
+### all_parser_info
+
+```python
+def all_parser_info(
+        documentation: bool = False,
+        show_hidden: bool = False,
+        show_deprecated: bool = False) -> List[jc.jc_types.ParserInfoType]
+```
+
+Returns a list of dictionaries that includes metadata for all parser
+modules. By default only non-hidden, non-deprecated parsers are
+returned.
+
+Parameters:
+
+    documentation:      (boolean)    include parser docstrings if True
+    show_hidden:        (boolean)    also show parsers marked as hidden
+                                     in their info metadata.
+    show_deprecated:    (boolean)    also show parsers marked as
+                                     deprecated in their info metadata.
+
+<a id="jc.lib.get_help"></a>
+
+### get_help
+
+```python
+def get_help(parser_mod_name: Union[str, module]) -> None
+```
+
+Show help screen for the selected parser.
+
+This function will accept **module_name**, **cli-name**, and
+**--argument-name** variants of the module name string as well as a
+parser module object.
+
 <a id="jc.lib.get_parser"></a>

-### get\_parser
+### get_parser

 ```python
-def get_parser(parser_mod_name: Union[str, ModuleType]) -> ModuleType
+def get_parser(parser_mod_name: Union[str, module]) -> module
 ```

 Return the parser module object and check that the module is a valid
@ -56,13 +94,13 @@ Raises:

 ```python
 def parse(
-    parser_mod_name: Union[str, ModuleType],
+    parser_mod_name: Union[str, module],
    data: Union[str, bytes, Iterable[str]],
    quiet: bool = False,
    raw: bool = False,
    ignore_exceptions: Optional[bool] = None,
    **kwargs
-) -> Union[JSONDictType, List[JSONDictType], Iterator[JSONDictType]]
+) -> Union[Dict[str, Any], List[Dict[str, Any]], Iterator[Dict[str, Any]]]
 ```

 Parse the data (string or bytes) using the supplied parser (string or
@ -152,73 +190,13 @@ Returns:
    Standard Parsers:   Dictionary or List of Dictionaries
    Streaming Parsers:  Generator Object containing Dictionaries

-<a id="jc.lib.parser_mod_list"></a>
-
-### parser\_mod\_list
-
-```python
-def parser_mod_list(show_hidden: bool = False,
-                    show_deprecated: bool = False) -> List[str]
-```
-
-Returns a list of all available parser module names.
-
-<a id="jc.lib.plugin_parser_mod_list"></a>
-
-### plugin\_parser\_mod\_list
-
-```python
-def plugin_parser_mod_list(show_hidden: bool = False,
-                           show_deprecated: bool = False) -> List[str]
-```
-
-Returns a list of plugin parser module names. This function is a
-subset of `parser_mod_list()`.
-
-<a id="jc.lib.standard_parser_mod_list"></a>
-
-### standard\_parser\_mod\_list
-
-```python
-def standard_parser_mod_list(show_hidden: bool = False,
-                             show_deprecated: bool = False) -> List[str]
-```
-
-Returns a list of standard parser module names. This function is a
-subset of `parser_mod_list()` and does not contain any streaming
-parsers.
-
-<a id="jc.lib.streaming_parser_mod_list"></a>
-
-### streaming\_parser\_mod\_list
-
-```python
-def streaming_parser_mod_list(show_hidden: bool = False,
-                              show_deprecated: bool = False) -> List[str]
-```
-
-Returns a list of streaming parser module names. This function is a
-subset of `parser_mod_list()`.
-
-<a id="jc.lib.slurpable_parser_mod_list"></a>
-
-### slurpable\_parser\_mod\_list
-
-```python
-def slurpable_parser_mod_list(show_hidden: bool = False,
-                              show_deprecated: bool = False) -> List[str]
-```
-
-Returns a list of slurpable parser module names. This function is a
-subset of `parser_mod_list()`.
-
 <a id="jc.lib.parser_info"></a>

-### parser\_info
+### parser_info

 ```python
-def parser_info(parser_mod_name: Union[str, ModuleType],
-                documentation: bool = False) -> ParserInfoType
+def parser_info(parser_mod_name: Union[str, module],
+                documentation: bool = False) -> jc.jc_types.ParserInfoType
 ```

 Returns a dictionary that includes the parser module metadata.
@ -233,39 +211,64 @@ Parameters:

    documentation:      (boolean)    include parser docstring if True

-<a id="jc.lib.all_parser_info"></a>
+<a id="jc.lib.parser_mod_list"></a>

-### all\_parser\_info
+### parser_mod_list

 ```python
-def all_parser_info(documentation: bool = False,
-                    show_hidden: bool = False,
-                    show_deprecated: bool = False) -> List[ParserInfoType]
+def parser_mod_list(show_hidden: bool = False,
+                    show_deprecated: bool = False) -> List[str]
 ```

-Returns a list of dictionaries that includes metadata for all parser
-modules. By default only non-hidden, non-deprecated parsers are
-returned.
+Returns a list of all available parser module names.

-Parameters:
+<a id="jc.lib.plugin_parser_mod_list"></a>

-    documentation:      (boolean)    include parser docstrings if True
-    show_hidden:        (boolean)    also show parsers marked as hidden
-                                     in their info metadata.
-    show_deprecated:    (boolean)    also show parsers marked as
-                                     deprecated in their info metadata.
-
-<a id="jc.lib.get_help"></a>
-
-### get\_help
+### plugin_parser_mod_list

 ```python
-def get_help(parser_mod_name: Union[str, ModuleType]) -> None
+def plugin_parser_mod_list(show_hidden: bool = False,
+                           show_deprecated: bool = False) -> List[str]
 ```

-Show help screen for the selected parser.
+Returns a list of plugin parser module names. This function is a
+subset of `parser_mod_list()`.
+
+<a id="jc.lib.slurpable_parser_mod_list"></a>
+
+### slurpable_parser_mod_list
+
+```python
+def slurpable_parser_mod_list(show_hidden: bool = False,
+                              show_deprecated: bool = False) -> List[str]
+```
+
+Returns a list of slurpable parser module names. This function is a
+subset of `parser_mod_list()`.
+
+<a id="jc.lib.standard_parser_mod_list"></a>
+
+### standard_parser_mod_list
+
+```python
+def standard_parser_mod_list(show_hidden: bool = False,
+                             show_deprecated: bool = False) -> List[str]
+```
+
+Returns a list of standard parser module names. This function is a
+subset of `parser_mod_list()` and does not contain any streaming
+parsers.
+
+<a id="jc.lib.streaming_parser_mod_list"></a>
+
+### streaming_parser_mod_list
+
+```python
+def streaming_parser_mod_list(show_hidden: bool = False,
+                              show_deprecated: bool = False) -> List[str]
+```
+
+Returns a list of streaming parser module names. This function is a
+subset of `parser_mod_list()`.

-This function will accept **module_name**, **cli-name**, and
-**--argument-name** variants of the module name string as well as a
-parser module object.

--- a/docs/parsers/airport_s.md
+++ b/docs/parsers/airport_s.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.airport_s"></a>

-# jc.parsers.airport\_s
+# jc.parsers.airport_s

 jc - JSON Convert `airport -s` command output parser

--- a/docs/parsers/apt_cache_show.md
+++ b/docs/parsers/apt_cache_show.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.apt_cache_show"></a>

-# jc.parsers.apt\_cache\_show
+# jc.parsers.apt_cache_show

 jc - JSON Convert `apt-cache show` command parser

@ -157,7 +157,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/apt_get_sqq.md
+++ b/docs/parsers/apt_get_sqq.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.apt_get_sqq"></a>

-# jc.parsers.apt\_get\_sqq
+# jc.parsers.apt_get_sqq

 jc - JSON Convert `apt-get -sqq` command output parser

@ -28,7 +28,7 @@ Schema:
        "package":              string,
        "broken":               string/null,
        "proposed_pkg_ver":     string,
-        "existing_src":         string/null,
+        "existing_pkg_ver":     string/null,
        "architecture":         string
      }
    ]
@ -42,7 +42,7 @@ Examples:
        "package": "dpkg",
        "broken": "1.19.7",
        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
-        "existing_src": "Debian-Security:10/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
        "architecture": "amd64"
      },
      {
@ -50,7 +50,7 @@ Examples:
        "package": "dpkg",
        "broken": null,
        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
-        "existing_src": "Debian-Security:10/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
        "architecture": "amd64"
      },
      {
@ -58,7 +58,7 @@ Examples:
        "package": "dpkg",
        "broken": "1.19.7",
        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
-        "existing_src": "Debian-Security:10/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
        "architecture": "amd64"
      },
      {
@ -66,7 +66,7 @@ Examples:
        "package": "dpkg",
        "broken": "1.19.7",
        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
-        "existing_src": "Debian-Security:10/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
        "architecture": "amd64"
      },
      {
@ -74,7 +74,7 @@ Examples:
        "package": "base-files",
        "broken": "10.3+deb10u4",
        "proposed_pkg_ver": "10.3+deb10u13 Debian:10.13/oldstable",
-        "existing_src": null,
+        "existing_pkg_ver": null,
        "architecture": "amd64"
      },
      {
@ -82,7 +82,7 @@ Examples:
        "package": "base-files",
        "broken": null,
        "proposed_pkg_ver": "10.3+deb10u13 Debian:10.13/oldstable",
-        "existing_src": null,
+        "existing_pkg_ver": null,
        "architecture": "amd64"
      },
      {
@ -90,7 +90,7 @@ Examples:
        "package": "dpkg",
        "broken": "1.19.7",
        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
-        "existing_src": "Debian-Security:10/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
        "architecture": "amd64"
      },
      {
@ -98,7 +98,7 @@ Examples:
        "package": "dpkg",
        "broken": null,
        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
-        "existing_src": "Debian-Security:10/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
        "architecture": "amd64"
      }
    ]
@ -110,7 +110,7 @@ Examples:
        "package": "dpkg",
        "broken": "1.19.7",
        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
-        "existing_src": "Debian-Security:10/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
        "architecture": "amd64"
      },
      {
@ -118,7 +118,7 @@ Examples:
        "package": "dpkg",
        "broken": null,
        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
-        "existing_src": "Debian-Security:10/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
        "architecture": "amd64"
      },
      {
@ -126,7 +126,7 @@ Examples:
        "package": "dpkg",
        "broken": "1.19.7",
        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
-        "existing_src": "Debian-Security:10/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
        "architecture": "amd64"
      },
      {
@ -134,7 +134,7 @@ Examples:
        "package": "dpkg",
        "broken": "1.19.7",
        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
-        "existing_src": "Debian-Security:10/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
        "architecture": "amd64"
      },
      {
@ -142,7 +142,7 @@ Examples:
        "package": "base-files",
        "broken": "10.3+deb10u4",
        "proposed_pkg_ver": "10.3+deb10u13 Debian:10.13/oldstable",
-        "existing_src": null,
+        "existing_pkg_ver": null,
        "architecture": "amd64"
      },
      {
@ -150,7 +150,7 @@ Examples:
        "package": "base-files",
        "broken": null,
        "proposed_pkg_ver": "10.3+deb10u13 Debian:10.13/oldstable",
-        "existing_src": null,
+        "existing_pkg_ver": null,
        "architecture": "amd64"
      },
      {
@ -158,7 +158,7 @@ Examples:
        "package": "dpkg",
        "broken": "1.19.7",
        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
-        "existing_src": "Debian-Security:10/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
        "architecture": "amd64"
      },
      {
@ -166,7 +166,7 @@ Examples:
        "package": "dpkg",
        "broken": null,
        "proposed_pkg_ver": "1.19.8 Debian:10.13/oldstable",
-        "existing_src": "Debian-Security:10/oldstable",
+        "existing_pkg_ver": "Debian-Security:10/oldstable",
        "architecture": "amd64"
      }
    ]
@ -178,7 +178,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/asciitable_m.md
+++ b/docs/parsers/asciitable_m.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.asciitable_m"></a>

-# jc.parsers.asciitable\_m
+# jc.parsers.asciitable_m

 jc - JSON Convert `asciitable-m` parser

--- a/docs/parsers/bluetoothctl.md
+++ b/docs/parsers/bluetoothctl.md
@ -112,7 +112,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/cbt.md
+++ b/docs/parsers/cbt.md
@ -104,7 +104,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/cef_s.md
+++ b/docs/parsers/cef_s.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.cef_s"></a>

-# jc.parsers.cef\_s
+# jc.parsers.cef_s

 jc - JSON Convert CEF string output streaming parser

@ -95,7 +95,6 @@ Examples:
 ### parse

 ```python
-@add_jc_meta
 def parse(data: Iterable[str],
          raw: bool = False,
          quiet: bool = False,
--- a/docs/parsers/certbot.md
+++ b/docs/parsers/certbot.md
@ -140,7 +140,7 @@ Examples:
 ### parse

 ```python
-def parse(data: str, raw: bool = False, quiet: bool = False) -> JSONDictType
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict[str, Any]
 ```

 Main text parsing function
--- a/docs/parsers/clf.md
+++ b/docs/parsers/clf.md
@ -178,7 +178,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/clf_s.md
+++ b/docs/parsers/clf_s.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.clf_s"></a>

-# jc.parsers.clf\_s
+# jc.parsers.clf_s

 jc - JSON Convert Common Log Format file streaming parser

@ -88,11 +88,12 @@ Examples:
 ### parse

 ```python
-@add_jc_meta
-def parse(data: Iterable[str],
+def parse(
+    data: Iterable[str],
    raw: bool = False,
    quiet: bool = False,
-          ignore_exceptions: bool = False) -> StreamingOutputType
+    ignore_exceptions: bool = False
+) -> Iterator[Union[Dict[str, Any], Tuple[BaseException, str]]]
 ```

 Main text parsing generator function. Returns an iterable object.
--- a/docs/parsers/crontab_u.md
+++ b/docs/parsers/crontab_u.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.crontab_u"></a>

-# jc.parsers.crontab\_u
+# jc.parsers.crontab_u

 jc - JSON Convert `crontab -l` command output and crontab
 file parser
--- a/docs/parsers/csv.md
+++ b/docs/parsers/csv.md
@ -84,7 +84,7 @@ Examples:
 ```python
 def parse(data: Union[str, bytes],
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/csv_s.md
+++ b/docs/parsers/csv_s.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.csv_s"></a>

-# jc.parsers.csv\_s
+# jc.parsers.csv_s

 jc - JSON Convert `csv` file streaming parser

@ -64,7 +64,6 @@ Examples:
 ### parse

 ```python
-@add_jc_meta
 def parse(data, raw=False, quiet=False, ignore_exceptions=False)
 ```

--- a/docs/parsers/curl_head.md
+++ b/docs/parsers/curl_head.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.curl_head"></a>

-# jc.parsers.curl\_head
+# jc.parsers.curl_head

 jc - JSON Convert `curl --head` command output parser

@ -286,7 +286,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/datetime_iso.md
+++ b/docs/parsers/datetime_iso.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.datetime_iso"></a>

-# jc.parsers.datetime\_iso
+# jc.parsers.datetime_iso

 jc - JSON Convert ISO 8601 Datetime string parser

--- a/docs/parsers/debconf_show.md
+++ b/docs/parsers/debconf_show.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.debconf_show"></a>

-# jc.parsers.debconf\_show
+# jc.parsers.debconf_show

 jc - JSON Convert `debconf-show` command output parser

@ -84,7 +84,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/dpkg_l.md
+++ b/docs/parsers/dpkg_l.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.dpkg_l"></a>

-# jc.parsers.dpkg\_l
+# jc.parsers.dpkg_l

 jc - JSON Convert `dpkg -l` command output parser

--- a/docs/parsers/efibootmgr.md
+++ b/docs/parsers/efibootmgr.md
@ -81,7 +81,7 @@ Examples:
 ### parse

 ```python
-def parse(data: str, raw: bool = False, quiet: bool = False) -> JSONDictType
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict[str, Any]
 ```

 Main text parsing function
--- a/docs/parsers/email_address.md
+++ b/docs/parsers/email_address.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.email_address"></a>

-# jc.parsers.email\_address
+# jc.parsers.email_address

 jc - JSON Convert Email Address string parser

--- a/docs/parsers/ethtool.md
+++ b/docs/parsers/ethtool.md
@ -171,7 +171,7 @@ Examples:
 ### parse

 ```python
-def parse(data: str, raw: bool = False, quiet: bool = False) -> JSONDictType
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict[str, Any]
 ```

 Main text parsing function
--- a/docs/parsers/findmnt.md
+++ b/docs/parsers/findmnt.md
@ -96,7 +96,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/git_log.md
+++ b/docs/parsers/git_log.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.git_log"></a>

-# jc.parsers.git\_log
+# jc.parsers.git_log

 jc - JSON Convert `git log` command output parser

--- a/docs/parsers/git_log_s.md
+++ b/docs/parsers/git_log_s.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.git_log_s"></a>

-# jc.parsers.git\_log\_s
+# jc.parsers.git_log_s

 jc - JSON Convert `git log` command output streaming parser

@ -82,7 +82,6 @@ Examples:
 ### parse

 ```python
-@add_jc_meta
 def parse(data: Iterable[str],
          raw: bool = False,
          quiet: bool = False,
--- a/docs/parsers/git_ls_remote.md
+++ b/docs/parsers/git_ls_remote.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.git_ls_remote"></a>

-# jc.parsers.git\_ls\_remote
+# jc.parsers.git_ls_remote

 jc - JSON Convert `git ls-remote` command output parser

@ -71,7 +71,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> Union[JSONDictType, List[JSONDictType]]
+          quiet: bool = False) -> Union[Dict[str, Any], List[Dict[str, Any]]]
 ```

 Main text parsing function
--- a/docs/parsers/http_headers.md
+++ b/docs/parsers/http_headers.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.http_headers"></a>

-# jc.parsers.http\_headers
+# jc.parsers.http_headers

 jc - JSON Convert HTTP headers parser

@ -313,7 +313,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/ifconfig.md
+++ b/docs/parsers/ifconfig.md
@ -222,7 +222,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/ini_dup.md
+++ b/docs/parsers/ini_dup.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.ini_dup"></a>

-# jc.parsers.ini\_dup
+# jc.parsers.ini_dup

 jc - JSON Convert INI with duplicate key file parser

--- a/docs/parsers/iostat_s.md
+++ b/docs/parsers/iostat_s.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.iostat_s"></a>

-# jc.parsers.iostat\_s
+# jc.parsers.iostat_s

 jc - JSON Convert `iostat` command output streaming parser

@ -108,7 +108,6 @@ Examples:
 ### parse

 ```python
-@add_jc_meta
 def parse(data, raw=False, quiet=False, ignore_exceptions=False)
 ```

--- a/docs/parsers/ip_address.md
+++ b/docs/parsers/ip_address.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.ip_address"></a>

-# jc.parsers.ip\_address
+# jc.parsers.ip_address

 jc - JSON Convert IP Address string parser

--- a/docs/parsers/ip_route.md
+++ b/docs/parsers/ip_route.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.ip_route"></a>

-# jc.parsers.ip\_route
+# jc.parsers.ip_route

 jc - JSON Convert `ip route` command output parser

--- a/docs/parsers/iw_scan.md
+++ b/docs/parsers/iw_scan.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.iw_scan"></a>

-# jc.parsers.iw\_scan
+# jc.parsers.iw_scan

 jc - JSON Convert `iw dev <device> scan` command output parser

--- a/docs/parsers/iwconfig.md
+++ b/docs/parsers/iwconfig.md
@ -90,7 +90,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/jar_manifest.md
+++ b/docs/parsers/jar_manifest.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.jar_manifest"></a>

-# jc.parsers.jar\_manifest
+# jc.parsers.jar_manifest

 jc - JSON Convert Java `MANIFEST.MF` file parser

--- a/docs/parsers/kv_dup.md
+++ b/docs/parsers/kv_dup.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.kv_dup"></a>

-# jc.parsers.kv\_dup
+# jc.parsers.kv_dup

 jc - JSON Convert `Key/Value` with duplicate key file and string parser

--- a/docs/parsers/ls_s.md
+++ b/docs/parsers/ls_s.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.ls_s"></a>

-# jc.parsers.ls\_s
+# jc.parsers.ls_s

 jc - JSON Convert `ls` and `vdir` command output streaming parser

@ -77,7 +77,6 @@ Examples:
 ### parse

 ```python
-@add_jc_meta
 def parse(data, raw=False, quiet=False, ignore_exceptions=False)
 ```

--- a/docs/parsers/lsattr.md
+++ b/docs/parsers/lsattr.md
@ -69,7 +69,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/lsb_release.md
+++ b/docs/parsers/lsb_release.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.lsb_release"></a>

-# jc.parsers.lsb\_release
+# jc.parsers.lsb_release

 jc - JSON Convert `lsb_release` command parser

@ -40,7 +40,7 @@ Examples:
 ### parse

 ```python
-def parse(data: str, raw: bool = False, quiet: bool = False) -> JSONDictType
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict[str, Any]
 ```

 Main text parsing function
--- a/docs/parsers/lspci.md
+++ b/docs/parsers/lspci.md
@ -127,7 +127,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/mpstat_s.md
+++ b/docs/parsers/mpstat_s.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.mpstat_s"></a>

-# jc.parsers.mpstat\_s
+# jc.parsers.mpstat_s

 jc - JSON Convert `mpstat` command output streaming parser

@ -100,7 +100,6 @@ Examples:
 ### parse

 ```python
-@add_jc_meta
 def parse(data: Iterable[str],
          raw: bool = False,
          quiet: bool = False,
--- a/docs/parsers/needrestart.md
+++ b/docs/parsers/needrestart.md
@ -0,0 +1,101 @@
+[Home](https://kellyjonbrazil.github.io/jc/)
+<a id="jc.parsers.needrestart"></a>
+
+# jc.parsers.needrestart
+
+jc - JSON Convert `needrestart -b` command output parser
+
+Usage (cli):
+
+    $ needrestart -b | jc --needrestart
+
+or
+
+    $ jc needrestart -b
+
+Usage (module):
+
+    import jc
+    result = jc.parse('needrestart', needrestart_command_output)
+
+Schema:
+
+    {
+      "version":                        string,
+      "running_kernel_version":         string,
+      "expected_kernel_version":        string,
+      "kernel_status":                  integer,
+      "container":                      string,
+      "session": [
+                                        string
+      ],
+      "service": [
+                                        string
+      ],
+      "pid": [
+                                        string
+      ]
+    }
+
+Examples:
+
+    $ needrestart -b | jc --needrestart -p
+    {
+      "version": "2.1",
+      "running_kernel_version": "3.19.3-tl1+",
+      "expected_kernel_version": "3.19.3-tl1+",
+      "kernel_status": 1,
+      "container": "LXC web1",
+      "session": [
+        "metabase @ user manager service",
+        "root @ session #28017"
+      ],
+      "service": [
+        "systemd-journald.service",
+        "systemd-machined.service"
+      ]
+    }
+
+    $ needrestart -b | jc --needrestart -p -r
+    {
+      "needrestart_ver": "2.1",
+      "needrestart_kcur": "3.19.3-tl1+",
+      "needrestart_kexp": "3.19.3-tl1+",
+      "needrestart_ksta": "1",
+      "needrestart_cont": "LXC web1",
+      "needrestart_sess": [
+        "metabase @ user manager service",
+        "root @ session #28017"
+      ],
+      "needrestart_svc": [
+        "systemd-journald.service",
+        "systemd-machined.service"
+      ]
+    }
+
+<a id="jc.parsers.needrestart.parse"></a>
+
+### parse
+
+```python
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict[str, Any]
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) unprocessed output if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    Dictionary. Raw or processed structured data.
+
+### Parser Information
+Compatibility:  linux
+
+Source: [`jc/parsers/needrestart.py`](https://github.com/kellyjonbrazil/jc/blob/master/jc/parsers/needrestart.py)
+
+Version 1.0 by Kelly Brazil (kellyjonbrazil@gmail.com)
--- a/docs/parsers/nsd_control.md
+++ b/docs/parsers/nsd_control.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.nsd_control"></a>

-# jc.parsers.nsd\_control
+# jc.parsers.nsd_control

 jc - JSON Convert `nsd-control` command output parser

--- a/docs/parsers/openvpn.md
+++ b/docs/parsers/openvpn.md
@ -157,7 +157,7 @@ Examples:
 ### parse

 ```python
-def parse(data: str, raw: bool = False, quiet: bool = False) -> JSONDictType
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict[str, Any]
 ```

 Main text parsing function
--- a/docs/parsers/os_prober.md
+++ b/docs/parsers/os_prober.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.os_prober"></a>

-# jc.parsers.os\_prober
+# jc.parsers.os_prober

 jc - JSON Convert `os-prober` command output parser

@ -45,7 +45,7 @@ Examples:
 ### parse

 ```python
-def parse(data: str, raw: bool = False, quiet: bool = False) -> JSONDictType
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict[str, Any]
 ```

 Main text parsing function
--- a/docs/parsers/os_release.md
+++ b/docs/parsers/os_release.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.os_release"></a>

-# jc.parsers.os\_release
+# jc.parsers.os_release

 jc - JSON Convert `/etc/os-release` file parser

@ -65,7 +65,7 @@ Examples:
 ### parse

 ```python
-def parse(data: str, raw: bool = False, quiet: bool = False) -> JSONDictType
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict[str, Any]
 ```

 Main text parsing function
--- a/docs/parsers/path_list.md
+++ b/docs/parsers/path_list.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.path_list"></a>

-# jc.parsers.path\_list
+# jc.parsers.path_list

 jc - JSON Convert POSIX path list string parser

--- a/docs/parsers/pci_ids.md
+++ b/docs/parsers/pci_ids.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.pci_ids"></a>

-# jc.parsers.pci\_ids
+# jc.parsers.pci_ids

 jc - JSON Convert `pci.ids` file parser

@ -78,7 +78,7 @@ Examples:
 ### parse

 ```python
-def parse(data: str, raw: bool = False, quiet: bool = False) -> JSONDictType
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict[str, Any]
 ```

 Main text parsing function
--- a/docs/parsers/pgpass.md
+++ b/docs/parsers/pgpass.md
@ -54,7 +54,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/pidstat_s.md
+++ b/docs/parsers/pidstat_s.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.pidstat_s"></a>

-# jc.parsers.pidstat\_s
+# jc.parsers.pidstat_s

 jc - JSON Convert `pidstat -H` command output streaming parser

@ -86,7 +86,6 @@ Examples:
 ### parse

 ```python
-@add_jc_meta
 def parse(data: Iterable[str],
          raw: bool = False,
          quiet: bool = False,
--- a/docs/parsers/ping_s.md
+++ b/docs/parsers/ping_s.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.ping_s"></a>

-# jc.parsers.ping\_s
+# jc.parsers.ping_s

 jc - JSON Convert `ping` command output streaming parser

@ -86,7 +86,6 @@ Examples:
 ### parse

 ```python
-@add_jc_meta
 def parse(data, raw=False, quiet=False, ignore_exceptions=False)
 ```

--- a/docs/parsers/pip_list.md
+++ b/docs/parsers/pip_list.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.pip_list"></a>

-# jc.parsers.pip\_list
+# jc.parsers.pip_list

 jc - JSON Convert `pip-list` command output parser

--- a/docs/parsers/pip_show.md
+++ b/docs/parsers/pip_show.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.pip_show"></a>

-# jc.parsers.pip\_show
+# jc.parsers.pip_show

 jc - JSON Convert `pip-show` command output parser

--- a/docs/parsers/pkg_index_apk.md
+++ b/docs/parsers/pkg_index_apk.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.pkg_index_apk"></a>

-# jc.parsers.pkg\_index\_apk
+# jc.parsers.pkg_index_apk

 jc - JSON Convert Alpine Linux Package Index files

--- a/docs/parsers/pkg_index_deb.md
+++ b/docs/parsers/pkg_index_deb.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.pkg_index_deb"></a>

-# jc.parsers.pkg\_index\_deb
+# jc.parsers.pkg_index_deb

 jc - JSON Convert Debian Package Index file parser

@ -132,7 +132,7 @@ Examples:
 ```python
 def parse(data: str,
          raw: bool = False,
-          quiet: bool = False) -> List[JSONDictType]
+          quiet: bool = False) -> List[Dict[str, Any]]
 ```

 Main text parsing function
--- a/docs/parsers/proc_buddyinfo.md
+++ b/docs/parsers/proc_buddyinfo.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_buddyinfo"></a>

-# jc.parsers.proc\_buddyinfo
+# jc.parsers.proc_buddyinfo

 jc - JSON Convert `/proc/buddyinfo` file parser

--- a/docs/parsers/proc_cmdline.md
+++ b/docs/parsers/proc_cmdline.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_cmdline"></a>

-# jc.parsers.proc\_cmdline
+# jc.parsers.proc_cmdline

 jc - JSON Convert `/proc/cmdline` file parser

@ -71,7 +71,7 @@ Examples:
 ### parse

 ```python
-def parse(data: str, raw: bool = False, quiet: bool = False) -> JSONDictType
+def parse(data: str, raw: bool = False, quiet: bool = False) -> Dict[str, Any]
 ```

 Main text parsing function
--- a/docs/parsers/proc_consoles.md
+++ b/docs/parsers/proc_consoles.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_consoles"></a>

-# jc.parsers.proc\_consoles
+# jc.parsers.proc_consoles

 jc - JSON Convert `/proc/consoles` file parser

--- a/docs/parsers/proc_cpuinfo.md
+++ b/docs/parsers/proc_cpuinfo.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_cpuinfo"></a>

-# jc.parsers.proc\_cpuinfo
+# jc.parsers.proc_cpuinfo

 jc - JSON Convert `/proc/cpuinfo` file parser

--- a/docs/parsers/proc_crypto.md
+++ b/docs/parsers/proc_crypto.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_crypto"></a>

-# jc.parsers.proc\_crypto
+# jc.parsers.proc_crypto

 jc - JSON Convert `/proc/crypto` file parser

--- a/docs/parsers/proc_devices.md
+++ b/docs/parsers/proc_devices.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_devices"></a>

-# jc.parsers.proc\_devices
+# jc.parsers.proc_devices

 jc - JSON Convert `/proc/devices` file parser

--- a/docs/parsers/proc_diskstats.md
+++ b/docs/parsers/proc_diskstats.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_diskstats"></a>

-# jc.parsers.proc\_diskstats
+# jc.parsers.proc_diskstats

 jc - JSON Convert `/proc/diskstats` file parser

--- a/docs/parsers/proc_driver_rtc.md
+++ b/docs/parsers/proc_driver_rtc.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_driver_rtc"></a>

-# jc.parsers.proc\_driver\_rtc
+# jc.parsers.proc_driver_rtc

 jc - JSON Convert `/proc/driver/rtc` file parser

--- a/docs/parsers/proc_filesystems.md
+++ b/docs/parsers/proc_filesystems.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_filesystems"></a>

-# jc.parsers.proc\_filesystems
+# jc.parsers.proc_filesystems

 jc - JSON Convert `/proc/filesystems` file parser

--- a/docs/parsers/proc_interrupts.md
+++ b/docs/parsers/proc_interrupts.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_interrupts"></a>

-# jc.parsers.proc\_interrupts
+# jc.parsers.proc_interrupts

 jc - JSON Convert `/proc/interrupts` file parser

--- a/docs/parsers/proc_iomem.md
+++ b/docs/parsers/proc_iomem.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_iomem"></a>

-# jc.parsers.proc\_iomem
+# jc.parsers.proc_iomem

 jc - JSON Convert `/proc/iomem` file parser

--- a/docs/parsers/proc_ioports.md
+++ b/docs/parsers/proc_ioports.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_ioports"></a>

-# jc.parsers.proc\_ioports
+# jc.parsers.proc_ioports

 jc - JSON Convert `/proc/ioports` file parser

--- a/docs/parsers/proc_loadavg.md
+++ b/docs/parsers/proc_loadavg.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_loadavg"></a>

-# jc.parsers.proc\_loadavg
+# jc.parsers.proc_loadavg

 jc - JSON Convert `/proc/loadavg` file parser

--- a/docs/parsers/proc_locks.md
+++ b/docs/parsers/proc_locks.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_locks"></a>

-# jc.parsers.proc\_locks
+# jc.parsers.proc_locks

 jc - JSON Convert `/proc/locks` file parser

--- a/docs/parsers/proc_meminfo.md
+++ b/docs/parsers/proc_meminfo.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_meminfo"></a>

-# jc.parsers.proc\_meminfo
+# jc.parsers.proc_meminfo

 jc - JSON Convert `/proc/meminfo` file parser

--- a/docs/parsers/proc_modules.md
+++ b/docs/parsers/proc_modules.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_modules"></a>

-# jc.parsers.proc\_modules
+# jc.parsers.proc_modules

 jc - JSON Convert `/proc/modules` file parser

--- a/docs/parsers/proc_mtrr.md
+++ b/docs/parsers/proc_mtrr.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_mtrr"></a>

-# jc.parsers.proc\_mtrr
+# jc.parsers.proc_mtrr

 jc - JSON Convert `/proc/mtrr` file parser

--- a/docs/parsers/proc_net_arp.md
+++ b/docs/parsers/proc_net_arp.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_net_arp"></a>

-# jc.parsers.proc\_net\_arp
+# jc.parsers.proc_net_arp

 jc - JSON Convert `/proc/net/arp` file parser

--- a/docs/parsers/proc_net_dev.md
+++ b/docs/parsers/proc_net_dev.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_net_dev"></a>

-# jc.parsers.proc\_net\_dev
+# jc.parsers.proc_net_dev

 jc - JSON Convert `/proc/net/dev` file parser

--- a/docs/parsers/proc_net_dev_mcast.md
+++ b/docs/parsers/proc_net_dev_mcast.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_net_dev_mcast"></a>

-# jc.parsers.proc\_net\_dev\_mcast
+# jc.parsers.proc_net_dev_mcast

 jc - JSON Convert `/proc/net/dev_mcast` file parser

--- a/docs/parsers/proc_net_if_inet6.md
+++ b/docs/parsers/proc_net_if_inet6.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_net_if_inet6"></a>

-# jc.parsers.proc\_net\_if\_inet6
+# jc.parsers.proc_net_if_inet6

 jc - JSON Convert `/proc/net/if_inet6` file parser

--- a/docs/parsers/proc_net_igmp.md
+++ b/docs/parsers/proc_net_igmp.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_net_igmp"></a>

-# jc.parsers.proc\_net\_igmp
+# jc.parsers.proc_net_igmp

 jc - JSON Convert `/proc/net/igmp` file parser

--- a/docs/parsers/proc_net_igmp6.md
+++ b/docs/parsers/proc_net_igmp6.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_net_igmp6"></a>

-# jc.parsers.proc\_net\_igmp6
+# jc.parsers.proc_net_igmp6

 jc - JSON Convert `/proc/net/igmp6` file parser

--- a/docs/parsers/proc_net_ipv6_route.md
+++ b/docs/parsers/proc_net_ipv6_route.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_net_ipv6_route"></a>

-# jc.parsers.proc\_net\_ipv6\_route
+# jc.parsers.proc_net_ipv6_route

 jc - JSON Convert `/proc/net/ipv6_route` file parser

--- a/docs/parsers/proc_net_netlink.md
+++ b/docs/parsers/proc_net_netlink.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_net_netlink"></a>

-# jc.parsers.proc\_net\_netlink
+# jc.parsers.proc_net_netlink

 jc - JSON Convert `/proc/net/netlink` file parser

--- a/docs/parsers/proc_net_netstat.md
+++ b/docs/parsers/proc_net_netstat.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_net_netstat"></a>

-# jc.parsers.proc\_net\_netstat
+# jc.parsers.proc_net_netstat

 jc - JSON Convert `/proc/net/netstat` file parser

--- a/docs/parsers/proc_net_packet.md
+++ b/docs/parsers/proc_net_packet.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_net_packet"></a>

-# jc.parsers.proc\_net\_packet
+# jc.parsers.proc_net_packet

 jc - JSON Convert `/proc/net/packet` file parser

--- a/docs/parsers/proc_net_protocols.md
+++ b/docs/parsers/proc_net_protocols.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_net_protocols"></a>

-# jc.parsers.proc\_net\_protocols
+# jc.parsers.proc_net_protocols

 jc - JSON Convert `/proc/net/protocols` file parser

--- a/docs/parsers/proc_net_route.md
+++ b/docs/parsers/proc_net_route.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_net_route"></a>

-# jc.parsers.proc\_net\_route
+# jc.parsers.proc_net_route

 jc - JSON Convert `/proc/net/route` file parser

--- a/docs/parsers/proc_net_tcp.md
+++ b/docs/parsers/proc_net_tcp.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_net_tcp"></a>

-# jc.parsers.proc\_net\_tcp
+# jc.parsers.proc_net_tcp

 jc - JSON Convert `/proc/net/tcp` and `proc/net/tcp6` file parser

--- a/docs/parsers/proc_net_unix.md
+++ b/docs/parsers/proc_net_unix.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_net_unix"></a>

-# jc.parsers.proc\_net\_unix
+# jc.parsers.proc_net_unix

 jc - JSON Convert `/proc/net/unix` file parser

--- a/docs/parsers/proc_pagetypeinfo.md
+++ b/docs/parsers/proc_pagetypeinfo.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_pagetypeinfo"></a>

-# jc.parsers.proc\_pagetypeinfo
+# jc.parsers.proc_pagetypeinfo

 jc - JSON Convert `/proc/pagetypeinfo` file parser

--- a/docs/parsers/proc_partitions.md
+++ b/docs/parsers/proc_partitions.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_partitions"></a>

-# jc.parsers.proc\_partitions
+# jc.parsers.proc_partitions

 jc - JSON Convert `/proc/partitions` file parser

--- a/docs/parsers/proc_pid_fdinfo.md
+++ b/docs/parsers/proc_pid_fdinfo.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_pid_fdinfo"></a>

-# jc.parsers.proc\_pid\_fdinfo
+# jc.parsers.proc_pid_fdinfo

 jc - JSON Convert `/proc/<pid>/fdinfo/<fd>` file parser

--- a/docs/parsers/proc_pid_io.md
+++ b/docs/parsers/proc_pid_io.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_pid_io"></a>

-# jc.parsers.proc\_pid\_io
+# jc.parsers.proc_pid_io

 jc - JSON Convert `/proc/<pid>/io` file parser

--- a/docs/parsers/proc_pid_maps.md
+++ b/docs/parsers/proc_pid_maps.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_pid_maps"></a>

-# jc.parsers.proc\_pid\_maps
+# jc.parsers.proc_pid_maps

 jc - JSON Convert `/proc/<pid>/maps` file parser

--- a/docs/parsers/proc_pid_mountinfo.md
+++ b/docs/parsers/proc_pid_mountinfo.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_pid_mountinfo"></a>

-# jc.parsers.proc\_pid\_mountinfo
+# jc.parsers.proc_pid_mountinfo

 jc - JSON Convert `/proc/<pid>/mountinfo` file parser

--- a/docs/parsers/proc_pid_numa_maps.md
+++ b/docs/parsers/proc_pid_numa_maps.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_pid_numa_maps"></a>

-# jc.parsers.proc\_pid\_numa\_maps
+# jc.parsers.proc_pid_numa_maps

 jc - JSON Convert `/proc/<pid>/numa_maps` file parser

--- a/docs/parsers/proc_pid_smaps.md
+++ b/docs/parsers/proc_pid_smaps.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_pid_smaps"></a>

-# jc.parsers.proc\_pid\_smaps
+# jc.parsers.proc_pid_smaps

 jc - JSON Convert `/proc/<pid>/smaps` file parser

--- a/docs/parsers/proc_pid_stat.md
+++ b/docs/parsers/proc_pid_stat.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_pid_stat"></a>

-# jc.parsers.proc\_pid\_stat
+# jc.parsers.proc_pid_stat

 jc - JSON Convert `/proc/<pid>/stat` file parser

--- a/docs/parsers/proc_pid_statm.md
+++ b/docs/parsers/proc_pid_statm.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_pid_statm"></a>

-# jc.parsers.proc\_pid\_statm
+# jc.parsers.proc_pid_statm

 jc - JSON Convert `/proc/<pid>/statm` file parser

--- a/docs/parsers/proc_pid_status.md
+++ b/docs/parsers/proc_pid_status.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_pid_status"></a>

-# jc.parsers.proc\_pid\_status
+# jc.parsers.proc_pid_status

 jc - JSON Convert `/proc/<pid>/status` file parser

--- a/docs/parsers/proc_slabinfo.md
+++ b/docs/parsers/proc_slabinfo.md
@ -1,7 +1,7 @@
 [Home](https://kellyjonbrazil.github.io/jc/)
 <a id="jc.parsers.proc_slabinfo"></a>

-# jc.parsers.proc\_slabinfo
+# jc.parsers.proc_slabinfo

 jc - JSON Convert `/proc/slabinfo` file parser

--- a/Show More
+++ b/Show More