# Devkron Edge (dkle) Devkron Edge (`dkle`) es un runtime del lenguaje Devkron (DKL) pensado para **microservicios y conectores entre API HTTP**: recibir un webhook, validar su firma, transformar el JSON y entregarlo a otro sistema; exponer una API pequeña que consulta a otra; renovar tokens, guardar valores en memoria y responder en milisegundos. Es un solo ejecutable, sin dependencias, con su propio servidor HTTP/HTTPS, y como Devkron, los cambios se hacen en caliente: se modifica el `.dkl` y la siguiente petición ya usa la versión nueva. `dkle` es **gratuito** (no requiere licencia) y corre en Linux x64, Linux ARM64 y Windows x64. ## Qué es y qué no es Un programa para `dkle` es un programa DKL normal: misma sintaxis, mismas sentencias (`dkli.dkh`), mismas reglas de variables, registros, listas y JSON que Devkron 2.0. La diferencia está en la biblioteca: `dkle` trae **integrada** una biblioteca, la biblioteca Edge, con lo necesario para conectar dos extremos HTTP y procesar datos en memoria, y deja fuera todo lo demás. | Tiene | No tiene (a propósito) | |---|---| | Cadenas, números, fechas y zonas horarias, registros, listas, JSON y XML | Bases de datos (`dbr.dkh`) | | Petición recibida (`httpreq.*`) y respuesta (`httpres.*`) | Sistema de archivos (`file.*`, `dir.*`, subida de archivos) | | Cliente HTTP saliente (`http.*`), OAuth 2.0, JWT, HMAC, hashes, base64 | Interop con ensamblados (`#import`, `_map_function`) | | Caché en memoria y candados por sitio (`cache.*`, `threads.lock`) | Hilos y procesos (`threads.run`, `exec`) | | Configuración y secretos por sitio (`config.get`, `env.get`) | Programador de tareas interno (se usa el del sistema operativo) | | Bitácora JSON por línea (`log.*`) | Archivos estáticos (`dkle` solo ejecuta `.dkl`) | Por eso un conector de `dkle` arranca en unos 20 ms, ocupa poca memoria y no puede, ni por error, leer un archivo del servidor o la configuración de otro cliente. ## Cuándo usar dkle y cuándo Devkron 2.0 | Necesita | Use | |---|---| | Un conector o microservicio que habla HTTP con otros sistemas, sin base de datos | **dkle** | | Varios conectores de distintos clientes en un mismo servidor, aislados entre sí | **dkle** | | Un servicio pequeño en un equipo ARM (Raspberry Pi, servidores ARM en la nube) | **dkle** | | Una aplicación web con base de datos, sesiones, archivos, reportes o CRUD-L | [Devkron 2.0](/es/devkron/2.0/) | | Bibliotecas .NET, extensiones o bibliotecas de terceros (Excel, PDF, imágenes) | [Devkron 2.0](/es/devkron/2.0/) | Los dos se combinan bien: la aplicación con base de datos en Devkron 2.0 y, a un lado, los conectores con tiendas en línea, plataformas de pago o de entrega en `dkle`. ## Un vistazo Un sitio de `dkle` es una carpeta `web//` con programas `.dkl`. Este programa recibe un pedido en JSON y responde un resumen: ```dkl #include "dkli.dkh" #! program "pedido" { #include "edge.dkh" ref p = httpreq.json() ref items = field.obj(p, "line_items") ref partidas = list.create() total = 0 for i = 0; i < list.count(items) { ref it = list.atobj(items, i) importe = round(field.num(it, "price") * field.num(it, "quantity"), 2) total = total + importe ref r = record.create() r<"sku">:toupper(field.str(it, "sku")) r<"importe">:importe do list.addobj(partidas, r) } ref salida = record.create() salida<"pedido">:field.str(p, "id") salida<"total">:total salida<"partidas*">:partidas do httpres.json(salida) } ``` Con `dkle run` se prueba sin abrir ningún puerto (el ejemplo viene en la carpeta `ejemplo/` de la distribución): ``` $ dkle run --root . POST /pedidos -H "Content-Type: application/json" --body @pedido.json HTTP/1.1 200 OK Content-Length: 103 Content-Type: application/json;charset=utf-8 X-Powered-By: Devkron X-Request-Id: bdd756e86b7d8b2637f2e72a {"pedido":"1001","total":34.00,"partidas":[{"sku":"A-1","importe":21.0},{"sku":"B-2","importe":13.00}]} ``` Los números de DKL son decimales exactos, así que los importes no acumulan errores de redondeo. ## Rendimiento Medido con los mismos programas en el mismo equipo (Linux x64, 2 núcleos): - **Arranque:** unos 20 ms, contra 250 ms de Devkron 2.0. Importa en cada recarga y en las tareas que se lanzan desde `cron`. - **Conector** (leer un pedido JSON de 200 partidas, transformarlo, serializarlo y firmarlo con HMAC-SHA256): unos **6 ms por pedido**, algo menos que Devkron 2.0. - **Cálculo intensivo** (ciclos y aritmética): Devkron 2.0 es más rápido. `dkle` no está pensado para cálculo pesado; en un conector el tiempo lo pone, casi siempre, la red hacia los otros sistemas. ## Contenido | Página | Qué encontrará | |---|---| | [Instalación](/es/devkron/2.0/dkle/instalacion.md) | Descargas, verificación, Linux y Windows, el sitio de ejemplo, servicio de systemd y de Windows, actualizar | | [Configuración](/es/devkron/2.0/dkle/configuracion.md) | `dkle.json` (HTTP, HTTPS con Let's Encrypt o certificados propios, FastCGI, proxies) y `_config/.dkle.json` de cada sitio (secretos, límites, destinos permitidos, rutas locales, errores) | | [Programas y sitios](/es/devkron/2.0/dkle/programas.md) | Cómo se escribe un conector: rutas, petición y respuesta, errores, bitácora, configuración, caché y candados, llamadas salientes, tareas periódicas y concurrencia | | [Biblioteca Edge](/es/devkron/2.0/dkle/biblioteca.md) | Todas las funciones disponibles por grupo, con enlace a su referencia, y las que no están en Edge | | [Funciones nuevas](/es/devkron/2.0/dkle/funciones-nuevas.md) | Referencia y ejemplos de las funciones que agrega la biblioteca Edge | | [Línea de comandos](/es/devkron/2.0/dkle/linea-de-comandos.md) | `dkle serve`, `run`, `check`, `dkl` y `version`, el archivo de petición simulada y los códigos de salida | | [Despliegue](/es/devkron/2.0/dkle/despliegue.md) | Casos completos: HTTPS directo, detrás de nginx o IIS, varios clientes, un proceso por cliente, tareas periódicas y conectores dentro de la red del cliente con httptn | | [Devkron Edge y Devkron 2.0](/es/devkron/2.0/dkle/devkron2.md) | Qué es igual, qué cambia y cómo correr el mismo programa en los dos motores | ## Versión vigente **2.0.1**, parte de la línea Devkron 2.0 LTS, con su propio ciclo de versiones. Descárguela de [Induxsoft/Devkron-2-Releases](https://github.com/Induxsoft/Devkron-2-Releases/tree/main/2.0-LTS/dkle/2.0.1) (detalle en [Instalación](/es/devkron/2.0/dkle/instalacion.md)).