arquivos · Referência do comando

`qzx copyPath`

O que faz

Copia um arquivo, link simbólico ou diretório para um destino separado, com profundidade e substituição explícitas.

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

O modo real aplica as alterações solicitadas

Execução direta para esta operação

Funciona sem invocar programas nativos

Funciona sem usar a rede

Usa suas permissões atuais; o resultado pode variar

Criar um destino novo é uma operação direta. Os arquivos são verificados por tamanho e SHA-256, e os links simbólicos são preservados sem serem seguidos. O QZX bloqueia raízes do filesystem, objetos especiais, origem=destino e qualquer relação ancestral/descendente que possa provocar recursão ou apagar a origem. --force só substitui um destino existente depois de criar um backup recuperável.

O QZX cria um arquivo de recuperação antes das alterações reais; use --dangerously-bypass-approvals-and-sandbox/--yolo somente quando decidir ignorá-lo deliberadamente.

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

Sintaxe exata

qzx copyPath <source> <destination> [recursive] [force] --json

Parâmetros

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

Nome	Tipo	Obrigatório	Padrão	Descrição
source	str	Sim	Não declarado	Caminho do arquivo, link simbólico ou diretório de origem
destination	str	Sim	Não declarado	Caminho do destino separado
recursive	str	Não	Não declarado	Para diretórios: omitir ou usar -r copia tudo; -rN limita a N níveis e false/0 cria apenas a raiz
force	bool	Não	false	Substitui um destino existente depois de criar um backup de segurança

Exemplos de entrada

qzx copyPath source.txt destination.txt

Copiar um arquivo regular e verificá-lo com SHA-256

qzx copyPath myfile.txt backup/myfile.txt

Copiar um arquivo para um diretório de backup

qzx copyPath sourcedir destinationdir -r

Copiar um diretório completo preservando os links simbólicos

qzx copyPath sourcedir destinationdir -r2

Copiar um diretório até dois níveis de profundidade

qzx copyPath sourcedir destinationdir -r --force

Fazer backup e substituir um destino existente por uma cópia completa

Para obter o payload estruturado completo, adicione --json: qzx copyPath <source> <destination> [recursive] [force] --json

Exemplo de saída representativa

Este JSON ilustrativo deriva do contrato de resultado respaldado pela implementação atual. Mostra o que o comando pode retornar sem afirmar que seja uma execução gravada; os valores variam conforme entradas, máquina, permissões e ferramentas opcionais.

Comando do exemplo: qzx copyPath source.txt destination.txt --json

{
    "success": true,
    "message": "Copies one file, symbolic link, or directory to a separate destination with explicit depth and replacement behavior. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "copyPath",
        "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
    },
    "details": {
        "status": "ok",
        "source_exists_after": "C:\\project\\example.txt",
        "destination_exists_after": "C:\\project\\example.txt"
    }
}

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
        },
        "details": {
            "type": "object",
            "properties": {
                "status": {
                    "type": "string"
                },
                "source_exists_after": [],
                "destination_exists_after": []
            },
            "additionalProperties": true
        },
        "error": [],
        "error_code": []
    },
    "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.

Fluxo de evidência: requer um ambiente privilegiado controlado.

Evidência e procedência

Implementação: src/qzx/commands/file/copy_path.py
Testes: Não foi encontrado um arquivo de teste específico com o mesmo nome do módulo; isso não demonstra ausência total de cobertura.
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

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