Language Overview

MICAL is a line-oriented configuration language designed for flat structures and readability. A MICAL file is a sequence of key-value entries. Scope nesting is defined by braces { }, not by indentation.

Key-Value Entries

Each line represents a single entry: a key followed by a space and a value.

host    localhost
port    8080
enabled true

{
  "host": "localhost",
  "port": 8080,
  "enabled": true
}

Keys

Keys come in two forms:

• Word key: any sequence of non-whitespace characters. name, server.port, -flag, 42 are all valid keys.
• Quoted key: a string enclosed in " or ', allowing spaces and empty keys.

name        hello
server.port 8080
"user name" Alice
""          empty-key

Values

The type of a value is determined by its content on the line.

• true / false → Boolean (only when the entire value is the keyword alone)
• Integer literal (e.g. 42, +1, -10) → Integer (only when the entire value is the literal alone)
• "..." / '...' → Quoted String (must be the sole value; trailing content is an error)
• | / > followed by newline → Block String
• Everything else → Line String (the rest of the line, as-is)

The fallback to Line String is intentional: anything that does not exactly match the typed forms is treated as a plain string.

flag  true
count 42
name  "Alice"
path  /usr/local/bin
text  10 items
note  true story

{
  "flag": true,
  "count": 42,
  "name": "Alice",
  "path": "/usr/local/bin",
  "text": "10 items",
  "note": "true story"
}

Note that 10 items is a Line String (not integer) and true story is a Line String (not boolean) because they contain trailing content.

Comments

Lines starting with # followed by a space (or nothing) are comments. There are no inline comments.

# This is a comment
key value # this is NOT a comment, it is part of the value

{
  "key": "value # this is NOT a comment, it is part of the value"
}

Prefix Blocks

Blocks group entries under a common key prefix. They do not create nested objects and do not insert any separator (such as .).

server {
    .host localhost
    .port 8080
}

{
  "server.host": "localhost",
  "server.port": 8080
}

Since no separator is inserted, omitting the . changes the result:

http_ {
    port 80
}

This produces the key http_port, equivalent to writing http_port 80.

A { is only recognized as starting a block when it is the last non-whitespace character on the line. Otherwise it is part of the value.

data { port 80 }

{
  "data": "{ port 80 }"
}

Block Strings

Multi-line string values use the | (literal) or > (folded) header. Indentation of the first content line defines the base indent, which is stripped.

description |
    MICAL is simple.
    It keeps your config clean.

{
  "description": "MICAL is simple.\nIt keeps your config clean.\n"
}

Chomping indicators (+ keep, - strip, default clip) control trailing newlines. See Block Strings for the full algorithm.