feat(RFC): An expression language for format strings

This is a set of 3 RFCs to propose an expression language to use in
template format strings based on a subset of the Python language. The
three proposals are:

RFC 5 - Expression Language
RFC 6 - Expression Function Library
RFC 7 - Extended Parameter Types

Signed-off-by: Mark <399551+mwiebe@users.noreply.github.com>

Author: mwiebe

conformance-tests/2023-09/EXPR/job_templates/2--type-case-insensitive.yaml

@@ -0,0 +1,46 @@
+specificationVersion: jobtemplate-2023-09
+extensions:
+- EXPR
+name: TestJob
+parameterDefinitions:
+- name: MyInt
+  type: int
+- name: MyFloat
+  type: Float
+- name: MyString
+  type: STRING
+- name: MyPath
+  type: pAtH
+- name: MyBool
+  type: Bool
+  default: true
+- name: MyRangeExpr
+  type: range_expr
+  default: "1-10"
+- name: MyListString
+  type: "list[string]"
+  default: ["a", "b"]
+- name: MyListInt
+  type: "List[Int]"
+  default: [1, 2]
+- name: MyListFloat
+  type: "LIST[float]"
+  default: [1.0, 2.0]
+- name: MyListPath
+  type: "list[PATH]"
+  default: ["/tmp/a", "/tmp/b"]
+- name: MyListBool
+  type: "List[Bool]"
+  default: [true, false]
+- name: MyListListInt
+  type: "list[list[int]]"
+  default: [[1, 2], [3]]
+steps:
+- name: Step1
+  script:
+    actions:
+      onRun:
+        command: python
+        args:
+        - "-c"
+        - "print()"

conformance-tests/2023-09/EXPR/job_templates/2.10--range-expr-param-invalid-default.invalid.yaml

@@ -0,0 +1,17 @@
+specificationVersion: jobtemplate-2023-09
+extensions:
+- EXPR
+name: TestJob
+parameterDefinitions:
+- name: Frames
+  type: RANGE_EXPR
+  default: "not-a-range"
+steps:
+- name: Step1
+  script:
+    actions:
+      onRun:
+        command: python
+        args:
+        - "-c"
+        - "print()"

conformance-tests/2023-09/EXPR/job_templates/2.10--range-expr-param.yaml

@@ -0,0 +1,86 @@
+specificationVersion: jobtemplate-2023-09
+extensions:
+- EXPR
+name: TestJob
+parameterDefinitions:
+# Single values
+- name: SinglePositive
+  type: RANGE_EXPR
+  default: "42"
+- name: SingleZero
+  type: RANGE_EXPR
+  default: "0"
+- name: SingleNegative
+  type: RANGE_EXPR
+  default: "-100"
+# Simple ranges
+- name: SimpleRange
+  type: RANGE_EXPR
+  default: "1-100"
+- name: NegativeRange
+  type: RANGE_EXPR
+  default: "-10-10"
+# Ranges with step
+- name: RangeWithStep
+  type: RANGE_EXPR
+  default: "0-100:10"
+- name: RangeStepNotEvenlyDivide
+  type: RANGE_EXPR
+  default: "1-9:3"
+- name: NegativeStep
+  type: RANGE_EXPR
+  default: "10-1:-1"
+- name: NegativeRangeNegativeStep
+  type: RANGE_EXPR
+  default: "-1--10:-1"
+# Comma-separated values
+- name: CommaSeparated
+  type: RANGE_EXPR
+  default: "1,3,5,7"
+# Mixed ranges and values
+- name: MixedRangesAndValues
+  type: RANGE_EXPR
+  default: "1-10,20-30:2,42"
+# Multiple ranges
+- name: MultipleRanges
+  type: RANGE_EXPR
+  default: "0-3:3,5-10:5,12,13,14,15"
+# Ranges out of order (parser normalizes)
+- name: OutOfOrder
+  type: RANGE_EXPR
+  default: "20-29,0-9,10-19"
+# Whitespace (parser ignores)
+- name: WithWhitespace
+  type: RANGE_EXPR
+  default: " 0 - 1 : 1, 2 - 100 : 1"
+# Large values
+- name: LargeValues
+  type: RANGE_EXPR
+  default: "9999999"
+# UI controls
+- name: WithLineEdit
+  type: RANGE_EXPR
+  default: "1-10"
+  userInterface:
+    control: LINE_EDIT
+    label: Frame Range
+- name: WithHidden
+  type: RANGE_EXPR
+  default: "1-10"
+  userInterface:
+    control: HIDDEN
+# Length constraints
+- name: WithLengthConstraints
+  type: RANGE_EXPR
+  default: "1-100"
+  minLength: 1
+  maxLength: 1024
+steps:
+- name: Step1
+  script:
+    actions:
+      onRun:
+        command: python
+        args:
+        - "-c"
+        - "print()"

conformance-tests/2023-09/EXPR/job_templates/2.11--list-string-item-not-in-allowed.invalid.yaml

@@ -0,0 +1,19 @@
+specificationVersion: jobtemplate-2023-09
+extensions:
+- EXPR
+name: TestJob
+parameterDefinitions:
+- name: Items
+  type: LIST[STRING]
+  default: ["x"]
+  item:
+    allowedValues: ["a", "b", "c"]
+steps:
+- name: Step1
+  script:
+    actions:
+      onRun:
+        command: python
+        args:
+        - "-c"
+        - "print()"

