pre-commit-crocodile 6.2.1__tar.gz → 8.0.0__tar.gz

{pre_commit_crocodile-6.2.1 → pre_commit_crocodile-8.0.0}/.gitlab-ci.yml

@@ -126,6 +126,7 @@ variables:
 
 .local:
   include:
+    'gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commits@$CI_COMMIT_SHA': 'templates/commits.yml'
     'RadianDevCore/gitlab-ci/components': '.gitlab-ci.d'
   no_regex: true
   version: 12.0

{pre_commit_crocodile-6.2.1 → pre_commit_crocodile-8.0.0}/.pre-commit-config.yaml

@@ -10,6 +10,7 @@ default_stages:
   - pre-push
   - prepare-commit-msg
 minimum_pre_commit_version: 3.8.0
+minimum_prek_version: 0.2.0
 
 # pre-commit exclusions
 exclude: >
@@ -77,7 +78,7 @@ repos:
 
   # Repository: commitizen
   - repo: https://github.com/commitizen-tools/commitizen
-    rev: v4.8.3
+    rev: v4.9.1
     hooks:
       - id: commitizen
         stages:
@@ -117,7 +118,7 @@ repos:
 
   # Repository: gcil
   - repo: https://gitlab.com/RadianDevCore/tools/gcil
-    rev: 13.0.0
+    rev: 13.0.1
     hooks:
       - id: run-gcil-push
         name: Run GitLab CI job with gcil (codestyle)

{pre_commit_crocodile-6.2.1 → pre_commit_crocodile-8.0.0}/CHANGELOG.md

@@ -1,5 +1,81 @@
 # Changelog
 
