kde-6-widget-starter
Code Issues

feat: add git pre-commit hooks

Browse Source
This commit is contained in:
ruinivist
2026-02-24 00:11:31 +00:00
parent 819e824552
commit ecb375b5f0
3 changed files with 31 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.githooks/pre-commit
Executable
+14
View File
@@ -0,0 +1,14 @@
#!/usr/bin/env bash
set -euo pipefail
repo_root="$(git rev-parse --show-toplevel)"
cd "$repo_root"
echo "[pre-commit] Running make format..."
make format
echo "[pre-commit] Staging formatting changes..."
git add -A
echo "[pre-commit] Running make lint..."
make lint
Makefile
+8
View File
@@ -30,6 +30,14 @@ help:
@echo " make clean Remove build artifacts"
@echo " make format Format QML, C++, JSON, YAML, and Markdown files"
@echo " make lint Run non-mutating lint and formatting checks"
@echo " make hooks-install Configure Git to use versioned hooks from .githooks/"
# Git Hooks
# Configure Git to use versioned hooks stored in this repository.
.PHONY: hooks-install
hooks-install:
git config core.hooksPath .githooks
@echo "Configured core.hooksPath=.githooks"
# C++ Bridge Build Targets
# Generate CMake build files for the C++ QML bridge.
README.md
+9 -8
View File
@@ -24,14 +24,15 @@ sudo pacman -S plasma-sdk inotify-tools kirigami2 qt6-base qt6-declarative
## Quick Start
1. Clone this repository.
2. If you use VS Code, run `make cpp-build` once to build the C++ bridge and generate IDE metadata for autocomplete. Then install the official QML extension and reload the VS Code window.
3. Start hot reload while editing with `make watch`.
4. Install a symlinked development version with `make dev-install`.
5. For a normal local install (non-symlinked), use `make install`.
6. Check style/lint status with `make lint`.
7. Format everything with `make format`.
8. Test in different modes with `make test`, `make test-panel`, `make test-desktop`, or `make test-hidpi`.
9. Package for distribution with `make package` (creates `build/<widget-id>.plasmoid`, default: `build/org.kde.plasma.starter.plasmoid`). This is just a zip file with a different extension, so you can inspect it with any archive manager.
2. Run `make hooks-install` once to enable Git hooks from `.githooks/`.
3. If you use VS Code, run `make cpp-build` once to build the C++ bridge and generate IDE metadata for autocomplete. Then install the official QML extension and reload the VS Code window.
4. Start hot reload while editing with `make watch`.
5. Install a symlinked development version with `make dev-install`.
6. For a normal local install (non-symlinked), use `make install`.
7. Check style/lint status with `make lint`.
8. Format everything with `make format`.
9. Test in different modes with `make test`, `make test-panel`, `make test-desktop`, or `make test-hidpi`.
10. Package for distribution with `make package` (creates `build/<widget-id>.plasmoid`, default: `build/org.kde.plasma.starter.plasmoid`). This is just a zip file with a different extension, so you can inspect it with any archive manager.
## Editor Setup Notes