Skip to content

v0.5.0

Choose a tag to compare

@github-actions github-actions released this 27 Apr 15:35
· 522 commits to main since this release

kpubdata 0.5.0 adds two providers (law and krx), 10 datasets on existing providers, and richer dataset metadata with relevance-ranked search. The catalogue grows from 245 datasets to 261.

pip install "kpubdata==0.5.0"

Behaviour changes — check before upgrading

  • datasets.search() is now fuzzy and ranked. It used to be a substring match delegated to each adapter. It now scores name, description, tags and id (NFC-normalised, so Korean text matches consistently), returns results sorted by relevance, and drops anything below threshold (default 0.5). Expect more, and differently ordered, results (#63, #185).

Added

  • law provider (법제처, law.go.kr): law.law_search, law.law_detail and law.ordin_search (#180, #182).
  • krx provider (Korea Exchange): krx.kospi_index, krx.investor_flow and krx.market_valuation. It needs no API key and uses pykrx, which you install with pip install "kpubdata[krx]" (#199, #200, #204, #205).
  • Adapters declare requires_api_key, and Client.iter_authenticated_providers() lists only the providers that need a key (#204).
  • bok: bok.usd_krw (KRW/USD daily rate) and bok.bond_yield_3y (3-year treasury yield) from ECOS (#201, #202).
  • kosis: kosis.industrial_production, and dataset-level default query parameters that your own filters override (#203).
  • datago: four building-register datasets (building_area, building_floor, building_recap_title, building_title) (#181), and g2b_contract, g2b_catalog and social_enterprise (#193, #195). social_enterprise is served from api.odcloud.kr; the datago adapter now handles that host's page/perPage paging and flat data[] responses.
  • DatasetRef gains description, tags and source_url, filled in across the provider catalogues (#55, #183).
  • FieldConstraints describes a schema field's max_length, min_value, max_value, pattern, allowed_values and format, exposed as FieldDescriptor.constraints (#57, #184).
  • Cookbook guides (getting started, discovery, raw access) and example scripts (#59, #186).

For contributors

Built-in providers are listed in providers/manifest.py (#178), and semas, sgis and law gained live integration tests (#80, #187).

Full changelog: v0.4.0...v0.5.0