berkus
/
kdl
mirror of https://github.com/kdl-org/kdl.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Include results of discussion on KDL Data Model

This commit is contained in:
Jakob Voss 2021-10-12 10:25:49 +02:00
parent 668c6d334c
commit 43f16802d3
1 changed files with 12 additions and 13 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
MODEL.md
View File

@ -33,29 +33,31 @@ circular structures.
### Node ### Node
A node consists of five elements: A node consists of four mandatory and one optional elements:
* a **name** being a Unicode string * a **name** being a Unicode string
* a **tag** being a Unicode string * an optional **tag** being a Unicode string (the empty string tag is distinct from no tag)
* a sequence of **arguments**, each being a [value](#value) * a sequence of **arguments**, each being a [value](#value)
* a set of **properties**, each consisting of * a map of **properties**, each consisting of
* a name being Unicode string unique within the set * a key being a Unicode string unique within the map
* a [value](#value) * a [value](#value)
* a list of **children** being a [document](#document) * a sequence of **children** being a [document](#document)
### Value ### Value
A value consists of two elements: A value consists of one of:
* a **tag** being a Unicode string
and one one of:
* a Unicode string * a Unicode string
* a **number**, being an arbitrary-precision, base-10 decimal number value * a **number**, being an arbitrary-precision, base-10 decimal number value
* a **boolean**, being one of the special values *true* and *false* * a **boolean**, being one of the special values *true* and *false*
* the special value *null* * the special value *null*
and
* an optional a **tag** being a Unicode string (the empty string tag is distinct from no tag)
The data model does not limit the use of tags to specific types of values.
## Implementation Notes ## Implementation Notes
### Extensions to the data model ### Extensions to the data model
@ -68,9 +70,6 @@ data model, such as:
* Comments and precise details of whitespace and node terminators. * Comments and precise details of whitespace and node terminators.
* Whether a tag is the empty string (`("")node)` or missing. KDL syntax allows
nodes and values with and without tag. Both are identical in KDL data model.
* Whether a node had an empty child list (`node {}`) or no child list at all. * Whether a node had an empty child list (`node {}`) or no child list at all.
KDL syntax allows both. KDL data model considers these identical. KDL syntax allows both. KDL data model considers these identical.