Skip to content

Install pre commit

Jump to bottom
Pedro M. Baeza edited this page Jun 20, 2023 · 6 revisions

Introduction

pre-commit is a tool used in OCA that allows to trigger automatically some checks and changes when committing in git.

Some of the hooks we have configured in OCA repositories:

  • black and autoflake formatting tools
  • flake8, pylint, pylint-odoo and pre-commit checks
  • setuptools-odoo folder creation
  • isort
  • prettier for XML
  • eslint for JS
  • ...

Installation

To install pre-commit, you can use the most used package installer for Python pip, and simply type in your command line:

pip install pre-commit

Refer to your distribution documentation to see how to install pip (if not already installed).

But for isolating dependencies, it's better to use another package installer called pipx. The installation command line will be this time:

pipx install pre-commit

Repository preparation

It's good to have pre-commit stuff auto-launched when running git commit. To get that, you can type on each repository pre-commit install -f. New cloned and created repositories will have it by default.

Clone this wiki locally