luxolus/pyo3
2
0
Fork 0
Code Issues Pull requests Packages Projects Releases Wiki Activity

docs: Update the guide for python3-dll-a v0.2.6

Browse source 
Bump the minimum `python3-dll-a` dependency version.

Document the implemented workaround for
https://github.com/PyO3/python3-dll-a/issues/28
This commit is contained in:
Sergey Kvachonok 2022-08-21 14:33:52 +03:00
parent d0492b7c72
commit 97eaa77db8
2 changed files with 7 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
guide/src/building_and_distribution.md
View file

@ -293,9 +293,13 @@ An experimental `pyo3` crate feature `generate-import-lib` enables the user to c
extension modules for Windows targets without setting the `PYO3_CROSS_LIB_DIR` environment
variable or providing any Windows Python library files. It uses an external [`python3-dll-a`] crate
to generate import libraries for the Python DLL for MinGW-w64 and MSVC compile targets.
`python3-dll-a` uses the binutils `dlltool` program to generate DLL import libraries for MinGW-w64 targets.
It is possible to override the default `dlltool` command name for the cross target
by setting `PYO3_MINGW_DLLTOOL` environment variable.
*Note*: MSVC targets require LLVM binutils or MSVC build tools to be available on the host system.
More specifically, `python3-dll-a` requires `llvm-dlltool` or `lib.exe` executable to be present in `PATH` when
targeting `*-pc-windows-msvc`.
targeting `*-pc-windows-msvc`. Zig compiler executable can be used in place of `llvm-dlltool` when `ZIG_COMMAND`
environment variable is set to the installed Zig program name (`"zig"` or `"python -m ziglang"`).
An example might look like the following (assuming your target's sysroot is at `/home/pyo3/cross/sysroot` and that your target is `armv7`):

4
pyo3-build-config/Cargo.toml
View file

@ -12,11 +12,11 @@ edition = "2018"
[dependencies]
once_cell = "1"
python3-dll-a = { version = "0.2.5", optional = true }
python3-dll-a = { version = "0.2.6", optional = true }
target-lexicon = "0.12"
[build-dependencies]
python3-dll-a = { version = "0.2.5", optional = true }
python3-dll-a = { version = "0.2.6", optional = true }
target-lexicon = "0.12"
[features]