conformance-tests/2023-09/EXPR/job_templates/2.11--list-string-item-too-long.invalid.yaml

@@ -0,0 +1,19 @@
+specificationVersion: jobtemplate-2023-09
+extensions:
+- EXPR
+name: TestJob
+parameterDefinitions:
+- name: Items
+  type: LIST[STRING]
+  default: ["abcdef"]
+  item:
+    maxLength: 3
+steps:
+- name: Step1
+  script:
+    actions:
+      onRun:
+        command: python
+        args:
+        - "-c"
+        - "print()"

conformance-tests/2023-09/EXPR/job_templates/2.11--list-string-item-too-short.invalid.yaml

@@ -0,0 +1,19 @@
+specificationVersion: jobtemplate-2023-09
+extensions:
+- EXPR
+name: TestJob
+parameterDefinitions:
+- name: Items
+  type: LIST[STRING]
+  default: [""]
+  item:
+    minLength: 1
+steps:
+- name: Step1
+  script:
+    actions:
+      onRun:
+        command: python
+        args:
+        - "-c"
+        - "print()"

conformance-tests/2023-09/EXPR/job_templates/2.11--list-string-param.yaml

@@ -0,0 +1,90 @@
+specificationVersion: jobtemplate-2023-09
+extensions:
+- EXPR
+name: TestJob
+parameterDefinitions:
+# Minimal
+- name: Minimal
+  type: LIST[STRING]
+# With default
+- name: WithDefault
+  type: LIST[STRING]
+  default: ["a", "b", "c"]
+# Empty default
+- name: EmptyDefault
+  type: LIST[STRING]
+  default: []
+# Single element
+- name: SingleElement
+  type: LIST[STRING]
+  default: ["only"]
+# Long list
+- name: LongList
+  type: LIST[STRING]
+  default: ["a","b","c","d","e","f","g","h","i","j","k","l","m","n","o","p","q","r","s","t"]
+# Length constraints
+- name: WithMinMax
+  type: LIST[STRING]
+  default: ["a", "b"]
+  minLength: 1
+  maxLength: 50
+# Min only
+- name: MinOnly
+  type: LIST[STRING]
+  default: ["a"]
+  minLength: 0
+# Max only
+- name: MaxOnly
+  type: LIST[STRING]
+  default: ["a", "b", "c"]
+  maxLength: 100
+# Item constraints - allowedValues
+- name: ItemAllowed
+  type: LIST[STRING]
+  default: ["alpha", "beta"]
+  item:
+    allowedValues: ["alpha", "beta", "gamma"]
+# Item constraints - string length
+- name: ItemLength
+  type: LIST[STRING]
+  default: ["hi", "bye"]
+  item:
+    minLength: 1
+    maxLength: 10
+# Both list and item constraints
+- name: FullyConstrained
+  type: LIST[STRING]
+  default: ["hello", "world"]
+  minLength: 1
+  maxLength: 5
+  item:
+    allowedValues: ["hello", "world", "foo"]
+    minLength: 3
+    maxLength: 5
+# Description
+- name: WithDescription
+  type: LIST[STRING]
+  default: ["x"]
+  description: A list of string values
+# UI controls
+- name: WithLineEditList
+  type: LIST[STRING]
+  default: ["a"]
+  userInterface:
+    control: LINE_EDIT_LIST
+    label: Items
+    groupLabel: Options
+- name: WithHidden
+  type: LIST[STRING]
+  default: ["a"]
+  userInterface:
+    control: HIDDEN
+steps:
+- name: Step1
+  script:
+    actions:
+      onRun:
+        command: python
+        args:
+        - "-c"
+        - "print()"

conformance-tests/2023-09/EXPR/job_templates/2.11--list-string-scalar-not-list.invalid.yaml

@@ -0,0 +1,17 @@
+specificationVersion: jobtemplate-2023-09
+extensions:
+- EXPR
+name: TestJob
+parameterDefinitions:
+- name: Items
+  type: LIST[STRING]
+  default: notalist
+steps:
+- name: Step1
+  script:
+    actions:
+      onRun:
+        command: python
+        args:
+        - "-c"
+        - "print()"

conformance-tests/2023-09/EXPR/job_templates/2.11--list-string-too-long.invalid.yaml

@@ -0,0 +1,18 @@
+specificationVersion: jobtemplate-2023-09
+extensions:
+- EXPR
+name: TestJob
+parameterDefinitions:
+- name: Items
+  type: LIST[STRING]
+  default: ["a", "b", "c"]
+  maxLength: 2
+steps:
+- name: Step1
+  script:
+    actions:
+      onRun:
+        command: python
+        args:
+        - "-c"
+        - "print()"

conformance-tests/2023-09/EXPR/job_templates/2.11--list-string-too-short.invalid.yaml

@@ -0,0 +1,18 @@
+specificationVersion: jobtemplate-2023-09
+extensions:
+- EXPR
+name: TestJob
+parameterDefinitions:
+- name: Items
+  type: LIST[STRING]
+  default: []
+  minLength: 1
+steps:
+- name: Step1
+  script:
+    actions:
+      onRun:
+        command: python
+        args:
+        - "-c"
+        - "print()"