file · Referensi perintah

`qzx calculateFileHash`

Apa fungsinya

Menghitung hash kriptografis MD5, SHA-1, dan SHA-256 dari sebuah file.

Kematangan perintah: Alpha

Tersedia untuk penggunaan nyata dan umpan balik sementara antarmuka serta perilakunya masih dapat berkembang. Ini adalah evaluasi saat ini untuk checkout pengembangan. Setiap tag rilis immutable di masa mendatang akan mempertahankan evaluasi persis yang disertakan dalam versi tersebut. Tersedia di PyPI 0.2.2.0.9. Dokumentasi ini sesuai dengan checkout alpha 0.2.2.0.9.

Perilaku dan perlindungan bawaan

Memeriksa tanpa mengubah status

Eksekusi langsung untuk operasi ini

Berfungsi tanpa memanggil program native

Berfungsi tanpa menggunakan jaringan

Dirancang untuk bekerja tanpa elevasi hak akses

Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Pro terhadap digest implementasi sha256:e8a9c4f9d792ece0b4d3fdfc47c82d9b474c1eca0206e796076c039f9558496a pada 2026-08-25.

Sintaks persis

qzx calculateFileHash <file_path> [algorithm] --json

Parameter

Geser atau gunakan bilah horizontal untuk melihat semua kolom.

Nama	Tipe	Wajib	Default	Deskripsi
file_path	str	Ya	Tidak dideklarasikan	Jalur file yang hash-nya akan dihitung
algorithm	str	Tidak	"sha256"	Algoritma hash yang digunakan (sha256, sha1, atau md5)

Contoh input

qzx calculateFileHash file.txt

Hitung hash SHA-256 file.txt

qzx calculateFileHash file.txt md5

Hitung hash MD5 file.txt

Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx calculateFileHash <file_path> [algorithm] --json

Contoh output yang diamati

Ditangkap dengan QZX 0.2.2.0.9 di Windows 11; kode keluar 0. Nilai yang bergantung pada host dan durasi dapat bervariasi.

Perintah contoh: 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": 4.623,
        "schema_version": 1
    }
}

Lihat kontrak hasil 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
}

Kesalahan dan batasan

Kontrak publik mensyaratkan success=false dan message yang deskriptif saat gagal. Katalog ini belum mendeklarasikan taksonomi kesalahan khusus untuk setiap perintah; periksa hasil dan jangan menyimpulkan kode yang tidak ada.

QZX masih dalam tahap alpha. Dependency opsional, izin, dan kemampuan host dapat mengubah hasil.

{
    "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": 4.017,
        "schema_version": 1
    }
}

Perintah yang ditangkap: qzx calculateFileHash ../artifacts/qzx-evidence/golden-core-files/missing.txt sha256 --json

Alur bukti: ditangkap dan divalidasi dengan digest.

Bukti dan asal-usul

Implementasi: src/qzx/commands/file/calculate_file_hash.py
Pengujian: tests/test_file_commands/test_calculate_file_hash.py
Kanal dokumentasi: Dokumentasi pengembangan 0.2.2.0.9 · main · sha256:cfba936e39931c286ca23add0ae546693db17d8b316e7cbc3891d26642d9b7e8
Ketersediaan: 0.2.2.0.9 atau lebih lama

Lanjut jelajahi

Perintah ini juga termasuk kategori file. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.

Jelajahi semua perintah QZX