mirror of
https://github.com/kellyjonbrazil/jc.git
synced 2025-06-21 00:19:42 +02:00
136 lines
2.3 KiB
Markdown
136 lines
2.3 KiB
Markdown
|
|
# jc.parsers.jobs
|
|
jc - JSON CLI output utility `jobs` command output parser
|
|
|
|
Also supports the `-l` option.
|
|
|
|
Usage (cli):
|
|
|
|
$ jobs | jc --jobs
|
|
|
|
or
|
|
|
|
$ jc jobs
|
|
|
|
Usage (module):
|
|
|
|
import jc.parsers.jobs
|
|
result = jc.parsers.jobs.parse(jobs_command_output)
|
|
|
|
Compatibility:
|
|
|
|
'linux', 'darwin', 'cygwin', 'aix', 'freebsd'
|
|
|
|
Example:
|
|
|
|
$ jobs -l | jc --jobs -p
|
|
[
|
|
{
|
|
"job_number": 1,
|
|
"pid": 5283,
|
|
"status": "Running",
|
|
"command": "sleep 10000 &"
|
|
},
|
|
{
|
|
"job_number": 2,
|
|
"pid": 5284,
|
|
"status": "Running",
|
|
"command": "sleep 10100 &"
|
|
},
|
|
{
|
|
"job_number": 3,
|
|
"pid": 5285,
|
|
"history": "previous",
|
|
"status": "Running",
|
|
"command": "sleep 10001 &"
|
|
},
|
|
{
|
|
"job_number": 4,
|
|
"pid": 5286,
|
|
"history": "current",
|
|
"status": "Running",
|
|
"command": "sleep 10112 &"
|
|
}
|
|
]
|
|
|
|
$ jobs -l | jc --jobs -p -r
|
|
[
|
|
{
|
|
"job_number": "1",
|
|
"pid": "19510",
|
|
"status": "Running",
|
|
"command": "sleep 1000 &"
|
|
},
|
|
{
|
|
"job_number": "2",
|
|
"pid": "19511",
|
|
"status": "Running",
|
|
"command": "sleep 1001 &"
|
|
},
|
|
{
|
|
"job_number": "3",
|
|
"pid": "19512",
|
|
"history": "previous",
|
|
"status": "Running",
|
|
"command": "sleep 1002 &"
|
|
},
|
|
{
|
|
"job_number": "4",
|
|
"pid": "19513",
|
|
"history": "current",
|
|
"status": "Running",
|
|
"command": "sleep 1003 &"
|
|
}
|
|
]
|
|
|
|
|
|
## info
|
|
```python
|
|
info()
|
|
```
|
|
|
|
|
|
## process
|
|
```python
|
|
process(proc_data)
|
|
```
|
|
|
|
Final processing to conform to the schema.
|
|
|
|
Parameters:
|
|
|
|
proc_data: (List of Dictionaries) raw structured data to process
|
|
|
|
Returns:
|
|
|
|
List of Dictionaries. Structured data with the following schema:
|
|
|
|
[
|
|
{
|
|
"job_number": integer,
|
|
"pid": integer,
|
|
"history": string,
|
|
"status": string,
|
|
"command": string
|
|
}
|
|
]
|
|
|
|
|
|
## 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.
|
|
|