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

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

@@ -1,5 +1,5 @@
 include:
-  - component: gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commits@$CI_COMMIT_SHA
+  - component: $CI_SERVER_FQDN/$CI_PROJECT_PATH/commits@$CI_COMMIT_SHA
     inputs:
       stage: prepare
   - project: RadianDevCore/gitlab-ci/components
@@ -504,6 +504,8 @@ quality:sonarcloud:
     - job: coverage:linux
     - job: coverage:windows
   rules:
+    - if: $SONAR_HOST_URL == null || $SONAR_TOKEN == null
+      when: never
     - if: $CI_COMMIT_REF_NAME == $CI_DEFAULT_BRANCH
       changes:
         - 'CHANGELOG.md'
@@ -512,7 +514,7 @@ quality:sonarcloud:
         - 'src/**/*'
         - 'tests/**/*'
       when: always
-    - if: $CI_COMMIT_REF_NAME == "main"
+    - if: $CI_COMMIT_REF_NAME == 'main'
       when: always
     - if: $CI_PIPELINE_SOURCE == 'merge_request_event'
       when: always

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

@@ -10,7 +10,7 @@ default_stages:
   - pre-push
   - prepare-commit-msg
 minimum_pre_commit_version: 3.8.0
-minimum_prek_version: 0.2.0
+minimum_prek_version: 0.2.1
 
 # pre-commit exclusions
 exclude: >

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

@@ -1,5 +1,37 @@
 # Changelog
 
