commit b4c7de6ab9799bf3e8cb4a67d73d0a49e0c99a1d
author Krzysztof Drewniak <Krzysztof.Drewniak@amd.com> Fri Jan 17 12:53:30 2025 -0800
committer GitHub <noreply@github.com> Fri Jan 17 14:53:30 2025 -0600
tree f93840d2c766b7f5b37edad4c2e556cef9ddf9d0
parent b08d152138e82f355c12bc5909b181adde6d4b0e

[Python] Enable building Python bindings as editable wheels, document it (#19716)

In order to not need to constantly source PYTHONPATH, and to run the
rink of potentially having it set wrong when dealing with multiple IREE
builds, and to allow packages like the kernel bunchmarking suite to use
a local build without needing to edit requirements.txt, add the ability
to build these packages as editableble wheels.

This method, newly added to the build documentation, tells CMake to use
symbolic links when "installing" the Python packages from the build
directroy into a different build directory. In combination with telling
copytree to preserve symlinks, this creates Python packages that link
back to the build or source directory when the `-e` flag is used on pip.

This means that an automated virtual environment switcher, like `pyenv`,
will pick up the correct Python bindings automatically and will direct
`iree-compiler` and `iree-runtime` shims to the correct build.