BusDK Update

Preferences siirtyy yhteiseen Bus config -juureen

bus-preferences käyttää nyt samaa käyttäjäkohtaista Bus config rootia kuin uusi auth- ja API-token-polku. Unix-tyyppisissä ympäristöissä oletus on $XDG_CONFIG_HOME/bus/preferences.json tai ~/.config/bus/preferences.json; Windowsissa oletus on %APPDATA%\Bus\preferences.json.

Vanha busdk/preferences.json ei jää irralleen. Jos uusi tiedosto puuttuu ja vanha oletustiedosto löytyy, kirjasto siirtää vanhan tiedoston uuteen Bus-polkuun ennen lukua tai kirjoitusta.

26.4.2026bus-preferencesconfigmigration

Tiiviisti

TL;DR

BUS_CONFIG_DIR voi nyt ohjata oletuspolun: ${BUS_CONFIG_DIR}/preferences.json.
Ilman eksplisiittistä polkua bus-preferences käyttää bus-config-juurta, ei enää busdk-juurta.
Vanha oletustiedosto migroidaan uuteen sijaintiin vain silloin, kun uusi tiedosto ei vielä ole olemassa.
BUS_PREFERENCES_PATH säilyy täsmällisenä override-polkkuna ja poistaa automaattisen migraation käytöstä.

Uusi polkujärjestys on selkeä. Jos BUS_PREFERENCES_PATH on asetettu, sitä käytetään sellaisenaan. Muussa tapauksessa BUS_CONFIG_DIR antaa jaetun config-juuren. Vasta sen jälkeen käytetään käyttöjärjestelmän oletuspolkuja:

BUS_PREFERENCES_PATH                 # exact override
BUS_CONFIG_DIR/preferences.json      # shared Bus config root
$XDG_CONFIG_HOME/bus/preferences.json
~/.config/bus/preferences.json
%APPDATA%\Bus\preferences.json

Yksinkertaisessa kehitysesimerkissä oman config-juuren voi antaa komennolle näin:

$ BUS_CONFIG_DIR=./bus-config bus-preferences set bus.default_country FI
$ BUS_CONFIG_DIR=./bus-config bus-preferences get bus.default_country

FI

Migraatio suojaa vanhan käyttäjäasetuksen. Jos vanha ~/.config/busdk/preferences.json on olemassa mutta uusi ~/.config/bus/preferences.json puuttuu, ensimmäinen get, list, set tai unset siirtää tiedoston uuteen sijaintiin. Jos uusi tiedosto on jo olemassa, vanhaa tiedostoa ei käytetä eikä sillä ylikirjoiteta uutta sisältöä.

Muutos liittyy samaan paikallisen tilan siivoukseen kuin auth-tokenien dokumentoitu polku: Bus API -tokenit ja käyttäjäkohtaiset preferences-asetukset eivät kuulu repositoryn .bus/-hakemistoon. Repo pysyy workspace-datana, ja käyttäjäkohtainen config pysyy käyttöjärjestelmän config-juuressa. Tarkempi polkusääntö löytyy bus-preferences-dokumentaatiosta.