Struct TraitBridgeConfig 

pub struct TraitBridgeConfig {
    pub trait_name: String,
    pub super_trait: Option<String>,
    pub registry_getter: Option<String>,
    pub register_fn: Option<String>,
    pub type_alias: Option<String>,
    pub param_name: Option<String>,
    pub register_extra_args: Option<String>,
    pub exclude_languages: Vec<String>,
}

Configuration for generating trait bridge code that allows foreign language objects to implement Rust traits via FFI.

Fields

trait_name: String

Name of the Rust trait to bridge (e.g., "OcrBackend").

super_trait: Option<String>

Super-trait that requires forwarding (e.g., "Plugin"). When set, the bridge generates an impl SuperTrait for Wrapper block.

registry_getter: Option<String>

Rust path to the registry getter function (e.g., "kreuzberg::plugins::registry::get_ocr_backend_registry"). Optional — when set, the generated registration function inserts the bridge into a registry.

register_fn: Option<String>

Name of the registration function to generate (e.g., "register_ocr_backend"). Optional — when set, a #[pyfunction] registration function is generated. When absent, only the wrapper struct and trait impl are emitted (per-call bridge pattern).

type_alias: Option<String>

Named type alias in the IR that maps to this bridge (e.g., "VisitorHandle").

When a function parameter has a TypeRef::Named matching this alias, code generators replace the parameter type with the language-native callback object (e.g., Py<PyAny> for Python) and emit wrapping code to construct the bridge.

param_name: Option<String>

Parameter name override — when the extractor sanitizes the type (e.g., VisitorHandle becomes String because it is a type alias over Rc<RefCell<dyn Trait>>), use the parameter name instead of the IR type to detect which parameter to bridge.

For example, param_name = "visitor" ensures that a sanitized visitor: Option<String> parameter is still treated as a bridge param for this trait.

register_extra_args: Option<String>

Extra arguments to append to the registry.register(arc, ...) call. Example: "0" produces registry.register(arc, 0).

exclude_languages: Vec<String>

Language backends that should NOT generate this trait bridge. Use backend names as they appear in Backend::name(), e.g. ["elixir", "wasm"]. When a backend’s name is listed here, the bridge struct and all related code are omitted from that backend’s output.

Trait Implementations

impl Clone for TraitBridgeConfig

fn clone(&self) -> TraitBridgeConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for TraitBridgeConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TraitBridgeConfig

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TraitBridgeConfig

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.