@@ -199,6 +199,43 @@ setup.
199199
200200 Remember to activate the environment whenever you start working on Matplotlib!
201201
202+ .. tab-item :: pixi environment
203+
204+ A pixi configuration is included in ``pyproject.toml ``. The environment
205+ includes the base Matplotlib dependencies, and documentation and testing
206+ dependencies. To install the dependencies::
207+
208+ pixi install
209+
210+ and then to install an editable version on Matplotlib::
211+
212+ pixi run python -m pip install \
213+ --no-build-isolation \
214+ --config-settings=setup-args="-Db_lto=false" \
215+ --editable .
216+
217+ (the ``-Db_lto=false `` is not needed on all platforms). You can test the installation with::
218+
219+ pixi run python -c "import matplotlib; print(matplotlib.__file__)"
220+
221+ Note there are some pixi tasks available as shortcuts::
222+
223+ pixi task list
224+
225+ If you do not want to use ``pixi run `` in front of every command, you can do::
226+
227+ pixi shell
228+
229+ and continue to use pixi as a python environment.
230+
231+ .. note :: do not edit the ``pyproject.toml`` file and commit to the repository, as this
232+ will affect all developers. If you want to change the dependencies, please open an
233+ issue or pull request to discuss the change. If you want a custom ``pixi.toml `` file,
234+ you can create one in your home directory, and it will be used instead of the
235+ repository one. An example is available in ``tools/pixi.example.toml `` that lists the
236+ dependencies needed to build Matplotlib.
237+
238+ .. _pixi : https://pixi.prefix.dev/
202239
203240Install external dependencies
204241^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
0 commit comments