Apuvälineet

Random (satunnainen)


Tulot	`min`, `max` (lukuja), `seed`
Lähdöt	`result`

`op`	Palauttaa
`int`	Kokonaisluvun arvojen `min` ja `max` väliltä
`float`	Liukuluvun
`string`	Merkkijonon, jossa on `length` merkkiä
`boolean`	Totuusarvon
`pick`	Alkion, joka on poimittu `items`-luettelosta

Kenttä seed (luku tai merkkijono) tekee arvonnasta determinististä: näin data voi vaihdella, mutta testi pysyy toistettavana. Tämä on olennainen ero {{$random…}}-helpereihin, jotka eivät ole koskaan toistettavia.

Schema validate (skeeman validointi)


Tulot	`value`, `schema` (merkkijono)
Lähdöt	`valid`, `invalid`, `errors`
Kokoonpano	`schema` — JSON Schema, versio draft-07, 2019-09 tai 2020-12

Paras väline sen tarkistamiseen, että vastaus noudattaa sopimustaan. Kytke errors Log-lohkoon: tuloste erittelee jokaisen rikkomuksen, mikä tekee jatkuvan integraation epäonnistumisesta suoraan hyödynnettävän.

HTTP-pyyntö ──response[body]──► Schema validate
                                   ├─ valid   ──► (jatko)
                                   ├─ invalid ──► Throw
                                   └─ errors  ──► Log

Read file (lue tiedosto)


Tulot	`path` (merkkijono)
Lähdöt	`content` (merkkijono)
Kokoonpano	`path` — absoluuttinen tai suhteessa avattuun `.restorm`-tiedostoon

Suhteellista polkua kannattaa käyttää, jotta skenaario pysyy siirrettävänä oman koneen ja jatkuvan integraation välillä.

Write file (kirjoita tiedosto)


Tulot	`path` (merkkijono), `content`
Lähdöt	ei mitään
Kokoonpano	`path`, `mode`: `replace` (oletus) tai `append`

Log (loki)


Tulot	`message` (merkkijono), `data`
Lähdöt	ei mitään
Kokoonpano	`level`: `debug`, `info`, `warn`, `error`

Tämä on se jäljitettävyyden lohko. Vain sen merkinnät näkyvät oletuksena suorituslokissa ja komentorivin tulosteessa — moottorin omat merkinnät tulevat mukaan vain valitsimella --all-logs.

Toisin sanoen: se mitä kirjoitat Log-lohkolla, on juuri se mitä löydät jatkuvan integraation artefakteista.

Assert (väittämä)


Tulot	`a` (havaittu arvo), `b` (odotettu arvo), `message` (merkkijono)
Lähdöt	`then` (onnistuminen), `else` (epäonnistuminen)
Kokoonpano	`operator`, `a`, `b`, `message`

Käytettävissä olevat operaattorit:

eq · ne · lt · lte · gt · gte · contains · isString · isNumber · isBoolean · isArray · isObject · isNull · exists · isEmpty · matchesRegex · isOneOf · deepEquals · lengthEq · lengthGt · lengthLt

message-kenttä on se, joka tekee epäonnistumisesta lokissa ymmärrettävän: kirjoita siihen mitä odotettiin, ei ”virhe”.

Throw (heitä virhe)


Tulot	`message` (merkkijono)
Lähdöt	ei mitään — tällä lohkolla ei ole `done`-porttia
Kokoonpano	`message`

Kaataa suorituksen tarkoituksella. Juuri tämä tuottaa jatkuvassa integraatiossa poistumiskoodin 1: kytke se kriittisten väittämien else-lähtöön tai skeeman validoinnin invalid-lähtöön.