mirror of
https://github.com/kellyjonbrazil/jc.git
synced 2025-06-19 00:17:51 +02:00
151 lines
2.5 KiB
Markdown
151 lines
2.5 KiB
Markdown
|
|
# jc.parsers.group
|
|
jc - JSON CLI output utility `/etc/group` file parser
|
|
|
|
Usage (cli):
|
|
|
|
$ cat /etc/group | jc --group
|
|
|
|
Usage (module):
|
|
|
|
import jc.parsers.group
|
|
result = jc.parsers.group.parse(group_file_output)
|
|
|
|
Compatibility:
|
|
|
|
'linux', 'darwin', 'aix', 'freebsd'
|
|
|
|
Examples:
|
|
|
|
$ cat /etc/group | jc --group -p
|
|
[
|
|
{
|
|
"group_name": "nobody",
|
|
"password": "*",
|
|
"gid": -2,
|
|
"members": []
|
|
},
|
|
{
|
|
"group_name": "nogroup",
|
|
"password": "*",
|
|
"gid": -1,
|
|
"members": []
|
|
},
|
|
{
|
|
"group_name": "wheel",
|
|
"password": "*",
|
|
"gid": 0,
|
|
"members": [
|
|
"root"
|
|
]
|
|
},
|
|
{
|
|
"group_name": "certusers",
|
|
"password": "*",
|
|
"gid": 29,
|
|
"members": [
|
|
"root",
|
|
"_jabber",
|
|
"_postfix",
|
|
"_cyrus",
|
|
"_calendar",
|
|
"_dovecot"
|
|
]
|
|
},
|
|
...
|
|
]
|
|
|
|
$ cat /etc/group | jc --group -p -r
|
|
[
|
|
{
|
|
"group_name": "nobody",
|
|
"password": "*",
|
|
"gid": "-2",
|
|
"members": [
|
|
""
|
|
]
|
|
},
|
|
{
|
|
"group_name": "nogroup",
|
|
"password": "*",
|
|
"gid": "-1",
|
|
"members": [
|
|
""
|
|
]
|
|
},
|
|
{
|
|
"group_name": "wheel",
|
|
"password": "*",
|
|
"gid": "0",
|
|
"members": [
|
|
"root"
|
|
]
|
|
},
|
|
{
|
|
"group_name": "certusers",
|
|
"password": "*",
|
|
"gid": "29",
|
|
"members": [
|
|
"root",
|
|
"_jabber",
|
|
"_postfix",
|
|
"_cyrus",
|
|
"_calendar",
|
|
"_dovecot"
|
|
]
|
|
},
|
|
...
|
|
]
|
|
|
|
|
|
## 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:
|
|
|
|
[
|
|
{
|
|
"group_name": string,
|
|
"password": string,
|
|
"gid": integer,
|
|
"members": [
|
|
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.
|
|
|