+<a name="8.0.0"></a>
+## [8.0.0](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/compare/7.0.0...8.0.0) (2025-09-14)
+
+### ✨ Features
+
+- **cli:** implement 'includes: remotes:' support and '--remotes' ([c640cb4](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/c640cb498aa1e9dbf1e7951a601f5ba1cd84f373))
+- **pre-commit-config:** migrate to 'prek' 0.2.0 ([efaec2a](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/efaec2a4d6e3e22dc5d125d9d4b3bc7adb8c3a04))
+- **pre-commit-config:** migrate to 'commitizen' v4.9.1 ([731a152](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/731a1527ae19f7e81b4d30729e7bbd1fcc296cc0))
+- **pre-commit-config:** migrate to 'gcil' 13.0.1 ([0d76eef](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/0d76eefad0fb2d8b47e881404b662bbdd0e103fb))
+- **precommit:** migrate to 'prek auto-update' usage ([9e7da0f](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/9e7da0f6eca3b54526fe6a81703f6728dac5cce9))
+- **precommit:** configure 'prek' as default engine ([e172dd6](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/e172dd68cb290335fdaa4d9a755b24b81e8018d3))
+- **src, requirements:** migrate to 'commitizen' 4.9.1+adriandc.20250914 ([b46a211](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/b46a2118c3bb40d1e72fe5c4d85ffe4c1b91a6db))
+
+### 🐛 Bug Fixes
+
+- **assets:** isolate template as '.pre-commit-config.template.yaml' ([4188926](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/4188926227d9949de2bb33d60cee133044b5ee68))
+
+### 📚 Documentation
+
+- **components:** document 'include: remote:' syntax usage ([c415801](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/c4158010673de6bc5ca314ae4e5ae4b122c786be))
+- **readme:** document engine settings configuration ([0b88412](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/0b88412285e15fef4585333739db128959ac471d))
+- **readme:** improve documentation to document provided features ([8d4c424](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/8d4c424a8533457f81d218941e6104c7005264e4))
+- **readme:** move 'prek' default engine first ([c9401ea](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/c9401ead05423257830869ac078a2c84a3f3a7cb))
+
+### ⚙️ Cleanups
+
+- **assets:** use 'PACKAGE_REVISION' simpler text syntax ([b24ae12](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/b24ae12a6167dff377ed8ce6d7b26a7b7a11ba99))
+
+### 🚀 CI
+
+- **commits:** configure 'prek' as default engine ([d07cd24](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/d07cd2478718f6fca5a76106c0e444d9fe59e3da))
+- **commits:** detect duplicated commits titles in checked ranges ([b675527](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/b675527ad8f1624bad2eb5986731b29be7c8a848))
+
+### 📦 Build
+
+- **commits:** raise minimal image version to '7' ([57e2fa3](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/57e2fa354bbf4bdea8819bb6a2c3557ee4d47072))
+
+
+<a name="7.0.0"></a>
+## [7.0.0](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/compare/6.2.1...7.0.0) (2025-08-14)
+
+### ✨ Features
+
+- **cli, features:** implement 'prek' engine 'pre-commit' alternative ([e369d7e](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/e369d7e1d53ccde73be8f8e3e3236e44664a3b0e))
+- **features:** add support for multiple 'PACKAGES' dependencies ([91d1b0e](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/91d1b0ef5d8aab77d2229db9b90aa6018eeab2b4))
+- **main:** implement '--set-engine' to set 'pre-commit' or 'prek' ([1db9afa](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/1db9afafc0a58f8b33640ab3a7fd79bdb1a88f4b))
+- **main:** add 3 seconds warning if engine setting is not done ([305a999](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/305a999595e789e648529c25486837598b55bcf8))
+- **pre-commit:** migrate 'minimum_prek_version' to 0.0.25 ([db06b79](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/db06b7964ff78c11fb67801886e5cfdc3f921e9c))
+- **precommit:** add support for 'prek run' output parsing ([ac36ae3](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/ac36ae31c2d62cd415bcfa0c34e3c858eefcd24e))
+- **src:** isolate 'pre-commit' and 'commitizen' titles to constants ([16ab56f](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/16ab56ffabb2d373446f7c3eb11270cb7dfb9f77))
+
+### 🐛 Bug Fixes
+
+- **main:** show engine warning only without a critical result ([f111b40](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/f111b407e4837c669c1386b7590ff2b354daf2bd))
+- **main, colors:** use '‣' symbol only in UTF-8 terminals ([bdfce45](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/bdfce4558309faf01db57f2e0b9655474ea30700))
+- **version:** enforce against digit only revision with 'x.y.z[-N-gSHA]' ([b9f5983](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/b9f59830e34949375199f9fe09c5c17f992888c7))
+
+### 📚 Documentation
+
+- **readme:** document 'prek' and 'uv' as being use ([747ad94](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/747ad94ce4fb1ace84bd8adc867d3089e6635438))
+- **readme, docs, setup, bundle:** improve description with 'prek' ([b0d4d6e](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/b0d4d6ee4cdf327e8afa5481383fd6c7b3851700))
+
+### 🚀 CI
+
+- **commits:** avoid 'install --install-hooks' upon local jobs ([c4aa944](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/c4aa9440adb8ec4f112070982bc84c2afcb40375))
+- **gitlab-ci:** bind 'commits' job locally for validation tests ([d243212](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/d24321270f908a4e4e37fbdc47c549232e030887))
+
+### 📦 Build
+
+- **commits:** implement 'prek' optional 'pre-commit' engine ([3c5f33d](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/3c5f33da6eeb56b69634fb6ab4af9bdd5fe6ea44))
+- **commits:** optimize Rust compiler caches out of the image ([e132755](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/e13275584218dab883c027aae73f3d2532193c3a))
+- **containers/rehost:** revert to Debian 12 'python:3.13-slim-bookworm' ([287673a](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/287673a731e32dd5f8fd62a6d16c7eebf03ccce6))
+- **requirements:** upgrade to 'playwright' 1.54.0 ([bd5fa6d](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/bd5fa6d8ac781451bb9ac7c6a49744d58e3e6722))
+- **requirements:** install 'prek' 0.0.25 and 'uv' 0.8.10 ([1199962](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/1199962a071c5dcb87ad6bf8eed338d1d1eadb60))
+
+
 <a name="6.2.1"></a>
 ## [6.2.1](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/compare/6.2.0...6.2.1) (2025-08-13)
 

