file · Command reference

`qzx countLinesInFile`

What it does

Counts the number of lines in files with support for wildcards and recursive searching

Canonical command: countLinesInFile

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

Read-only under the current classification

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:07ca2c371e2804592cd71af6292c85329b1761a42f4172a86d3097ae20d27d1a on 2026-07-24.

Exact syntax

qzx countLinesInFile <file_path> [recursive] [ignore_empty] --json

Parameters

Name	Type	Required	Default	Description
file_path	str	Yes	Not declared	Path to the file(s) to count lines in. Supports wildcards like "*.py"
recursive	str	No	Not declared	Recursion level: -r/--recursive for unlimited depth, -rN/--recursiveN for N levels deep
ignore_empty	bool	No	false	Whether to ignore empty lines when counting

Input examples

qzx countLinesInFile "script.py"

Count the number of lines in a Python script

qzx countLinesInFile "data/logs.txt"

Count the number of lines in a log file

qzx countLinesInFile "*.py"

Count the number of lines in all Python files in the current directory

qzx countLinesInFile "src/**/*.js" -r

Count the number of lines in all JavaScript files in the src directory and its subdirectories

qzx countLinesInFile "*.txt" -r2 true

Count the number of non-empty lines in all text files in the current directory and subdirectories up to 2 levels deep

For the complete structured payload, add --json: qzx countLinesInFile <file_path> [recursive] [ignore_empty] --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 countLinesInFile "script.py" --json

{
    "success": true,
    "message": "Counts the number of lines in files with support for wildcards and recursive searching. In this illustrative example, the command completed successfully.",
    "errors": [],
    "extension_stats": [
        {
            "name": "example",
            "status": "ok"
        }
    ],
    "file_pattern": "C:\\project\\example.txt",
    "file_results": [
        {
            "path": "src/example.py",
            "status": "analyzed"
        }
    ],
    "files_analyzed": "C:\\project\\example.txt",
    "files_found": 3,
    "files_processed": "C:\\project\\example.txt",
    "recursive": true,
    "total_counted": 3,
    "total_empty_lines": 3,
    "total_lines": "Example value",
    "total_non_empty_lines": 3
}

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"
        },
        "errors": [],
        "extension_stats": [],
        "file_pattern": [],
        "file_results": [],
        "files_analyzed": [],
        "files_found": {
            "type": "integer"
        },
        "files_processed": [],
        "recursive": [],
        "total_counted": [],
        "total_empty_lines": [],
        "total_lines": {
            "type": "string"
        },
        "total_non_empty_lines": []
    },
    "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: ready for deterministic automated capture.

Evidence and provenance

Implementation: src/qzx/commands/file/count_lines_in_file.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