Standalone `python3.dll` import library generator
=================================================
Generates import libraries for the Stable ABI Python DLL
for MinGW-w64 cross-compile targets.
See <https://docs.python.org/3/c-api/stable.html> for details.
This crate **does not require** Python 3 distribution files
to be present on the cross-compile host system.
Example `build.rs` script
-------------------------
The following script can be used to cross-compile Stable ABI
PyO3 extension modules for Windows:
```rust
fn main() {
if std::env::var("TARGET").unwrap() == "x86_64-pc-windows-gnu" {
let libdir = std::env::var("PYO3_CROSS_LIB_DIR")
.expect("PYO3_CROSS_LIB_DIR is not set when cross-compiling");
python3_dll_a::generate_implib(&libdir)
.expect("python3.dll import library generator failed");
}
}
```
A compatible `python3.dll` import library will be automatically created in
the directory pointed by `PYO3_CROSS_LIB_DIR` environment variable.
If both 64-bit and 32-bit Windows cross-compile targets support is needed,
the more generic `generate_implib_for_target()` function must be used:
```rust
fn main() {
if std::env::var("CARGO_CFG_TARGET_OS").unwrap() == "windows"
&& std::env::var("CARGO_CFG_TARGET_ENV").unwrap() == "gnu"
{
let libdir = std::env::var("PYO3_CROSS_LIB_DIR")
.expect("PYO3_CROSS_LIB_DIR is not set when cross-compiling");
let arch = std::env::var("CARGO_CFG_TARGET_ARCH").unwrap();
python3_dll_a::generate_implib_for_target(&libdir, &arch, "gnu")
.expect("python3.dll import library generator failed");
}
}
```
Example `cargo build` invocation
--------------------------------
```sh
PYO3_CROSS_LIB_DIR=target/python3-dll cargo build --target x86_64-pc-windows-gnu
```