archivos · Referencia de comando
qzx listFiles
Qué hace
Enumera archivos de un directorio con comodines y búsqueda recursiva.
Madurez del comando: Alpha
Disponible para uso real y retroalimentación mientras su interfaz y comportamiento todavía pueden evolucionar. Esta es la evaluación actual del checkout de desarrollo. Cada futuro tag inmutable de release conservará la evaluación exacta incluida en esa versión. Disponible en PyPI 0.2.2.0.8. La documentación corresponde al checkout alpha 0.2.2.0.8.
Comportamiento y protecciones integradas
Inspecciona sin cambiar el estado
Ejecución directa para esta operación
Funciona sin invocar programas nativos
Funciona sin usar la red
Diseñado para funcionar sin elevación
Esta clasificación de seguridad fue revisada por OpenAI GPT-5.6 Pro contra el digest de implementación sha256:9ed75febb115f7e7e659a5047df5f47a43e95d5c7e32d3f5b1c96e4f85b27eff el 2026-08-25.
Sintaxis exacta
qzx listFiles [directory_path] [pattern] [recursive] --jsonParámetros
Desliza o usa la barra horizontal para ver todas las columnas.
| Nombre | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| directory_path | str | No | "." | Ruta del directorio cuyos archivos se enumerarán |
| pattern | str | No | "*" | Patrón por el que se filtrarán los archivos (por ejemplo, "*.txt" o "doc*.pdf") |
| recursive | str | No | No declarado | Nivel de recursión: ninguno de forma predeterminada, -r/--recursive sin límite o -rN/--recursiveN hasta N niveles de profundidad |
Ejemplos de entrada
qzx listFilesEnumerar todos los archivos del directorio actual
qzx listFiles C:\DocumentsEnumerar todos los archivos del directorio C:\Documents (Windows)
qzx listFiles /home/user/documentsEnumerar todos los archivos del directorio /home/user/documents (Linux/Mac)
qzx listFiles . "*.py"Enumerar todos los archivos Python del directorio actual
qzx listFiles src "*.js" -rEnumerar todos los archivos JavaScript del directorio src y todos sus subdirectorios
qzx listFiles src "*.js" -r2Enumerar todos los archivos JavaScript del directorio src y hasta 2 niveles de subdirectorios
Para obtener la carga estructurada completa, añade --json: qzx listFiles [directory_path] [pattern] [recursive] --json
Ejemplo de salida observada
Capturado con QZX 0.2.2.0.8 en Windows 11; código de salida 0. Los valores dependientes del host y la duración pueden variar.
Comando del ejemplo: qzx listFiles ../artifacts/qzx-evidence/golden-core-files "*.txt" -r --json
{
"success": true,
"directory": "../artifacts/qzx-evidence/golden-core-files",
"pattern": "*.txt",
"recursive": true,
"recursion_depth": null,
"files": [
{
"name": "alpha.txt",
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\golden-core-files\\alpha.txt",
"size": 33,
"size_formatted": "33.0 B",
"modified": 1788913187.3232598,
"modified_formatted": "2026-09-08 19:19:47",
"is_directory": false
},
{
"name": "gamma.txt",
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\golden-core-files\\nested\\gamma.txt",
"size": 19,
"size_formatted": "19.0 B",
"modified": 1788913187.3252766,
"modified_formatted": "2026-09-08 19:19:47",
"is_directory": false
}
],
"message": "Found 2 files matching '*.txt' in '../artifacts/qzx-evidence/golden-core-files' (including subdirectories)",
"meta": {
"command": "listFiles",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 7.276,
"schema_version": 1
}
}Ver el contrato de resultado JSON
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"required": [
"success",
"message",
"meta"
],
"properties": {
"success": {
"type": "boolean"
},
"message": {
"type": "string"
},
"meta": {
"type": "object",
"required": [
"command",
"command_maturity",
"duration_ms",
"schema_version"
],
"properties": {
"command": {
"type": "string"
},
"command_maturity": {
"type": "object",
"required": [
"stage",
"label",
"sequence",
"public_executable",
"stability",
"summary",
"promotion_review_required",
"assessment_scope"
],
"properties": {
"stage": {
"type": "string"
},
"label": {
"type": "string"
},
"sequence": {
"type": "integer"
},
"public_executable": {
"type": "boolean"
},
"stability": {
"type": "string"
},
"summary": {
"type": "string"
},
"promotion_review_required": {
"type": "boolean"
},
"assessment_scope": {
"type": "string"
},
"note": {
"type": "string"
},
"review": {
"type": "object",
"required": [
"reviewed_on",
"rationale",
"evidence"
],
"properties": {
"reviewed_on": {
"type": "string",
"format": "date"
},
"rationale": {
"type": "string"
},
"evidence": {
"type": "array",
"minItems": 1,
"items": {
"type": "string"
}
},
"replacement": {
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": true
},
"duration_ms": {
"type": "number"
},
"schema_version": {
"type": "integer"
}
},
"additionalProperties": true
},
"details": {
"type": "object",
"properties": {
"directory": [],
"pattern": []
},
"additionalProperties": true
},
"directory": [],
"error": [],
"error_code": {
"type": "string"
},
"files": {
"type": "array"
},
"pattern": [],
"recursion_depth": [],
"recursive": []
},
"additionalProperties": true
}Errores y límites
El contrato público exige success=false y un message descriptivo en fallos. Este catálogo aún no declara una taxonomía de errores específica para cada comando; revisa el resultado y no infieras códigos inexistentes.
QZX está en alpha. Dependencias opcionales, permisos y capacidades del host pueden cambiar el resultado.
{
"success": false,
"error": "Directory '../artifacts/qzx-evidence/missing-golden-core-path' not found.",
"error_code": "path_not_found",
"message": "Directory '../artifacts/qzx-evidence/missing-golden-core-path' not found.",
"details": {
"directory": "../artifacts/qzx-evidence/missing-golden-core-path",
"pattern": "*"
},
"meta": {
"command": "listFiles",
"command_maturity": {
"stage": "alpha",
"label": "Alpha",
"sequence": 2,
"public_executable": true,
"stability": "interface_may_change",
"summary": "Available for real use and feedback while its interface and behavior can still evolve.",
"promotion_review_required": false,
"assessment_scope": "development_checkout"
},
"duration_ms": 2.403,
"schema_version": 1
}
}Comando capturado: qzx listFiles ../artifacts/qzx-evidence/missing-golden-core-path --json
Flujo de evidencia: capturada y validada por digest.
Evidencia y procedencia
- Implementación
- src/qzx/commands/file/list_files.py
- Canal de documentación
- Documentación de desarrollo 0.2.2.0.8 · main · sha256:9aa902dfb6b006017e52972bf7871fef49b03ec24ff80741231d743d0354bfc2
- Disponibilidad
- 0.2.2.0.8 o anterior
Sigue explorando
Comandos relacionados
Estos comandos también pertenecen a la categoría de archivos. Compáralos para elegir la operación que mejor resuelva tu tarea.
qzx isFileEmptyComprueba si un archivo tiene cero bytes o sólo espacios Unicode mediante decodificación en streaming y sin seguir enlaces de forma predeterminada.qzx movePathMueve o renombra un archivo, enlace simbólico o directorio completo; rechaza movimientos parciales de directorios.qzx isFileBinaryDetermina si un archivo regular es binario o texto mediante muestreo acotado de inicio, centro y final.qzx readFileLee y muestra el contenido de un archivo.