Generates import libraries for the Python DLL
(either python3.dll
or python3y.dll
)
for MinGW-w64 and MSVC (cross-)compile targets.
This crate does not require Python 3 distribution files to be present on the (cross-)compile host system.
This crate uses the binutils dlltool
program to generate
the Python DLL import libraries for MinGW-w64 targets.
Setting PYO3_MINGW_DLLTOOL
environment variable overrides
the default dlltool
command name for the target.
Note: MSVC cross-compile targets require either LLVM binutils
or Zig 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
from Linux.
Alternatively, ZIG_COMMAND
environment variable may be set to e.g. "zig"
or "python -m ziglang"
, then zig dlltool
will be used in place
of llvm-dlltool
(or MinGW binutils).
Since version 0.16.5, the pyo3
crate implements support
for both the Stable ABI and version-specific Python DLL import
library generation via its new generate-import-lib
feature.
In this configuration, python3-dll-a
becomes a pyo3
crate dependency
and is automatically invoked by its build script in both native
and cross compilation scenarios.
[dependencies]
pyo3 = { version = "0.16.5", features = ["extension-module", "abi3-py37", "generate-import-lib"] }
[dependencies]
pyo3 = { version = "0.16.5", features = ["extension-module", "generate-import-lib"] }
If an older pyo3
crate version is used, or a different Python bindings
library is required, python3-dll-a
can be used directly
from the crate build script.
The examples below assume using an older version of PyO3.
The following cargo build script can be used to cross-compile Stable ABI PyO3 extension modules for Windows (64/32-bit x86 or 64-bit ARM) using either MinGW-w64 or MSVC target environment ABI:
fn main() {
if std::env::var("CARGO_CFG_TARGET_OS").unwrap() == "windows" {
let cross_lib_dir = std::env::var_os("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();
let libdir = std::path::Path::new(&cross_lib_dir);
python3_dll_a::generate_implib_for_target(libdir, &arch, &env)
.expect("python3.dll import library generator failed");
}
}
A compatible python3.dll
import library file named python3.dll.a
or python3.lib
will be automatically created in the directory
pointed by the PYO3_CROSS_LIB_DIR
environment variable.
PYO3_CROSS_LIB_DIR=target/python3-dll cargo build --target x86_64-pc-windows-gnu
As an advanced feature, python3-dll-a
can generate Python version
specific import libraries such as python39.lib
.
See the ImportLibraryGenerator
builder API description for details.
This crate embeds Module-Defitions based on the stable_abi.toml
file from CPython.
The upstream version of this file is located in the CPython project
repository under the path Misc/stable_abi.toml
.