BusDK

BusDK Update

bus-files tuo tiedostotarkistukset BusDK:hon

BusDK:hon tulee komento, jolla pystyy tarkistamaan tiedostojen olemassaolon ja CSV-artefaktien rivejä ilman erillisiä shell-putkia.

bus-files-moduulin käyttökelpoinen osa on tässä vaiheessa assert. Sillä voi tarkistaa tiedostoja ja CSV-rivejä, mutta moduulin laajempi tarkoitus tiedostojen jäsentämiseen ja hakemiseen ei vielä ole valmis normaaliin käyttöön.

4.4.2026 bus-files Tiedostotarkistukset

Tiiviisti

TL;DR

  • Tiedostoartefaktien tarkistus saa oman Bus-komennon.
  • CSV-rivejä pystyy tarkistamaan samoilla periaatteilla kuin muita assert-pintoja.
  • Moduulin käyttökelpoinen ensimmäinen pinta on assert; tiedostojen jäsentäminen ja haku eivät vielä ole valmiita normaaliin käyttöön.

Help tekee nykyisen rajauksen näkyväksi heti: 

bus-files --help
Commands:
  parse
  find
  assert

Tärkein uusi osa on assert. Se ratkaisee yksinkertaisen mutta toistuvan tarpeen: onko tiedosto olemassa ja onko raportin yksi rivi juuri se mitä odotettiin. Esimerkiksi synteettisen 2024-aineiston mukana tullut tuloslaskelma ja sen CSV-rivi voi tarkistaa näin: 

bus files assert exists \
  examples/synthetic-full-fictional-2024/data-monthly-transfer-v2/tuloslaskelma-2024.pdf

bus files assert cell \
  examples/synthetic-full-fictional-2024/data-monthly-transfer-v2/profit-loss-2024.csv \
  --row-filter 'section=LIIKEVAIHTO' \
  --column amount \
  --equals 3774.02
assertion	target	expected	observed	status
exists	.../tuloslaskelma-2024.pdf	exists	exists	ok

assertion	target	expected	observed	status
cell	.../profit-loss-2024.csv	filters=section=LIIKEVAIHTO; column=amount; equals=3774.02	amount=3774.02	ok

Tällainen tarkistus on hyödyllinen juuri siksi, että raportin olemassaolo tai yhden rivin arvo ei enää jää satunnaisten shell-työkalujen varaan. bus-files on juuri nyt ennen kaikkea tiedostoassertien työkalu. Moduulin laajempi rooli tiedostojen jäsentämisessä ja hakemisessa ei vielä ole valmis normaaliin käyttöön. Lisää käyttötapoja löytyy bus-files-dokumentaatiosta.