file · Command reference

`qzx createDirectory`

What it does

Creates one or more directories at specified paths

Canonical command: createDirectory

Accepted aliases: None

Case-sensitive: no

Included in the published package

Available in PyPI 0.2.2.0.2. This page documents the 0.2.2.0.2 alpha development checkout.

Safety and effects

Can mutate state

No documented dry-run parameter

No native program invocation in the current classification

No documented network use

No inherent elevation requirement

This safety classification was reviewed against implementation digest sha256:5f9a00f14cef44b537c759ff934b135037e9e7634654acb94654ee1345eb93ed on 2026-07-24.

Exact syntax

qzx createDirectory <directory_paths> --json

Parameters

Name	Type	Required	Default	Description
directory_paths	list[str]	Yes	Not declared	One or more paths where directories should be created

Input examples

qzx createDirectory "ProjectFolder"

Create a single directory named "ProjectFolder"

qzx createDirectory "src/components" "src/styles" "src/utils"

Create multiple directories for a project structure

For the complete structured payload, add --json: qzx createDirectory <directory_paths> --json

Observed output example

Captured with QZX 0.2.2.0.2 on Windows 11; exit code 0. Host-dependent values and duration can vary.

Example command: qzx createDirectory ../artifacts/qzx-evidence/created-one ../artifacts/qzx-evidence/created-two --json

{
    "success": true,
    "message": "Created 2 of 2 directories.",
    "details": {
        "requested": 2,
        "created": 2,
        "failed": 0,
        "results": [
            "✓ Directory created: ../artifacts/qzx-evidence/created-one",
            "✓ Directory created: ../artifacts/qzx-evidence/created-two"
        ]
    },
    "meta": {
        "command": "createDirectory",
        "duration_ms": 1.317,
        "schema_version": 1
    }
}

View the JSON result contract

{
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "type": "object",
    "required": [
        "success",
        "message"
    ],
    "properties": {
        "success": {
            "type": "boolean"
        },
        "message": {
            "type": "string"
        },
        "details": {
            "type": "object",
            "properties": {
                "requested": [],
                "created": [],
                "failed": [],
                "results": []
            },
            "additionalProperties": true
        },
        "error": {
            "type": "string"
        },
        "error_code": {
            "type": "string"
        }
    },
    "additionalProperties": true
}

Errors and limits

The public contract requires success=false and a descriptive message on failure. This catalog does not yet declare a command-specific error taxonomy; inspect the result and do not invent error codes.

QZX is alpha software. Optional dependencies, permissions, and host capabilities can change the result.

{
    "success": false,
    "message": "Created 0 of 1 directories.",
    "details": {
        "requested": 1,
        "created": 0,
        "failed": 1,
        "results": [
            "✗ Error creating directory '': [WinError 3] El sistema no puede encontrar la ruta especificada: ''"
        ]
    },
    "error": "Created 0 of 1 directories.",
    "meta": {
        "command": "createDirectory",
        "duration_ms": 0.16,
        "schema_version": 1
    }
}

Captured command: qzx createDirectory "" --json

Evidence workflow: captured and digest-validated.

Evidence and provenance

Implementation: src/qzx/commands/file/create_directory.py
Tests: No command-specific test file with the same module name was found; this does not prove that all coverage is absent.
Documentation channel: Development documentation 0.2.2.0.2 · main · sha256:319b16857a87636ebc3b89734cc040a737bb56194464fca33ce73bdae2043096
Availability: 0.2.2.0.2 or earlier

Keep exploring

These commands also belong to the file category. Compare them to choose the operation that best fits your task.

Explore all QZX commands