Crate python3_dll_a
source · [−]Expand description
Standalone python3.dll
import library generator
Generates import libraries for the Stable ABI Python DLL for MinGW-w64 and MSVC (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.
Note: MSVC (cross-)compile targets require LLVM binutils
to be available on the host system.
More specifically, python3-dll-a
requires llvm-dlltool
executable
to be present in PATH
when targeting *-pc-windows-msvc
.
Example build.rs
script
The following script can be used to cross-compile Stable ABI PyO3 extension modules for Windows (64-bit MinGW-w64):
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 or GNU and MSVC ABI (cross-)compile target
support is needed, the more generic generate_implib_for_target()
function must be used:
fn main() {
if std::env::var("CARGO_CFG_TARGET_OS").unwrap() == "windows" {
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();
let env = std::env::var("CARGO_CFG_TARGET_ENV").unwrap();
python3_dll_a::generate_implib_for_target(&libdir, &arch, &env)
.expect("python3.dll import library generator failed");
}
}
Example cargo build
invocation
PYO3_CROSS_LIB_DIR=target/python3-dll cargo build --target x86_64-pc-windows-gnu
Functions
Generates python3.dll
import library directly from the embedded
Python Stable ABI definitions data for the default 64-bit MinGW-w64
compile target.
Generates python3.dll
import library directly from the embedded
Python Stable ABI definitions data for the specified compile target.