archivos · Referencia de comando

`qzx calculateFileHash`

Qué hace

Calcula hashes criptográficos MD5, SHA-1 y SHA-256 de un archivo.

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.7a5. La documentación corresponde al checkout alpha 0.2.2.0.7a5.

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 Codex agent contra el digest de implementación sha256:f5db2959aedf2a872c54cb7f46fc561720974e3a1ef951ffea821d796beb12e5 el 2026-08-08.

Sintaxis exacta

qzx calculateFileHash <file_path> [algorithm] --json

Parámetros

Desliza o usa la barra horizontal para ver todas las columnas.

Nombre	Tipo	Obligatorio	Predeterminado	Descripción
file_path	str	Sí	No declarado	Ruta del archivo cuyo hash se calculará
algorithm	str	No	"sha256"	Algoritmo de hash que se usará (sha256, sha1 o md5)

Ejemplos de entrada

qzx calculateFileHash file.txt

Calcular el hash SHA-256 de file.txt

qzx calculateFileHash file.txt md5

Calcular el hash MD5 de file.txt

Para obtener la carga estructurada completa, añade --json: qzx calculateFileHash <file_path> [algorithm] --json

Ejemplo de salida observada

Capturado con QZX 0.2.2.0.7a5 en Windows 11; código de salida 0. Los valores dependientes del host y la duración pueden variar.

Comando del ejemplo: qzx calculateFileHash ../artifacts/qzx-evidence/golden-core-files/alpha.txt sha256 --json

{
    "success": true,
    "file_path": "C:\\Team Dropbox\\Valis Idealis\\Ale\\Programacion\\QZX - Quick Zap Exchange\\artifacts\\qzx-evidence\\golden-core-files\\alpha.txt",
    "algorithm": "sha256",
    "hash": "58d32d5e56b4815d6cd4d2ebd18f8ca825804ad4efa2067197dd5e93132e73df",
    "file_size": 33,
    "file_size_readable": "33.00 B",
    "message": "SHA256 hash for '../artifacts/qzx-evidence/golden-core-files/alpha.txt': 58d32d5e56b4815d6cd4d2ebd18f8ca825804ad4efa2067197dd5e93132e73df",
    "meta": {
        "command": "calculateFileHash",
        "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": 12.808,
        "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
        },
        "algorithm": [],
        "error": {
            "type": "string"
        },
        "file_path": [],
        "file_size": [],
        "file_size_readable": [],
        "hash": []
    },
    "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": "File '../artifacts/qzx-evidence/golden-core-files/missing.txt' does not exist.",
    "message": "File '../artifacts/qzx-evidence/golden-core-files/missing.txt' does not exist.",
    "meta": {
        "command": "calculateFileHash",
        "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": 6.688,
        "schema_version": 1
    }
}

Comando capturado: qzx calculateFileHash ../artifacts/qzx-evidence/golden-core-files/missing.txt sha256 --json

Flujo de evidencia: capturada y validada por digest.

Evidencia y procedencia

Implementación: src/qzx/commands/file/calculate_file_hash.py
Pruebas: tests/test_file_commands/test_calculate_file_hash.py
Canal de documentación: Documentación de desarrollo 0.2.2.0.7a5 · main · sha256:f2555cf1c06a4bb51aacdb4c3cfb8a4dcdaa991d21751f203e889bd3653fcd24
Disponibilidad: 0.2.2.0.7a5 o anterior

Sigue explorando

Estos comandos también pertenecen a la categoría de archivos. Compáralos para elegir la operación que mejor resuelva tu tarea.

Explorar todos los comandos de QZX