# Bibliotecas estándar nuevas Devkron 2.0 LTS trae, además de `functions.dkh`, `serialize.dkh`, `dbr.dkh` y `webcl.dkh`, bibliotecas estándar nuevas para lo que hoy cada programa resuelve a mano: hilos y caché, HTTP (cliente, petición y respuesta), URL, zip, fechas y zonas horarias, expresiones regulares y texto, hashes y JWT, OAuth, archivos y bitácoras. Esta sección es para el programador de Devkron que escribe servicios web, tareas de consola o integraciones con otros sistemas. ## Qué las distingue - **Vienen con la distribución.** Los encabezados (`.dkh`) y sus ensamblados (`Devkron.Ext.Threads.dll`, `Devkron.Ext.Http.dll`, `Devkron.Ext.Base.dll`) están en la carpeta de `dkl`; no se instala nada aparte. - **No dependen de componentes de otros autores.** Lo que depende de componentes de terceros (CSV, Excel, PDF, imágenes, lectura de HTML, Markdown) está en las [bibliotecas de terceros](/es/devkron/2.0/bibliotecas/terceros/), que se instalan aparte. - **No cambian lo existente.** `functions.dkh`, `serialize.dkh`, `webcl.dkh`, `dbr.dkh` y `dkl-web` siguen funcionando igual; estas bibliotecas agregan nombres nuevos y estandarizados. - **Se incluye solo lo que se usa**, siempre después de `functions.dkh` y `serialize.dkh`. `oauth.dkh` necesita además `threads.dkh`, `http.dkh`, `url.dkh` y `hash.dkh`. ```dkl #include "dkli.dkh" #! program "mi servicio" { #include "functions.dkh" #include "serialize.dkh" #include "threads.dkh" #include "http.dkh" #include "url.dkh" #include "zip.dkh" #include "time.dkh" #include "text.dkh" #include "hash.dkh" #include "oauth.dkh" #include "fs.dkh" #include "log.dkh" do print("Bibliotecas cargadas. Hoy es día " + str(date.weekday(date.now())) + " de la semana; " + str(threads.cpus()) + " procesadores") } ``` Salida (en un martes, en un equipo de 2 núcleos): ``` Bibliotecas cargadas. Hoy es día 2 de la semana; 2 procesadores ``` ## Contenido | Página | Encabezado | Para qué sirve | |---|---|---| | [Hilos, candados y caché](/es/devkron/2.0/bibliotecas/estandar/threads.md) | `threads.dkh` | Ejecutar programas en paralelo (`threads.pool`), candados con nombre para folios, caché en memoria del proceso (`cache.*`) | | [HTTP](/es/devkron/2.0/bibliotecas/estandar/http.md) | `http.dkh` | Cliente JSON, formularios, multipart y en paralelo; leer la petición recibida (`httpreq.*`) y armar la respuesta (`httpres.*`); Basic y Bearer | | [URL](/es/devkron/2.0/bibliotecas/estandar/url.md) | `url.dkh` | Partes de una URL, direcciones relativas, cadenas de consulta, codificación | | [Zip](/es/devkron/2.0/bibliotecas/estandar/zip.md) | `zip.dkh` | Crear, ampliar, extraer y listar archivos zip | | [Fechas y zonas horarias](/es/devkron/2.0/bibliotecas/estandar/time.md) | `time.dkh` | Sumar y restar tiempo, rangos de semana y mes, ISO 8601, tiempo Unix, zonas IANA | | [Texto](/es/devkron/2.0/bibliotecas/estandar/text.md) | `text.dkh` | Expresiones regulares, quitar acentos, *slugs*, redondeo comercial, escape de HTML | | [Hashes y JWT](/es/devkron/2.0/bibliotecas/estandar/hash.md) | `hash.dkh` | SHA-256, hashes de archivos, tokens aleatorios, comparación segura, JWT HS256 y RS256 (Google, Microsoft) | | [OAuth 2.0](/es/devkron/2.0/bibliotecas/estandar/oauth.md) | `oauth.dkh` | `client_credentials` (PayPal y otras API), inicio de sesión con PKCE (Google, Microsoft), `refresh` | | [Carpetas y archivos](/es/devkron/2.0/bibliotecas/estandar/fs.md) | `fs.dkh` | Copiar y borrar carpetas, tamaño, búsqueda recursiva, mover, agregar texto, temporales | | [Bitácoras](/es/devkron/2.0/bibliotecas/estandar/log.md) | `log.dkh` | Una línea por evento con fecha y nivel, un archivo por día | | [Ordenar listas](/es/devkron/2.0/bibliotecas/estandar/listx.md) | `listx.dkh` | Ordenar números, cadenas o registros por un campo e invertir listas, en su lugar | | [JSON con sangría](/es/devkron/2.0/bibliotecas/estandar/jsonx.md) | `jsonx.dkh` | `to.json_pretty`: JSON legible, con saltos de línea y sangría | | [Configuración y entorno](/es/devkron/2.0/bibliotecas/estandar/env.md) | `env.dkh` | Configuración del sitio (`_config/.dkle.json`) y variables de entorno, con valores por omisión; las mismas funciones que en Devkron Edge | `edge.dkh`, la biblioteca para escribir programas que corren igual en Devkron 2.0 y en Devkron Edge, se documenta en [Devkron Edge](/es/devkron/2.0/dkle/devkron2.md). ## Qué reemplazan | Antes (1.x o código propio) | Ahora | |---|---| | `dkl.async` (`async.runscript`, `async.wait`) | `threads.dkh`: además devuelve la salida y el error de cada hilo y aísla cada hilo | | `@http_context<"request/…">` y `@http_context<"response/…">` escritos a mano | `httpreq.*` y `httpres.*` | | `cookie.set` / `cookie.setw` de `dkl-web` | `httpres.cookie` / `httpres.cookie_raw` | | `htmlAttributesFromRec` de `dkl-web` | `html.attrs` | | `copydir` de `dkl-web/createsite.dkl` | `dir.copy` | | funciones `saveLog` de cada programa | `log.dkh` | | arreglos propios para escribir o copiar archivos en carpetas de red (SMB, NFS) en Linux | Ya no se necesitan: el motor 2.0 escribe y copia bien en SMB y NFS | Lo anterior sigue funcionando; para código nuevo use las bibliotecas de esta sección. ## Convenciones de todas - Los errores se lanzan como excepción DKL con mensaje en español y se atrapan con `exception { }` y `last_error()`. Cuando el error viene de una función .NET, el motor lo envuelve así: `{1} Error en 'función. (mensaje…Exception has been thrown by the target of an invocation.) [archivo][Ln= n]`. - Números y fechas siempre con cultura invariante (`1.5`, `2026-10-27`), sin importar la del servidor. - Las fechas son números `AAAAMMDD.HHMMSS`, como las de `ndatetime.*`, sin zona horaria. - Los registros que devuelven no distinguen mayúsculas en los nombres de campo. - **En una cadena DKL la barra invertida se escribe doble**: el patrón `\d+` se escribe `"\\d+"`. ## Advertencias comunes - **El caché, los candados, los tokens de OAuth y las llaves de JWKS son por proceso.** En el servidor FastCGI se comparten entre todas las peticiones y **entre todos los sitios** que atiende ese proceso, y se pierden al reiniciarlo. Con varios procesos, cada uno tiene los suyos. Use llaves con un prefijo propio del sitio. - **`httpreq.*` y `httpres.*` solo funcionan dentro del servidor FastCGI**, donde existe `@http_context`. - **El cliente `http.*` no reintenta.** Reintente usted solo las operaciones que se pueden repetir sin efectos. - **Credenciales fuera del código**: secretos de JWT, llaves privadas y secretos de OAuth se leen de archivos protegidos o de variables de entorno.