archivos · Referencia de comando
qzx createDirectory
Qué hace
Crea uno o varios directorios reales con deduplicación, detección de conflictos y rollback independiente por destino.
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
El modo real aplica los cambios que solicites
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:902b158008896ce4683ee6c457beffc870050415324dbf7ddf46ed0fc87273cd el 2026-08-25.
Sintaxis exacta
qzx createDirectory <directory_paths> --jsonParámetros
Desliza o usa la barra horizontal para ver todas las columnas.
| Nombre | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| directory_paths | list[str] | Sí | No declarado | Una o varias rutas reales de directorios que se crearán |
Ejemplos de entrada
qzx createDirectory "ProjectFolder"Crear un directorio llamado «ProjectFolder»
qzx createDirectory "src/components" "src/styles" "src/utils"Crear varios directorios del proyecto e informar cada destino por separado
Para obtener la carga estructurada completa, añade --json: qzx createDirectory <directory_paths> --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 createDirectory ../artifacts/qzx-evidence/created-one ../artifacts/qzx-evidence/created-two --json
{
"success": true,
"message": "Created 2 target directories; 0 already existed and 0 duplicates were skipped.",
"details": {
"requested": 2,
"normalized_unique": 2,
"created": 2,
"already_existed": 0,
"duplicates": 0,
"failed": 0,
"directories_created": 2,
"directories_rolled_back": 0,
"directories_retained_after_command": 2,
"filesystem_changed": true,
"link_traversal_allowed": false,
"rollback_policy": "empty_directories_created_by_a_failed_target",
"operations": [
{
"request_index": 1,
"requested_path": "../artifacts/qzx-evidence/created-one",
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\created-one",
"status": "created",
"changed": true,
"created_paths": [
"C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\created-one"
],
"concurrent_directories": []
},
{
"request_index": 2,
"requested_path": "../artifacts/qzx-evidence/created-two",
"path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\created-two",
"status": "created",
"changed": true,
"created_paths": [
"C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\created-two"
],
"concurrent_directories": []
}
]
},
"meta": {
"command": "createDirectory",
"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": 8.179,
"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": {
"requested_count": [],
"maximum_path_count": [],
"filesystem_changed": {
"type": "boolean"
}
},
"additionalProperties": true
},
"error": {
"type": "string"
},
"error_code": {
"type": "string"
}
},
"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_code": "directory_creation_failed",
"error": "1 of 1 path request failed.",
"message": "Created 0 target directories; 0 already existed, 0 duplicates were skipped, and 1 failed.",
"details": {
"requested": 1,
"normalized_unique": 0,
"created": 0,
"already_existed": 0,
"duplicates": 0,
"failed": 1,
"directories_created": 0,
"directories_rolled_back": 0,
"directories_retained_after_command": 0,
"filesystem_changed": false,
"link_traversal_allowed": false,
"rollback_policy": "empty_directories_created_by_a_failed_target",
"operations": [
{
"request_index": 1,
"requested_path": "",
"status": "failed",
"changed": false,
"error_code": "invalid_directory_path",
"error": "Directory paths must not be empty."
}
]
},
"meta": {
"command": "createDirectory",
"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": 4.236,
"schema_version": 1
}
}Comando capturado: qzx createDirectory "" --json
Flujo de evidencia: capturada y validada por digest.
Evidencia y procedencia
- Implementación
- src/qzx/commands/file/create_directory.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 countLinesCuenta líneas lógicas Unicode de un archivo regular estable mediante streaming de memoria acotada y evidencia explícita de saltos de línea.qzx createZipCrea un archivo ZIP atómico desde un archivo o directorio, con reglas de exclusión configurables.qzx copyPathCopia un archivo, enlace simbólico o directorio a un destino separado, con profundidad y reemplazo explícitos.qzx deletePathPrevisualiza o elimina un archivo o directorio del sistema de archivos.