development · Command reference

`qzx scaffoldCpp`

What it does

Creates a basic scaffolding for a C++ program

Canonical command: scaffoldCpp

Accepted aliases: cppScaff, newCpp, createCpp, makeScaffProgramCpp

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

May invoke native programs

No documented network use

No inherent elevation requirement

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

Exact syntax

qzx scaffoldCpp <project_name> [path] [with_tests] [build_system] [cpp_standard] --json

Parameters

Name	Type	Required	Default	Description
project_name	str	Yes	Not declared	Name of the C++ project to create
path	str	No	"."	Path where to create the project (default: current directory)
with_tests	str	No	"true"	Whether to include testing scaffolding (using Catch2)
build_system	str	No	"cmake"	Build system to use (make, cmake, or none)
cpp_standard	str	No	"17"	C++ standard to use (11, 14, 17, 20)

Input examples

qzx makeScaffProgramCpp my_project

Creates a new C++ project using CMake in the current directory

qzx makeScaffProgramCpp my_project /path/to/dir true make 20

Creates a new C++ project using Make, C++20 and tests in the specified directory

qzx cppScaff util_library . false none 17

Creates a C++ project without tests or build system in the current directory using C++17

For the complete structured payload, add --json: qzx scaffoldCpp <project_name> [path] [with_tests] [build_system] [cpp_standard] --json

Representative output example

This illustrative JSON is derived from the current implementation-backed result contract. It shows what the command can return without claiming a recorded execution; values vary with inputs, host, permissions, and optional tools.

Example command: qzx makeScaffProgramCpp my_project --json

{
    "success": true,
    "message": "Creates a basic scaffolding for a C++ program. In this illustrative example, the command completed successfully.",
    "project_name": "Example value"
}

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"
        },
        "error": {
            "type": "string"
        },
        "project_name": []
    },
    "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.

Evidence workflow: requires an isolated disposable target.

Evidence and provenance

Implementation: src/qzx/commands/development/scaffold_cpp.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 development category. Compare them to choose the operation that best fits your task.

Explore all QZX commands