arquivos · Referência do comando

`qzx changePermissions`

O que faz

Altera as permissões de um arquivo ou diretório.

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

Sintaxe exata

qzx changePermissions <path> <mode> [recursive] --json

Parâmetros

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

Nome	Tipo	Obrigatório	Padrão	Descrição
path	str	Sim	Não declarado	Caminho do arquivo ou diretório
mode	str	Sim	Não declarado	Modo de permissões em octal (por exemplo, 755) ou em formato de string (por exemplo, "a+x")
recursive	bool	Não	false	Indica se as permissões são aplicadas recursivamente: -r/--recursive sem limite ou -rN/--recursiveN até N níveis

Exemplos de entrada

qzx changePermissions myfile.txt 644

Alterar as permissões de um arquivo para 644 (rw-r--r--)

qzx changePermissions myscript.sh "a+x"

Tornar um script executável para todos os usuários

qzx changePermissions mydir 755 -r

Alterar recursivamente as permissões de um diretório

qzx changePermissions mydir 755 -r2

Alterar as permissões de um diretório até 2 níveis de profundidade

Para obter o payload estruturado completo, adicione --json: qzx changePermissions <path> <mode> [recursive] --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 changePermissions myfile.txt 644 --json

{
    "success": true,
    "message": "Changes permissions of a file or directory. In this illustrative example, the command completed successfully.",
    "meta": {
        "command": "changePermissions",
        "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
    },
    "items_modified": "Example value",
    "mode": "default",
    "path": "C:\\project\\example.txt",
    "recursive": true,
    "type": "file",
    "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
        },
        "error": {
            "type": "string"
        },
        "items_modified": [],
        "mode": [],
        "path": [],
        "recursive": [],
        "type": {
            "type": "string"
        },
        "warnings": {
            "type": "array"
        }
    },
    "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/change_permissions.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