file · Referensi perintah
qzx findText
Apa fungsinya
Mencari pola teks dalam file dengan filter lanjutan.
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:2aeda2f46c91d3f2a806da12a8f604fdcb90f6f0959d6c35a51b3c785c9e6d34 pada 2026-08-25.
Sintaks persis
qzx findText <pattern> <target> [recursive] [regex] [case_sensitive] [file_pattern] [context_lines] [invert_match] [count_only] [max_matches] [colored] --jsonParameter
Geser atau gunakan bilah horizontal untuk melihat semua kolom.
| Nama | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| pattern | str | Ya | Tidak dideklarasikan | Pola teks yang dicari (mendukung regular expression) |
| target | str | Ya | Tidak dideklarasikan | File, direktori, atau daftar file/direktori dipisahkan spasi tempat pencarian dilakukan |
| recursive | str | Tidak | Tidak dideklarasikan | Tingkat rekursi: -r/--recursive tanpa batas atau -rN/--recursiveN hingga N tingkat kedalaman |
| regex | bool | Tidak | false | Menggunakan regular expression untuk mencocokkan pola (true/false) |
| case_sensitive | bool | Tidak | true | Membedakan huruf besar/kecil dalam pencarian (true/false) |
| file_pattern | str | Tidak | "*" | Cari hanya dalam file yang cocok dengan pola ini (misalnya "*.py" atau "*.{py,js}") |
| context_lines | int | Tidak | 0 | Jumlah baris yang ditampilkan sebelum dan sesudah setiap kecocokan |
| invert_match | bool | Tidak | false | Menampilkan baris yang TIDAK cocok dengan pola (true/false) |
| count_only | bool | Tidak | false | Hanya menampilkan jumlah kecocokan per file (true/false) |
| max_matches | int | Tidak | 0 | Jumlah maksimum kecocokan yang ditampilkan (0 tanpa batas) |
| colored | bool | Tidak | true | Menyorot kecocokan dengan warna (true/false) |
Contoh input
qzx findText "function" "script.js"Cari semua kemunculan "function" dalam file JavaScript
qzx findText "error" "logs" trueCari semua kemunculan "error" dalam file di direktori logs
qzx findText "def\s+\w+" "src" true trueCari definisi fungsi dalam file Python menggunakan regular expression
qzx findText "WARNING|ERROR" "logs" true true false "*.log"Cari peringatan atau error dalam file log
qzx findText "TODO" "src" true false true "*.{py,js,ts}" 2Cari TODO dalam file sumber dengan 2 baris konteks
qzx findText "function" "file1.js file2.js lib/utils.js"Cari semua kemunculan "function" dalam beberapa file tertentu
Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx findText <pattern> <target> [recursive] [regex] [case_sensitive] [file_pattern] [context_lines] [invert_match] [count_only] [max_matches] [colored] --json
Contoh output yang diamati
Ditangkap dengan QZX 0.2.2.0.9 di Windows 11; kode keluar 0. Nilai yang bergantung pada host dan durasi dapat bervariasi.
Perintah contoh: qzx findText QZX ../artifacts/qzx-evidence/golden-core-files -r --regex=false --case-sensitive=false "--file-pattern=*.txt" --context-lines=1 --max-matches=10 --colored=false --json
{
"success": true,
"pattern": "QZX",
"target": "../artifacts/qzx-evidence/golden-core-files",
"regex": false,
"case_sensitive": false,
"file_pattern": "*.txt",
"recursive": "unlimited",
"context_lines": 1,
"invert_match": false,
"files_searched": 2,
"files_with_matches": 2,
"total_matches": 2,
"results": [
{
"file": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\golden-core-files\\alpha.txt",
"matches": 1,
"lines": [
{
"line_num": 1,
"content": "QZX alpha evidence",
"is_match": true
},
{
"line_num": 2,
"content": "second line",
"is_match": false
}
]
},
{
"file": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\golden-core-files\\nested\\gamma.txt",
"matches": 1,
"lines": [
{
"line_num": 1,
"content": "prefix qzx suffix",
"is_match": true
}
]
}
],
"message": "Found 2 matches in 2 files (including all subdirectories)",
"meta": {
"command": "findText",
"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": 7.362,
"schema_version": 1
}
}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
},
"case_sensitive": [],
"context_lines": [],
"error": {
"type": "string"
},
"file_pattern": [],
"files_searched": [],
"files_with_matches": [],
"invert_match": [],
"pattern": [],
"recursive": {
"type": "string"
},
"regex": [],
"results": [],
"target": [],
"total_matches": []
},
"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.
{
"success": false,
"error": "Invalid regular expression: unterminated character set at position 0",
"message": "Invalid regular expression: unterminated character set at position 0",
"meta": {
"command": "findText",
"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": 4.133,
"schema_version": 1
}
}Perintah yang ditangkap: qzx findText "[" ../artifacts/qzx-evidence/golden-core-files -r --regex=true --max-matches=1 --colored=false --json
Alur bukti: ditangkap dan divalidasi dengan digest.
Bukti dan asal-usul
- Implementasi
- src/qzx/commands/file/find_text.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 file. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.
qzx findFilesMencari file berdasarkan nama, kedalaman, ukuran, dan tanggal modifikasi, lalu mengembalikan metadata terstruktur.qzx getHumanLanguageStatsMenganalisis file untuk memperkirakan distribusi bahasa manusia; mendukung wildcard dan pencarian rekursif.qzx findDuplicateFilesMencari file identik berdasarkan ukuran, SHA-256, dan verifikasi byte demi byte.qzx inspectImageMemeriksa dimensi, format, dan ukuran dari header PNG, JPEG, GIF, dan BMP.