Repository navigation
v0.5.0
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 belowthreshold(default 0.5). Expect more, and differently ordered, results (#63, #185).
Added
lawprovider (법제처, law.go.kr):law.law_search,law.law_detailandlaw.ordin_search(#180, #182).krxprovider (Korea Exchange):krx.kospi_index,krx.investor_flowandkrx.market_valuation. It needs no API key and usespykrx, which you install withpip install "kpubdata[krx]"(#199, #200, #204, #205).- Adapters declare
requires_api_key, andClient.iter_authenticated_providers()lists only the providers that need a key (#204). - bok:
bok.usd_krw(KRW/USD daily rate) andbok.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), andg2b_contract,g2b_catalogandsocial_enterprise(#193, #195).social_enterpriseis served fromapi.odcloud.kr; the datago adapter now handles that host'spage/perPagepaging and flatdata[]responses. DatasetRefgainsdescription,tagsandsource_url, filled in across the provider catalogues (#55, #183).FieldConstraintsdescribes a schema field'smax_length,min_value,max_value,pattern,allowed_valuesandformat, exposed asFieldDescriptor.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