Lenguaje
Especificación DON v1
DON (Directive Object Notation) no define un esquema: solo la gramática de directivas, argumentos y bloques. Los nombres y el significado de cada directiva los define tu proyecto. Esta página resume la especificación v1; el texto completo, con casos límite y la tubería de codificación, está en el repositorio.
name arg1 arg2 ... {
childName arg
} # Application configuration
name "my-app"
server {
host "0.0.0.0"
port 8080 # Listen port
ssl true
} Elementos
Directivas
Un nombre y cero o más argumentos posicionales, separados por espacios. Una directiva termina con un salto de línea.
Bloques
Llaves { } con subdirectivas, con profundidad arbitraria. Tras la llave de cierre no puede haber más tokens en la misma línea.
Identifiers
Letras, dígitos, _ y símbolos como $ - / : [ ]. Distinguen mayúsculas de minúsculas.
Números
Enteros, decimales, hex (0x), octal (0o), binario (0b) y BigInt (sufijo n).
Strings
Comillas dobles o simples; el escape \ solo protege al delimitador.
Booleanos y null
true, false y null, siempre en minúscula.
Heredocs
<<< con descriptor opcional; el contenido se delimita por indentación.
Comentarios
# hasta el final de la línea y /* ... */ de varias líneas, sin anidar.
Extensión y tipo de medio
-
Los documentos DON deberían usar la extensión
.dono.donly. -
Cuando hace falta un tipo de medio (un encabezado
Content-Typeo la asociación de un editor), se sugiereapplication/x-donly. No está registrado en IANA: es solo una convención para herramientas.
Reglas generales
- La indentación no es significativa, salvo en los heredocs.
-
Un nombre de directiva es obligatorio antes de
{. - Se pueden repetir directivas con el mismo nombre en el mismo nivel.
- El parser procesa las directivas en orden, lo que permite que un plugin las sobrescriba o las componga de forma incremental.