Formulės

Formulės rašomos prepare stulpelyje. Formulių pagalba galima atlikti įvairius duomenų transformavimo, nuasmeninimo, filtravimo ir kokybės tikrinimo veiksmus.

Kadangi yra labai didelė įvairovė duomenų formatų ir duomenų valdymo mechanizmų, siekiant suvaldyti visą šią įvairovę DSA formulės leidžia vieningai aprašyti veiksmus su duomenimis. Vėliau formulės verčiamos į vieningą AST, kurį gali interpretuoti automatizuotos priemonės, priklausomai nuo duomenų šaltinio ir konteksto ir DSA sluoksnio.

Gramatika

Formulių sintaksė atitinką šią ABNF gramatiką:

formula     = testlist
testlist    = test *("," test) *1","
test        = or
or          = and *("|" and)
and         = not *("&" not)
not         = "!" not / comp
comp        = expr *(compop expr)
expr        = term *(termop term)
term        = factor *(factorop factor)
factor      = sign factor / composition
composition = atom *trailer
atom        = "(" *1group ")"
            / "[" *1list "]"
            / func / value / name
group       = test *("," test) *1","
list        = test *("," test) *1","
trailer     = "[" *1filter "]" / method / attr
func        = name call
method      = "." name call
call        = "(" *1arglist ")"
arglist     = argument *("," argument) *1","
argument    = test / kwarg
kwarg       = name ":" test
filter      = test *("," test) *1","
attr        = "." name
value       = null / bool / integer / number / string / star
compop      = ">=" / "<=" / "!=" / "=" / "<" / ">"
termpop     = "+" / "-"
factorop    = "*" / "/" / "%"
sign        = "+" / "-"
star        = "*"
name        = ~/[a-z_][a-z0-9_]*/i
number      = ~/\d+(\.\d+)?/
integer     = ~/0|[1-9]\d*/
bool        = "false" / "true"
null        = "null"
string      = ~/(?!"").*?(?<!\\)(\\\\)*?"|'(?!'').*?
                (?<!\\)(\\\\)*?'/i

Sintaksės medis

Formulės verčiamos į vieningą abstraktų sintaksės medį. Vieningas abstraktus sintaksės medis leidžia atskirti formulės skaitymo ir interpretavimo veiklas.

Abstraktus sintaksės medis sudarytas iš vienodų elementų turinčių tokias savybes:

name: Funkcijos pavadinimas.

args: Funkcijos argumentų sąrašas, kurį gali sudaryti konkrečios reikšmės ar kiti medžio elementai, veiksmai.

Visos formulėje naudojamos išraiškos sintaksės medyje verčiamos į funkcijų ir argumentų medį. Pavyzdžiui test("a", "b") bus verčiamas į:

{
    "name": "test",
    "args": ["a", "b"],
}

Funkcijų iškvietimas

Formulės susideda iš vykdomų funkcijų sekos. Pavyzdžiui funkcijos pavadinimu test vykdymas formulėje atrodys taip:

test()

Aukščiau pavyzdyje pateikta formulė vykdo funkciją test, be argumentų. Tačiau funkcijos gali turėti pozicinius ir vardinius argumentus.

Poziciniai argumentai

Poziciniai argumentai perduodami taip:

test(a, b, c)

Pavyzdyje, funkcijai test perduodami trys argumentai a, b ir c. Šioje dokumentacijoje, tais atvejais, kai funkcijos pozicinių argumentų skaičius nėra fiksuotas, naudojama *args išraiška, kur * nurodo, kad pozicinių argumentų gali būti 0 ar daugiau.

Vardiniai argumentai

Vardiniai argumentai funkcijai perduodami taip:

test(a: 1, b: 2, c: 3)

Pozicinius argumentus būtina perduoti tiksliai tokia tvarka, kokios tikisi funkcija. Tačiau vardinius argumentus, galima perduoti, bet kuria tvarka.

Jei vardinių argumentų sąrašas nėra fiksuotas, dokumentacijoje toks argumentų sąrašas užrašomas **kwargs forma, kur ** nurodo, kad vardinių argumentų gali būti 0 ar daugiau.

Alternatyvus funkcijos iškvietimas

Funkcijų iškvietimas gali būti užrašomas įprastiniu būdu, pavyzdžiui:

test(test(test(a), b), c)

Arba funkcijų grandinės (angl. Method chain) būdu:

a.test().test(b).test(c)

Kadangi formulės dažnai naudojamos tam tikros reikšmės transformavimui, todėl dažnai formulė yra lengviau skaitoma, naudojant funkcijų grandinę.

test(a) yra a.test() arba test(a, b) ir a.test(b) yra ekvivalentūs (UFCS).

Standartinės funkcijos

Priklausomai nuo duomenų šaltinio ar konteksto gali būti naudojami skirtingi veiksmai, tačiau žemiau yra pateikti bendrosios paskirties veiksmai:

func.bind(name)

Rodo į reikšmę pavadinimu name iš konteksto. Reikšmės ieškoma tokia tvarka:

var()
param()
item()
prop()

func.prop(name): Modelio savybė pavadinimu name iš property stulpelio.

func.item(name): Sąrašo elemento savybė pavadinimu name.

func.param(name): Parametras pavadinimu name. Žiūrėti Parametrai.

func.var(name): Kintamasis apibrėžtas set() funkcijos pagalba.

func.self(): Rodo į aktyvią reikšmę, naudojamas property.prepare formulėse.

func.or(*args)