Lewati ke konten utama

file · Referensi perintah

qzx countLines

Apa fungsinya

Menghitung baris logis Unicode pada file reguler yang stabil dengan streaming bermemori terbatas dan bukti line break yang eksplisit.

Kematangan perintah: Alpha

Tersedia untuk penggunaan nyata dan umpan balik sementara antarmuka serta perilakunya masih dapat berkembang. Ini adalah evaluasi saat ini untuk checkout pengembangan. Setiap tag rilis immutable di masa mendatang akan mempertahankan evaluasi persis yang disertakan dalam versi tersebut. Tersedia di PyPI 0.2.2.0.9. Dokumentasi ini sesuai dengan checkout alpha 0.2.2.0.9.

Perilaku dan perlindungan bawaan

Memeriksa tanpa mengubah status

Eksekusi langsung untuk operasi ini

Berfungsi tanpa memanggil program native

Berfungsi tanpa menggunakan jaringan

Dirancang untuk bekerja tanpa elevasi hak akses

Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Pro terhadap digest implementasi sha256:756c9525da9352308e7c9c710924545dc4fcbb5b2c8bfd25c5b13e5e2110d815 pada 2026-08-25.

Sintaks persis

qzx countLines <file_path> [encoding] [follow_symlinks] --json

Parameter

Geser atau gunakan bilah horizontal untuk melihat semua kolom.

NamaTipeWajibDefaultDeskripsi
file_pathstrYaTidak dideklarasikanJalur file teks reguler yang barisnya akan dihitung
encodingstrTidak"auto"Nama encoding atau «auto» untuk menggunakan deteksi terbatas berdasarkan konten
follow_symlinksboolTidakfalseMengikuti komponen symbolic link atau junction yang telah ditinjau hingga file reguler target

Contoh input

qzx countLines source.py

Hitung baris kode dengan deteksi encoding otomatis

qzx countLines legacy.txt windows-1252

Hitung file menggunakan encoding lama yang ditentukan secara eksplisit

qzx countLines reviewed-link auto true

Hitung target hasil resolusi dari link yang ditinjau secara eksplisit

Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx countLines <file_path> [encoding] [follow_symlinks] --json

Contoh output representatif

JSON ilustratif ini berasal dari kontrak hasil yang didukung implementasi saat ini. Ini menunjukkan apa yang dapat dikembalikan perintah tanpa mengklaim sebagai eksekusi yang direkam; nilainya bervariasi menurut input, mesin, izin, dan alat opsional.

Perintah contoh: qzx countLines source.py --json

{
    "success": true,
    "message": "Counts logical Unicode lines in a stable regular file using bounded-memory streaming and explicit newline evidence. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "countLines",
        "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": 0,
        "schema_version": 1
    },
    "analyzed_path": "C:\\project\\example.txt",
    "blank_line_count": 3,
    "details": {
        "target": "Example value",
        "encoding": "Example value"
    },
    "empty_line_count": 3,
    "encoding": "Example value",
    "file_path": "C:\\project\\example.txt",
    "line_count": 3,
    "non_blank_line_count": 3,
    "whitespace_only_line_count": 3
}
Lihat kontrak hasil 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
        },
        "analyzed_path": [],
        "blank_line_count": [],
        "details": {
            "oneOf": [
                {
                    "type": "object",
                    "properties": {
                        "target": [],
                        "encoding": []
                    },
                    "additionalProperties": true
                },
                {
                    "type": "object",
                    "properties": {
                        "target": [],
                        "encoding": [],
                        "bytes_scanned_before_failure": []
                    },
                    "additionalProperties": true
                },
                {
                    "type": "object",
                    "properties": {
                        "target": []
                    },
                    "additionalProperties": true
                },
                {
                    "type": "object",
                    "properties": {
                        "target": [],
                        "phase": []
                    },
                    "additionalProperties": true
                }
            ]
        },
        "empty_line_count": [],
        "encoding": [],
        "error": {
            "type": "string"
        },
        "error_code": {
            "type": "string"
        },
        "file_path": [],
        "line_count": [],
        "non_blank_line_count": [],
        "whitespace_only_line_count": []
    },
    "additionalProperties": true
}

Kesalahan dan batasan

Kontrak publik mensyaratkan success=false dan message yang deskriptif saat gagal. Katalog ini belum mendeklarasikan taksonomi kesalahan khusus untuk setiap perintah; periksa hasil dan jangan menyimpulkan kode yang tidak ada.

QZX masih dalam tahap alpha. Dependency opsional, izin, dan kemampuan host dapat mengubah hasil.

Alur bukti: siap untuk penangkapan otomatis deterministik.

Bukti dan asal-usul

Kanal dokumentasi
Dokumentasi pengembangan 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
Ketersediaan
0.2.2.0.9 atau lebih lama

Lanjut jelajahi

Perintah terkait

Perintah ini juga termasuk kategori file. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.

Jelajahi semua perintah QZX