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

177 lines
3.5 KiB
Markdown
Raw Normal View History

[Home](https://kellyjonbrazil.github.io/jc/)
2022-01-25 17:07:47 -08:00
<a id="jc.parsers.dpkg_l"></a>
# jc.parsers.dpkg\_l
2021-04-01 20:12:58 -07:00
jc - JSON CLI output utility `dpkg -l` command output parser
2022-01-19 17:30:14 -08:00
Set the `COLUMNS` environment variable to a large value to avoid field
truncation. For example:
2021-04-01 20:12:58 -07:00
2022-01-25 17:07:47 -08:00
$ COLUMNS=500 dpkg -l | jc --dpkg-l
2021-04-01 20:12:58 -07:00
Usage (cli):
2022-01-25 17:07:47 -08:00
$ dpkg -l | jc --dpkg-l
2021-04-01 20:12:58 -07:00
2022-01-25 17:07:47 -08:00
or
2021-04-01 20:12:58 -07:00
2022-01-25 17:07:47 -08:00
$ jc dpkg -l
2021-04-01 20:12:58 -07:00
Usage (module):
2022-01-25 17:07:47 -08:00
import jc
result = jc.parse('dpkg_l', dpkg_command_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.dpkg_l
result = jc.parsers.dpkg_l.parse(dpkg_command_output)
2021-04-01 20:12:58 -07:00
2021-04-08 12:42:01 -07:00
Schema:
2022-01-25 17:07:47 -08:00
[
{
"codes": string,
"name": string,
"version": string,
"architecture": string,
"description": string,
"desired": string,
"status": string,
"error": string
}
]
**Examples**:
$ dpkg -l | jc --dpkg-l -p
[
{
- `"codes"` - "ii",
- `"name"` - "accountsservice",
- `"version"` - "0.6.45-1ubuntu1.3",
- `"architecture"` - "amd64",
- `"description"` - "query and manipulate user account information",
- `"desired"` - "install",
- `"status"` - "installed"
},
{
- `"codes"` - "rc",
- `"name"` - "acl",
- `"version"` - "2.2.52-3build1",
- `"architecture"` - "amd64",
- `"description"` - "Access control list utilities",
- `"desired"` - "remove",
- `"status"` - "config-files"
},
{
- `"codes"` - "uWR",
- `"name"` - "acpi",
- `"version"` - "1.7-1.1",
- `"architecture"` - "amd64",
- `"description"` - "displays information on ACPI devices",
- `"desired"` - "unknown",
- `"status"` - "trigger await",
- `"error"` - "reinstall required"
},
{
- `"codes"` - "rh",
- `"name"` - "acpid",
- `"version"` - "1:2.0.28-1ubuntu1",
- `"architecture"` - "amd64",
- `"description"` - "Advanced Configuration and Power Interface...",
- `"desired"` - "remove",
- `"status"` - "half installed"
},
{
- `"codes"` - "pn",
- `"name"` - "adduser",
- `"version"` - "3.116ubuntu1",
- `"architecture"` - "all",
- `"description"` - "add and remove users and groups",
- `"desired"` - "purge",
- `"status"` - "not installed"
},
...
]
$ dpkg -l | jc --dpkg-l -p -r
[
{
- `"codes"` - "ii",
- `"name"` - "accountsservice",
- `"version"` - "0.6.45-1ubuntu1.3",
- `"architecture"` - "amd64",
- `"description"` - "query and manipulate user account information"
},
{
- `"codes"` - "rc",
- `"name"` - "acl",
- `"version"` - "2.2.52-3build1",
- `"architecture"` - "amd64",
- `"description"` - "Access control list utilities"
},
{
- `"codes"` - "uWR",
- `"name"` - "acpi",
- `"version"` - "1.7-1.1",
- `"architecture"` - "amd64",
- `"description"` - "displays information on ACPI devices"
},
{
- `"codes"` - "rh",
- `"name"` - "acpid",
- `"version"` - "1:2.0.28-1ubuntu1",
- `"architecture"` - "amd64",
- `"description"` - "Advanced Configuration and Power Interface..."
},
{
- `"codes"` - "pn",
- `"name"` - "adduser",
- `"version"` - "3.116ubuntu1",
- `"architecture"` - "all",
- `"description"` - "add and remove users and groups"
},
...
]
<a id="jc.parsers.dpkg_l.info"></a>
## info Objects
2021-04-01 20:12:58 -07:00
```python
2022-01-25 17:07:47 -08:00
class info()
2021-04-01 20:12:58 -07:00
```
2022-01-25 17:07:47 -08:00
2021-04-08 12:42:01 -07:00
Provides parser metadata (version, author, etc.)
2021-04-01 20:12:58 -07:00
2022-01-25 17:07:47 -08:00
<a id="jc.parsers.dpkg_l.parse"></a>
#### parse
2021-04-01 20:12:58 -07:00
```python
2022-01-25 17:07:47 -08:00
def parse(data, raw=False, quiet=False)
2021-04-01 20:12:58 -07:00
```
Main text parsing function
2022-01-25 17:07:47 -08:00
**Arguments**:
2021-04-01 20:12:58 -07: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
2021-04-01 20:12:58 -07:00
2022-01-25 17:07:47 -08:00
**Returns**:
2021-04-01 20:12:58 -07:00
2022-01-25 17:07:47 -08:00
List of Dictionaries. Raw or processed structured data.
2021-04-01 20:12:58 -07:00
## Parser Information
Compatibility: linux
2021-12-01 16:12:51 -08:00
Version 1.2 by Kelly Brazil (kellyjonbrazil@gmail.com)