1
0
mirror of https://github.com/kellyjonbrazil/jc.git synced 2025-06-17 00:07:37 +02:00
Files
jc/docs/parsers/crontab_u.md

216 lines
3.3 KiB
Markdown
Raw Normal View History

[Home](https://kellyjonbrazil.github.io/jc/)
2022-01-25 17:07:47 -08:00
<a id="jc.parsers.crontab_u"></a>
# jc.parsers.crontab\_u
2020-07-30 16:20:24 -07:00
2022-01-19 17:30:14 -08:00
jc - JSON CLI output utility `crontab -l` command output and crontab
file parser
2020-08-05 16:51:58 -07:00
2022-01-19 17:30:14 -08:00
This version of the `crontab -l` parser supports output that contains user
information for processes.
2020-02-04 14:19:33 -08:00
2020-08-05 13:32:59 -07:00
Usage (cli):
2020-02-04 14:19:33 -08:00
2022-01-25 17:07:47 -08:00
$ crontab -l | jc --crontab-u
2020-02-04 14:19:33 -08:00
2020-08-05 13:32:59 -07:00
Usage (module):
2022-01-25 17:07:47 -08:00
import jc
result = jc.parse('crontab_u', crontab_u_output)
2022-01-18 14:18:12 -08:00
2022-01-25 17:07:47 -08:00
or
2022-01-18 14:18:12 -08:00
2022-01-25 17:07:47 -08:00
import jc.parsers.crontab_u
result = jc.parsers.crontab_u.parse(crontab_u_output)
2020-08-05 13:32:59 -07:00
Schema:
2022-01-25 17:07:47 -08:00
{
"variables": [
{
"name": string,
"value": string
}
],
"schedule": [
{
"occurrence" string,
"minute": [
string
],
"hour": [
string
],
"day_of_month": [
string
],
"month": [
string
],
"day_of_week": [
string
],
"occurrence": string,
"user": string,
"command": string
}
]
}
**Examples**:
$ cat /etc/crontab | jc --crontab-u -p
{
- `"variables"` - [
{
- `"name"` - "PATH",
- `"value"` - "/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sb..."
},
{
- `"name"` - "SHELL",
- `"value"` - "/bin/sh"
}
],
- `"schedule"` - [
{
- `"minute"` - [
"25"
],
- `"hour"` - [
"6"
],
- `"day_of_month"` - [
"*"
],
- `"month"` - [
"*"
],
- `"day_of_week"` - [
"*"
],
- `"user"` - "root",
- `"command"` - "test -x /usr/sbin/anacron || ( cd / && run-parts ..."
},
{
- `"minute"` - [
"47"
],
- `"hour"` - [
"6"
],
- `"day_of_month"` - [
"*"
],
- `"month"` - [
"*"
],
- `"day_of_week"` - [
"7"
],
- `"user"` - "root",
- `"command"` - "test -x /usr/sbin/anacron || ( cd / && run-parts ..."
},
{
- `"minute"` - [
"52"
],
- `"hour"` - [
"6"
],
- `"day_of_month"` - [
"1"
],
- `"month"` - [
"*"
],
- `"day_of_week"` - [
"*"
],
- `"user"` - "root",
- `"command"` - "test -x /usr/sbin/anacron || ( cd / && run-parts ..."
}
]
}
$ cat /etc/crontab | jc --crontab-u -p -r
{
- `"variables"` - [
{
- `"name"` - "PATH",
- `"value"` - "/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/..."
},
{
- `"name"` - "SHELL",
- `"value"` - "/bin/sh"
}
],
- `"schedule"` - [
{
- `"minute"` - "25",
- `"hour"` - "6",
- `"day_of_month"` - "*",
- `"month"` - "*",
- `"day_of_week"` - "*",
- `"user"` - "root",
- `"command"` - "test -x /usr/sbin/anacron || ( cd / && run-parts ..."
},
{
- `"minute"` - "47",
- `"hour"` - "6",
- `"day_of_month"` - "*",
- `"month"` - "*",
- `"day_of_week"` - "7",
- `"user"` - "root",
- `"command"` - "test -x /usr/sbin/anacron || ( cd / && run-parts ..."
},
{
- `"minute"` - "52",
- `"hour"` - "6",
- `"day_of_month"` - "1",
- `"month"` - "*",
- `"day_of_week"` - "*",
- `"user"` - "root",
- `"command"` - "test -x /usr/sbin/anacron || ( cd / && run-parts ..."
}
]
}
<a id="jc.parsers.crontab_u.info"></a>
## info Objects
2020-02-04 14:19:33 -08:00
```python
2022-01-25 17:07:47 -08:00
class info()
2020-02-04 14:19:33 -08:00
```
2022-01-25 17:07:47 -08:00
Provides parser metadata (version, author, etc.)
2020-07-30 16:20:24 -07:00
2022-01-25 17:07:47 -08:00
<a id="jc.parsers.crontab_u.parse"></a>
#### parse
2020-02-04 14:19:33 -08:00
```python
2022-01-25 17:07:47 -08:00
def parse(data, raw=False, quiet=False)
2020-02-04 14:19:33 -08:00
```
Main text parsing function
2022-01-25 17:07:47 -08:00
**Arguments**:
2020-02-04 14:19:33 -08:00
2022-01-25 17:07:47 -08:00
- `data` - (string) text data to parse
- `raw` - (boolean) unprocessed output if True
- `quiet` - (boolean) suppress warning messages if True
2020-02-04 14:19:33 -08:00
2022-01-25 17:07:47 -08:00
**Returns**:
2020-02-04 14:19:33 -08:00
2022-01-25 17:07:47 -08:00
Dictionary. Raw or processed structured data.
2020-02-04 14:19:33 -08:00
## Parser Information
Compatibility: linux, darwin, aix, freebsd
2021-12-01 16:12:51 -08:00
Version 1.7 by Kelly Brazil (kellyjonbrazil@gmail.com)