# Archivos, carpetas, línea de comandos y procesos Funciones de `functions.dkh` para leer y escribir archivos de texto y binarios, manejar carpetas y rutas, leer los argumentos de un programa de consola y ejecutar programas del sistema. Las rutas pueden ser absolutas o relativas al directorio de trabajo del proceso (en FastCGI, el del servicio). En Linux use `/`; en Windows se aceptan `\\` (escapada en la cadena) y `/`. ## Leer y escribir archivos | Función | Qué hace | |---|---| | `file.wtext(archivo, texto)` | Escribe el texto en UTF-8 **sin BOM**; crea o sobrescribe el archivo | | `file.wtexte(archivo, texto, codificación)` | Igual, con la codificación indicada (`utf8`, `unicode`, `ascii`, `uft8bom`… ver [nombres](/es/devkron/2.0/bibliotecas/motor/functions/codificacion.md)) | | `file.rtext(archivo)` | Devuelve el contenido leído como UTF-8 | | `file.rtexte(archivo, codificación)` | Devuelve el contenido con la codificación indicada | | `file.rbytes(archivo)` | Devuelve una referencia al arreglo de bytes del archivo | | `file.wbytes(archivo, bytes)` | Escribe un arreglo de bytes; crea o sobrescribe | | `file.exists(archivo)` | `@true` si el archivo existe | | `file.len(archivo)` | Tamaño en bytes | | `file.copy(origen, destino)` | Copia; **siempre sobrescribe** el destino | | `file.delete(archivo)` | Elimina el archivo; si no existe no hace nada | | `file.newer(f1, f2)` | 1 si `f1` es más reciente, 2 si lo es `f2`, 0 si tienen la misma fecha de modificación, -1 si `f1` no existe, -2 si `f2` no existe | > `file.copy` recibe dos argumentos y siempre sobrescribe. La página 1.x describía un tercer argumento `sobreescribir` que no existe en `functions.dkh`. ## Nombres y rutas | Función | Devuelve | Para `/datos/reportes/ventas.csv` | |---|---|---| | `file.name(ruta)` | Nombre con extensión | `ventas.csv` | | `file.justname(ruta)` | Nombre sin extensión | `ventas` | | `file.extension(ruta)` | Extensión con punto | `.csv` | | `dir.name(ruta)` | La carpeta que contiene la ruta | `/datos/reportes` | | `path.concat(r1, r2)` | Las dos partes unidas con un solo separador; usa `\` si alguna parte ya lo usa | `path.concat("/tmp/", "/datos.txt")` → `/tmp/datos.txt` | | `dir.struct(ruta)` | Lista de cadenas con cada carpeta de la ruta, de la raíz hacia adentro | ver ejemplo | ## Carpetas | Función | Qué hace | |---|---| | `dir.exists(carpeta)` | `@true` si existe | | `dir.create(carpeta)` | Crea la carpeta **y las intermedias** que falten; devuelve un objeto `DirectoryInfo` | | `dir.ensure(carpeta)` | Crea la carpeta solo si no existe | | `dir.delete(carpeta)` | Elimina una carpeta **vacía** (si tiene contenido es error) | | `list.files(carpeta, filtro)` | Lista de cadenas con las rutas completas de los archivos que cumplen el filtro (`*`, `*.csv`, `factura_*.xml`); no entra en subcarpetas | | `list.dirs(carpeta)` | Lista de cadenas con las rutas completas de las subcarpetas | Para copiar carpetas completas, búsqueda recursiva, mover o temporales use [fs.dkh](/es/devkron/2.0/bibliotecas/estandar/fs.md). ## Ejemplo ```dkl #include "dkli.dkh" #! program "archivos" { #include "functions.dkh" #include "serialize.dkh" base = "/tmp/dkdoc/salida" do dir.ensure(base) do print(dir.exists(base)) ruta = path.concat(base, "reportes/2026") do print(ruta) do dir.create(ruta) archivo = path.concat(ruta, "ventas.csv") do file.wtext(archivo, "sku,total\nP-01,300\n") do print(file.exists(archivo)) do print(file.len(archivo)) do print(file.rtext(archivo)) do print(file.name(archivo) + " | " + file.justname(archivo) + " | " + file.extension(archivo) + " | " + dir.name(archivo)) copia = path.concat(ruta, "ventas-copia.csv") do file.copy(archivo, copia) do print(file.newer(archivo, copia)) do print(file.newer(archivo, "/tmp/dkdoc/no-existe.txt")) ref bytes = file.rbytes(archivo) do file.wbytes(path.concat(ruta, "ventas.bin"), bytes) ref archs = list.files(ruta, "*.csv") do print(list.count(archs)) ref dirs = list.dirs(path.concat(base, "reportes")) do print(to.json(dirs)) ref estructura = dir.struct(archivo) go foreach.lstr(value:v) with(estructura) { do print(v) } do file.delete(copia) do print(file.exists(copia)) do dir.delete(base) exception { do print(last_error()) do clear_exceptions() } ref todos = list.files(ruta, "*") go foreach.lstr(value:f) with(todos) { do file.delete(f) } do dir.delete(ruta) do dir.delete(path.concat(base, "reportes")) do dir.delete(base) do print(dir.exists(base)) } ``` ```text 1 /tmp/dkdoc/salida/reportes/2026 1 19 sku,total P-01,300 ventas.csv | ventas | .csv | /tmp/dkdoc/salida/reportes/2026 0 -2 2 ["/tmp/dkdoc/salida/reportes/2026"] / /tmp /tmp/dkdoc /tmp/dkdoc/salida /tmp/dkdoc/salida/reportes /tmp/dkdoc/salida/reportes/2026 0 {1} Error en 'dir.delete. (Directory not empty : '/tmp/dkdoc/salida'Exception has been thrown by the target of an invocation.) [archivos.dkl][Ln= 36] 0 ``` `go … with(…)` recibe una variable, no una llamada: guarde primero el resultado (`ref todos = list.files(…)`). ## Línea de comandos y procesos | Función | Qué hace | |---|---| | `commandline(separador)` | Registro con los argumentos de `dkl programa.dkl …` como pares `clave=valor` (con el separador indicado). Todos los valores son cadenas. Incluye también el nombre del programa y las opciones de `dkl` como claves con valor vacío | | `commandlinen(separador, numéricas)` | Igual, y convierte a número las claves listadas en `numéricas` (separadas por comas); un valor no numérico queda en 0 | | `exec(ejecutable, argumentos, esperar)` | Ejecuta un programa. Con `esperar` = `@true` espera hasta `@exec_timeout` milisegundos y devuelve su salida estándar; con `@false` lo lanza y devuelve `""` | | `@exec_timeout` | Variable global con el tiempo máximo de espera de `exec`, en milisegundos (180000 por omisión) | Programa `reporte.dkl` ejecutado como `dkl reporte.dkl -hide-log dias=30 empresa=Demo limite=x`: ```dkl #include "dkli.dkh" #! program "args" { #include "functions.dkh" #include "serialize.dkh" ref linea = commandline("=") do print(to.json(linea)) ref linean = commandlinen("=", "dias,limite") do print(to.json(linean)) do print(field.num(linean, "dias") + 1) } ``` ```text {"reporte.dkl":"","-hide-log":"","dias":"30","empresa":"Demo","limite":"x"} {"reporte.dkl":"","-hide-log":"","dias":30,"empresa":"Demo","limite":0} 31 ``` Lea los argumentos con `field.dstr`/`field.dnum` para dar valores predeterminados: `dias = field.dnum(args, "dias", 7)`. Ejecutar un programa del sistema: ```dkl #include "dkli.dkh" #! program "util" { #include "functions.dkh" salida = exec("/bin/echo", "hola desde el sistema", @true) do print(trim(salida)) do print(@exec_timeout) @exec_timeout = 5000 r = exec("/bin/ls", "/no-existe", @true) do print("[" + r + "]") do exec("/bin/no-existe", "", @true) exception { do print(last_error()) do clear_exceptions() } } ``` ```text hola desde el sistema 180000 [] {1} Error en '_exec. (An error occurred trying to start process '/bin/no-existe' with working directory '/tmp/dkdoc'. No such file or directoryException has been thrown by the target of an invocation.) [functions.dkh][Ln= 431] ``` - `exec` **no** lanza error cuando el programa termina con error o escribe en la salida de error (el `ls` de arriba): solo devuelve lo que escribió en la salida estándar. Si necesita saber si falló, revise la salida o haga que el programa escriba un resultado. La documentación 1.x decía lo contrario. - Sí lanza error si el ejecutable no existe o no se puede iniciar. - Los argumentos van en una sola cadena; ponga entre comillas los que tengan espacios. - `exec` corre con el usuario del proceso de Devkron (en FastCGI, el del servicio). No le pase datos recibidos del usuario sin validarlos. ## Errores típicos | Mensaje | Causa | Solución | |---|---|---| | `Could not find file '…'.` | `file.rtext`/`file.rbytes` de un archivo inexistente | Compruebe con `file.exists` | | `Could not find a part of the path '…'.` | `file.wtext` en una carpeta que no existe | `dir.ensure(dir.name(archivo))` antes de escribir | | `Directory not empty` | `dir.delete` de una carpeta con contenido | Borre su contenido antes, o use `fs.dkh` | | `Access to the path '…' is denied.` | El usuario del proceso no tiene permisos | Revise el dueño y los permisos de la carpeta | | `An error occurred trying to start process` | `exec` con un ejecutable inexistente | Use la ruta completa del ejecutable | [Regresar a functions.dkh](/es/devkron/2.0/bibliotecas/motor/functions/)