+<a name="8.1.0"></a>
+## [8.1.0](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/compare/8.0.1...8.1.0) (2025-09-16)
+
+### 🚀 CI
+
+- **commits:** disable 'set -x' verbose execution logs ([e012b91](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/e012b9121601c638fbdb18a42fb694e935cc3967))
+- **commits:** implement 'validate_commitizen_config' CI/CD input ([ba5d5e5](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/ba5d5e5a5951d06270a9f4e46ee795f932b0c86f))
+- **commits:** implement 'validate_commitizen_range' CI/CD input ([14eee9d](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/14eee9df39cf7bb2ea7e048ce6c331eaa5392022))
+- **commits:** implement 'validate_hooks_checks' CI/CD input ([a507ec3](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/a507ec328fc37e0ea6f8592e56b9a6f59ec4091c))
+- **commits:** implement 'validate_duplicated_commits' CI/CD input ([08da916](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/08da91672352b97378d57176eade685704a0ce4e))
+- **commits:** implement 'validate_wip_commits' CI/CD input ([dcd6e6a](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/dcd6e6a5b822107731a83b66d1e36a669111eeb0))
+
+
+<a name="8.0.1"></a>
+## [8.0.1](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/compare/8.0.0...8.0.1) (2025-09-15)
+
+### ✨ Features
+
+- **pre-commit-config:** migrate to 'prek' 0.2.1 ([5663ddf](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/5663ddf6421f5d597e6a8258c87ce180ca02ed1f))
+
+### 🐛 Bug Fixes
+
+- **precommit:** resolve 'pip install PACKAGE1 PACKAGE2' usage ([cfe7274](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/cfe7274b038ddb81476254b93e4e770cdcb9a6ee))
+
+### 🚀 CI
+
+- **commits:** upgrade engine if older than 'minimum_{pre_commit,prek}_version' ([d78936a](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/d78936ac5d5a7da24d7701ce7c3478c1cdc64676))
+- **gitlab-ci:** use '$CI_SERVER_FQDN/$CI_PROJECT_PATH' for forks ([5ba2f44](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/5ba2f4491c3f663c78785e54baa5e450c30fe82f))
+- **gitlab-ci:** resolve 'CI_COMMIT_REF_NAME' quoting syntax ([c32a8a8](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/c32a8a8e8b1fdcc35eec1c8bdf421b7026dd9953))
+- **gitlab-ci:** disable 'quality:sonarcloud' without 'SONAR_{HOST_URL,TOKEN}' ([bad88bd](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/commit/bad88bd20bacf4b5627dc8a5b4e1f7261e396265))
+
+
 <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)
 

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pre-commit-crocodile
-Version: 8.0.0
+Version: 8.1.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
@@ -98,7 +98,7 @@ Git hooks manager intended for developers using [pre-commit](https://pre-commit.
 
 ## Preview
 
-![preview.svg](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/raw/8.0.0/docs/preview.svg)
+![preview.svg](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/raw/8.1.0/docs/preview.svg)
 
 ---
 

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

@@ -48,7 +48,7 @@ Git hooks manager intended for developers using [pre-commit](https://pre-commit.
 
 ## Preview
 
-![preview.svg](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/raw/8.0.0/docs/preview.svg)
+![preview.svg](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/raw/8.1.0/docs/preview.svg)
 
 ---
 

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

@@ -38,7 +38,7 @@ default_stages:
   - pre-commit
   - pre-push
 minimum_pre_commit_version: 3.8.0
-minimum_prek_version: 0.2.0
+minimum_prek_version: 0.2.1
 
 # pre-commit repositories
 repos:

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pre-commit-crocodile
-Version: 8.0.0
+Version: 8.1.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
@@ -98,7 +98,7 @@ Git hooks manager intended for developers using [pre-commit](https://pre-commit.
 
 ## Preview
 
-![preview.svg](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/raw/8.0.0/docs/preview.svg)
+![preview.svg](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/raw/8.1.0/docs/preview.svg)
 
 ---
 

{pre_commit_crocodile-8.0.0 → pre_commit_crocodile-8.1.0}/requirements/commits.txt

@@ -1,4 +1,4 @@
 git+https://github.com/AdrianDC/commitizen.git@4.9.1+adriandc.20250914
 pre-commit>=3.8.0
-prek>=0.2.0
+prek>=0.2.1
 uv>=0.8.15

{pre_commit_crocodile-8.0.0 → pre_commit_crocodile-8.1.0}/src/assets/.pre-commit-config.template.yaml

@@ -10,7 +10,7 @@ default_stages:
   - pre-push
   - prepare-commit-msg
 minimum_pre_commit_version: 3.8.0
-minimum_prek_version: 0.2.0
+minimum_prek_version: 0.2.1
 
 # pre-commit exclusions
 exclude: >

{pre_commit_crocodile-8.0.0/templates → pre_commit_crocodile-8.1.0/src/assets}/commits.yml

@@ -18,6 +18,26 @@ spec:
     pre_commit:
       default: prek
       description: 'Defines the commits pre-commit engine name (pre-commmit or prek, default: prek)'
+    validate_commitizen_config:
+      type: boolean
+      default: true
+      description: 'Defines the commits commitizen configuration validation (default: true)'
+    validate_commitizen_range:
+      type: boolean
+      default: true
+      description: 'Defines the commits commitizen range validation (default: true)'
+    validate_hooks_checks:
+      type: boolean
+      default: true
+      description: 'Defines the commits hooks checks validation (default: true)'
+    validate_duplicated_commits:
+      type: boolean
+      default: true
+      description: 'Defines the commits duplicated titles validation (default: true)'
+    validate_wip_commits:
+      type: boolean
+      default: true
+      description: 'Defines the commits WIP titles validation (default: true)'
 ---
 $[[ inputs.name ]]:
   image: $[[ inputs.image ]]
@@ -39,24 +59,30 @@ $[[ inputs.name ]]:
         sleep 3
         exit 1
       fi
-    # Check system context
-    - git cz --config ./.cz.yaml version -r
-    # Show commits documentation
+    # Check commitizen system context
     - |
-      (
+      if $[[ inputs.validate_commitizen_config ]]; then
         set +x
-        echo ' '
-        for hint in 'example:33' 'info:36' 'schema:32'; do
-          command="${hint%%:*}"
-          color="${hint##*:}"
+        git cz --config ./.cz.yaml version -r
+      fi
+    # Show commitizen commits documentation
+    - |
+      if $[[ inputs.validate_commitizen_config ]]; then
+        (
+          set +x
+          echo ' '
+          for hint in 'example:33' 'info:36' 'schema:32'; do
+            command="${hint%%:*}"
+            color="${hint##*:}"
+            echo '---'
+            echo "git cz ${command}:"
+            echo -e "\033[1;${color}m"
+            git cz --config ./.cz.yaml "${command}" | sed 's#^$# #g'
+            echo -e '\033[0m '
+          done
           echo '---'
-          echo "git cz ${command}:"
-          echo -e "\033[1;${color}m"
-          git cz --config ./.cz.yaml "${command}" | sed 's#^$# #g'
-          echo -e '\033[0m '
-        done
-        echo '---'
-      )
+        )
+      fi
   script:
     # Detect commits range
     - set +x
@@ -86,36 +112,44 @@ $[[ inputs.name ]]:
         base_branch=$(git rev-parse --abbrev-ref 'HEAD')
         range_sha="${base_sha}..${head_sha}"
       fi
-    # Validate commits range
+    # Validate commitizen commits range
     - |
-      set +x
-      echo ' '
-      echo '---'
-      echo -e "\033[0m\033[1mINFO: Commitizen checks from \033[1m'\033[1;36m${base_sha:0:8}\033[0m\033[1m' (\033[1;33m${base_branch}\033[0m\033[1m) to '\033[1;36m${head_sha:0:8}\033[0m\033[1m' (\033[1;33mHEAD\033[0m\033[1m)\033[0m"
-      echo ' '
-      git log --pretty=oneline --abbrev-commit "${range_sha}" | sed "s#^\([^ ]*\) #$(printf '\033[1;33m')\1$(printf '\033[0m') #g"
-      echo ' '
-      set -x
-      git cz --config ./.cz.yaml --no-raise 3 check --rev-range "${range_sha}"
-    # Validate pre-commit checks
+      if $[[ inputs.validate_commitizen_range ]]; then
+        set +x
+        echo ' '
+        echo '---'
+        echo -e "\033[0m\033[1mINFO: Commitizen checks from \033[1m'\033[1;36m${base_sha:0:8}\033[0m\033[1m' (\033[1;33m${base_branch}\033[0m\033[1m) to '\033[1;36m${head_sha:0:8}\033[0m\033[1m' (\033[1;33mHEAD\033[0m\033[1m)\033[0m"
+        echo ' '
+        git log --pretty=oneline --abbrev-commit "${range_sha}" | sed "s#^\([^ ]*\) #$(printf '\033[1;33m')\1$(printf '\033[0m') #g"
+        echo ' '
+        git cz --config ./.cz.yaml --no-raise 3 check --rev-range "${range_sha}"
+      fi
+    # Validate engine version
+    - |
+      if $[[ inputs.pre_commit ]] run --from-ref HEAD --to-ref HEAD 2>&1 | grep -q 'is required but version\|is greater than current version'; then
+        $[[ inputs.pre_commit ]] run --from-ref HEAD --to-ref HEAD || true
+        pip3 install -q --no-cache-dir --root-user-action=ignore --upgrade $[[ inputs.pre_commit ]]
+      fi
+    # Validate hooks checks
     - |
-      set +x
-      echo ' '
-      skip=$(
-        {
-          grep 'id: run-gcil-' .pre-commit-config.yaml | sed 's/.* id: //g'
-          echo -n "${PRE_COMMIT_SKIP}" | tr ' ' '\n'
-        } | tr '\n' ',' | sed 's/,$//g' || true
-      )
-      set -x
-      if [ -z "${CI_LOCAL:-}" ]; then
-        $[[ inputs.pre_commit ]] install --install-hooks
+      if $[[ inputs.validate_hooks_checks ]]; then
+        set +x
+        echo ' '
+        skip=$(
+          {
+            grep 'id: run-gcil-' .pre-commit-config.yaml | sed 's/.* id: //g'
+            echo -n "${PRE_COMMIT_SKIP}" | tr ' ' '\n'
+          } | tr '\n' ',' | sed 's/,$//g' || true
+        )
+        if [ -z "${CI_LOCAL:-}" ]; then
+          $[[ inputs.pre_commit ]] install --install-hooks
+        fi
+        SKIP="${skip}" $[[ inputs.pre_commit ]] run --all-files --show-diff-on-failure
       fi
-      SKIP="${skip}" $[[ inputs.pre_commit ]] run --all-files --show-diff-on-failure
     # Validate duplicated commits
     - |
-      set +x
-      if git log --pretty='%s' "${range_sha}" | sort | uniq -D | grep '.'; then
+      if $[[ inputs.validate_duplicated_commits ]] && git log --pretty='%s' "${range_sha}" | sort | uniq -D | grep '.'; then
+        set +x
         echo ' '
         echo " [ERROR] Detected duplicated commits titles in range '${range_sha}'"
         echo ' '
@@ -123,8 +157,8 @@ $[[ inputs.name ]]:
       fi
     # Validate WIP commits
     - |
-      set +x
-      if git log --pretty='%s' "${range_sha}" | grep -i '^WIP'; then
+      if $[[ inputs.validate_wip_commits ]] && git log --pretty='%s' "${range_sha}" | grep -i '^WIP'; then
+        set +x
         echo ' '
         echo " [ERROR] Detected WIP commits in range '${range_sha}'"
         echo ' '

{pre_commit_crocodile-8.0.0 → pre_commit_crocodile-8.1.0}/src/features/precommit.py

@@ -368,6 +368,9 @@ class PreCommit:
     @staticmethod
     def dependencies() -> bool:
 
+        # Variables
+        result: bool = True
+
         # Uninstall existing pre-commit, pylint: disable=duplicate-code
         if Commands.exists(PreCommit.BINARY):
             for package in PreCommit.PACKAGES:
@@ -378,9 +381,21 @@ class PreCommit:
                 print(' ')
 
         # Install pre-commit
-        return Commands.pip([
-            'install',
-        ] + PreCommit.PACKAGES)
+        for package in PreCommit.PACKAGES:
+
+            # Check package installation
+            if not Commands.pip([
+                    'install',
+                    package,
+            ]):
+                result = False
+
+            # Isolate package installation
+            if package != PreCommit.PACKAGES[-1]:
+                print(' ')
+
+        # Result
+        return result
 
     # Exists
     @staticmethod

{pre_commit_crocodile-8.0.0/src/assets → pre_commit_crocodile-8.1.0/templates}/commits.yml

@@ -18,6 +18,26 @@ spec:
     pre_commit:
       default: prek
       description: 'Defines the commits pre-commit engine name (pre-commmit or prek, default: prek)'
+    validate_commitizen_config:
+      type: boolean
+      default: true
+      description: 'Defines the commits commitizen configuration validation (default: true)'
+    validate_commitizen_range:
+      type: boolean
+      default: true
+      description: 'Defines the commits commitizen range validation (default: true)'
+    validate_hooks_checks:
+      type: boolean
+      default: true
+      description: 'Defines the commits hooks checks validation (default: true)'
+    validate_duplicated_commits:
+      type: boolean
+      default: true
+      description: 'Defines the commits duplicated titles validation (default: true)'
+    validate_wip_commits:
+      type: boolean
+      default: true
+      description: 'Defines the commits WIP titles validation (default: true)'
 ---
 $[[ inputs.name ]]:
   image: $[[ inputs.image ]]
@@ -39,24 +59,30 @@ $[[ inputs.name ]]:
         sleep 3
         exit 1
       fi
-    # Check system context
-    - git cz --config ./.cz.yaml version -r
-    # Show commits documentation
+    # Check commitizen system context
     - |
-      (
+      if $[[ inputs.validate_commitizen_config ]]; then
         set +x
-        echo ' '
-        for hint in 'example:33' 'info:36' 'schema:32'; do
-          command="${hint%%:*}"
-          color="${hint##*:}"
+        git cz --config ./.cz.yaml version -r
+      fi
+    # Show commitizen commits documentation
+    - |
+      if $[[ inputs.validate_commitizen_config ]]; then
+        (
+          set +x
+          echo ' '
+          for hint in 'example:33' 'info:36' 'schema:32'; do
+            command="${hint%%:*}"
+            color="${hint##*:}"
+            echo '---'
+            echo "git cz ${command}:"
+            echo -e "\033[1;${color}m"
+            git cz --config ./.cz.yaml "${command}" | sed 's#^$# #g'
+            echo -e '\033[0m '
+          done
           echo '---'
-          echo "git cz ${command}:"
-          echo -e "\033[1;${color}m"
-          git cz --config ./.cz.yaml "${command}" | sed 's#^$# #g'
-          echo -e '\033[0m '
-        done
-        echo '---'
-      )
+        )
+      fi
   script:
     # Detect commits range
     - set +x
@@ -86,36 +112,44 @@ $[[ inputs.name ]]:
         base_branch=$(git rev-parse --abbrev-ref 'HEAD')
         range_sha="${base_sha}..${head_sha}"
       fi
-    # Validate commits range
+    # Validate commitizen commits range
     - |
-      set +x
-      echo ' '
-      echo '---'
-      echo -e "\033[0m\033[1mINFO: Commitizen checks from \033[1m'\033[1;36m${base_sha:0:8}\033[0m\033[1m' (\033[1;33m${base_branch}\033[0m\033[1m) to '\033[1;36m${head_sha:0:8}\033[0m\033[1m' (\033[1;33mHEAD\033[0m\033[1m)\033[0m"
-      echo ' '
-      git log --pretty=oneline --abbrev-commit "${range_sha}" | sed "s#^\([^ ]*\) #$(printf '\033[1;33m')\1$(printf '\033[0m') #g"
-      echo ' '
-      set -x
-      git cz --config ./.cz.yaml --no-raise 3 check --rev-range "${range_sha}"
-    # Validate pre-commit checks
+      if $[[ inputs.validate_commitizen_range ]]; then
+        set +x
+        echo ' '
+        echo '---'
+        echo -e "\033[0m\033[1mINFO: Commitizen checks from \033[1m'\033[1;36m${base_sha:0:8}\033[0m\033[1m' (\033[1;33m${base_branch}\033[0m\033[1m) to '\033[1;36m${head_sha:0:8}\033[0m\033[1m' (\033[1;33mHEAD\033[0m\033[1m)\033[0m"
+        echo ' '
+        git log --pretty=oneline --abbrev-commit "${range_sha}" | sed "s#^\([^ ]*\) #$(printf '\033[1;33m')\1$(printf '\033[0m') #g"
+        echo ' '
+        git cz --config ./.cz.yaml --no-raise 3 check --rev-range "${range_sha}"
+      fi
+    # Validate engine version
+    - |
+      if $[[ inputs.pre_commit ]] run --from-ref HEAD --to-ref HEAD 2>&1 | grep -q 'is required but version\|is greater than current version'; then
+        $[[ inputs.pre_commit ]] run --from-ref HEAD --to-ref HEAD || true
+        pip3 install -q --no-cache-dir --root-user-action=ignore --upgrade $[[ inputs.pre_commit ]]
+      fi
+    # Validate hooks checks
     - |
-      set +x
-      echo ' '
-      skip=$(
-        {
-          grep 'id: run-gcil-' .pre-commit-config.yaml | sed 's/.* id: //g'
-          echo -n "${PRE_COMMIT_SKIP}" | tr ' ' '\n'
-        } | tr '\n' ',' | sed 's/,$//g' || true
-      )
-      set -x
-      if [ -z "${CI_LOCAL:-}" ]; then
-        $[[ inputs.pre_commit ]] install --install-hooks
+      if $[[ inputs.validate_hooks_checks ]]; then
+        set +x
+        echo ' '
+        skip=$(
+          {
+            grep 'id: run-gcil-' .pre-commit-config.yaml | sed 's/.* id: //g'
+            echo -n "${PRE_COMMIT_SKIP}" | tr ' ' '\n'
+          } | tr '\n' ',' | sed 's/,$//g' || true
+        )
+        if [ -z "${CI_LOCAL:-}" ]; then
+          $[[ inputs.pre_commit ]] install --install-hooks
+        fi
+        SKIP="${skip}" $[[ inputs.pre_commit ]] run --all-files --show-diff-on-failure
       fi
-      SKIP="${skip}" $[[ inputs.pre_commit ]] run --all-files --show-diff-on-failure
     # Validate duplicated commits
     - |
-      set +x
-      if git log --pretty='%s' "${range_sha}" | sort | uniq -D | grep '.'; then
+      if $[[ inputs.validate_duplicated_commits ]] && git log --pretty='%s' "${range_sha}" | sort | uniq -D | grep '.'; then
+        set +x
         echo ' '
         echo " [ERROR] Detected duplicated commits titles in range '${range_sha}'"
         echo ' '
@@ -123,8 +157,8 @@ $[[ inputs.name ]]:
       fi
     # Validate WIP commits
     - |
-      set +x
-      if git log --pretty='%s' "${range_sha}" | grep -i '^WIP'; then
+      if $[[ inputs.validate_wip_commits ]] && git log --pretty='%s' "${range_sha}" | grep -i '^WIP'; then
+        set +x
         echo ' '
         echo " [ERROR] Detected WIP commits in range '${range_sha}'"
         echo ' '