Contributing to djangofmt¶

Prerequisites¶

Djangofmt is written in Rust, so you'll need to install the Rust toolchain.

You will also need uv to run various python tools and just to run development commands.

Development¶

To get started, bootstrap your environment:

just bootstrap

This will install all the necessary tools and dependencies.

Before opening a pull request, make sure all checks are passing by running:

just pre-mr-check

This will run linting, formatting, and tests.

Other tools / scripts¶

You can run the benchmarks locally using just.

To run the Python-based comparative benchmarks:

just bench-py <path/to/templates>

See the benchmark README for more details.

To run the Rust-based micro-benchmarks:

just bench-rs

You can also run the ecosystem check locally (it will run in CI anyway).

just ecosystem-check-dev

See the README.

Use of AI¶

We support using AI (i.e., LLMs) as tools for coding. However, you remain responsible for any code you publish and we are responsible for any code we merge and release. We hold a high bar for all contributions to our projects.

AI should not be used to generate comments when communicating with maintainers. We expect comments on our projects to be written by humans. We may hide any comments that we believe are AI generated.

If you are opening an issue, we expect you to describe the problem in your own words.

If you are opening a pull request, we expect you to be able to explain the proposed changes in your own words. This includes the pull request body and responses to questions. Do not copy responses from the AI when replying to questions from maintainers.

We require a human in the loop who understands the work produced by AI. We do not allow autonomous agents to be used for contributing to our projects. We will close any pull requests that we believe were created autonomously.

If you wish to include context from an interaction with AI in your comments, it must be in a quote block (e.g., using >) and disclosed as such. It must be accompanied by human commentary explaining the relevance and implications of the context. Do not share long snippets.

We understand that AI is useful when communicating as a non-native English speaker. If you are using AI to edit your comments for this purpose, please take the time to ensure it reflects your own voice and ideas. If using AI for translation, we recommend writing in your native language and including the AI translation in a quote block.