IfcOpenShell/src/bonsai/docs/guides/development/code_style.rst

Code style
============


Code formatters
-------------------------------
For Python code formatting, we use `Black code formatter <https://pypi.org/project/black/>`__, 
black settings are stored in the repository's pyproject.toml.

We have GitHub workflow `ci-black-formatting` to maintain black formatting across the repository.

``black`` can be installed using ``pip install black`` and files can be formatted with the following example command:

.. code-block:: bash

   # Format the entire repository.
   # Should be used in 99% cases as the entire repository is already formatted using black.
   black .
   # Format only some specific file.
   black src/bonsai/bonsai/bim/module/qto/operator.py


There is also `ruff` with some basic linter rules (checked automatically by the same Github workflow).
Which also helps maintaining consistency across the code base
and ensure new Python syntax doesn't break code on older Python versions.

``ruff`` can be installed using ``pip install ruff`` and files can be formatted with the following example commands:

.. code-block:: bash
   # Check issues for the entire repository.
   ruff check
   # Apply some automatic fixes, if available.
   ruff check --fix
   # Check only some specific file.
   ruff src/bonsai/bonsai/bim/module/qto/operator.py