Skip to main content

pdb_bindgen_codegen/
lib.rs

1//! Host-side configuration for generating bindings from Program Database files.
2//!
3//! This crate describes images, source discovery, and PDB acquisition policy.
4//! Configuring a [`Builder`] is side-effect free. [`Builder::generate`] reads the
5//! Cargo environment and package source files, acquires active PDBs, and publishes
6//! Rust bindings. Users normally access this API through the
7//! `pdb-bindgen` facade's `codegen` feature.
8
9#[allow(
10    dead_code,
11    reason = "acquisition is invoked by build-script generation"
12)]
13mod acquisition;
14#[allow(dead_code, reason = "rendering is invoked by build-script generation")]
15mod codegen;
16mod config;
17#[allow(dead_code, reason = "discovery is invoked by build-script generation")]
18mod discovery;
19mod execution;
20mod identity;
21#[allow(dead_code, reason = "layout facts are consumed by binding generation")]
22mod layout;
23#[allow(
24    dead_code,
25    reason = "output publication is invoked by build-script generation"
26)]
27mod output;
28#[allow(
29    dead_code,
30    reason = "PDB normalization is consumed by layout and binding generation"
31)]
32mod pdb;
33
34pub use config::{Builder, CachePolicy, ConfigError, Image, SymbolServer, SymbolServerErrorKind};
35pub use execution::{GenerateError, GenerateErrorKind};
36pub use identity::{GuidErrorKind, ParsePdbGuidError, PdbFilenameErrorKind, PdbGuid, PdbIdentity};
37
38#[cfg(test)]
39#[path = "../tests/unit/mod.rs"]
40mod unit_tests;