# pre-commit-crocodile
<!-- markdownlint-disable no-inline-html -->
[](https://pypi.org/project/pre-commit-crocodile)
[](https://pypi.org/project/pre-commit-crocodile)
[](https://pypi.org/project/pre-commit-crocodile)
[](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/-/blob/main/LICENSE)
<br />
[](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/-/commits/main/)
[](https://sonarcloud.io/dashboard?id=RadianDevCore_pre-commit-crocodile)
[](https://sonarcloud.io/dashboard?id=RadianDevCore_pre-commit-crocodile)
[](https://sonarcloud.io/dashboard?id=RadianDevCore_pre-commit-crocodile)
[](https://sonarcloud.io/dashboard?id=RadianDevCore_pre-commit-crocodile)
[](https://sonarcloud.io/dashboard?id=RadianDevCore_pre-commit-crocodile)
<br />
[](https://github.com/pre-commit/pre-commit)
[](https://commitizen-tools.github.io/commitizen/)
[](https://radiandevcore.gitlab.io/tools/gcil)
[](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
[](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/)
**Documentation:** <https://radiandevcore.gitlab.io/tools/pre-commit-crocodile>
**Package:** <https://pypi.org/project/pre-commit-crocodile/>
---
## Features
**`pre-commit-crocodile` uses the following features:**
- **CLI - [pre-commit](https://pre-commit.com/):** Automated Git hooks before commits and upon pushes
- **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
---
## Preview
---
<span class="page-break"></span>
## Usage
<!-- prettier-ignore-start -->
<!-- readme-help-start -->
```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] [--stage STAGE] [--]
pre-commit-crocodile: Git hooks intended for developers using pre-commit
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'
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
configurations arguments:
--config FOLDER # Use configurations from a specific folder
-D, --default # Use global default configurations instead of sources
--stage STAGE # Run a specific pre-commit stage with --run
# (use 'list' to list supported stages)
positional arguments:
-- # Positional arguments separator (recommended)
```
<!-- readme-help-stop -->
<!-- prettier-ignore-end -->
---
<span class="page-break"></span>
## Installation
```bash
{
# Option 1: If using pipx
if type pipx >/dev/null 2>&1; then
pipx ensurepath
pipx install pre-commit-crocodile
pipx upgrade pre-commit-crocodile
# Option 2: If using pip
else
sudo pip3 install pre-commit-crocodile
fi
}
```
---
## Compatibility
Projects compatible with `pre-commit-crocodile` can use this badge to ease things for developers, both as an indicator and a documentation shortcut button :
> [](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
```markdown title="Badge in Markdown"
[](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
```
```html title="Badge in HTML"
<a href="https://radiandevcore.gitlab.io/tools/pre-commit-crocodile"><img src="https://img.shields.io/badge/pre--commit--crocodile-enabled-brightgreen?logo=gitlab" alt="pre-commit-crocodile" style="max-width:100%;"></a>
```
---
<span class="page-break"></span>
## Projects with configurations | [](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
### Install dependencies (once per user)
```bash
pre-commit-crocodile --install
```
### Enable hooks for a project
```bash
pre-commit-crocodile --enable
```
### Manually run hooks of a project
```bash
pre-commit-crocodile --run
```
### Disable hooks for a project
```bash
pre-commit-crocodile --disable
```
---
## Projects without configurations | [](https://github.com/pre-commit/pre-commit)
### Import or refresh configurations
```bash
pre-commit-crocodile --configure
```
---
## Projects maintenance | [](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)
### Update hooks automatically
```bash
pre-commit-crocodile --autoupdate
```
### Cleanup hooks cache
```bash
pre-commit-crocodile --clean
```
---
<span class="page-break"></span>
## Dependencies
- [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
- [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
---
## References
- [.gitlab-ci.yml](https://docs.gitlab.com/ee/ci/yaml/): GitLab CI/CD Pipeline Configuration Reference
- [conventionalcommits](https://www.conventionalcommits.org/en/v1.0.0/): Conventional Commits specification for commit messages
- [gcil](https://radiandevcore.gitlab.io/tools/gcil): Launch .gitlab-ci.yml jobs locally
- [git-cliff](https://github.com/orhun/git-cliff): CHANGELOG generator
- [gitlab-release](https://pypi.org/project/gitlab-release/): Utility for publishing on GitLab
- [mkdocs](https://www.mkdocs.org/): Project documentation with Markdown
- [mkdocs-exporter](https://adrienbrignon.github.io/mkdocs-exporter/): Exporter plugin for mkdocs documentation
- [mkdocs-material](https://squidfunk.github.io/mkdocs-material/): Material theme for mkdocs documentation
- [mypy](https://pypi.org/project/mypy/): Optional static typing for Python
- [pexpect-executor](https://radiandevcore.gitlab.io/tools/pexpect-executor): Automate interactive CLI tools actions
- [PyPI](https://pypi.org/): The Python Package Index
- [termtosvg](https://pypi.org/project/termtosvg/): Record terminal sessions as SVG animations
- [twine](https://pypi.org/project/twine/): Utility for publishing on PyPI
Raw data
{
"_id": null,
"home_page": "https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile",
"name": "pre-commit-crocodile",
"maintainer": null,
"docs_url": null,
"requires_python": "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,!=3.7.*,!=3.8.*,>=3",
"maintainer_email": null,
"keywords": "git pre-commit hooks",
"author": "Adrian DC",
"author_email": "radian.dc@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/dd/49/0900d04c67f174e69128bd1eac4b9af66a2df195803184196dfe6ff6b7b6/pre_commit_crocodile-4.0.0.tar.gz",
"platform": null,
"description": "# pre-commit-crocodile\n\n<!-- markdownlint-disable no-inline-html -->\n\n[](https://pypi.org/project/pre-commit-crocodile)\n[](https://pypi.org/project/pre-commit-crocodile)\n[](https://pypi.org/project/pre-commit-crocodile)\n[](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/-/blob/main/LICENSE)\n<br />\n[](https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/-/commits/main/)\n[](https://sonarcloud.io/dashboard?id=RadianDevCore_pre-commit-crocodile)\n[](https://sonarcloud.io/dashboard?id=RadianDevCore_pre-commit-crocodile)\n[](https://sonarcloud.io/dashboard?id=RadianDevCore_pre-commit-crocodile)\n[](https://sonarcloud.io/dashboard?id=RadianDevCore_pre-commit-crocodile)\n[](https://sonarcloud.io/dashboard?id=RadianDevCore_pre-commit-crocodile)\n<br />\n[](https://github.com/pre-commit/pre-commit)\n[](https://commitizen-tools.github.io/commitizen/)\n[](https://radiandevcore.gitlab.io/tools/gcil)\n[](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)\n[](https://radiandevcore.gitlab.io/wiki/guidelines)\n\nGit hooks intended for developers using [pre-commit](https://pre-commit.com/) and [commitizen](https://commitizen-tools.github.io/commitizen/)\n\n**Documentation:** <https://radiandevcore.gitlab.io/tools/pre-commit-crocodile> \n**Package:** <https://pypi.org/project/pre-commit-crocodile/>\n\n---\n\n## Features\n\n**`pre-commit-crocodile` uses the following features:**\n\n- **CLI - [pre-commit](https://pre-commit.com/):** Automated Git hooks before commits and upon pushes\n- **CLI - [commitizen](https://commitizen-tools.github.io/commitizen/):** Commits tools and validation based upon [conventional commits](https://www.conventionalcommits.org/en/)\n- **Hooks - [pre-commit-hooks](https://github.com/pre-commit/pre-commit-hooks):** Common `pre-commit` hooks useful for developers\n- **Hooks - `prepare-commit-msg`:** Prepare commit message automatically based on changes\n\n---\n\n## Preview\n\n\n\n---\n\n<span class=\"page-break\"></span>\n\n## Usage\n\n<!-- prettier-ignore-start -->\n<!-- readme-help-start -->\n\n```yaml\nusage: pre-commit-crocodile [-h] [--version] [--no-color] [--update-check] [--settings] [--set GROUP KEY VAL]\n [-l | -i | -c | -b | -e | -d | -a | -C | -r] [--config FOLDER | -D] [--stage STAGE] [--]\n\npre-commit-crocodile: Git hooks intended for developers using pre-commit\n\ninternal arguments:\n -h, --help # Show this help message\n --version # Show the current version\n --no-color # Disable colors outputs with 'NO_COLOR=1'\n # (or default settings: [themes] > no_color)\n --update-check # Check for newer package updates\n --settings # Show the current settings path and contents\n --set GROUP KEY VAL # Set settings specific 'VAL' value to [GROUP] > KEY\n # or unset by using 'UNSET' as 'VAL'\n\nmodes arguments:\n -l, --list # List Git hooks installed in sources\n -i, --install # Install dependencies for pre-commit hooks\n -c, --configure # Update sources with hooks configurations\n -b, --badges # Update documentation with badges configurations\n -e, --enable # Enable pre-commit hooks\n -d, --disable # Disable pre-commit hooks\n -a, --autoupdate # Autoupdate pre-commit hooks\n -C, --clean # Clean pre-commit cached hooks\n -r, --run # Run pre-commit hooks\n\nconfigurations arguments:\n --config FOLDER # Use configurations from a specific folder\n -D, --default # Use global default configurations instead of sources\n --stage STAGE # Run a specific pre-commit stage with --run\n # (use 'list' to list supported stages)\n\npositional arguments:\n -- # Positional arguments separator (recommended)\n```\n\n<!-- readme-help-stop -->\n<!-- prettier-ignore-end -->\n\n---\n\n<span class=\"page-break\"></span>\n\n## Installation\n\n```bash\n{\n # Option 1: If using pipx\n if type pipx >/dev/null 2>&1; then\n pipx ensurepath\n pipx install pre-commit-crocodile\n pipx upgrade pre-commit-crocodile\n\n # Option 2: If using pip\n else\n sudo pip3 install pre-commit-crocodile\n fi\n}\n```\n\n---\n\n## Compatibility\n\nProjects compatible with `pre-commit-crocodile` can use this badge to ease things for developers, both as an indicator and a documentation shortcut button :\n\n> [](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)\n\n```markdown title=\"Badge in Markdown\"\n[](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)\n```\n\n```html title=\"Badge in HTML\"\n<a href=\"https://radiandevcore.gitlab.io/tools/pre-commit-crocodile\"><img src=\"https://img.shields.io/badge/pre--commit--crocodile-enabled-brightgreen?logo=gitlab\" alt=\"pre-commit-crocodile\" style=\"max-width:100%;\"></a>\n```\n\n---\n\n<span class=\"page-break\"></span>\n\n## Projects with configurations | [](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)\n\n### Install dependencies (once per user)\n\n```bash\npre-commit-crocodile --install\n```\n\n### Enable hooks for a project\n\n```bash\npre-commit-crocodile --enable\n```\n\n### Manually run hooks of a project\n\n```bash\npre-commit-crocodile --run\n```\n\n### Disable hooks for a project\n\n```bash\npre-commit-crocodile --disable\n```\n\n---\n\n## Projects without configurations | [](https://github.com/pre-commit/pre-commit)\n\n### Import or refresh configurations\n\n```bash\npre-commit-crocodile --configure\n```\n\n---\n\n## Projects maintenance | [](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile)\n\n### Update hooks automatically\n\n```bash\npre-commit-crocodile --autoupdate\n```\n\n### Cleanup hooks cache\n\n```bash\npre-commit-crocodile --clean\n```\n\n---\n\n<span class=\"page-break\"></span>\n\n## Dependencies\n\n- [colored](https://pypi.org/project/colored/): Terminal colors and styles\n- [commitizen](https://pypi.org/project/commitizen/): Simple commit conventions for internet citizens\n- [pre-commit](https://pre-commit.com/): A framework for managing and maintaining pre-commit hooks\n- [pre-commit-crocodile](https://radiandevcore.gitlab.io/tools/pre-commit-crocodile): Git hooks intended for developers using pre-commit\n- [setuptools](https://pypi.org/project/setuptools/): Build and manage Python packages\n- [update-checker](https://pypi.org/project/update-checker/): Check for package updates on PyPI\n\n---\n\n## References\n\n- [.gitlab-ci.yml](https://docs.gitlab.com/ee/ci/yaml/): GitLab CI/CD Pipeline Configuration Reference\n- [conventionalcommits](https://www.conventionalcommits.org/en/v1.0.0/): Conventional Commits specification for commit messages\n- [gcil](https://radiandevcore.gitlab.io/tools/gcil): Launch .gitlab-ci.yml jobs locally\n- [git-cliff](https://github.com/orhun/git-cliff): CHANGELOG generator\n- [gitlab-release](https://pypi.org/project/gitlab-release/): Utility for publishing on GitLab\n- [mkdocs](https://www.mkdocs.org/): Project documentation with Markdown\n- [mkdocs-exporter](https://adrienbrignon.github.io/mkdocs-exporter/): Exporter plugin for mkdocs documentation\n- [mkdocs-material](https://squidfunk.github.io/mkdocs-material/): Material theme for mkdocs documentation\n- [mypy](https://pypi.org/project/mypy/): Optional static typing for Python\n- [pexpect-executor](https://radiandevcore.gitlab.io/tools/pexpect-executor): Automate interactive CLI tools actions\n- [PyPI](https://pypi.org/): The Python Package Index\n- [termtosvg](https://pypi.org/project/termtosvg/): Record terminal sessions as SVG animations\n- [twine](https://pypi.org/project/twine/): Utility for publishing on PyPI\n",
"bugtrack_url": null,
"license": "Apache License 2.0",
"summary": "Git hooks intended for developers using pre-commit",
"version": "4.0.0",
"project_urls": {
"Bug Reports": "https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/-/issues",
"Changelog": "https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile/blob/main/CHANGELOG.md",
"Documentation": "https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile#pre-commit-crocodile",
"Homepage": "https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile",
"Source": "https://gitlab.com/RadianDevCore/tools/pre-commit-crocodile",
"Statistics": "https://pypistats.org/packages/pre-commit-crocodile"
},
"split_keywords": [
"git",
"pre-commit",
"hooks"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "de21361b30157fb217098bd19bbe6232462c625e1857e0fbc76de0401e694944",
"md5": "b35a10098b6270890e9123f46e6b93dc",
"sha256": "94298384d9c4e33cfeea496c20894c1c2708740d463b78b76e979c0c2b8baf39"
},
"downloads": -1,
"filename": "pre_commit_crocodile-4.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "b35a10098b6270890e9123f46e6b93dc",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,!=3.7.*,!=3.8.*,>=3",
"size": 42992,
"upload_time": "2025-01-01T16:51:34",
"upload_time_iso_8601": "2025-01-01T16:51:34.735166Z",
"url": "https://files.pythonhosted.org/packages/de/21/361b30157fb217098bd19bbe6232462c625e1857e0fbc76de0401e694944/pre_commit_crocodile-4.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "dd490900d04c67f174e69128bd1eac4b9af66a2df195803184196dfe6ff6b7b6",
"md5": "ef3db70cc020bd6913af2766b13e5fd2",
"sha256": "7bf11a57ef37bf8dc1934a19909fd6d2d7f9ca1268e96d088e5c8266bf42fd64"
},
"downloads": -1,
"filename": "pre_commit_crocodile-4.0.0.tar.gz",
"has_sig": false,
"md5_digest": "ef3db70cc020bd6913af2766b13e5fd2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "!=3.0.*,!=3.1.*,!=3.2.*,!=3.3.*,!=3.4.*,!=3.5.*,!=3.6.*,!=3.7.*,!=3.8.*,>=3",
"size": 145508,
"upload_time": "2025-01-01T16:51:37",
"upload_time_iso_8601": "2025-01-01T16:51:37.167001Z",
"url": "https://files.pythonhosted.org/packages/dd/49/0900d04c67f174e69128bd1eac4b9af66a2df195803184196dfe6ff6b7b6/pre_commit_crocodile-4.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-01-01 16:51:37",
"github": false,
"gitlab": true,
"bitbucket": false,
"codeberg": false,
"gitlab_user": "RadianDevCore",
"gitlab_project": "tools",
"lcname": "pre-commit-crocodile"
}
JSON