Picture this: You're a busy Django developer working on a large-scale web project with a team of developers. You spend hours coding, testing, and debugging, only to realize that your codebase is littered with small issues like formatting inconsistencies, syntax errors, or import sorting problems. These small issues can pile up and slow down your development workflow, especially when working with a large team. That's where pre-commit comes in. Pre-commit is a simple yet powerful tool that can help you catch these issues before they make it into your codebase. It is a hook script. git Git hook scripts are useful for identifying simple issues before submission to code review. We run our hooks on every commit to automatically point out issues in code such as missing semicolons, trailing whitespace, and debug statements. Pointing these issues out before code review, allows a code reviewer to focus on the architecture of a change while not wasting time with trivial style nitpicks. By automating code formatting, linting, and testing, pre-commit can save you time and headaches, allowing you to focus on what matters: building great software. This blog post will explore how to use pre-commit in Django projects. We'll cover everything from installation and configuration to creating custom hooks and integrating with CI tools. By the end of this post, you'll have a solid understanding of how to use pre-commit to improve your workflow and streamline your development process. So, let's dive in! Installation & Configuration The first step to using pre-commit in your Django project is to install it using pip, the Python package manager. pip install pre-commit Once you have pre-commit installed, you'll need to configure it using a file called .pre-commit-config.yaml. This configuration file is where you define the hooks that will run on your code. A hook is a command or script that checks your code for issues like formatting errors, syntax mistakes, or security vulnerabilities. There is a wide range of hooks that you can use in your Django project, and you can also create your custom hooks. pre-commit In your file, you'll specify which hooks you want to run and in what order. You can also set options for each hook, such as which files to run it on or what arguments to pass to the command. .pre-commit-config.yaml For Django projects, some of the most useful pre-commit hooks include Black for code formatting, Flake8 for code linting, isort for import sorting, and Mypy for static type checking. By running these hooks automatically, you can ensure that your code is clean, consistent, and easy to read. TLDR To adopt into our system, we simply perform the following actions: pre-commit Install pre-commit: pip install pre-commit Add to (or ) pre-commit requirements.txt requirements-dev.txt Define with the hooks, you want to include. .pre-commit-config.yaml Execute to install git hooks in your directory. pre-commit install .git/ Creating .pre-commit-config.yaml Create a file named in your repository root directory(also your Django project’s root directory). .pre-commit-config.yaml You can generate a very basic configuration using pre-commit sample-config Instead of creating sample-config, you can also start from scratch. In this post, I have included packages like , , & for our Django projects. black flake8 reorder-python-imports bandit Here is a sample of pre-commit files that I am currently using for my projects. These files help me ensure that my code is clean, formatted, and free of errors before I commit it to the repository. I highly recommend using pre-commit hooks in your projects to save time and avoid potential issues down the road. repos:
  - repo: 'https://github.com/psf/black'
    rev: 22.10.0
    hooks:
      - id: black
        args:
          - '--line-length=88'
        language_version: python3
  - repo: 'https://github.com/PyCQA/flake8'
    rev: 5.0.4
    hooks:
      - id: flake8
        args:
          - '--max-line-length=88'
        exclude: ^(.*/migrations/|core/settings.py)
  - repo: 'https://github.com/asottile/reorder_python_imports'
    rev: v3.9.0
    hooks:
      - id: reorder-python-imports
  - repo: local
    hooks:
      - id: django-tests
        name: django-tests
        entry: python manage.py test
        always_run: true
        pass_filenames: false
        language: system
  - repo: 'https://github.com/PyCQA/bandit'
    hooks:
      - id: bandit
        name: bandit
        description: Bandit is a tool for finding common security issues in Python code
        entry: bandit
        language: python
        language_version: python3
        types:
          - python Black is a code formatter that ensures my code follows a consistent style. Flake8 is a linter that checks my code for syntax errors, unused imports, and other potential issues. reorder-python-imports is a tool that sorts my imports alphabetically, making them easier to read and maintain. bandit looks for potential security vulnerabilities in your code. By running these checks automatically, you can ensure that your code is secure and free of common security issues. In addition to using these tools, I also include a pre-commit hook that runs my unit tests before each commit. This helps me catch any bugs or regressions before they make it into the codebase. Overall, pre-commit hooks are an essential part of my workflow, and I highly recommend incorporating them into your development process. Note that these are my recommendations and not the holy grail of truth for Django projects, but I hope they can serve as a helpful starting point for you. Getting it into action Once, you create your .pre-commit-config.yaml - configuration file, you need to install that pre-commit hook into your .git repository. It’s fairly easy and simple. To install the pre-commit hook, you just need to run and in your terminal. This will automatically install the hook into your directory, allowing it to run on every commit. You can also run manually run the hooks on your codebase. git add .pre-commit-config.yaml pre-commit install .git pre-commit run Once installed, pre-commit will run automatically every time you commit code to your repository, ensuring that your code is clean and ready for review. For more details, you can look at . pre-commit documentation Now the next time you make some changes in your repositories, you can run to stage all changes and to commit them. git add . git commit Pre-commit will automatically run the hooks you specified in your file on your staged changes before the commit is finalized. This will help catch any errors or issues before they make it into your codebase and save you time and headaches down the road. .pre-commit-config.yaml The output will be somewhat similar to the above image, if the code passes the rules defined by linters & hooks, it will be mentioned as Passed by that hook, but if the code fails for some reason, the error will be shown where it fails, and you can work on that specific code. If there were formatting issues, most of the time, black will reformat them for you. Conclusion By automating code formatting, linting, and testing, pre-commit can help catch errors and issues before they make it into your codebase. With a solid understanding of installation and configuration, and by using custom hooks, you can streamline your development process and ensure that your code is clean, consistent, and easy to read. I hope this article served as a good starting point for automating some of your linting, and code quality improvement tasks. There are many amazing hooks other than these available online. You can start at to continue learning more about this. https://pre-commit.com Happy Coding! Also published here

The code in this story is for educational purposes. The readers are solely responsible for whatever they build with it.

You Need Django Signals Right Now — Here's Why 

How to Simplify Your Workflow With Pre-Commit Hooks

About Author

Comments

TOPICS

THIS ARTICLE WAS FEATURED IN

Related Stories

Caching in Django: Everything You Need to Know

0–100 in Django: Starting an app the right way

The Noonification: I Trained an AI to Act Like Me: Heres What Happened (11/1/2023)

10 Questions for Aswin Ganesh, Noonie Nominee for Functional Programming

10 Popular Websites Built With Django Framework

10 Popular Websites Built With Django

Caching in Django: Everything You Need to Know

0–100 in Django: Starting an app the right way

The Noonification: I Trained an AI to Act Like Me: Heres What Happened (11/1/2023)

10 Questions for Aswin Ganesh, Noonie Nominee for Functional Programming

10 Popular Websites Built With Django Framework

10 Popular Websites Built With Django

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps