Struct PythonGenerator 

pub struct PythonGenerator;

Trait Implementations

impl Generator for PythonGenerator

type Config = <PythonGenerator as LanguageBackend>::Config

Per-target, fully-typed configuration consumed by generate and output_files. Must round-trip through serde_json so the orchestrator can hash it as part of the cache key.

fn name(&self) -> &'static str

Stable short name for the target ("swift", "c", "node", …). Used as the cache file basename and the --target filter token.

fn generate( &self, api: &Api, out_dir: &Utf8Path, config: &Self::Config, ) -> Result<()>

Render the bindings under out_dir.

fn output_files( &self, api: &Api, out_dir: &Utf8Path, config: &Self::Config, ) -> Vec<String>

Files that generate would write, relative to (or anchored under) out_dir. Used by --dry-run and diff. Default implementation returns the empty list; generators override to surface the list without doing any I/O.

impl LanguageBackend for PythonGenerator

type Config = PythonConfig

Per-target, fully-typed configuration. Mirrors Generator::Config.

fn name(&self) -> &'static str

Stable short name ("swift", "python", …): the --target token.

fn prefix<'a>(&self, config: &'a Self::Config) -> &'a str

The C ABI symbol prefix the producer used. The driver builds the BindingModel with it so every emitted call targets the right exported symbol. Defaults to "weaveffi"; override when the config carries a configurable c_prefix.

fn render_enum(&self, out: &mut String, e: &EnumBinding, _config: &Self::Config)

Render one enum (its declaration and any helpers), including doc comments. Override when using emit_members.

fn render_struct( &self, out: &mut String, _module: &ModuleBinding, s: &StructBinding, _config: &Self::Config, )

Render one struct: the wrapper type, its getters, lifecycle, and the optional builder. module is the owning module (for symbol paths). Override when using emit_members.

fn render_function( &self, out: &mut String, module: &ModuleBinding, f: &FnBinding, config: &Self::Config, )

Render one function. Implementations match on f.shape (sync / async / iterator) and emit the idiomatic wrapper plus its doc comment. Override when using emit_members.

fn files( &self, api: &Api, model: &BindingModel, out_dir: &Utf8Path, config: &Self::Config, ) -> Vec<OutputFile>

Assemble the complete output set. The driver has already built model (via BindingModel::build with prefix) and passes the source api too, for the rare file (e.g. a .pyi stub) that needs the raw IR. Most backends render a primary source file by composing emit_members over model.modules, then append package manifests (package.json, pyproject.toml, go.mod, …) as additional OutputFiles.

fn render_callback( &self, out: &mut String, module: &ModuleBinding, c: &CallbackBinding, config: &Self::Config, )

Render a module-scope callback typedef. Default: no output (most idiomatic backends express callbacks inline at the async/listener call site).

fn render_listener( &self, out: &mut String, module: &ModuleBinding, l: &ListenerBinding, config: &Self::Config, )

Render a listener’s register/unregister surface. Default: no output.

fn emit_members( &self, out: &mut String, module: &ModuleBinding, config: &Self::Config, )

Emit every member of module in canonical order (enums → structs → callbacks → listeners → functions). Backends call this from within their own module scoping; overriding the per-entity hooks is what guarantees a single-pass backend cannot silently skip an entity kind.