# Primeros pasos con DKL El lenguaje Devkron, o simplemente **DKL** (*Devkron Language*), es a la vez: - **declarativo**: todo programa es un árbol que se traduce a XML o HTML tal como se escribe; - **imperativo y procedural**: con `#include "dkli.dkh"` y `#!` el mismo árbol se interpreta como sentencias al estilo de C (variables, ciclos, funciones, excepciones). Su sintaxis se parece a C, así que resulta familiar para casi cualquier programador. Incluye además directivas para **definir sintaxis propia** (`#def`, `#pattern`), de modo que el lenguaje se adapta a cada necesidad. De hecho, toda la sintaxis imperativa de DKL está definida con esas directivas en el archivo `dkli.dkh`. DKL es de propósito general: se usa para construir sitios y servicios web (páginas, API JSON, sistemas con base de datos), procesos por lotes, tareas de consola, integraciones con otros sistemas y reportes, y para generar XML a partir de bases de datos. Devkron 2.0 LTS es una sola distribución autónoma para Linux x64 y Windows x64, que no requiere instalar nada más: el mismo ejecutable `dkl` corre programas de consola y sirve como servidor FastCGI. Vea [Instalación](/es/devkron/2.0/instalacion/). ## Su primer programa Guarde este código como `hola.dkl`: ```dkl #include "dkli.dkh" #! program "hola" { #include "functions.dkh" do print("Hola mundo") } ``` Ejecútelo desde la terminal (Linux) o PowerShell (Windows): ```bash ./dkl /home/usuario/ejemplos/hola.dkl -hide-log ``` ```powershell .\dkl.exe C:\ejemplos\hola.dkl -hide-log ``` Salida: ```text Hola mundo ``` Línea por línea: | Línea | Qué hace | |---|---| | `#include "dkli.dkh"` | Incorpora los patrones de la sintaxis imperativa. Va siempre al principio de un programa imperativo. | | `#!` | Cambia al contexto imperativo para lo que sigue. | | `program "hola"` | Nodo raíz del programa y contenedor del código. | | `#include "functions.dkh"` | Biblioteca de funciones de propósito general (cadenas, listas, registros, archivos…). Se incluye **dentro** del nodo raíz. | | `do print(...)` | Llama a la función incorporada `print`. Una función que no se asigna se llama con `do` (o `call`). | Sin `-hide-log`, `dkl` imprime además una bitácora con la hora de inicio, el identificador de ejecución, la hora de fin y la duración: ```text Iniciado 10/27/2026 17:19:53 ID de ejecución: 8d8891c3947141bbb2a09b77165ce76c Hola mundo Terminado 10/27/2026 17:19:53 00:00:00.0637920 ``` ## Bibliotecas de funciones Además de las [funciones incorporadas](/es/devkron/2.0/lenguaje/funciones-incorporadas/), que no requieren nada, hay bibliotecas que se incluyen dentro del nodo raíz: ```dkl #include "dkli.dkh" #! program "ejemplo" { #include "functions.dkh" #include "serialize.dkh" #include "dbr.dkh" #include "webcl.dkh" // código del programa } ``` Por convención las bibliotecas usan la extensión `.dkh`, aunque son código DKL como cualquier otro. Vea [Bibliotecas](/es/devkron/2.0/bibliotecas/). > Si incluye `functions.dkh` **antes** de `dkli.dkh` o fuera del nodo raíz, el análisis falla con `{109} Error de sintaxis [...functions.dkh] [109] - Definición de elemento incompleta`. Vea [Errores frecuentes](/es/devkron/2.0/lenguaje/errores-frecuentes.md). ## Generar XML Un archivo DKL sin `#!` es puramente declarativo: cada elemento se traduce a XML. Guarde esto como `personas.dkl`: ```dkl Personas(cantidad="3") { Persona(nombre="Juan") Persona(nombre="Pedro") Persona(nombre="Camila") } ``` ```text ``` Todo programa DKL produce un árbol con **un único nodo raíz**. Si el resultado tiene dos raíces (`uno{} dos{}` en el nivel superior), `dkl` termina con `No hay un elemento raíz`. En la página siguiente, [Símbolos primitivos](/es/devkron/2.0/lenguaje/declarativo/simbolos-primitivos.md), y en [Elementos y atributos](/es/devkron/2.0/lenguaje/declarativo/elementos-y-atributos.md) se explica la sintaxis completa. ## Opciones de la línea de comandos ```text dkl programa.dkl [opciones] ejecuta un programa (la extensión .dkl se puede omitir) dkl -fastcgi [configuracion.json] inicia el servidor FastCGI dkl -license muestra la licencia instalada dkl -crypto archivo [destino] [codificación] cifra un archivo fuente ``` Todas las opciones de ejecución son opcionales; el único argumento obligatorio es el programa. | Opción | Efecto | |---|---| | `-hide-log` | No imprime `Iniciado…`, `ID de ejecución…`, `Terminado…` ni la duración. | | `-hide-output` | No imprime en la consola el árbol XML resultante. | | `-hide-critical` | Oculta los mensajes de error de la bitácora. | | `-ninja` | Oculta toda salida de la bitácora y del árbol (`-hide-log` + `-hide-output`). | | `-output:archivo` | Escribe el árbol XML en un archivo (UTF-8 con BOM por omisión). `@id` en el nombre se reemplaza por el identificador de ejecución. En 2.0 acepta rutas de Windows con `:` (`-output:C:\salida\x.xml`). | | `-log:archivo` | Escribe la bitácora en un archivo. | | `-id:valor` | Identificador de la ejecución; si no se indica, se genera un GUID. | | `-encoding:codificación` | Codificación de los fuentes y de `-output:`: `default`, `utf8`, `utf8bom`, `utf7`, `utf32`, `unicode`, `ascii`, `not-set`. | | `-parse` | Analiza el archivo y muestra el árbol XML **sin** ejecutar la parte imperativa. Sirve para validar la sintaxis. | | `-scandeps` / `-deps` | Muestra los archivos que se incluyen con `#include`. | | `-skip-not-found-includes` | Con `-scandeps`, no marca error por los `#include` que no existen. | | `-skip-all-includes` | Con `-scandeps`, no analiza el contenido de los archivos incluidos. | | `-stepbystep` | Ejecución paso a paso (depuración). | | `-debugfile:archivo` | Con `-stepbystep`, limita la ejecución paso a paso a ese archivo. | | `-culture:xx-XX` | (2.0) Cultura de presentación de `format`, fechas y marcas con formato. Vea [Cultura](/es/devkron/2.0/introduccion/). | | `-compile`, `-native-cache-dir:ruta`, `-tree-output`, `-tree-cache`, `-tree-cache-dir:ruta` | (2.0) Compilación a nativo y cachés. Vea [Rendimiento](/es/devkron/2.0/introduccion/). | Ejemplo: guardar el XML de un programa en un archivo sin mostrar nada en la consola. ```bash ./dkl /home/usuario/ejemplos/personas.dkl -ninja -output:/home/usuario/ejemplos/personas.xml ``` ### Código de salida En 2.0, `dkl` termina con código **0** si el programa terminó bien (también si un error se capturó con `exception`) y con **1** si hubo un error no manejado, un error de sintaxis, un archivo inexistente o un argumento inválido. En 1.x siempre era 0. Así puede usarlo en scripts: ```bash if ! ./dkl /home/usuario/ejemplos/hola.dkl -hide-log; then echo "El programa falló" fi ``` Esto también vale para `-parse`: con un error de sintaxis termina con 1. ### Argumentos para su programa El programa recibe la línea de comando completa en `@_run_settings`; la forma cómoda de leerla es la función `commandline` de `functions.dkh`. Vea [Bibliotecas](/es/devkron/2.0/bibliotecas/). ### Cifrar el código fuente `dkl -crypto archivo.dkl` crea `archivo.dkl.crypto`, que se ejecuta igual que el original (`dkl archivo.dkl.crypto`). Sirve para entregar programas sin el código legible. ## El archivo dkli.dkh `dkli.dkh` contiene los patrones (`#pattern`) que definen la sintaxis imperativa: `if`, `for`, `new`, `do`, las funciones `::`, etc. Por eso debe incluirse al principio de todo programa que use el contexto imperativo. Viene en la distribución junto a `dkl`, igual que `functions.dkh`, `serialize.dkh`, `dbr.dkh` y `webcl.dkh`. ## Siguientes pasos - [Símbolos primitivos](/es/devkron/2.0/lenguaje/declarativo/simbolos-primitivos.md): identificadores, cadenas, comentarios. - [Variables](/es/devkron/2.0/lenguaje/imperativo/variables.md): el primer tema del lenguaje imperativo. - [Guía de aprendizaje](/es/devkron/2.0/lenguaje/guia-de-aprendizaje.md): un recorrido ordenado por todo el lenguaje. - [Depuración](/es/devkron/2.0/instalacion/depuracion.md): `dkl-debug` y la extensión de VS Code y Cursor para depurar desde el editor.