mirror of
https://github.com/kellyjonbrazil/jc.git
synced 2025-06-21 00:19:42 +02:00
219 lines
3.2 KiB
Markdown
219 lines
3.2 KiB
Markdown
[Home](https://kellyjonbrazil.github.io/jc/)
|
|
<a id="jc.parsers.crontab"></a>
|
|
|
|
# jc.parsers.crontab
|
|
|
|
jc - JSON CLI output utility `crontab -l` command output and crontab
|
|
file parser
|
|
|
|
Supports `crontab -l` command output and crontab files.
|
|
|
|
Usage (cli):
|
|
|
|
$ crontab -l | jc --crontab
|
|
|
|
or
|
|
|
|
$ jc crontab -l
|
|
|
|
Usage (module):
|
|
|
|
import jc
|
|
result = jc.parse('crontab', crontab_output)
|
|
|
|
or
|
|
|
|
import jc.parsers.crontab
|
|
result = jc.parsers.crontab.parse(crontab_output)
|
|
|
|
Schema:
|
|
|
|
{
|
|
"variables": [
|
|
{
|
|
"name": string,
|
|
"value": string
|
|
}
|
|
],
|
|
"schedule": [
|
|
{
|
|
"occurrence" string,
|
|
"minute": [
|
|
string
|
|
],
|
|
"hour": [
|
|
string
|
|
],
|
|
"day_of_month": [
|
|
string
|
|
],
|
|
"month": [
|
|
string
|
|
],
|
|
"day_of_week": [
|
|
string
|
|
],
|
|
"occurrence": string,
|
|
"command": string
|
|
}
|
|
]
|
|
}
|
|
|
|
**Examples**:
|
|
|
|
|
|
$ crontab -l | jc --crontab -p
|
|
{
|
|
- `"variables"` - [
|
|
{
|
|
- `"name"` - "MAILTO",
|
|
- `"value"` - "root"
|
|
},
|
|
{
|
|
- `"name"` - "PATH",
|
|
- `"value"` - "/sbin:/bin:/usr/sbin:/usr/bin"
|
|
},
|
|
{
|
|
- `"name"` - "SHELL",
|
|
- `"value"` - "/bin/bash"
|
|
}
|
|
],
|
|
- `"schedule"` - [
|
|
{
|
|
- `"minute"` - [
|
|
"5"
|
|
],
|
|
- `"hour"` - [
|
|
"10-11",
|
|
"22"
|
|
],
|
|
- `"day_of_month"` - [
|
|
"*"
|
|
],
|
|
- `"month"` - [
|
|
"*"
|
|
],
|
|
- `"day_of_week"` - [
|
|
"*"
|
|
],
|
|
- `"command"` - "/var/www/devdaily.com/bin/mk-new-links.php"
|
|
},
|
|
{
|
|
- `"minute"` - [
|
|
"30"
|
|
],
|
|
- `"hour"` - [
|
|
"4/2"
|
|
],
|
|
- `"day_of_month"` - [
|
|
"*"
|
|
],
|
|
- `"month"` - [
|
|
"*"
|
|
],
|
|
- `"day_of_week"` - [
|
|
"*"
|
|
],
|
|
- `"command"` - "/var/www/devdaily.com/bin/create-all-backups.sh"
|
|
},
|
|
{
|
|
- `"occurrence"` - "yearly",
|
|
- `"command"` - "/home/maverick/bin/annual-maintenance"
|
|
},
|
|
{
|
|
- `"occurrence"` - "reboot",
|
|
- `"command"` - "/home/cleanup"
|
|
},
|
|
{
|
|
- `"occurrence"` - "monthly",
|
|
- `"command"` - "/home/maverick/bin/tape-backup"
|
|
}
|
|
]
|
|
}
|
|
|
|
$ cat /etc/crontab | jc --crontab -p -r
|
|
{
|
|
- `"variables"` - [
|
|
{
|
|
- `"name"` - "MAILTO",
|
|
- `"value"` - "root"
|
|
},
|
|
{
|
|
- `"name"` - "PATH",
|
|
- `"value"` - "/sbin:/bin:/usr/sbin:/usr/bin"
|
|
},
|
|
{
|
|
- `"name"` - "SHELL",
|
|
- `"value"` - "/bin/bash"
|
|
}
|
|
],
|
|
- `"schedule"` - [
|
|
{
|
|
- `"minute"` - "5",
|
|
- `"hour"` - "10-11,22",
|
|
- `"day_of_month"` - "*",
|
|
- `"month"` - "*",
|
|
- `"day_of_week"` - "*",
|
|
- `"command"` - "/var/www/devdaily.com/bin/mk-new-links.php"
|
|
},
|
|
{
|
|
- `"minute"` - "30",
|
|
- `"hour"` - "4/2",
|
|
- `"day_of_month"` - "*",
|
|
- `"month"` - "*",
|
|
- `"day_of_week"` - "*",
|
|
- `"command"` - "/var/www/devdaily.com/bin/create-all-backups.sh"
|
|
},
|
|
{
|
|
- `"occurrence"` - "yearly",
|
|
- `"command"` - "/home/maverick/bin/annual-maintenance"
|
|
},
|
|
{
|
|
- `"occurrence"` - "reboot",
|
|
- `"command"` - "/home/cleanup"
|
|
},
|
|
{
|
|
- `"occurrence"` - "monthly",
|
|
- `"command"` - "/home/maverick/bin/tape-backup"
|
|
}
|
|
]
|
|
}
|
|
|
|
<a id="jc.parsers.crontab.info"></a>
|
|
|
|
## info Objects
|
|
|
|
```python
|
|
class info()
|
|
```
|
|
|
|
Provides parser metadata (version, author, etc.)
|
|
|
|
<a id="jc.parsers.crontab.parse"></a>
|
|
|
|
#### parse
|
|
|
|
```python
|
|
def parse(data, raw=False, quiet=False)
|
|
```
|
|
|
|
Main text parsing function
|
|
|
|
**Arguments**:
|
|
|
|
|
|
- `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, darwin, aix, freebsd
|
|
|
|
Version 1.6 by Kelly Brazil (kellyjonbrazil@gmail.com)
|