Struct BuilderSpec 

pub struct BuilderSpec {
    pub constructor: Constructor,
    pub calls: Vec<MethodCall>,
    pub terminal: Terminal,
}

A declarative specification for a builder pattern.

This represents the intent of building an object via method chaining, independent of any specific language syntax.

Fields

constructor: Constructor

How to construct the base expression.

calls: Vec<MethodCall>

Method calls in order.

terminal: Terminal

Terminal operation (await, try, build method).

Implementations

impl BuilderSpec

pub fn new(type_path: impl Into<String>) -> Self

Create a new builder spec with a static ::new() constructor.

pub fn with_constructor(constructor: Constructor) -> Self

Create a builder spec with a custom constructor.

pub fn call(self, name: impl Into<String>) -> Self

Add a method call with no arguments.

pub fn call_arg(self, name: impl Into<String>, value: Value) -> Self

Add a method call with a single argument.

pub fn call_args( self, name: impl Into<String>, values: impl IntoIterator<Item = Value>, ) -> Self

Add a method call with multiple arguments.

pub fn call_if(self, condition: bool, name: impl Into<String>) -> Self

Conditionally add a method call.

pub fn call_arg_if( self, condition: bool, name: impl Into<String>, value: Value, ) -> Self

Conditionally add a method call with argument.

pub fn call_opt(self, name: impl Into<String>, value: Option<Value>) -> Self

Add a method call if the value is Some.

pub fn async_(self) -> Self

Mark the chain as async.

pub fn try_(self) -> Self

Mark the chain as try (error propagation).

pub fn terminal_method(self, name: impl Into<String>) -> Self

Add a terminal method call.

pub fn has_calls(&self) -> bool

Check if the spec has any method calls.

pub fn apply_config<I, S>(self, config: I) -> Self

where I: IntoIterator<Item = (S, Option<Value>)>, S: Into<String>,

Apply configuration from an iterator of optional values.

This enables declarative config-to-chain mapping:

spec.apply_config([
    ("max_connections", config.max.map(Value::uint)),
    ("timeout", config.timeout.map(Value::duration_secs)),
])

pub fn render(&self, renderer: &dyn Renderer) -> String

Render using the given renderer with default options.

pub fn render_inline(&self, renderer: &dyn Renderer) -> String

Render inline using the given renderer.

pub fn render_with( &self, renderer: &dyn Renderer, opts: &RenderOptions, ) -> String

Render with custom options.

Trait Implementations

impl Clone for BuilderSpec

fn clone(&self) -> BuilderSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for BuilderSpec

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

Formats the value using the given formatter.

impl PartialEq for BuilderSpec

fn eq(&self, other: &BuilderSpec) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for BuilderSpec