sistem · Referensi perintah
qzx checkExecutable
Apa fungsinya
Menemukan executable di PATH dan, hanya jika diminta, membaca output konvensional --version miliknya.
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
Menggunakan alat native saat diperlukan
Berfungsi tanpa menggunakan jaringan
Dirancang untuk bekerja tanpa elevasi hak akses
Pemeriksaan default hanya membaca PATH dan tidak menjalankan program yang ditemukan. --include-version menjalankan jalur persis yang telah ditemukan satu kali, tanpa shell, hanya dengan --version, lingkungan minimal, batas tiga detik, dan output terbatas.
Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Pro terhadap digest implementasi sha256:2e82544698518dd4f8d5841dfeddf529af4cb85f5545836d66956c2612438f70 pada 2026-08-25.
Sintaks persis
qzx checkExecutable <executable> [include_version] --jsonParameter
Geser atau gunakan bilah horizontal untuk melihat semua kolom.
| Nama | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| executable | str | Ya | Tidak dideklarasikan | Nama atau jalur eksplisit executable yang akan ditemukan (misalnya git, node, atau docker) |
| include_version | bool | Tidak | false | Menjalankan binary yang ditemukan sekali dengan --version; default-nya nonaktif |
Contoh input
qzx checkExecutable gitTemukan Git tanpa menjalankannya
qzx checkExecutable node --include-versionTemukan Node.js dan minta output --version secara eksplisit
Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx checkExecutable <executable> [include_version] --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 checkExecutable git --json
{
"success": true,
"message": "Locates an executable in the system PATH and optionally reads its conventional --version output. In this illustrative example, the command completed successfully.",
"meta": {
"command": "checkExecutable",
"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
},
"available": true,
"executable": "Example value",
"executable_path": "C:\\project\\example.txt",
"version": null,
"version_checked": true,
"version_probe": {
"argument": "Example value",
"return_code": "Example value",
"output": "Command completed successfully with structured details.",
"output_truncated": true
},
"version_requested": "Example value",
"warnings": [
{
"name": "example",
"status": "ok"
}
]
}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
},
"available": {
"type": "boolean"
},
"error": {
"type": "string"
},
"error_code": {
"type": "string"
},
"executable": [],
"executable_path": [],
"version": {
"type": "null"
},
"version_checked": {
"type": "boolean"
},
"version_probe": {
"type": "object",
"properties": {
"argument": {
"type": "string"
},
"return_code": [],
"output": [],
"output_truncated": {
"type": "boolean"
}
},
"additionalProperties": true
},
"version_requested": [],
"warnings": {
"type": "array"
}
},
"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: memerlukan matriks sistem operasi yang kompatibel.
Bukti dan asal-usul
- Implementasi
- src/qzx/commands/system/check_executable.py
- 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 sistem. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.
qzx aboutMenampilkan data produk QZX, pembuat, maintainer, dan lisensinya.qzx checkSystemPathMendiagnosis variabel PATH, mencantumkan direktori rusak atau duplikat, dan menemukan semua instance suatu binary.qzx welcomeSegera menampilkan sambutan QZX dan, secara opsional, informasi sistem.qzx clearScreenMembersihkan terminal interaktif secara langsung tanpa menjalankan cls, clear, atau command shell.