add tracepath parser skeleton

docs/parsers/tracepath.md

@@ -0,0 +1,64 @@
+# jc.parsers.tracepath
+jc - JSON CLI output utility tracepath Parser
+
+Usage:
+
+    specify --tracepath as the first argument if the piped input is coming from tracepath
+
+Compatibility:
+
+    'linux'
+
+Examples:
+
+    $ tracepath | jc --tracepath -p
+    []
+
+    $ tracepath | jc --tracepath -p -r
+    []
+
+## info
+```python
+info(self, /, *args, **kwargs)
+```
+
+## process
+```python
+process(proc_data)
+```
+
+Final processing to conform to the schema.
+
+Parameters:
+
+    proc_data:   (dictionary) raw structured data to process
+
+Returns:
+
+    List of dictionaries. Structured data with the following schema:
+
+    [
+      {
+        "tracepath":     string,
+        "bar":     boolean,
+        "baz":     integer
+      }
+    ]
+
+## parse
+```python
+parse(data, raw=False, quiet=False)
+```
+
+Main text parsing function
+
+Parameters:
+
+    data:        (string)  text data to parse
+    raw:         (boolean) output preprocessed JSON if True
+    quiet:       (boolean) suppress warning messages if True
+
+Returns:
+
+    List of dictionaries. Raw or processed structured data.
+

jc/parsers/tracepath.py

@@ -0,0 +1,89 @@
+"""jc - JSON CLI output utility tracepath Parser
+
+Usage:
+
+    specify --tracepath as the first argument if the piped input is coming from tracepath
+
+Compatibility:
+
+    'linux'
+
+Examples:
+
+    $ tracepath | jc --tracepath -p
+    []
+
+    $ tracepath | jc --tracepath -p -r
+    []
+"""
+import jc.utils
+
+
+class info():
+    version = '1.0'
+    description = 'tracepath command parser'
+    author = 'John Doe'
+    author_email = 'johndoe@gmail.com'
+
+    # compatible options: linux, darwin, cygwin, win32, aix, freebsd
+    compatible = ['linux']
+    magic_commands = ['tracepath', 'tracepath6']
+
+
+__version__ = info.version
+
+
+def process(proc_data):
+    """
+    Final processing to conform to the schema.
+
+    Parameters:
+
+        proc_data:   (dictionary) raw structured data to process
+
+    Returns:
+
+        List of dictionaries. Structured data with the following schema:
+
+        [
+          {
+            "tracepath":     string,
+            "bar":     boolean,
+            "baz":     integer
+          }
+        ]
+    """
+
+    # rebuild output for added semantic information
+    return proc_data
+
+
+def parse(data, raw=False, quiet=False):
+    """
+    Main text parsing function
+
+    Parameters:
+
+        data:        (string)  text data to parse
+        raw:         (boolean) output preprocessed JSON if True
+        quiet:       (boolean) suppress warning messages if True
+
+    Returns:
+
+        List of dictionaries. Raw or processed structured data.
+    """
+    if not quiet:
+        jc.utils.compatibility(__name__, info.compatible)
+
+    raw_output = []
+
+    if jc.utils.has_data(data):
+
+        for line in filter(None, data.splitlines()):
+            # parse the content
+            pass
+
+    if raw:
+        return raw_output
+    else:
+        return process(raw_output)