pdb-bindgen-codegen 0.1.0

Build-time discovery, PDB acquisition, and binding generation for pdb-bindgen.
Documentation
use pdb_bindgen_macro_support::FragmentKind;

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct Discovery {
    pub(crate) files: Vec<SourceFile>,
    pub(crate) resolved: Vec<ResolvedItem>,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct SourceFile {
    pub(crate) path: String,
    pub(crate) items: Vec<DiscoveredItem>,
}

#[derive(Clone, Copy, Debug, Eq, PartialEq)]
pub(crate) struct Location {
    pub(crate) line: usize,
    pub(crate) column: usize,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct DiscoveredItem {
    pub(crate) location: Location,
    pub(crate) kind: DiscoveredItemKind,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) enum DiscoveredItemKind {
    Module {
        name: String,
        body: ModuleBody,
        image: Option<ImageScope>,
        path: Option<String>,
    },
    Compatibility {
        name: String,
    },
    Type {
        rust_name: String,
        type_name: String,
        kind: FragmentKind,
        syntax: TypeSyntax,
        fields: Vec<SelectedField>,
    },
    Symbols {
        declarations: Vec<SymbolDeclaration>,
    },
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) enum ModuleBody {
    Inline(Vec<DiscoveredItem>),
    OutOfLine,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct ImageScope {
    pub(crate) image: String,
    pub(crate) base: String,
}

/// Rust syntax captured from the first active source AST walk.
#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct TypeSyntax {
    pub(crate) visibility: String,
    pub(crate) attributes: Vec<String>,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct SelectedField {
    pub(crate) location: Location,
    pub(crate) rust_name: String,
    pub(crate) field_name: String,
    pub(crate) visibility: String,
    pub(crate) attributes: Vec<String>,
    pub(crate) ty: String,
    pub(crate) read_only: bool,
}

/// Owned Rust declaration facts retained after the single source AST walk.
#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) enum SymbolDeclaration {
    Function(SymbolFunction),
    Global(SymbolGlobal),
}
#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) enum SymbolSafety {
    Safe,
    Unsafe,
}
#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct SymbolFunction {
    pub(crate) location: Location,
    pub(crate) name: String,
    pub(crate) visibility: String,
    pub(crate) attributes: Vec<String>,
    pub(crate) safety: SymbolSafety,
    pub(crate) arguments: Vec<SymbolArgument>,
    pub(crate) output: Option<String>,
}
#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct SymbolArgument {
    pub(crate) name: String,
    pub(crate) ty: String,
}
#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct SymbolGlobal {
    pub(crate) location: Location,
    pub(crate) name: String,
    pub(crate) visibility: String,
    pub(crate) attributes: Vec<String>,
    pub(crate) safety: SymbolSafety,
    pub(crate) ty: String,
    pub(crate) mutable: bool,
}

/// A PDB declaration after module ownership and image scope resolution.
#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) struct ResolvedItem {
    pub(crate) source_path: String,
    pub(crate) module_path: Vec<String>,
    pub(crate) location: Location,
    pub(crate) image: ImageScope,
    pub(crate) kind: ResolvedItemKind,
}

#[derive(Clone, Debug, Eq, PartialEq)]
pub(crate) enum ResolvedItemKind {
    Type {
        rust_name: String,
        type_name: String,
        kind: FragmentKind,
        syntax: TypeSyntax,
        fields: Vec<SelectedField>,
    },
    Symbols {
        declarations: Vec<SymbolDeclaration>,
    },
}