text_expressions 1.2.0

A tiny and complete tool to supercharge static JSON strings with dynamic, user-defined expressions.

Supercharge your JSON strings using simple yet powerful dynamic expressions

Table of Contents

• The Syntax
• Case Operations

The Syntax

Parameter

A parameter may be introduced through the use of {}, which mark a parameter template. A parameter template can contain either a named parameter (through the use of its name) or a positional one (through the use of its index).

Examples

Your name is {name} and your age is {age}.

The three chosen members are {0}, {1} and {2}.

Expression

An expression works a little like a switch statement. A parameter is passed into an expression and checked against the defined cases. If the parameter matches a case, its result is returned.

Expressions may be nested, and there is virtually no limit to how many cases an expression can contain. However, for readability's sake, it is best to keep expressions small and understandable.

[{parameter} ~ case1:result1/case2:result2/(...)]

[] introduce an expression

~ separates the parameter from the cases

: separates the result of a case from the case itself

/ separates cases and their results

Examples

[{age} ~ Lesser(18):You are underage!/Default:You are free to drink.]

[{temperature} ~ Lesser(15):Too cold./Lesser(30):Temperate./Default:It's too hot!]

Case Operations

The parser supports several comparison operations, which can be used to match a parameter to a case.

String-exclusive operations:

• StartsWith
• EndsWith
• Contains

Indifferent operations:

• Equals *
• In
• NotIn
• InRange
• NotInRange

Number-exclusive operations:

• Greater
• GreaterOrEqual
• Lesser
• LesserOrEqual

Other:

• Default

• If no operation has been defined, the operation will default to 'Equals'