yamltypes 1.0

Root Node

the meta yaml file must describe the root type, which will snowball all the nested type checks

root:
  type: dict
  kids:
     param1:
     type: int
     param2:
     type: string

will match:

param1: 1
param2: stringvalue

imports Node

The meta yaml file can use types described in another file. For that, it will import a list of .types.yaml files.

A .types.yaml is a yaml file defining a map of named types. ex:

foo:
    type: string
    values: [bar]

can be used in a myconfig.meta.yaml:

imports:
    - foo.type.yaml
root:
    type: dict
    kids:
        foo:
            type: listoffoos

Base types

base types are:

int

an integer

string

a string

boolean

a true/false boolean

float

a floating point number

Compound types

A value of compound type is composed of several subtypes values or key/value:

dict

an associative array that has a defined list of childrens key

map

an associative array that has an arbitrary list childrens keys

list

a list of arbitrary values

set

a list that ensure member unicity (you cannot have several time the same value)

Specifying types of values

For map, list, set, it is possible to specify what type is expected as the values. The syntax is:

type: <compound_type>of<type>s

for example, following types are valid

type: mapofstrings
type: listofints
type: listofsetsofints

User defined types

You can specify a meta.yaml file defining the map of types, you can reuse inside your main meta.yaml file. e.g:

location:
    type: string
    values: [l1,l2,l3,l4,l5,l6]

This defines a location type, which is a string with 6 possible values.

types modifers

Each type can be associated with a number of modifiers, that will extend the number of specification you describe for it:

values:

a set of possible values that the attribute can take

name:

the name of the attribute as displayed in the UI

default:

The value the attribute takes if it is not defined explicitly

forbidden:

a python expression checking whether this attribute should not be defined in a particular configuration

required:

a python expression checking whether this attribute must be defined in a particular configuration

maybenull:

a python expression checking whether this attribute must be defined in a particular configuration