Skip to main content

Extractor configuration

Use extractor: for one source or extractors: for a list. Each spec needs type. File extractors typically set mode and method.

Modes

singlefile, api, code. Unknown modes fail validation.

File types

file-csv, file-json, file-jsonl, file-xml, file-xls, file-xlsx, file-zip.

Methods: url (needs config.url), urlbypattern (needs prefix and data_prefix).

force: true re-downloads into current/.

APIBackuper

extractor:
type: api
method: apibackuper
mode: api

Keep apibackuper.cfg under storage/.

Code extractor

extractor:
type: code
mode: code
config:
script: scripts/collect.py

The script must live under the project directory and expose collect(). It is trusted input. See Security.

RSS and DCAT

extractors:
- name: feed
type: rss
config:
url: https://example.com/feed.xml
- name: catalog
type: dcat
config:
url: https://example.com/catalog.json

Concepts: Extractors.