Alati

Nasumično

Ulazi	min, max (brojevi), seed
Izlazi	result

op	Vraća
int	Cijeli broj između min i max
float	Decimalni broj
string	Niz od length znakova
boolean	Booleovu vrijednost
pick	Element izvučen iz items

Polje seed (broj ili niz) čini izvlačenje determinističkim: to omogućuje raznolike podatke uz ponovljiv test. To je bitna razlika u odnosu na pomoćnike {{$random…}}, koji nikada nisu ponovljivi.

Validacija sheme

Ulazi	value, schema (niz)
Izlazi	valid, invalid, errors
Konfiguracija	schema — JSON Schema, u draft-07, 2019-09 ili 2020-12

Alat izbora za provjeru poštuje li odgovor svoj ugovor. Priključite errors na Log: izlaz razlaže svaku povredu, čime CI neuspjeh postaje izravno upotrebljiv.

HTTP zahtjev ──response[body]──► Validacija sheme
                                    ├─ valid   ──► (nastavak)
                                    ├─ invalid ──► Throw
                                    └─ errors  ──► Log

Čitaj datoteku

Ulazi	path (niz)
Izlazi	content (niz)
Konfiguracija	path — apsolutna ili relativna prema otvorenoj .restorm datoteci

Relativnu putanju treba koristiti kako bi scenarij ostao prenosiv između vašeg računala i CI-ja.

Zapiši datoteku

Ulazi	path (niz), content
Izlazi	nema
Konfiguracija	path, mode: replace (zadano) ili append

Log (zapisnik)

Ulazi	message (niz), data
Izlazi	nema
Konfiguracija	level: debug, info, warn, error

To je ta kutija za sljedivost. Njezine su stavke jedine koje se prema zadanome prikazuju u zapisniku izvođenja i na izlazu naredbene linije — stavke pogona dodaju se tek uz --all-logs.

Drugim riječima: ono što napišete kutijom Log ono je što ćete zateći u artefaktima svojeg CI-ja.

Assert (tvrdnja)

Ulazi	a (opažena vrijednost), b (očekivana vrijednost), message (niz)
Izlazi	then (uspjeh), else (neuspjeh)
Konfiguracija	operator, a, b, message

Dostupni operatori:

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

Polje message ono je što će neuspjeh učiniti razumljivim u zapisniku: napišite u njega što se očekivalo, a ne „pogreška”.

Throw (podigni pogrešku)

Ulazi	message (niz)
Izlazi	nema — ta kutija nema port done
Konfiguracija	message

Namjerno obara izvođenje. To je ono što u CI-ju daje izlazni kod 1: priključite je na izlaz else svojih ključnih tvrdnji ili na invalid validacije sheme.