pengembangan · Referensi perintah
qzx prepareRelease
Apa fungsinya
Merencanakan pembaruan metadata versi dan dapat memodifikasi manifest serta CHANGELOG.md secara atomik; tidak pernah melakukan build, commit, tagging, atau publikasi.
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
Mode nyata menerapkan perubahan yang Anda minta
Pratinjau tersedia
Menggunakan alat native saat diperlukan
Berfungsi tanpa menggunakan jaringan
Menggunakan izin Anda saat ini; hasil dapat bervariasi
Pratinjau adalah perilaku default. Untuk menerapkan, diperlukan cadangan proyek dengan perlindungan kegagalan, satu manifest yang tidak ambigu, catatan yang telah ditinjau saat changelog diperbarui, dan secara default working tree Git yang bersih. Tidak pernah menjalankan test, build, commit, tag, publikasi, atau deployment.
QZX membuat arsip pemulihan sebelum perubahan nyata; gunakan --dangerously-bypass-approvals-and-sandbox/--yolo hanya jika Anda sengaja memilih untuk melewatinya.
Klasifikasi keamanan ini ditinjau oleh OpenAI GPT-5.6 Pro terhadap digest implementasi sha256:50bb166bd5377dc55fb00399daa06e678700dee990c8e0069b2b75e14bd88a7f pada 2026-08-25.
Sintaks persis
qzx prepareRelease [bump] [path] [dry_run] [new_version] [release_notes] [update_changelog] [require_clean_git] [manifest] --jsonParameter
Geser atau gunakan bilah horizontal untuk melihat semua kolom.
| Nama | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| bump | str | Tidak | "patch" | Kenaikan versi: patch, minor, atau major |
| path | str | Tidak | "." | Direktori proyek yang akan disiapkan |
| dry_run | bool | Tidak | true | Mempratinjau perubahan metadata secara persis tanpa menuliskannya |
| new_version | str | Tidak | Tidak dideklarasikan | Versi target eksplisit; direkomendasikan untuk pra-rilis dan proyek yang tidak menggunakan SemVer tiga bagian |
| release_notes | str | Tidak | Tidak dideklarasikan | Teks changelog yang telah ditinjau; wajib saat menerapkan dengan update_changelog=true |
| update_changelog | bool | Tidak | true | Menambahkan entri yang telah ditinjau ke bagian awal CHANGELOG.md |
| require_clean_git | bool | Tidak | true | Mengharuskan proyek memiliki working tree Git yang bersih sebelum menerapkan perubahan |
| manifest | str | Tidak | Tidak dideklarasikan | Jalur eksplisit manifest kompatibel di dalam proyek ketika deteksi otomatis ambigu |
Contoh input
qzx prepareReleasePratinjau versi patch berikutnya dan semua prasyarat persiapan
qzx prepareRelease --new-version 2.0.0rc1 --release-notes "Release candidate with reviewed fixes" --dry-run falseCadangkan proyek yang bersih dan siapkan pra-rilis Python eksplisit secara atomik tanpa membuat commit atau tag
Untuk mendapatkan payload terstruktur lengkap, tambahkan --json: qzx prepareRelease [bump] [path] [dry_run] [new_version] [release_notes] [update_changelog] [require_clean_git] [manifest] --json
Contoh output representatif
JSON ilustratif ini berasal dari kontrak hasil yang didukung implementasi saat ini. Ini menunjukkan apa yang dapat dikembalikan perintah tanpa mengklaim sebagai eksekusi yang direkam; nilainya bervariasi menurut input, mesin, izin, dan alat opsional.
Perintah contoh: qzx prepareRelease --json
{
"success": true,
"message": "Plans a release metadata update and can atomically update one manifest plus CHANGELOG.md; it never builds, commits, tags, or publishes. In this illustrative example, the command completed successfully.",
"meta": {
"command": "prepareRelease",
"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
},
"changes_applied": true,
"details": {
"summary": "Additional structured context is included here."
},
"dry_run": true,
"plan": "Example value",
"status": "ok"
}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
},
"changes_applied": {
"type": "boolean"
},
"details": [],
"dry_run": {
"type": "boolean"
},
"error": {
"type": "string"
},
"error_code": {
"type": "string"
},
"plan": [],
"status": {
"type": "string"
}
},
"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.
Alur bukti: memerlukan lingkungan privileged yang terkontrol.
Bukti dan asal-usul
- Implementasi
- src/qzx/commands/development/prepare_release.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 terkait
Perintah ini juga termasuk kategori pengembangan. Bandingkan untuk memilih operasi yang paling sesuai bagi tugas Anda.
qzx planProjectBootstrapMenyusun rencana yang dapat dipilih untuk memulai proyek tanpa menulis file, menginstal dependency, membuat rahasia, atau menjalankan migrasi.qzx projectLanguagesMemprofilkan bahasa sumber dan format pendukung proyek dengan persentase berdasarkan baris, file, dan byte.qzx getProjectTreeMenghasilkan tree terbatas dalam ASCII dan JSON tanpa mengikuti symbolic link turunan.qzx scaffoldCMembuat struktur dasar untuk program C.