kdl-nim

KDL Nim implementation.

Installation

nimble install kdl

Or directly from this repository:

nimble install https://github.com/Patitotective/kdl-nim

Features

• Streams support
• Compile-time parsing support
• Decoder/Desializer
• Encoder/Serializer
• JSON-in-KDL (JiK)
• XML-in-KDL (Xik)
• Prefs

Overview

import kdl

var doc = parseKdl("""
// Nodes can be separated into multiple lines
title \
  "Some title"


// Files must be utf8 encoded!
smile (emoji)"😁" {
  upside-down (emoji)"🙃"
}

// Instead of anonymous nodes, nodes and properties can be wrapped
// in "" for arbitrary node names.
"!@#$@$%Q#$%~@!40" "1.2.3" "!!!!!"=true

// The following is a legal bare identifier:
foo123~!@#$%^&*.:'|?+ "weeee"

// And you can also use unicode!
ノード　お名前="☜(ﾟヮﾟ☜)"

// kdl specifically allows properties and values to be
// interspersed with each other, much like CLI commands.
foo bar=true "baz" quux=false 1 2 3
""") # You can also read files using parseKdlFile("file.kdl")

# Nodes are represented like:
# type KdlNode* = object
#   tag*: Option[string]
#   name*: string
#   args*: seq[KdlVal]
#   props*: Table[string, KdlVal]
#   children*: seq[KdlNode]

assert doc[0][0].isString() # title "Some title"

assert doc[1][0] == "😁" # smile node
assert doc[1][0].tag.isSome and doc[1][0].tag.get == "emoji" # Type annotation
assert doc[1].children[0][0] == "🙃" # smile node's upside-down child

assert doc[2].name == "!@#$@$%Q#$%~@!40"

assert doc[^1]["quux"] == false

doc[0][0].setString("New title")

# toKdlNode is a macro that facilitates the creation of `KdlNode`s, there's also toKdl (to create documents) and toKdlVal
doc[1].children[0] = toKdlNode: sunglasses("😎"[emoji], 3.14)

assert $doc[1].children[0] == "\"sunglasses\" (\"emoji\")\"😎\" 3.14"

assert doc[1].children[0][1].get(uint8) == 3u8 # Converts 3.14 into an uint8

doc[^1]["bar"].setTo(false) # Same as setBool(false)

doc.writeFile("doc.kdl")

Docs

Documentation is live at https://patitotective.github.io/kdl-nim/.

TODO

• Implement KDL schema language.
• Implement KDL query language.
• Support OrderedTables

About

• GitHub: https://github.com/Patitotective/kdl-nim.
• Discord: https://discord.gg/U23ZQMsvwc.
• Docs: https://patitotective.github.io/kdl-nim/.

Contact me:

• Discord: Patitotective#0127.
• Twitter: @patitotective.
• Email: [email protected].