Struct Binary 

pub struct Binary {
    pub content_type: String,
    pub source: BinarySource,
    pub name: Option<String>,
}

Binary payload attached to a message (e.g., image or PDF).

Fields

content_type: String

MIME type, such as “image/png” or “application/pdf”.

source: BinarySource

Where the bytes come from (base64 or URL).

name: Option<String>

Optional display name or filename.

Implementations

impl Binary

Constructors

pub fn new( content_type: impl Into<String>, source: BinarySource, name: Option<String>, ) -> Self

Construct a new Binary value.

pub fn from_base64( content_type: impl Into<String>, content: impl Into<Arc<str>>, name: Option<String>, ) -> Binary

Create a binary from a base64 payload.

• content_type: MIME type (e.g., “image/png”, “application/pdf”).
• content: base64-encoded bytes.
• name: optional display name or filename.

pub fn from_url( content_type: impl Into<String>, url: impl Into<String>, name: Option<String>, ) -> Binary

Create a binary referencing a URL.

Note: Only some providers accept URL-based inputs.

pub fn from_file(file_path: impl AsRef<Path>) -> Result<Binary>

Create a binary from a file path.

Reads the file, determines the MIME type from the file extension, and base64-encodes the content.

• file_path: Path to the file to read.

Returns an error if the file cannot be read.

impl Binary

is_.., into_.. Accessors

pub fn is_image(&self) -> bool

Returns true if this binary is an image (content_type starts with “image/”).

pub fn is_audio(&self) -> bool

Returns true if this binary is an audio file (content_type starts with “audio/”).

pub fn is_pdf(&self) -> bool

Returns true if this binary is a PDF (content_type equals “application/pdf”).

pub fn into_url(self) -> String

Generate the web or data url from this binary

impl Binary

Computed assessors

pub fn size(&self) -> usize

Returns an approximate in-memory size of this Binary, in bytes, computed as the sum of the UTF-8 lengths of:

• content_type
• name (if any)
• the underlying URL or base64 string in source.

This does not return the decoded byte length of the file. This does not return the size of the URL content

Trait Implementations

impl Clone for Binary

fn clone(&self) -> Binary

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Binary

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Binary

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl From<Binary> for ContentPart

fn from(value: Binary) -> Self

Converts to this type from the input type.

impl From<Binary> for MessageContent

fn from(bin: Binary) -> Self

Converts to this type from the input type.

impl Serialize for Binary

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.