# fs.dkh: carpetas y archivos `fs.dkh` complementa las funciones `file.*` y `dir.*` de `functions.dkh` con lo que hoy cada programa escribe a mano: copiar y borrar carpetas completas, medir su tamaño, buscar archivos en subcarpetas, mover, agregar texto al final de un archivo y obtener rutas temporales. Viene con la distribución de Devkron 2.0. Incluya antes `functions.dkh`. ## Cuándo usarla - Crear un sitio o un paquete copiando una carpeta plantilla (`dir.copy`). - Revisar cuánto ocupa la carpeta de un cliente o las bitácoras (`dir.size`). - Procesar todos los XML de una carpeta y sus subcarpetas (`dir.files_deep`). - Generar un archivo intermedio y moverlo al terminar (`file.temp`, `file.move`). ```dkl #include "fs.dkh" ``` ## Funciones | Función | Devuelve | Descripción | |---|---|---| | `dir.copy(origen, destino)` | — | Copia la carpeta con todo su contenido; crea `destino` y sobrescribe los archivos que ya estén | | `dir.size(carpeta)` | número | Bytes de todos los archivos, con subcarpetas | | `dir.files_deep(carpeta, patron)` | lista | Rutas de los archivos que cumplen `patron` (`"*.xml"`) en la carpeta y sus subcarpetas, ordenadas | | `dir.delete_deep(carpeta)` | — | Borra la carpeta con todo su contenido; no hace nada si no existe; no borra la raíz del disco | | `file.move(origen, destino, sobrescribir)` | — | Mueve o renombra; con `sobrescribir` en `@false` falla si el destino existe | | `file.append(archivo, texto)` | — | Agrega `texto` al final (UTF-8); crea el archivo si no existe | | `file.temp(extension)` | cadena | Ruta nueva en la carpeta temporal con esa extensión (`"csv"` o `".csv"`); **no crea el archivo** | | `file.size(archivo)` | número | Tamaño en bytes | | `file.mtime(archivo)` | fecha | Fecha de última modificación, `AAAAMMDD.HHMMSS` en la hora del servidor | | `path.temp()` | cadena | Carpeta temporal del sistema (`/tmp/` en Linux) | `dir.copy` sustituye a `copydir` de `dkl-web/createsite.dkl` (que sigue funcionando) y no imprime nada. Las funciones de `functions.dkh` (`file.exists`, `file.delete`, `file.rtext`, `file.wtext`, `list.files`, `dir.create`, `dir.ensure`…) no cambian. ## Ejemplo: reporte de una carpeta de XML Con la carpeta `cfdi/2026-10/` (`F-1.xml` y `dia27/F-2.xml`): ```dkl #include "dkli.dkh" #! program "carpeta cfdi" { #include "functions.dkh" #include "fs.dkh" carpeta = "cfdi" ref xmls = dir.files_deep(carpeta, "*.xml") do print(str(list.count(xmls)) + " XML, " + str(dir.size(carpeta)) + " bytes en total") reporte = file.temp("txt") for i=0; i 20260101)) do dir.delete_deep("copia") do print("Existe la copia: " + str(dir.exists("copia"))) do file.move("no-existe.txt", "otro.txt", @false) exception { do print(last_error()) } } ``` Salida (la ruta del último mensaje se acortó a `/srv/app/`; el mensaje real trae la ruta completa de la carpeta de trabajo): ``` 2 XML, 11 bytes en total cfdi/2026-10/F-1.xml 5 bytes cfdi/2026-10/dia27/F-2.xml 6 bytes Temporales en: /tmp/ Copiados: 2 fecha: 1 Existe la copia: 0 {1} Error en 'file._move. (Could not find file '/srv/app/no-existe.txt'.Exception has been thrown by the target of an invocation.) [fs.dkh][Ln= 18] ``` ## Errores | Mensaje | Causa | |---|---| | `dir.copy: no existe la carpeta '…'` | La carpeta de origen no existe | | `dir.files_deep: no existe la carpeta '…'` / `dir.size: …` | La carpeta no existe | | `dir.delete_deep: la carpeta está vacía` / `… no se borra la raíz del disco` | Ruta vacía o raíz | | `file.size: no existe el archivo '…'` / `file.mtime: …` | El archivo no existe | | `Error en 'file._move. (Could not find file …)` | `file.move` con un origen inexistente | | `Error en 'file._move. (The file '…' already exists.)` | `file.move` con `sobrescribir` en `@false` y el destino existe | Los errores de `file.move` y `file.append` vienen directamente de .NET, en inglés. ## Advertencias - `file.temp` solo da la ruta. Si la usa, bórrela o muévala al terminar: la carpeta temporal no se limpia sola. - Para bitácoras con varias peticiones a la vez use [log.dkh](/es/devkron/2.0/bibliotecas/estandar/log.md) en vez de `file.append` directo. - **No arme rutas con datos del cliente** (`"subidas/" + httpreq.arg("nombre")`): un nombre como `../../web/sitio/index.dkl` saldría de la carpeta. Quédese solo con el nombre con `file.name()` o genere usted el nombre. - `dir.delete_deep` no pide confirmación. Revise la ruta antes de llamarla, sobre todo si se arma con variables. - `dir.files_deep` sobre una carpeta con cientos de miles de archivos tarda y ocupa memoria. Acote la búsqueda.