{pre_commit_crocodile-6.2.1/pre_commit_crocodile.egg-info → pre_commit_crocodile-8.0.0}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.4
 Name: pre-commit-crocodile
-Version: 6.2.1
-Summary: Git hooks intended for developers using pre-commit
+Version: 8.0.0
+Summary: Git hooks manager intended for developers using pre-commit, prek and commitizen
 Home-page: https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile
 Author: Adrian DC
 Author-email: radian.dc@gmail.com
@@ -11,7 +11,7 @@ Project-URL: Changelog, https://gitlab.com/RadianDevCore/tools/pre-commit-crocod
 Project-URL: Documentation, https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile#pre-commit-crocodile
 Project-URL: Source, https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile
 Project-URL: Statistics, https://pypistats.org/packages/pre-commit-crocodile
-Keywords: git pre-commit hooks
+Keywords: git pre-commit hooks prek commitizen
 Classifier: Environment :: Console
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
@@ -70,7 +70,7 @@ Dynamic: summary
 [![pre-commit-crocodile](https://img.shields.io/badge/pre--commit--crocodile-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
 [![guidelines](https://img.shields.io/badge/radiandevcore-guidelines-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/wiki/guidelines)
 
-Git hooks intended for developers using [pre-commit](https://pre-commit.com/) and [commitizen](https://commitizen-tools.github.io/commitizen/)
+Git hooks manager intended for developers using [pre-commit](https://pre-commit.com/), [prek](https://github.com/j178/prek) and [commitizen](https://commitizen-tools.github.io/commitizen/).
 
 **Documentation:** <https://radiandevcore.gitlab.io/tools/pre-commit-crocodile>  
 **Package:** <https://pypi.org/project/pre-commit-crocodile/>
@@ -82,15 +82,23 @@ Git hooks intended for developers using [pre-commit](https://pre-commit.com/) an
 **`pre-commit-crocodile` uses the following features:**
 
 - **CLI - [pre-commit](https://pre-commit.com/):** Automated Git hooks before commits and upon pushes
+- **CLI - [prek](https://github.com/j178/prek):** Better `pre-commit`, re-engineered in Rust
 - **CLI - [commitizen](https://commitizen-tools.github.io/commitizen/):** Commits tools and validation based upon [conventional commits](https://www.conventionalcommits.org/en/)
 - **Hooks - [pre-commit-hooks](https://github.com/pre-commit/pre-commit-hooks):** Common `pre-commit` hooks useful for developers
-- **Hooks - `prepare-commit-msg`:** Prepare commit message automatically based on changes
+
+**`pre-commit-crocodile` provides the following features:**
+
+- **CLI - [pre-commit-crocodile](.):** Management tool for `pre-commit` Git hooks
+- **CLI - [pre-commit-crocodile](.):** Easy Git hooks activation for development teams
+- **CLI - [pre-commit-crocodile](.):** Dependencies preparation for [pre-commit](https://pre-commit.com/) or [prek](https://github.com/j178/prek).
+- **CLI - [pre-commit-crocodile](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile/pre-commit/):** Automated customized configurations for maintainers
+- **Hooks - [prepare-commit-msg](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile/hooks/):** Prepare commit message automatically based on changes
 
 ---
 
 ## Preview
 
-![preview.svg](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/raw/6.2.1/docs/preview.svg)
+![preview.svg](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/raw/8.0.0/docs/preview.svg)
 
 ---
 
@@ -104,43 +112,48 @@ Git hooks intended for developers using [pre-commit](https://pre-commit.com/) an
 ```yaml
 usage: pre-commit-crocodile [-h] [--version] [--no-color] [--update-check] [--settings] [--set GROUP KEY VAL]
                             [-l | -i | -c | -b | -e | -d | -a | -C | -r] [--config FOLDER | -D] [--commit]
-                            [--components | --no-components] [--offline] [--stage STAGE] [--]
+                            [--components | --remotes | --no-components] [--offline] [--stage STAGE]
+                            [--set-engine [ENGINE]] [--]
 
-pre-commit-crocodile: Git hooks intended for developers using pre-commit
+pre-commit-crocodile: Git hooks manager intended for developers using pre-commit, prek and commitizen
 
 internal arguments:
-  -h, --help           # Show this help message
-  --version            # Show the current version
-  --no-color           # Disable colors outputs with 'NO_COLOR=1'
-                       # (or default settings: [themes] > no_color)
-  --update-check       # Check for newer package updates
-  --settings           # Show the current settings path and contents
-  --set GROUP KEY VAL  # Set settings specific 'VAL' value to [GROUP] > KEY
-                       # or unset by using 'UNSET' as 'VAL'
+  -h, --help             # Show this help message
+  --version              # Show the current version
+  --no-color             # Disable colors outputs with 'NO_COLOR=1'
+                         # (or default settings: [themes] > no_color)
+  --update-check         # Check for newer package updates
+  --settings             # Show the current settings path and contents
+  --set GROUP KEY VAL    # Set settings specific 'VAL' value to [GROUP] > KEY
+                         # or unset by using 'UNSET' as 'VAL'
 
 modes arguments:
-  -l, --list           # List Git hooks installed in sources
-  -i, --install        # Install dependencies for pre-commit hooks
-  -c, --configure      # Update sources with hooks configurations
-  -b, --badges         # Update documentation with badges configurations
-  -e, --enable         # Enable pre-commit hooks
-  -d, --disable        # Disable pre-commit hooks
-  -a, --autoupdate     # Autoupdate pre-commit hooks
-  -C, --clean          # Clean pre-commit cached hooks
-  -r, --run            # Run pre-commit hooks
+  -l, --list             # List Git hooks installed in sources
+  -i, --install          # Install dependencies for pre-commit hooks
+  -c, --configure        # Update sources with hooks configurations
+  -b, --badges           # Update documentation with badges configurations
+  -e, --enable           # Enable pre-commit hooks
+  -d, --disable          # Disable pre-commit hooks
+  -a, --autoupdate       # Autoupdate pre-commit hooks
+  -C, --clean            # Clean pre-commit cached hooks
+  -r, --run              # Run pre-commit hooks
 
 configurations arguments:
-  --config FOLDER      # Use configurations from a specific folder
-  -D, --default        # Use global default configurations instead of sources
-  --commit             # Commit configurations changes automatically (implies --configure)
-  --components         # Import components from GitLab with 'include: component:'
-  --no-components      # Import components templates locally instead of 'include: component:'
-  --offline            # Use offline mode to disable configurations autoupdate
-  --stage STAGE        # Run a specific pre-commit stage with --run
-                       # (use 'list' to list supported stages)
+  --config FOLDER        # Use configurations from a specific folder
+  -D, --default          # Use global default configurations instead of sources
+  --commit               # Commit configurations changes automatically (implies --configure)
+  --components           # Import components from GitLab with 'include: component:'
+  --remotes              # Import components from GitLab with 'include: remote:'
+  --no-components        # Import components templates locally instead of 'include: component:'
+  --offline              # Use offline mode to disable configurations autoupdate
+  --stage STAGE          # Run a specific pre-commit stage with --run
+                         # (use 'list' to list supported stages)
+
+settings arguments:
+  --set-engine [ENGINE]  # Set pre-commit engine to use (pre-commit, prek, default: pre-commit)
 
 positional arguments:
-  --                   # Positional arguments separator (recommended)
+  --                     # Positional arguments separator (recommended)
 ```
 
 <!-- readme-help-stop -->
@@ -189,6 +202,15 @@ Projects compatible with `pre-commit-crocodile` can use this badge to ease thing
 
 ## Projects with configurations | [![pre-commit-crocodile](https://img.shields.io/badge/pre--commit--crocodile-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
 
+### Configure engine to use (once per user)
+
+- **[prek](https://github.com/j178/prek):** Recent Rust re-implementation, in development and faster (default, recommended)
+- **[pre-commit](https://pre-commit.com/):** Original Python implementation, stable but slower (legacy)
+
+```bash
+pre-commit-crocodile --set-engine [pre-commit,prek]
+```
+
 ### Install dependencies (once per user)
 
 ```bash
@@ -248,9 +270,11 @@ pre-commit-crocodile --clean
 - [colored](https://pypi.org/project/colored/): Terminal colors and styles
 - [commitizen](https://pypi.org/project/commitizen/): Simple commit conventions for internet citizens
 - [pre-commit](https://pre-commit.com/): A framework for managing and maintaining pre-commit hooks
-- [pre-commit-crocodile](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile): Git hooks intended for developers using pre-commit
+- [pre-commit-crocodile](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile): Git hooks manager intended for developers using pre-commit, prek and commitizen
+- [prek](https://github.com/j178/prek): Better `pre-commit`, re-engineered in Rust
 - [setuptools](https://pypi.org/project/setuptools/): Build and manage Python packages
 - [update-checker](https://pypi.org/project/update-checker/): Check for package updates on PyPI
+- [uv](https://github.com/astral-sh/uv): An extremely fast Python package and project manager, written in Rust.
 
 ---
 

{pre_commit_crocodile-6.2.1 → pre_commit_crocodile-8.0.0}/README.md

@@ -20,7 +20,7 @@
 [![pre-commit-crocodile](https://img.shields.io/badge/pre--commit--crocodile-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
 [![guidelines](https://img.shields.io/badge/radiandevcore-guidelines-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/wiki/guidelines)
 
-Git hooks intended for developers using [pre-commit](https://pre-commit.com/) and [commitizen](https://commitizen-tools.github.io/commitizen/)
+Git hooks manager intended for developers using [pre-commit](https://pre-commit.com/), [prek](https://github.com/j178/prek) and [commitizen](https://commitizen-tools.github.io/commitizen/).
 
 **Documentation:** <https://radiandevcore.gitlab.io/tools/pre-commit-crocodile>  
 **Package:** <https://pypi.org/project/pre-commit-crocodile/>
@@ -32,15 +32,23 @@ Git hooks intended for developers using [pre-commit](https://pre-commit.com/) an
 **`pre-commit-crocodile` uses the following features:**
 
 - **CLI - [pre-commit](https://pre-commit.com/):** Automated Git hooks before commits and upon pushes
+- **CLI - [prek](https://github.com/j178/prek):** Better `pre-commit`, re-engineered in Rust
 - **CLI - [commitizen](https://commitizen-tools.github.io/commitizen/):** Commits tools and validation based upon [conventional commits](https://www.conventionalcommits.org/en/)
 - **Hooks - [pre-commit-hooks](https://github.com/pre-commit/pre-commit-hooks):** Common `pre-commit` hooks useful for developers
-- **Hooks - `prepare-commit-msg`:** Prepare commit message automatically based on changes
+
+**`pre-commit-crocodile` provides the following features:**
+
+- **CLI - [pre-commit-crocodile](.):** Management tool for `pre-commit` Git hooks
+- **CLI - [pre-commit-crocodile](.):** Easy Git hooks activation for development teams
+- **CLI - [pre-commit-crocodile](.):** Dependencies preparation for [pre-commit](https://pre-commit.com/) or [prek](https://github.com/j178/prek).
+- **CLI - [pre-commit-crocodile](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile/pre-commit/):** Automated customized configurations for maintainers
+- **Hooks - [prepare-commit-msg](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile/hooks/):** Prepare commit message automatically based on changes
 
 ---
 
 ## Preview
 
-![preview.svg](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/raw/6.2.1/docs/preview.svg)
+![preview.svg](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/raw/8.0.0/docs/preview.svg)
 
 ---
 
@@ -54,43 +62,48 @@ Git hooks intended for developers using [pre-commit](https://pre-commit.com/) an
 ```yaml
 usage: pre-commit-crocodile [-h] [--version] [--no-color] [--update-check] [--settings] [--set GROUP KEY VAL]
                             [-l | -i | -c | -b | -e | -d | -a | -C | -r] [--config FOLDER | -D] [--commit]
-                            [--components | --no-components] [--offline] [--stage STAGE] [--]
+                            [--components | --remotes | --no-components] [--offline] [--stage STAGE]
+                            [--set-engine [ENGINE]] [--]
 
-pre-commit-crocodile: Git hooks intended for developers using pre-commit
+pre-commit-crocodile: Git hooks manager intended for developers using pre-commit, prek and commitizen
 
 internal arguments:
-  -h, --help           # Show this help message
-  --version            # Show the current version
-  --no-color           # Disable colors outputs with 'NO_COLOR=1'
-                       # (or default settings: [themes] > no_color)
-  --update-check       # Check for newer package updates
-  --settings           # Show the current settings path and contents
-  --set GROUP KEY VAL  # Set settings specific 'VAL' value to [GROUP] > KEY
-                       # or unset by using 'UNSET' as 'VAL'
+  -h, --help             # Show this help message
+  --version              # Show the current version
+  --no-color             # Disable colors outputs with 'NO_COLOR=1'
+                         # (or default settings: [themes] > no_color)
+  --update-check         # Check for newer package updates
+  --settings             # Show the current settings path and contents
+  --set GROUP KEY VAL    # Set settings specific 'VAL' value to [GROUP] > KEY
+                         # or unset by using 'UNSET' as 'VAL'
 
 modes arguments:
-  -l, --list           # List Git hooks installed in sources
-  -i, --install        # Install dependencies for pre-commit hooks
-  -c, --configure      # Update sources with hooks configurations
-  -b, --badges         # Update documentation with badges configurations
-  -e, --enable         # Enable pre-commit hooks
-  -d, --disable        # Disable pre-commit hooks
-  -a, --autoupdate     # Autoupdate pre-commit hooks
-  -C, --clean          # Clean pre-commit cached hooks
-  -r, --run            # Run pre-commit hooks
+  -l, --list             # List Git hooks installed in sources
+  -i, --install          # Install dependencies for pre-commit hooks
+  -c, --configure        # Update sources with hooks configurations
+  -b, --badges           # Update documentation with badges configurations
+  -e, --enable           # Enable pre-commit hooks
+  -d, --disable          # Disable pre-commit hooks
+  -a, --autoupdate       # Autoupdate pre-commit hooks
+  -C, --clean            # Clean pre-commit cached hooks
+  -r, --run              # Run pre-commit hooks
 
 configurations arguments:
-  --config FOLDER      # Use configurations from a specific folder
-  -D, --default        # Use global default configurations instead of sources
-  --commit             # Commit configurations changes automatically (implies --configure)
-  --components         # Import components from GitLab with 'include: component:'
-  --no-components      # Import components templates locally instead of 'include: component:'
-  --offline            # Use offline mode to disable configurations autoupdate
-  --stage STAGE        # Run a specific pre-commit stage with --run
-                       # (use 'list' to list supported stages)
+  --config FOLDER        # Use configurations from a specific folder
+  -D, --default          # Use global default configurations instead of sources
+  --commit               # Commit configurations changes automatically (implies --configure)
+  --components           # Import components from GitLab with 'include: component:'
+  --remotes              # Import components from GitLab with 'include: remote:'
+  --no-components        # Import components templates locally instead of 'include: component:'
+  --offline              # Use offline mode to disable configurations autoupdate
+  --stage STAGE          # Run a specific pre-commit stage with --run
+                         # (use 'list' to list supported stages)
+
+settings arguments:
+  --set-engine [ENGINE]  # Set pre-commit engine to use (pre-commit, prek, default: pre-commit)
 
 positional arguments:
-  --                   # Positional arguments separator (recommended)
+  --                     # Positional arguments separator (recommended)
 ```
 
 <!-- readme-help-stop -->
@@ -139,6 +152,15 @@ Projects compatible with `pre-commit-crocodile` can use this badge to ease thing
 
 ## Projects with configurations | [![pre-commit-crocodile](https://img.shields.io/badge/pre--commit--crocodile-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
 
+### Configure engine to use (once per user)
+
+- **[prek](https://github.com/j178/prek):** Recent Rust re-implementation, in development and faster (default, recommended)
+- **[pre-commit](https://pre-commit.com/):** Original Python implementation, stable but slower (legacy)
+
+```bash
+pre-commit-crocodile --set-engine [pre-commit,prek]
+```
+
 ### Install dependencies (once per user)
 
 ```bash
@@ -198,9 +220,11 @@ pre-commit-crocodile --clean
 - [colored](https://pypi.org/project/colored/): Terminal colors and styles
 - [commitizen](https://pypi.org/project/commitizen/): Simple commit conventions for internet citizens
 - [pre-commit](https://pre-commit.com/): A framework for managing and maintaining pre-commit hooks
-- [pre-commit-crocodile](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile): Git hooks intended for developers using pre-commit
+- [pre-commit-crocodile](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile): Git hooks manager intended for developers using pre-commit, prek and commitizen
+- [prek](https://github.com/j178/prek): Better `pre-commit`, re-engineered in Rust
 - [setuptools](https://pypi.org/project/setuptools/): Build and manage Python packages
 - [update-checker](https://pypi.org/project/update-checker/): Check for package updates on PyPI
+- [uv](https://github.com/astral-sh/uv): An extremely fast Python package and project manager, written in Rust.
 
 ---
 

{pre_commit_crocodile-6.2.1 → pre_commit_crocodile-8.0.0}/containers/commits/Dockerfile

@@ -12,10 +12,12 @@ RUN apk add -q --no-cache  \
 
 # Install requirements
 COPY --from='requirements' ./commits.txt /tmp/
-RUN export PIP_DISABLE_PIP_VERSION_CHECK=1 \
+RUN --mount=type=cache,target=/root/.cache \
+    --mount=type=cache,target=/root/.rustup \
+    export PIP_DISABLE_PIP_VERSION_CHECK=1 \
  && pip3 install -q -r /tmp/commits.txt --no-cache-dir --upgrade \
  && rm -f /tmp/commits.txt
 
 # Create image version
-ARG IMAGE_VERSION=5
+ARG IMAGE_VERSION=7
 RUN echo -n "${IMAGE_VERSION}" >/VERSION

{pre_commit_crocodile-6.2.1 → pre_commit_crocodile-8.0.0}/containers/rehost/images.txt

@@ -1,6 +1,6 @@
 python:3.9
 python:3.13
 python:3.13-alpine
-python:3.13-slim
+python:3.13-slim-bookworm|python:3.13-slim
 sonarsource/sonar-scanner-cli:latest
 tobix/pywine:3.10

{pre_commit_crocodile-6.2.1 → pre_commit_crocodile-8.0.0}/docs/commitizen.md

@@ -19,7 +19,7 @@
 [![gcil](https://img.shields.io/badge/gcil-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/gcil)
 [![pre-commit-crocodile](https://img.shields.io/badge/pre--commit--crocodile-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
 
-Git hooks intended for developers using [pre-commit](https://pre-commit.com/) and [commitizen](https://commitizen-tools.github.io/commitizen/).
+Git hooks manager intended for developers using [pre-commit](https://pre-commit.com/), [prek](https://github.com/j178/prek) and [commitizen](https://commitizen-tools.github.io/commitizen/).
 
 ---
 

{pre_commit_crocodile-6.2.1 → pre_commit_crocodile-8.0.0}/docs/commits.md

@@ -19,7 +19,7 @@
 [![gcil](https://img.shields.io/badge/gcil-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/gcil)
 [![pre-commit-crocodile](https://img.shields.io/badge/pre--commit--crocodile-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
 
-Git hooks intended for developers using [pre-commit](https://pre-commit.com/) and [commitizen](https://commitizen-tools.github.io/commitizen/).
+Git hooks manager intended for developers using [pre-commit](https://pre-commit.com/), [prek](https://github.com/j178/prek) and [commitizen](https://commitizen-tools.github.io/commitizen/).
 
 ---
 

{pre_commit_crocodile-6.2.1 → pre_commit_crocodile-8.0.0}/docs/components.md

@@ -19,7 +19,7 @@
 [![gcil](https://img.shields.io/badge/gcil-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/gcil)
 [![pre-commit-crocodile](https://img.shields.io/badge/pre--commit--crocodile-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
 
-Git hooks intended for developers using [pre-commit](https://pre-commit.com/) and [commitizen](https://commitizen-tools.github.io/commitizen/).
+Git hooks manager intended for developers using [pre-commit](https://pre-commit.com/), [prek](https://github.com/j178/prek) and [commitizen](https://commitizen-tools.github.io/commitizen/).
 
 ---
 
@@ -41,6 +41,7 @@ Git hooks intended for developers using [pre-commit](https://pre-commit.com/) an
 ```yaml title="Sources / .gitlab-ci.yml"
 include:
   - component: gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commits@X.Y.Z # Adapt to latest release tag
+    # remote: https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/-/raw/X.Y.Z/templates/commits.yml # Use on self-managed GitLab instances
     inputs:
       stage: prepare
 

{pre_commit_crocodile-6.2.1 → pre_commit_crocodile-8.0.0}/docs/hooks.md

@@ -19,7 +19,7 @@
 [![gcil](https://img.shields.io/badge/gcil-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/gcil)
 [![pre-commit-crocodile](https://img.shields.io/badge/pre--commit--crocodile-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
 
-Git hooks intended for developers using [pre-commit](https://pre-commit.com/) and [commitizen](https://commitizen-tools.github.io/commitizen/).
+Git hooks manager intended for developers using [pre-commit](https://pre-commit.com/), [prek](https://github.com/j178/prek) and [commitizen](https://commitizen-tools.github.io/commitizen/).
 
 ---
 
@@ -38,6 +38,7 @@ default_stages:
   - pre-commit
   - pre-push
 minimum_pre_commit_version: 3.8.0
+minimum_prek_version: 0.2.0
 
 # pre-commit repositories
 repos:

{pre_commit_crocodile-6.2.1 → pre_commit_crocodile-8.0.0}/docs/pre-commit.md

@@ -19,7 +19,7 @@
 [![gcil](https://img.shields.io/badge/gcil-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/gcil)
 [![pre-commit-crocodile](https://img.shields.io/badge/pre--commit--crocodile-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
 
-Git hooks intended for developers using [pre-commit](https://pre-commit.com/) and [commitizen](https://commitizen-tools.github.io/commitizen/).
+Git hooks manager intended for developers using [pre-commit](https://pre-commit.com/), [prek](https://github.com/j178/prek) and [commitizen](https://commitizen-tools.github.io/commitizen/).
 
 ---
 

{pre_commit_crocodile-6.2.1 → pre_commit_crocodile-8.0.0}/docs/settings.md

@@ -20,7 +20,7 @@
 [![gcil](https://img.shields.io/badge/gcil-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/gcil)
 [![pre-commit-crocodile](https://img.shields.io/badge/pre--commit--crocodile-enabled-brightgreen?logo=gitlab)](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
 
-Git hooks intended for developers using [pre-commit](https://pre-commit.com/) and [commitizen](https://commitizen-tools.github.io/commitizen/).
+Git hooks manager intended for developers using [pre-commit](https://pre-commit.com/), [prek](https://github.com/j178/prek) and [commitizen](https://commitizen-tools.github.io/commitizen/).
 
 ---
 

{pre_commit_crocodile-6.2.1 → pre_commit_crocodile-8.0.0}/mkdocs.yml

@@ -7,7 +7,7 @@ site_dir: public
 
 # Project information
 site_author: Adrian DC
-site_description: Git hooks intended for developers using pre-commit
+site_description: Git hooks manager intended for developers using pre-commit, prek and commitizen
 
 # Project repository
 repo_name: RadianDevCore/tools