Git Commit Hooks

🚀Git Commit Hooks

Active

Pertahankan repository checks saat Custy berjalan secara lokal atau di dalam container dengan operating system berbeda.

Command[tool.custy.git.hooks]

📦Category

Git Configuration

🚀Quick Command

[tool.custy.git.hooks]

---

safe defaultspre-commitcontainers

---

📋

Property

mode

⚙️

Default

auto

✅

Silent Bypass

Tidak Pernah

🌿

Project Tanpa Hook

Native Git

Configuration

📋Properties

Property	Type	Description	Default	Required
mode	auto | native | pre_commit	Pilih native Git execution atau verified direct pre-commit execution.	auto	No

Recommended default

toml

[tool.custy.git.hooks]
mode = "auto"

Behavior Matrix

ℹ️Hook Resolution

auto + tidak ada installed hook	Gunakan normal Git commit behavior. pre-commit tidak diwajibkan atau diaktifkan.
auto + compatible hook	Biarkan Git menjalankan installed hook secara native.
auto + incompatible pre-commit wrapper	Jalankan recognized configured pre-commit stage secara langsung, lalu lewati hanya wrapper yang sudah selesai untuk current commit.
auto + incompatible custom hook	Berhenti dengan aman karena Custy tidak dapat membuktikan equivalent execution path.
native	Selalu biarkan Git menjalankan installed hooks persis seperti yang tersimpan di repository.
pre_commit	Wajibkan .pre-commit-config.yaml dan pre-commit executable, jalankan configured stages secara langsung, dan lanjutkan hanya setelah semuanya lolos.

ℹ️Configuration File Saja Tidak Menginstal Hook

Dalam mode auto, .pre-commit-config.yaml tanpa installed .git/hooks/pre-commit wrapper diperlakukan seperti repository tanpa hook. Gunakan pre-commit install saat project memang ingin Git menegakkan checks tersebut, atau pilih pre_commit secara explicit saat Custy harus mewajibkan direct execution.

⚠️Direct Execution adalah Validation, Bukan Bypass

Custy menggunakan Git --no-verify hanya setelah setiap recognized wrapper yang akan dilewati flag tersebut berhasil dijalankan melalui pre-commit. Unknown custom hooks, unavailable tooling, missing configuration, dan failed checks menghentikan workflow. Tidak ada mode skip.

Panduan Local dan Docker

• Pertahankan mode = "auto" untuk kebanyakan project, termasuk project yang tidak menggunakan pre-commit.
• Gunakan native ketika custom hooks sudah portable pada setiap execution environment.
• Gunakan pre_commit ketika project policy mewajibkan direct framework execution.
• Instal local support dengan pip install "custy[hooks]". Production image sudah menyertakan pre-commit.
• Direct check yang gagal menghasilkan PRE_COMMIT_HOOK_FAILED dan tidak membuat Git commit.

Lanjutkan

🚀Related Commands

Commands commonly used together with this command.

Git Overview

Navigasikan remotes, push strategy, dan hooks.

Docker

Jalankan Custy pada mounted repositories.

Commit Troubleshooting

Atasi hook dan commit failures.