fullbleed 2.2.3

Deterministic HTML/CSS-to-PDF engine in Rust for transactional document generation and AI agent workflows.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

use std::env;
use std::path::{Path, PathBuf};
use std::process::Command;

fn main() {
    println!("cargo:rerun-if-env-changed=FULLBLEED_PYTHON_LIB_DIR");
    println!("cargo:rerun-if-env-changed=FULLBLEED_PYTHON_SYS_EXECUTABLE");
    println!("cargo:rerun-if-env-changed=PYTHON_SYS_EXECUTABLE");

    if env::var_os("CARGO_FEATURE_PYTHON").is_none() {
        return;
    }

    match env::var("CARGO_CFG_TARGET_OS").as_deref() {
        Ok("windows") => configure_windows_python(),
        Ok("macos") => configure_macos_extension(),
        _ => {}
    }
}

fn configure_windows_python() {
    let library_dir = env::var_os("FULLBLEED_PYTHON_LIB_DIR")
        .map(PathBuf::from)
        .unwrap_or_else(discover_windows_python_library_dir);
    let stable_import_library = library_dir.join("python3.lib");
    if !stable_import_library.is_file() {
        panic!(
            "Fullbleed's stable Python ABI requires {}; set \
             FULLBLEED_PYTHON_LIB_DIR to the target Python installation's libs directory",
            stable_import_library.display()
        );
    }
    println!("cargo:rustc-link-search=native={}", library_dir.display());
}

fn discover_windows_python_library_dir() -> PathBuf {
    let interpreter = env::var_os("FULLBLEED_PYTHON_SYS_EXECUTABLE")
        .or_else(|| env::var_os("PYTHON_SYS_EXECUTABLE"))
        .unwrap_or_else(|| "python".into());
    let script = concat!(
        "import pathlib, sys, sysconfig\n",
        "candidates = [\n",
        "    sysconfig.get_config_var('LIBDIR'),\n",
        "    pathlib.Path(sys.base_prefix) / 'libs',\n",
        "    pathlib.Path(sys.prefix) / 'libs',\n",
        "]\n",
        "for candidate in candidates:\n",
        "    if candidate and (pathlib.Path(candidate) / 'python3.lib').is_file():\n",
        "        print(pathlib.Path(candidate).resolve())\n",
        "        break\n",
    );
    let output = Command::new(&interpreter)
        .args(["-c", script])
        .output()
        .unwrap_or_else(|error| {
            panic!(
                "failed to run Python interpreter {:?} while locating python3.lib: {error}",
                interpreter
            )
        });
    if !output.status.success() {
        panic!(
            "Python interpreter {:?} failed while locating python3.lib: {}",
            interpreter,
            String::from_utf8_lossy(&output.stderr).trim()
        );
    }
    let path = String::from_utf8(output.stdout)
        .expect("Python library directory was not valid UTF-8")
        .trim()
        .to_owned();
    if path.is_empty() {
        panic!(
            "could not locate python3.lib through {:?}; set FULLBLEED_PYTHON_LIB_DIR",
            interpreter
        );
    }
    let path = Path::new(&path);
    path.to_path_buf()
}

fn configure_macos_extension() {
    // Extension modules resolve CPython symbols from their loading interpreter.
    println!("cargo:rustc-cdylib-link-arg=-Wl,-undefined");
    println!("cargo:rustc-cdylib-link-arg=-Wl,dynamic_lookup");
}