mirror of
https://github.com/godotengine/godot.git
synced 2024-11-21 03:18:37 +08:00
5408af1407
When going from version 14 to 15 it would introduce a tiny change in `websocket_macros.h` just before the comment re-enabling clang-format, but this can be solved by just letting it do its work. Bonus cosmetic change in `math_fieldwise.cpp` where clang-format isn't used, and bump recommended versions for pre-commit hook to [13; 15]. |
||
---|---|---|
.. | ||
canonicalize_filename.sh | ||
pre-commit | ||
pre-commit-black | ||
pre-commit-clang-format | ||
pre-commit-make-rst | ||
README.md | ||
winmessage.ps1 |
Git hooks for Godot Engine
This folder contains Git hooks meant to be installed locally by Godot Engine contributors to make sure they comply with our requirements.
List of hooks
- Pre-commit hook for
clang-format
: Appliesclang-format
to the staged files before accepting a commit; blocks the commit and generates a patch if the style is not respected. You may need to edit the file if yourclang-format
binary is not in thePATH
, or if you want to enable colored output withpygmentize
. - Pre-commit hook for
black
: Appliesblack
to the staged Python files before accepting a commit. - Pre-commit hook for
make_rst
: Checks the class reference syntax usingmake_rst.py
.
Installation
Copy all the files from this folder into your .git/hooks
folder, and make
sure the hooks and helper scripts are executable.
Linux/MacOS
The hooks rely on bash scripts and tools which should be in the system PATH
,
so they should work out of the box on Linux/macOS.
Windows
clang-format
- Download LLVM for Windows (version 13 or later) from https://releases.llvm.org/download.html
- Make sure LLVM is added to the
PATH
during installation
black
- Python installation: make sure Python is added to the
PATH
- Install
black
- in any console:pip3 install black
Custom hooks
The pre-commit hook will run any other script in .git/hooks
whose filename
matches pre-commit-custom-*
, after the Godot ones.