arquivos · Referência do comando

`qzx movePath`

O que faz

Move ou renomeia um arquivo, link simbólico ou diretório completo; rejeita movimentos parciais de diretórios.

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

O QZX só move diretórios completos e usa rename no mesmo sistema de arquivos; rejeita profundidades finitas e movimentos de diretórios entre sistemas de arquivos para não deixar árvores parcialmente copiadas ou excluídas. Arquivos que cruzam sistemas de arquivos são preparados e verificados por tamanho e SHA-256 antes de publicar o destino e remover a origem. Também bloqueia raízes, objetos especiais e relações ancestral/descendente. --force faz backup do destino anterior antes de substituí-lo.

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:1559276c985be85d9f6083622a44962973695297152550858e4261c992176c23 em 2026-08-25.

Sintaxe exata

qzx movePath <source> <destination> [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 da nova localização no sistema de arquivos
force	bool	Não	false	Substitui um destino existente depois de criar um backup de segurança

Exemplos de entrada

qzx movePath source.txt destination.txt

Mover um arquivo ou renomeá-lo

qzx movePath myfile.txt archive/myfile.txt

Mover um arquivo para um diretório de arquivamento

qzx movePath sourcedir destinationdir

Mover um diretório completo

qzx movePath sourcedir destinationdir --force

Fazer backup e substituir um destino existente por um diretório completo

Para obter o payload estruturado completo, adicione --json: qzx movePath <source> <destination> [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 movePath source.txt destination.txt --json

{
    "success": true,
    "message": "Moves or renames one file, symbolic link, or complete directory; partial directory moves are rejected. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "movePath",
        "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",
        "verification": "Example value",
        "replacement_cleanup": "Example value",
        "retained_previous_path": null
    },
    "warnings": [
        {
            "name": "example",
            "status": "ok"
        }
    ]
}

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": [],
                "verification": [],
                "replacement_cleanup": [],
                "retained_previous_path": {
                    "type": "null"
                }
            },
            "additionalProperties": true
        },
        "error": [],
        "error_code": [],
        "warnings": []
    },
    "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/move_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