Struct CodeGenConfig 

pub struct CodeGenConfig {

    pub context_type_path: String,
    pub result_type_path: String,
    pub models_path_template: String,
    pub models_path_crate_template: String,
    pub output: CodeGenOutput,
    pub generate_resource_enum: bool,
    pub generate_store_integration: bool,
    pub error_type_path: Option<String>,
    pub generate_object_conversions: bool,
    pub bindings: Option<BindingsConfig>,
    pub resource_store_crate_name: String,
    pub runtime: Runtime,
    pub transport_type_path: String,
    pub client_protocols: ClientProtocols,
    pub connect_client_path: Option<String>,
}

Configuration for code generation, including import paths and output directories.

Construct this struct directly and set the fields you need.

Fields

context_type_path: String

Fully-qualified path to the request context type used in handler methods.

Default: "crate::api::RequestContext"

result_type_path: String

Fully-qualified path to the Result alias used in generated handler and client code.

Default: "crate::Result"

models_path_template: String

Template for the external model import path. {service} is replaced with the service’s base path (e.g. "catalogs").

Example: "my_common::models::{service}::v1"

models_path_crate_template: String

Template for crate-local model import path. {service} is replaced with the service’s base path.

Default: "crate::models::{service}::v1"

output: CodeGenOutput

Output directory configuration.

generate_resource_enum: bool

When true, generate labels.rs with Resource / ObjectLabel enums derived from google.api.resource annotations. Requires output.models to be Some.

Store-specific output (Label impl, RESOURCE_DESCRIPTORS) is only emitted when generate_store_integration is also true.

generate_store_integration: bool

When true (and generate_resource_enum is set), emit the olai_store integration code in labels.rs:

• impl olai_store::Label for ObjectLabel
• pub static RESOURCE_DESCRIPTORS: &[olai_store::ResourceTypeDescriptor<ObjectLabel>]

Set to false for crates that use the enums without a store dependency.

error_type_path: Option<String>

Fully-qualified path to the Error type used in generated TryFrom<Resource> impls.

E.g. "crate::Error". When None, TryFrom impls are not generated.

generate_object_conversions: bool

When true and generate_resource_enum is set, emit TryFrom<Object>/TryFrom<T> and ResourceExt impl blocks in labels.rs for all resource types that have an IDENTIFIER-annotated field, plus a qualified_name() inherent method on each resource type.

bindings: Option<BindingsConfig>

Configuration for language-binding generation. Required when output.python, output.node, or output.node_ts is Some.

resource_store_crate_name: String

Crate name for the resource store types used in generated RESOURCE_DESCRIPTORS.

Default: "olai_store"

runtime: Runtime

Protobuf runtime the generated code is shaped for. See Runtime.

Defaults to Runtime::Prost for backward compatibility.

transport_type_path: String

Fully-qualified path to the HTTP transport type that generated clients store and call.

The transport must expose the surface generated client bodies use: per-verb builder methods (get/post/patch/delete/put) returning a request builder with .json(..)/.query(..)/.send(), whose response has .status()/.bytes(). olai_http::CloudClient satisfies this.

Defaults to "olai_http::CloudClient", so native output is unchanged. A WASM/browser client points this at a lightweight reqwest-Fetch transport that has no ring/tokio dependency and lets the browser attach the session.

client_protocols: ClientProtocols

Which client protocol layer(s) to emit. See ClientProtocols.

Defaults to REST only, so existing HTTP/JSON output is unchanged.

connect_client_path: Option<String>

Import path of the connect-rust (BSR plugin) generated client module, used only when client_protocols includes Connect.

The generated Connect builder layer references the connect-rust client type as <connect_client_path>::{Service}Client. The path should resolve to the module that holds the per-service {Service}Client<T> structs (e.g. "headwaters_proto::connect_gen::headwaters::read::v1").

Required (non-None) whenever Connect is selected and client output is enabled; ignored for REST-only output.

Implementations

impl CodeGenConfig

pub fn uses_default_transport(&self) -> bool

Whether generated clients use the default cloud transport (olai_http::CloudClient).

Controls emission of cloud-specific aggregate constructors (new_unauthenticated, new_with_token), which only make sense for CloudClient. A custom transport (e.g. the WASM/browser one) gets only the generic new(transport, base_url).

pub fn dual_transport(&self) -> bool

Whether the generated client should carry both transports, selected at compile time by cfg(target_arch = "wasm32") — CloudClient for native targets, olai_http_wasm::WasmClient for the browser.

Enabled when WASM bindings output is requested (output.wasm): a project that wants a browser client needs the same client crate to build both ways (native for server-side/tests, wasm32 for the frontend). Native-only projects leave output.wasm unset and keep the single transport_type_path transport with no WASM dependency.

pub fn validate(&self) -> Result<()>

Validate this config without running code generation.

Checks that:

• models_path_template and models_path_crate_template produce valid Rust paths after {service} substitution.
• bindings is Some whenever output.python, output.node, output.node_ts, or output.wasm is Some.

Call this at construction time to surface misconfiguration early, before generation runs.

Trait Implementations

impl Clone for CodeGenConfig

fn clone(&self) -> CodeGenConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CodeGenConfig

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

Formats the value using the given formatter.