archivos · Referencia de comando
qzx findText
Qué hace
Busca patrones de texto en archivos con filtros avanzados.
Madurez del comando: Alpha
Disponible para uso real y retroalimentación mientras su interfaz y comportamiento todavía pueden evolucionar. Esta es la evaluación actual del checkout de desarrollo. Cada futuro tag inmutable de release conservará la evaluación exacta incluida en esa versión. Disponible en PyPI 0.2.2.0.8. La documentación corresponde al checkout alpha 0.2.2.0.8.
Comportamiento y protecciones integradas
Inspecciona sin cambiar el estado
Ejecución directa para esta operación
Funciona sin invocar programas nativos
Funciona sin usar la red
Diseñado para funcionar sin elevación
Esta clasificación de seguridad fue revisada por OpenAI GPT-5.6 Pro contra el digest de implementación sha256:2aeda2f46c91d3f2a806da12a8f604fdcb90f6f0959d6c35a51b3c785c9e6d34 el 2026-08-25.
Sintaxis exacta
qzx findText <pattern> <target> [recursive] [regex] [case_sensitive] [file_pattern] [context_lines] [invert_match] [count_only] [max_matches] [colored] --jsonParámetros
Desliza o usa la barra horizontal para ver todas las columnas.
| Nombre | Tipo | Obligatorio | Predeterminado | Descripción |
|---|---|---|---|---|
| pattern | str | Sí | No declarado | Patrón de texto que se buscará (admite expresiones regulares) |
| target | str | Sí | No declarado | Archivo, directorio o lista de archivos/directorios separados por espacios en los que se buscará |
| recursive | str | No | No declarado | Nivel de recursión: -r/--recursive sin límite o -rN/--recursiveN hasta N niveles de profundidad |
| regex | bool | No | false | Usa expresiones regulares para comparar patrones (true/false) |
| case_sensitive | bool | No | true | Distingue mayúsculas y minúsculas en la búsqueda (true/false) |
| file_pattern | str | No | "*" | Busca únicamente en archivos que coincidan con este patrón (por ejemplo, "*.py" o "*.{py,js}") |
| context_lines | int | No | 0 | Número de líneas que se mostrarán antes y después de cada coincidencia |
| invert_match | bool | No | false | Muestra las líneas que NO coincidan con el patrón (true/false) |
| count_only | bool | No | false | Muestra únicamente el número de coincidencias por archivo (true/false) |
| max_matches | int | No | 0 | Número máximo de coincidencias que se mostrará (0 sin límite) |
| colored | bool | No | true | Resalta las coincidencias con color (true/false) |
Ejemplos de entrada
qzx findText "function" "script.js"Buscar todas las apariciones de "function" en un archivo JavaScript
qzx findText "error" "logs" trueBuscar todas las apariciones de "error" en los archivos del directorio logs
qzx findText "def\s+\w+" "src" true trueBuscar definiciones de funciones en archivos Python mediante una expresión regular
qzx findText "WARNING|ERROR" "logs" true true false "*.log"Buscar advertencias o errores en archivos de log
qzx findText "TODO" "src" true false true "*.{py,js,ts}" 2Buscar TODO en archivos fuente con 2 líneas de contexto
qzx findText "function" "file1.js file2.js lib/utils.js"Buscar todas las apariciones de "function" en varios archivos concretos
Para obtener la carga estructurada completa, añade --json: qzx findText <pattern> <target> [recursive] [regex] [case_sensitive] [file_pattern] [context_lines] [invert_match] [count_only] [max_matches] [colored] --json
Ejemplo de salida observada
Capturado con QZX 0.2.2.0.8 en Windows 11; código de salida 0. Los valores dependientes del host y la duración pueden variar.
Comando del ejemplo: 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": 4.5,
"schema_version": 1
}
}Ver el contrato de resultado 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
}Errores y límites
El contrato público exige success=false y un message descriptivo en fallos. Este catálogo aún no declara una taxonomía de errores específica para cada comando; revisa el resultado y no infieras códigos inexistentes.
QZX está en alpha. Dependencias opcionales, permisos y capacidades del host pueden cambiar el resultado.
{
"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": 3.523,
"schema_version": 1
}
}Comando capturado: qzx findText "[" ../artifacts/qzx-evidence/golden-core-files -r --regex=true --max-matches=1 --colored=false --json
Flujo de evidencia: capturada y validada por digest.
Evidencia y procedencia
- Implementación
- src/qzx/commands/file/find_text.py
- Canal de documentación
- Documentación de desarrollo 0.2.2.0.8 · main · sha256:9aa902dfb6b006017e52972bf7871fef49b03ec24ff80741231d743d0354bfc2
- Disponibilidad
- 0.2.2.0.8 o anterior
Sigue explorando
Comandos relacionados
Estos comandos también pertenecen a la categoría de archivos. Compáralos para elegir la operación que mejor resuelva tu tarea.
qzx findFilesBusca archivos por nombre, profundidad, tamaño y fecha de modificación, y devuelve metadatos estructurados.qzx getHumanLanguageStatsAnaliza archivos para estimar la distribución de idiomas humanos; admite comodines y búsqueda recursiva.qzx findDuplicateFilesBusca archivos idénticos mediante tamaño, SHA-256 y verificación byte por byte.qzx inspectImageInspecciona dimensiones, formato y tamaño desde las cabeceras de PNG, JPEG, GIF y BMP.