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-moduulin käyttökelpoinen osa on juuri nyt assert-puoli. Tiedostojen jäsentäminen ja haku kuuluvat moduulin laajempaan tarkoitukseen, mutta ne eivät vielä ole valmiita normaaliin käyttöön.

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ä vaan pitää tarkistaa pieni kokonaisuus. 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

Tässä hyöty näkyy heti: kolmen tilin yhteissumma voidaan 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.

Rajaus on silti hyvä pitää näkyvissä. bus-files on juuri nyt hyödyllinen erityisesti tiedostoassertien työkaluna. Moduulin laajempi tarkoitus tiedostojen jäsentämiseen ja hakemiseen ei vielä ole valmis normaaliin käyttöön. Nykyinen pinta löytyy bus-filesin dokumentaatiosta.