Skip to content

v0.6.0 — Nadiia

Choose a tag to compare

View all tags
@aborruso aborruso released this 29 Apr 06:45
· 203 commits to main since this release
v0.6.0
7daee8b

Named after Nadiia Babynska-Virna, whose work on building a local MCP server for Ukrainian statistics identified the blockers that this release solves.

What's new

Custom User-Agent support

Some SDMX providers (confirmed: Derzhstat, Ukraine) block requests from non-browser clients. opensdmx now supports a configurable User-Agent at two levels:

  • Global override via env var: OPENSDMX_USER_AGENT=Mozilla/5.0 opensdmx ...
  • Per-portal default via user_agent field in portals.json

data_key_format portal field

Providers that reject the SDMX dimension key-filter dot notation in data URLs (e.g. data/{df_id}/....) can now be configured with data_key_format: "empty". This omits the key segment entirely and relies on startPeriod / endPeriod / lastNObservations query params for filtering.

Default is "dots" — all existing providers are unaffected.

Derzhstat preset

portals.json now includes a derzhstat preset for the State Statistics Service of Ukraine (agency SSSU, 112+ dataflows):

OPENSDMX_PROVIDER=derzhstat opensdmx info DF_PRICE_CHANGE_CONSUMER_GOODS_SERVICE
OPENSDMX_PROVIDER=derzhstat opensdmx get DF_PRICE_CHANGE_CONSUMER_GOODS_SERVICE \
  --start-period 2024-01 --end-period 2024-12

Verified capabilities: constraints ✓ · last_n ✓ · categories ✗

Closes #20

Assets 2
Loading