📝 Update performance section

* Add Installation and usage of perflint
* Add perflint pre-commit hook
* Add link to cProfile

Author: veit

.pre-commit-config.yaml

@@ -37,6 +37,10 @@ repos:
     rev: 25.1.0
     hooks:
     - id: black
+  - repo: https://github.com/tonybaloney/perflint
+    rev: 0.8.1
+    hooks:
+    - id: perflint
   - repo: https://github.com/adamchainz/blacken-docs
     rev: "1.19.1"
     hooks:

docs/performance/index.rst

@@ -62,8 +62,8 @@ Performance measurements
 ------------------------
 
 Once you have worked with your code, it can be useful to examine its efficiency
-more closely. The :doc:`ipython-profiler` or :doc:`scalene` can be used for
-this.
+more closely. :mod:`cProfile`, :doc:`ipython-profiler` or :doc:`scalene` can be
+used for this.
 
 .. seealso::
     * `airspeed velocity (asv) <https://asv.readthedocs.io/en/stable/>`_

docs/performance/perflint.rst

@@ -6,7 +6,49 @@ perflint
 ========
 
 `perflint <https://github.com/tonybaloney/perflint>`_ is an extension for
-`pylint <https://pylint.org/>`_ for performance anti-patterns, among others:
+`pylint <https://pylint.org/>`_ for performance anti-patterns.
+
+Installation
+------------
+
+.. code-block:: console
+
+   $ uv add --dev perflint
+
+Use
+---
+
+… as an independent linter
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: console
+
+   $ uv run perflint src/
+
+… as ``pylint`` plugin
+~~~~~~~~~~~~~~~~~~~~~~
+
+.. code-block:: console
+
+   $ uv run perflint src/ --load-plugins=perflint
+
+… as pre-commit hook
+~~~~~~~~~~~~~~~~~x~~~
+
+perflint can also be used with the
+:doc:`/productive/git/advanced/hooks/pre-commit`:
+
+.. code-block:: yaml
+   :caption: .pre-commit-config.yaml
+
+   repos:
+     - repo: https://github.com/tonybaloney/perflint
+       rev: 0.8.1
+       hooks:
+       - id: perflint
+
+Rules
+-----
 
 W8101: ``unnecessary-list-cast``
     Unnecessary use of ``list()`` on an already iterable type.