build: opt-in static libxml2 link via LIBXML2_STATIC (v0.3.13)

When LIBXML2_STATIC is set, build.rs probes via pkg-config with .statik(true), emitting static=xml2 (+ transitive -lm), for a SONAME-independent self-contained downstream binary. Default (env unset) is unchanged.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

Author: dginev

CHANGELOG.md

@@ -1,6 +1,17 @@
 # Change Log
 
-## [0.3.13] (in development)
+## [0.3.13] (2026-06-11)
+
+### Added
+
+* Opt-in **static linking** of libxml2. Set the `LIBXML2_STATIC` environment
+  variable and `build.rs` probes via pkg-config with `.statik(true)`,
+  emitting `cargo:rustc-link-lib=static=xml2` (plus the transitive `-lm`).
+  Point `PKG_CONFIG_PATH` at a non-system prefix holding a PIC `libxml2.a`
+  to get a binary with no runtime `libxml2.so` dependency — independent of
+  the host's libxml2 SONAME, which bumped `.so.2` → `.so.16` at libxml2 2.14.
+  Unset (the default) is unchanged: a normal dynamic link against the host
+  libxml2.
 
 ## [0.3.12] (2026-05-23)
 

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "libxml"
-version = "0.3.12"
+version = "0.3.13"
 edition = "2024"
 authors = ["Andreas Franzén <andreas@devil.se>", "Deyan Ginev <deyan.ginev@gmail.com>","Jan Frederik Schaefer <j.schaefer@jacobs-university.de>"]
 description = "A Rust wrapper for libxml2 - the XML C parser and toolkit developed for the Gnome project"

build.rs

@@ -49,7 +49,18 @@ fn find_libxml2() -> Option<ProbedLib> {
       all(target_family = "windows", target_env = "gnu")
     ))]
     {
-      let lib = pkg_config::Config::new()
+      // Opt-in static link: when LIBXML2_STATIC is set and PKG_CONFIG_PATH points
+      // at a non-system prefix carrying a PIC `libxml2.a`, `.statik(true)` makes
+      // pkg-config emit `cargo:rustc-link-lib=static=xml2` plus the transitive
+      // `-lm` (which stays dynamic). pkg-config's static guard refuses a `static=`
+      // for a /usr/lib system path, so the non-system prefix is what enables this.
+      // Unset (the default) is unchanged: a normal dynamic link against the host
+      // libxml2. Used for the self-contained, SONAME-independent release binary.
+      let mut cfg = pkg_config::Config::new();
+      if std::env::var_os("LIBXML2_STATIC").is_some() {
+        cfg.statik(true);
+      }
+      let lib = cfg
         .probe("libxml-2.0")
         .expect("Couldn't find libxml2 via pkg-config");
       return Some(ProbedLib {
@@ -92,6 +103,8 @@ fn generate_bindings(header_dirs: Vec<PathBuf>, output_path: &Path) {
 }
 
 fn main() {
+  // Re-run if the opt-in static toggle flips (see find_libxml2's static branch).
+  println!("cargo:rerun-if-env-changed=LIBXML2_STATIC");
   let bindings_path = PathBuf::from(env::var_os("OUT_DIR").unwrap()).join("bindings.rs");
   // declare availability of config variable (without setting it)
   println!("cargo::rustc-check-cfg=cfg(libxml_older_than_2_12)");