Ir para o conteúdo principal

arquivos · Referência do comando

qzx findText

O que faz

Procura padrões de texto em arquivos com filtros avançados.

Maturidade do comando: Alpha

Disponível para uso real e feedback enquanto a interface e o comportamento ainda podem evoluir. Esta é a avaliação atual do checkout de desenvolvimento. Cada tag de release imutável futuro preservará a avaliação exata incluída nessa versão. Disponível no PyPI 0.2.2.0.9. A documentação corresponde ao checkout alpha 0.2.2.0.9.

Comportamento e proteções integradas

Inspeciona sem alterar o estado

Execução direta para esta operação

Funciona sem invocar programas nativos

Funciona sem usar a rede

Projetado para funcionar sem elevação

Esta classificação de segurança foi revisada por OpenAI GPT-5.6 Pro em relação ao digest de implementação sha256:2aeda2f46c91d3f2a806da12a8f604fdcb90f6f0959d6c35a51b3c785c9e6d34 em 2026-08-25.

Sintaxe exata

qzx findText <pattern> <target> [recursive] [regex] [case_sensitive] [file_pattern] [context_lines] [invert_match] [count_only] [max_matches] [colored] --json

Parâmetros

Deslize ou use a barra horizontal para ver todas as colunas.

NomeTipoObrigatórioPadrãoDescrição
patternstrSimNão declaradoPadrão de texto a procurar (aceita expressões regulares)
targetstrSimNão declaradoArquivo, diretório ou lista de arquivos/diretórios separados por espaços onde a busca será feita
recursivestrNãoNão declaradoNível de recursão: -r/--recursive sem limite ou -rN/--recursiveN até N níveis de profundidade
regexboolNãofalseUsa expressões regulares para comparar padrões (true/false)
case_sensitiveboolNãotrueDiferencia maiúsculas de minúsculas na busca (true/false)
file_patternstrNão"*"Busca somente em arquivos que correspondam a este padrão (por exemplo, "*.py" ou "*.{py,js}")
context_linesintNão0Número de linhas mostradas antes e depois de cada correspondência
invert_matchboolNãofalseMostra as linhas que NÃO correspondem ao padrão (true/false)
count_onlyboolNãofalseMostra somente o número de correspondências por arquivo (true/false)
max_matchesintNão0Número máximo de correspondências a mostrar (0 sem limite)
coloredboolNãotrueDestaca as correspondências com cor (true/false)

Exemplos de entrada

qzx findText "function" "script.js"

Procurar todas as ocorrências de "function" em um arquivo JavaScript

qzx findText "error" "logs" true

Procurar todas as ocorrências de "error" nos arquivos do diretório logs

qzx findText "def\s+\w+" "src" true true

Procurar definições de funções em arquivos Python usando uma expressão regular

qzx findText "WARNING|ERROR" "logs" true true false "*.log"

Procurar avisos ou erros em arquivos de log

qzx findText "TODO" "src" true false true "*.{py,js,ts}" 2

Procurar TODO em arquivos-fonte com 2 linhas de contexto

qzx findText "function" "file1.js file2.js lib/utils.js"

Procurar todas as ocorrências de "function" em vários arquivos específicos

Para obter o payload estruturado completo, adicione --json: qzx findText <pattern> <target> [recursive] [regex] [case_sensitive] [file_pattern] [context_lines] [invert_match] [count_only] [max_matches] [colored] --json

Exemplo de saída observada

Capturado com QZX 0.2.2.0.9 no Windows 11; código de saída 0. Valores dependentes do host e a duração podem variar.

Comando do exemplo: 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
    }
}
Ver o 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
}

Erros e limites

O contrato público exige success=false e uma message descritiva em caso de falha. Este catálogo ainda não declara uma taxonomia de erros específica para cada comando; revise o resultado e não infira códigos inexistentes.

O QZX está em alpha. Dependências opcionais, permissões e recursos do host podem alterar o 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": 4.133,
        "schema_version": 1
    }
}

Comando capturado: qzx findText "[" ../artifacts/qzx-evidence/golden-core-files -r --regex=true --max-matches=1 --colored=false --json

Fluxo de evidência: capturada e validada por digest.

Evidência e procedência

Canal de documentação
Documentação de desenvolvimento 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
Disponibilidade
0.2.2.0.9 ou anterior

Continue explorando

Comandos relacionados

Estes comandos também pertencem à categoria arquivos. Compare-os para escolher a operação que melhor resolve sua tarefa.

Explorar todos os comandos do QZX