BusDK

BusDK Update

bus-files saa lausekepohjaiset tarkistukset

bus files assert laajenee olemassaolon ja yksittäisten solujen tarkistuksista kohti aggregaatteja ja pieniä lausekkeita. Sama pinta pystyy nyt kysymään myös sitä, täsmääkö valittujen rivien summa odotettuun arvoon.

bus-files toimii nyt ennen kaikkea tiedostoassertien työkaluna. Sillä voi tarkistaa artefaktien olemassaolon, yksittäiset rivit ja nyt myös lasketut summat samassa komentopinnassa.

6.4.2026bus-filesAssertLausekkeet

Tiiviisti

TL;DR

  • bus files assert expr lisää valinnat, aggregaatit ja yksinkertaisen laskennan samaan tarkistuspintaan.
  • Sama komento pystyy nyt tarkistamaan esimerkiksi usean kassatilin summan yhdellä rivillä.
  • Onnistunut tarkistus palauttaa exit-statuksen 0, epäonnistunut mismatch palauttaa virheen.

Uusi pinta auttaa silloin, kun yksi raporttirivi ei riitä ja tarkistus pitää kohdistaa pieneen kokonaisuuteen. Esimerkiksi kassatilien yhteissumman voi tarkistaa yhdellä komennolla:

$ bus files assert expr \
  reports/20241231-tase-accounts.csv \
  --select-many cash 'account_code=1910|1911|1930' \
  --eval 'sum(cash.amount)' \
  --equals 129.27
assertion	expr
expected	129.27
observed	129.27
status	pass

Kolmen tilin yhteissumma voidaan näin tarkistaa samassa komennossa, eikä CSV:tä tarvitse ensin avata taulukkoon tai kierrättää awk- ja grep-putkien läpi. Onnistunut tarkistus palauttaa exit-statuksen 0, joten sama pinta sopii myös automaattisiin kontrolliketjuihin.

bus-files kattaa jo tiedostoille, riveille, soluille ja nyt myös lasketuille arvoille tehtävät tarkistukset samassa komentopinnassa. Juuri tämä assert-pinta on moduulin vahvin tämänhetkinen käyttö, ja nykyinen komentopinta löytyy bus-filesin dokumentaatiosta.