Struct OneOrMany 

pub struct OneOrMany<T> { /* private fields */ }

Struct containing either a single item or a list of items of type T. If a single item is present, first will contain it and rest will be empty. If multiple items are present, first will contain the first item and rest will contain the rest. IMPORTANT: this struct cannot be created with an empty vector. OneOrMany objects can only be created using OneOrMany::from() or OneOrMany::try_from().

Implementations

impl<T> OneOrMany<T>

where T: Clone,

pub fn first(&self) -> T

Get the first item in the list.

pub fn first_ref(&self) -> &T

Get a reference to the first item in the list.

pub fn first_mut(&mut self) -> &mut T

Get a mutable reference to the first item in the list.

pub fn last(&self) -> T

Get the last item in the list.

pub fn last_ref(&self) -> &T

Get a reference to the last item in the list.

pub fn last_mut(&mut self) -> &mut T

Get a mutable reference to the last item in the list.

pub fn rest(&self) -> Vec<T>

Get the rest of the items in the list (excluding the first one).

pub fn push(&mut self, item: T)

After OneOrMany<T> is created, add an item of type T to the rest.

pub fn insert(&mut self, index: usize, item: T)

After OneOrMany<T> is created, insert an item of type T at an index.

pub fn len(&self) -> usize

Length of all items in OneOrMany<T>.

pub fn is_empty(&self) -> bool

If OneOrMany<T> is empty. This will always be false because you cannot create an empty OneOrMany<T>. This method is required when the method len exists.

pub fn one(item: T) -> OneOrMany<T>

Create a OneOrMany object with a single item of any type.

pub fn many<I>(items: I) -> Result<OneOrMany<T>, EmptyListError>

where I: IntoIterator<Item = T>,

Create a OneOrMany object with a vector of items of any type.

pub fn merge<I>(one_or_many_items: I) -> Result<OneOrMany<T>, EmptyListError>

where I: IntoIterator<Item = OneOrMany<T>>,

Merge a list of OneOrMany items into a single OneOrMany item.

pub fn from_iter_optional<I>(items: I) -> Option<OneOrMany<T>>

where I: IntoIterator<Item = T>,

Build a OneOrMany from an iterator when the caller can naturally handle an empty input.

pub fn iter(&self) -> Iter<'_, T>

pub fn iter_mut(&mut self) -> IterMut<'_, T>

Trait Implementations

impl<T> Clone for OneOrMany<T>

where T: Clone,

fn clone(&self) -> OneOrMany<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Debug for OneOrMany<T>

where T: Debug,

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

Formats the value using the given formatter.

impl<'de, T> Deserialize<'de> for OneOrMany<T>

where T: Deserialize<'de> + Clone,

fn deserialize<D>( deserializer: D, ) -> Result<OneOrMany<T>, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<T> Eq for OneOrMany<T>

where T: Eq,

impl From<OneOrMany<AssistantContent>> for Message

fn from(content: OneOrMany<AssistantContent>) -> Message

Converts to this type from the input type.

impl From<OneOrMany<String>> for Vec<ReasoningSummary>

fn from(value: OneOrMany<String>) -> Vec<ReasoningSummary>

Converts to this type from the input type.

impl From<OneOrMany<ToolResultContent>> for ToolOutput

fn from(content: OneOrMany<ToolResultContent>) -> ToolOutput

Converts to this type from the input type.

impl From<OneOrMany<UserContent>> for Message

fn from(content: OneOrMany<UserContent>) -> Message

Converts to this type from the input type.

impl<T> IntoIterator for OneOrMany<T>

where T: Clone,

Implement Iterator for IntoIter<T>.

type Item = T

The type of the elements being iterated over.

type IntoIter = IntoIter<T>

Which kind of iterator are we turning this into?

fn into_iter(self) -> <OneOrMany<T> as IntoIterator>::IntoIter

Creates an iterator from a value.

impl<T> PartialEq for OneOrMany<T>

where T: PartialEq,

fn eq(&self, other: &OneOrMany<T>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<T> Serialize for OneOrMany<T>

where T: Serialize + Clone,

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl<T> StructuralPartialEq for OneOrMany<T>

where T: PartialEq,

impl TryFrom<OneOrMany<AssistantContent>> for Vec<Message>

type Error = MessageError

The type returned in the event of a conversion error.

fn try_from( value: OneOrMany<AssistantContent>, ) -> Result<Vec<Message>, <Vec<Message> as TryFrom<OneOrMany<AssistantContent>>>::Error>

Performs the conversion.

impl TryFrom<OneOrMany<UserContent>> for Vec<Message>

type Error = MessageError

The type returned in the event of a conversion error.

fn try_from( value: OneOrMany<UserContent>, ) -> Result<Vec<Message>, <Vec<Message> as TryFrom<OneOrMany<UserContent>>>::Error>

Performs the conversion.