docs: Add a FAQ section about recompilation due to IDE #4183
Conversation
|
I've chosen to put this question in first position, because I think it may be the most common issue encountered by users, as most of of them use an IDE with background |
CodSpeed Performance ReportMerging #4183 will not alter performanceComparing Summary
|
| A solution can be to set a fixed `PYO3_PYTHON` environment variable for each build. You can for example write a cargo [configuration file](https://doc.rust-lang.org/cargo/reference/config.html), e.g. `.cargo/config.toml`, with | ||
| ```toml | ||
| [env] | ||
| PYO3_PYTHON = "venv/bin/python" # or any other Python path like "/usr/bin/python" |
There was a problem hiding this comment.
Fixing the Python interpreter is one solution. Do we want to discuss the alternative to have rust-analyzer use a separate target directory, c.f. rust-lang/rust-analyzer#6007, as well?
IIRC, this is often recommended to avoid build directory lock contention and appears to be more general approach and does not have the downside of having to fix the interpreter? OTOH, fixing the interpreter might actually a good thing to avoid build and test errors and such coming from unexpected Python environments?
There was a problem hiding this comment.
Fixing the Python interpreter is one solution. Do we want to discuss the alternative to have rust-analyzer use a separate target directory, c.f. rust-lang/rust-analyzer#6007, as well?
Indeed, I didn't considered this solution, and it may be indeed a better alternative.
OTOH, fixing the interpreter might actually a good thing to avoid build and test errors and such coming from unexpected Python environments?
Yes, but it's kind of unrelated to this question of the FAQ. If users encounter issues caused by unexpected Python interpreters, then I think it will be worth to add a dedicated question in the FAQ.
I will update the answer to mention target directory as the first solution.
fixes #1708