Commands

Every command, argument and option of govdata 0.5.1, read from the CLI itself.

Global options

These options work with every command.

OptionDescriptionDefault
-V, --version output the version number
--base-url <url> API base URL (default: "https://ckan.govdata.de")
--timeout <ms> per-request timeout in milliseconds (default 30000; 0 = no timeout)
--user-agent <ua> User-Agent header value
--max-retries <n> retries for transient 429/503 responses and reset connections (0..10; linear backoff, longer if the server's Retry-After asks, up to 30 s)
--max-response-bytes <n> cap response body size in bytes (0 = unlimited; default 100 MiB)
--log-format <format> how errors, warnings and notes are written to stderr: text (log4j style: time, level, [topic], message) or jsonl (one JSON object per line: ts, level, topic, msg); default text
--compact print JSON on a single line instead of pretty-printed

govdata package

Show one dataset by id or name

govdata package [options] <id>

Arguments

<id> required
dataset id or name

govdata packages

List dataset names

govdata packages [options]

Options

OptionDescriptionDefault
--limit <n> max names (1 or more; omit for all)
--offset <n> offset for paging

govdata organizations

List organizations (data publishers)

govdata organizations [options]

Options

OptionDescriptionDefault
--all-fields return full objects instead of names

govdata organization

Show one organization

govdata organization [options] <id>

Arguments

<id> required
organization id or name

govdata groups

List groups (themes/categories)

govdata groups [options]

Options

OptionDescriptionDefault
--all-fields return full objects instead of names

govdata group

Show one group

govdata group [options] <id>

Arguments

<id> required
group id or name

govdata tags

List tags

govdata tags [options]

Options

OptionDescriptionDefault
--query <substring> filter tags by substring

govdata resource

Show one resource (distribution) by id

govdata resource [options] <id>

Arguments

<id> required
resource id

govdata action

Call any CKAN action by name (generic escape hatch)

govdata action [options] <name>

Arguments

<name> required

Options

OptionDescriptionDefault
--param <key=value> query parameter (repeatable)