LibTagCompiler-2.0

LibTagCompiler-2.0 is a library allowing configuration via tags, specifically useful for display components, allowing easy arrangement and modification of said display. It is currently used in Assessment and Aloft.

Syntax

TextTag       := { Statement } @
RawTag        := RValue @
NumberTag     := RValue @

Statement     := literal | "[" RValue "]"
RValue        := Logical
Logical       := Relation { "&" | "|" } Relation
Relation      := Concat [ ("==" | "~=" | ">" | "<" | "<=" | ">=") Concat ]
Concat        := Expression { ("."  | "..") Expression }
Expression    := Term { ("+" | "-") Term }
Factor        := Chain { ("*" | "/") Chain }
Chain         := Unary { ":" Unary }
Unary         := [ "~" | "-" ] Primary
Primary       := ConstantNumber | ConstantString | Identifier ["(" ParameterList ")"] | "(" RValue ")"
ParameterList := RValue {, RValue }

Usage

TagCompiler:Compile(tag, tagData, resultType)
tagData is a structure that optionally has:
    tagname.data
    tagname.events
    tagname.overrideEvents
    tagname.guaranteeResult
    tagname.noGuaranteeChange
    tagname.numeric
    parameterTypes        -- Array of either "raw", "number" or "string"
And must have one of:
    tagname.tableData
    tagname.string
    tagname.method        -- Will be called with the input parameter, prior result and any parameters
    tagname.compileString

For methods or compileStrings that require parameters, it must contain
    tagname.parameterTypes

resultType is "string", "number", or "raw"

The result of CreateTag is a table with:
    data   - a list of data elements required, which is all of the tag's .data lists
    events - a list of the events required, which is a list of all tag's .events minus .overrideEvents
    method - call with input parameter
    tag    - the tag used