Struct CodeBuilder 

pub struct CodeBuilder { /* private fields */ }

Fluent API for building code with proper indentation.

Supports both consuming methods (returning Self) for chaining and mutable methods (returning &mut Self) for the new API.

Example (Consuming API)

use baobao_codegen::builder::CodeBuilder;

let code = CodeBuilder::new(Default::default())
    .line("fn main() {")
    .indent()
    .line("println!(\"Hello, world!\");")
    .dedent()
    .line("}")
    .build();

assert_eq!(code, "fn main() {\n    println!(\"Hello, world!\");\n}\n");

Example (Mutable API)

use baobao_codegen::builder::CodeBuilder;

let mut builder = CodeBuilder::rust();
builder
    .push_line("fn main() {")
    .push_indent()
    .push_line("println!(\"Hello\");")
    .push_dedent()
    .push_line("}");
let code = builder.build();

Implementations

impl CodeBuilder

pub fn new(indent: Indent) -> Self

Create a new CodeBuilder with the specified indentation.

pub fn rust() -> Self

Create a new CodeBuilder with 4-space indentation (Rust default).

pub fn typescript() -> Self

Create a new CodeBuilder with 2-space indentation (JS/TS default).

pub fn go() -> Self

Create a new CodeBuilder with tab indentation (Go default).

pub fn push_line(&mut self, s: &str) -> &mut Self

Add a line of code with current indentation (mutable).

pub fn push_blank(&mut self) -> &mut Self

Add a blank line (mutable).

pub fn push_raw(&mut self, s: &str) -> &mut Self

Add raw text without indentation or newline (mutable).

pub fn push_indent(&mut self) -> &mut Self

Increase indentation level (mutable).

pub fn push_dedent(&mut self) -> &mut Self

Decrease indentation level (mutable).

pub fn push_jsdoc(&mut self, text: &str) -> &mut Self

Add a JSDoc comment (mutable).

pub fn push_rust_doc(&mut self, text: &str) -> &mut Self

Add a Rust doc comment (mutable).

pub fn emit(&mut self, node: &impl Renderable) -> &mut Self

Emit a Renderable node (mutable).

This is the primary way to render AST nodes with the new API.

pub fn apply_fragment(&mut self, fragment: CodeFragment)

Apply a single code fragment.

pub fn line(self, s: &str) -> Self

Add a line of code with current indentation.

pub fn blank(self) -> Self

Add a blank line (no indentation).

pub fn raw(self, s: &str) -> Self

Add raw text without indentation or newline.

pub fn indent(self) -> Self

Increase indentation level.

pub fn dedent(self) -> Self

Decrease indentation level.

pub fn block<F>(self, header: &str, f: F) -> Self

where F: FnOnce(Self) -> Self,

Add a block with automatic indentation.

Example

use baobao_codegen::builder::CodeBuilder;

let code = CodeBuilder::rust()
    .block("impl Foo {", |b: CodeBuilder| {
        b.line("fn bar(&self) {}")
    })
    .build();

pub fn block_with_close<F>(self, header: &str, close: &str, f: F) -> Self

where F: FnOnce(Self) -> Self,

Add a block with a closing line.

Example

use baobao_codegen::builder::CodeBuilder;

let code = CodeBuilder::rust()
    .block_with_close("fn main() {", "}", |b: CodeBuilder| {
        b.line("println!(\"Hello\");")
    })
    .build();

pub fn doc(self, prefix: &str, text: &str) -> Self

Add a doc comment line (e.g., /// text for Rust).

pub fn rust_doc(self, text: &str) -> Self

Add a Rust doc comment (/// text).

pub fn jsdoc(self, text: &str) -> Self

Add a JSDoc/TSDoc comment (/** text */ for single line).

pub fn when<F>(self, condition: bool, f: F) -> Self

where F: FnOnce(Self) -> Self,

Conditionally add content.

pub fn each<T, I, F>(self, items: I, f: F) -> Self

where I: IntoIterator<Item = T>, F: Fn(Self, T) -> Self,

Iterate and add content for each item.

pub fn current_indent(&self) -> usize

Get the current indentation level.

pub fn build(self) -> String

Consume the builder and return the generated code.

pub fn as_str(&self) -> &str

Get a reference to the current buffer content.

Trait Implementations

impl Clone for CodeBuilder

fn clone(&self) -> CodeBuilder

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CodeBuilder

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

Formats the value using the given formatter.

impl Default for CodeBuilder

fn default() -> Self

Returns the “default value” for a type.