Skip to content

Commit

Permalink
DOC: add a brief explanation of build isolation to the tutorial
Browse files Browse the repository at this point in the history
  • Loading branch information
rgommers committed May 19, 2024
1 parent 063fe8b commit 627976e
Showing 1 changed file with 12 additions and 0 deletions.
12 changes: 12 additions & 0 deletions docs/tutorials/introduction.rst
Original file line number Diff line number Diff line change
Expand Up @@ -255,6 +255,18 @@ If the build succeeded, you'll have the binary artifacts in the ``dist`` folder.
easier, we recommend checking out the cibuildwheel_ project, which allows you
to automate it.

Build isolation
```````````````

Building with ``python -m build`` or with ``pip`` uses build isolation by
default. I.e., the build frontend creates a new, temporary virtual environment
with all build dependencies before calling ``meson-python`` to build a wheel.

If you disable build isolation, you are responsible for ensuring that
``meson-python`` and all other build dependencies for the package are installed
already in the Python environment. Note that if you use a virtual environment
to build in, it must be activated.


Distributing the project
------------------------
Expand Down

0 comments on commit 627976e

Please sign in to comment.