Struct Blocks 

pub struct Blocks { /* private fields */ }

Fluent builder for a list of Anthropic content blocks.

All chained appenders return &mut Self; finalize with Blocks::build (consumes the builder) or Blocks::build_message.

Implementations

impl Blocks

pub fn new() -> Self

Create an empty builder.

pub fn text(&mut self, s: impl Into<String>) -> &mut Self

Append a plain text block.

pub fn text_with_cache( &mut self, s: impl Into<String>, cache_control: CacheControl, ) -> &mut Self

Append a text block carrying a cache_control marker.

pub fn image_b64( &mut self, data: &[u8], media_type: impl Into<String>, ) -> Result<&mut Self, BlockError>

Append a base64-encoded inline image block.

data is the raw image bytes; the builder base64-encodes them internally so callers never have to think about the encoding.

Returns BlockError::UnsupportedImageMediaType if media_type is not in VALID_IMAGE_MEDIA_TYPES.

pub fn image_b64_with_cache( &mut self, data: &[u8], media_type: impl Into<String>, cache_control: CacheControl, ) -> Result<&mut Self, BlockError>

Same as Blocks::image_b64 but also tags the block with a cache_control marker.

pub fn image_url(&mut self, url: impl Into<String>) -> &mut Self

Append an image block that references a remote URL.

pub fn tool_use( &mut self, id: impl Into<String>, name: impl Into<String>, input: Value, ) -> &mut Self

Append a tool_use block. input is taken as a serde_json::Value so callers may use the serde_json::json! macro or pass any type implementing Into<Value>.

pub fn tool_result( &mut self, tool_use_id: impl Into<String>, content: Value, is_error: bool, ) -> &mut Self

Append a tool_result block.

pub fn document_b64( &mut self, data: &[u8], media_type: impl Into<String>, ) -> Result<&mut Self, BlockError>

Append a base64-encoded document block. Defaults to PDF when no media type is supplied (see Blocks::document_pdf_b64).

Returns BlockError::UnsupportedDocumentMediaType if media_type is not in VALID_DOCUMENT_MEDIA_TYPES.

pub fn document_pdf_b64(&mut self, data: &[u8]) -> &mut Self

Convenience wrapper for the common application/pdf case.

pub fn extend<I>(&mut self, blocks: I) -> &mut Self

where I: IntoIterator<Item = ContentBlock>,

Splice an existing iterable of content blocks into the builder.

pub fn build(&mut self) -> Vec<ContentBlock>

Drain the builder and return the accumulated block list.

Takes &mut self (rather than self) so it composes naturally with the &mut Self-returning fluent chain (e.g. Blocks::new().text("hi").build()). The builder is left empty after the call; calling .build() twice yields [blocks, []].

pub fn build_message(&mut self, role: impl Into<String>) -> Message

Drain the builder and wrap the accumulated blocks in a {role, content} envelope.

pub fn len(&self) -> usize

Return the current number of accumulated blocks.

pub fn is_empty(&self) -> bool

Return true when no blocks have been appended yet.

pub fn tool_result_block( tool_use_id: impl Into<String>, content: Value, is_error: bool, ) -> ContentBlock

Build a single tool_result block without going through the builder. Mirrors the Python Blocks.tool_result classmethod.

Trait Implementations

impl Clone for Blocks

fn clone(&self) -> Blocks

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Blocks

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

Formats the value using the given formatter.

impl Default for Blocks

fn default() -> Blocks

Returns the “default value” for a type.