mirror of
https://github.com/kellyjonbrazil/jc.git
synced 2025-06-17 00:07:37 +02:00
181 lines
3.9 KiB
Python
181 lines
3.9 KiB
Python
"""jc - JSON Convert `/proc/modules` command output parser
|
|
|
|
Usage (cli):
|
|
|
|
$ cat /proc/modules | jc --proc
|
|
|
|
or
|
|
|
|
$ cat /proc/modules | jc --proc-modules
|
|
|
|
Usage (module):
|
|
|
|
import jc
|
|
result = jc.parse('proc', proc_modules_file)
|
|
|
|
or
|
|
|
|
import jc
|
|
result = jc.parse('proc_modules', proc_modules_file)
|
|
|
|
Schema:
|
|
|
|
[
|
|
{
|
|
"module": string,
|
|
"size": integer,
|
|
"used": integer,
|
|
"used_by": [
|
|
string
|
|
],
|
|
"status": string,
|
|
"location": string
|
|
}
|
|
]
|
|
|
|
Examples:
|
|
|
|
$ cat /proc/modules | jc --proc -p
|
|
[
|
|
{
|
|
"module": "binfmt_misc",
|
|
"size": 24576,
|
|
"used": 1,
|
|
"used_by": [],
|
|
"status": "Live",
|
|
"location": "0xffffffffc0ab4000"
|
|
},
|
|
{
|
|
"module": "vsock_loopback",
|
|
"size": 16384,
|
|
"used": 0,
|
|
"used_by": [],
|
|
"status": "Live",
|
|
"location": "0xffffffffc0a14000"
|
|
},
|
|
{
|
|
"module": "vmw_vsock_virtio_transport_common",
|
|
"size": 36864,
|
|
"used": 1,
|
|
"used_by": [
|
|
"vsock_loopback"
|
|
],
|
|
"status": "Live",
|
|
"location": "0xffffffffc0a03000"
|
|
},
|
|
...
|
|
]
|
|
|
|
$ proc_modules | jc --proc_modules -p -r
|
|
[
|
|
{
|
|
"module": "binfmt_misc",
|
|
"size": "24576",
|
|
"used": "1",
|
|
"used_by": [],
|
|
"status": "Live",
|
|
"location": "0xffffffffc0ab4000"
|
|
},
|
|
{
|
|
"module": "vsock_loopback",
|
|
"size": "16384",
|
|
"used": "0",
|
|
"used_by": [],
|
|
"status": "Live",
|
|
"location": "0xffffffffc0a14000"
|
|
},
|
|
{
|
|
"module": "vmw_vsock_virtio_transport_common",
|
|
"size": "36864",
|
|
"used": "1",
|
|
"used_by": [
|
|
"vsock_loopback"
|
|
],
|
|
"status": "Live",
|
|
"location": "0xffffffffc0a03000"
|
|
},
|
|
...
|
|
]
|
|
"""
|
|
from typing import List, Dict
|
|
import jc.utils
|
|
|
|
|
|
class info():
|
|
"""Provides parser metadata (version, author, etc.)"""
|
|
version = '1.0'
|
|
description = '`/proc/modules` command parser'
|
|
author = 'Kelly Brazil'
|
|
author_email = 'kellyjonbrazil@gmail.com'
|
|
compatible = ['linux']
|
|
hidden = True
|
|
|
|
|
|
__version__ = info.version
|
|
|
|
|
|
def _process(proc_data: List[Dict]) -> List[Dict]:
|
|
"""
|
|
Final processing to conform to the schema.
|
|
|
|
Parameters:
|
|
|
|
proc_data: (List of Dictionaries) raw structured data to process
|
|
|
|
Returns:
|
|
|
|
List of Dictionaries. Structured to conform to the schema.
|
|
"""
|
|
int_list = {'size', 'used'}
|
|
|
|
for entry in proc_data:
|
|
for key in entry:
|
|
if key in int_list:
|
|
entry[key] = jc.utils.convert_to_int(entry[key])
|
|
|
|
return proc_data
|
|
|
|
|
|
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.
|
|
"""
|
|
jc.utils.compatibility(__name__, info.compatible, quiet)
|
|
jc.utils.input_type_check(data)
|
|
|
|
raw_output: List = []
|
|
|
|
if jc.utils.has_data(data):
|
|
|
|
for line in filter(None, data.splitlines()):
|
|
|
|
module, size, used, used_by, status, location = line.split()
|
|
used_by_list = used_by.split(',')[:-1]
|
|
|
|
raw_output.append(
|
|
{
|
|
'module': module,
|
|
'size': size,
|
|
'used': used,
|
|
'used_by': used_by_list,
|
|
'status': status,
|
|
'location': location
|
|
}
|
|
)
|
|
|
|
return raw_output if raw else _process(raw_output)
|