use std::ops::{Deref, Index}; mod parse; // pub use parse::*; mod patterns; pub use patterns::*; use crate::{Pickable, PickerFlag, PickerResult}; /// Picker, used to record all states of a parameter parsing /// /// Includes the following: /// /// - Basic arguments /// - Parsing states /// - Parsing results pub struct Picker<'a> { /// Internal arguments of Picker args: PickerArgs<'a>, } /// Internal arguments of Picker /// /// - `Slice` - borrowed slice of string slices /// - `Vec` - owned vector of borrowed string slices /// - `Owned` - owned vector of owned strings pub enum PickerArgs<'a> { /// Borrowed slice of string slices Slice(&'a [&'a str]), /// Owned vector of borrowed string slices Vec(Vec<&'a str>), /// Owned vector of owned strings Owned(Vec), } impl<'a> Default for PickerArgs<'a> { fn default() -> Self { Self::Vec(vec![]) } } impl<'a> From<&'a [&'a str]> for Picker<'a> { fn from(value: &'a [&'a str]) -> Self { Picker { args: PickerArgs::Slice(value), } } } impl<'a> From> for Picker<'a> { fn from(value: Vec<&'a str>) -> Self { Picker { args: PickerArgs::Vec(value), } } } impl<'a> From> for Picker<'a> { fn from(value: Vec) -> Self { Picker { args: PickerArgs::Owned(value), } } } impl<'a> Picker<'a> { /// Returns the number of arguments in the picker. /// /// # Examples /// /// ``` /// use mingling_picker::Picker; /// /// let args = Picker::from(&["hello", "world"][..]); /// assert_eq!(args.len(), 2); /// /// let args = Picker::from(vec!["foo", "bar"]); /// assert_eq!(args.len(), 2); /// /// let args = Picker::from(vec!["a".to_string(), "b".to_string()]); /// assert_eq!(args.len(), 2); /// /// let empty: Picker = Picker::from(&[][..]); /// assert_eq!(empty.len(), 0); /// ``` pub fn len(&self) -> usize { match &self.args { PickerArgs::Slice(items) => items.len(), PickerArgs::Vec(items) => items.len(), PickerArgs::Owned(items) => items.len(), } } /// Returns `true` if the picker contains no arguments. /// /// # Examples /// /// ``` /// use mingling_picker::Picker; /// /// let empty: Picker = Picker::from(&[][..]); /// assert!(empty.is_empty()); /// /// let args = Picker::from(&["hello"][..]); /// assert!(!args.is_empty()); /// ``` pub fn is_empty(&self) -> bool { self.len() == 0 } /// Returns an iterator over the arguments, yielding owned `String` values. /// /// # Examples /// /// ``` /// use mingling_picker::Picker; /// /// let args = Picker::from(&["hello", "world"][..]); /// let collected: Vec = args.iter().collect(); /// assert_eq!(collected, vec!["hello", "world"]); /// /// let args = Picker::from(vec!["foo", "bar"]); /// let collected: Vec = args.iter().collect(); /// assert_eq!(collected, vec!["foo", "bar"]); /// /// let args = Picker::from(vec!["a".to_string(), "b".to_string()]); /// let collected: Vec = args.iter().collect(); /// assert_eq!(collected, vec!["a", "b"]); /// ``` pub fn iter(&'a self) -> PickerIter<'a> { match &self.args { PickerArgs::Slice(items) => PickerIter::Slice(items.iter()), PickerArgs::Vec(items) => PickerIter::Vec(items.iter()), PickerArgs::Owned(items) => PickerIter::Owned(items.iter()), } } } impl<'a> Index for Picker<'a> { type Output = str; fn index(&self, index: usize) -> &Self::Output { match &self.args { PickerArgs::Slice(items) => items[index], PickerArgs::Vec(items) => items[index], PickerArgs::Owned(items) => &items[index], } } } impl<'a> Index for &Picker<'a> { type Output = str; fn index(&self, index: usize) -> &Self::Output { match &self.args { PickerArgs::Slice(items) => items[index], PickerArgs::Vec(items) => items[index], PickerArgs::Owned(items) => &items[index], } } } impl<'a> IntoIterator for &'a Picker<'a> { type Item = String; type IntoIter = PickerIter<'a>; fn into_iter(self) -> Self::IntoIter { match &self.args { PickerArgs::Slice(items) => PickerIter::Slice(items.iter()), PickerArgs::Vec(items) => PickerIter::Vec(items.iter()), PickerArgs::Owned(items) => PickerIter::Owned(items.iter()), } } } /// Iterator for `Picker`, yielding owned `String` values. /// /// This enum wraps the underlying slice iterators for each variant of /// `PickerArgs`, allowing uniform iteration over borrowed or owned data. pub enum PickerIter<'a> { /// Iterates over a borrowed slice (`&[&str]`) Slice(std::slice::Iter<'a, &'a str>), /// Iterates over an owned vector of borrowed string slices (`Vec<&str>`) Vec(std::slice::Iter<'a, &'a str>), /// Iterates over an owned vector of owned strings (`Vec`) Owned(std::slice::Iter<'a, String>), } impl<'a> Iterator for PickerIter<'a> { type Item = String; fn next(&mut self) -> Option { match self { PickerIter::Slice(iter) => iter.next().map(|s| s.to_string()), PickerIter::Vec(iter) => iter.next().map(|s| s.to_string()), PickerIter::Owned(iter) => iter.next().cloned(), } } fn size_hint(&self) -> (usize, Option) { match self { PickerIter::Slice(iter) => iter.size_hint(), PickerIter::Vec(iter) => iter.size_hint(), PickerIter::Owned(iter) => iter.size_hint(), } } } impl<'a> ExactSizeIterator for PickerIter<'a> {} /// Trait for converting types into a `Picker` /// /// Implemented for: /// - `&[&str]` (borrowed slice) /// - `Vec<&str>` (owned vector of borrowed strings) /// - `Vec` (owned vector of owned strings) pub trait IntoPicker<'a> { /// Converts the value into a `Picker` /// /// # Examples /// /// ``` /// use mingling_picker::{IntoPicker, Picker}; /// /// let args: Picker = (&["hello", "world"][..]).to_picker(); /// assert_eq!(args.len(), 2); /// /// let args: Picker = vec!["foo", "bar"].to_picker(); /// assert_eq!(args.len(), 2); /// /// let args: Picker = vec!["a".to_string(), "b".to_string()].to_picker(); /// assert_eq!(args.len(), 2); /// ``` fn to_picker(self) -> Picker<'a>; /// Creates a `PickerPattern1` from the given flag for the `pick` method. /// /// This method converts the value into a `Picker` and starts a parameter /// picking chain with one flag. The result is initially `Unparsed`. fn pick(self, flag: &'a PickerFlag<'a, N>) -> PickerPattern1<'a, N> where Self: Sized, N: Pickable + Default + Sized, { PickerPattern1 { args: self.to_picker().args, flag_1: flag, result_1: PickerResult::Unparsed, default_1: None, post_1: None, } } } impl<'a> IntoPicker<'a> for &'a [&'a str] { fn to_picker(self) -> Picker<'a> { Picker { args: PickerArgs::Slice(self), } } } impl<'a> IntoPicker<'a> for &'a [String] { fn to_picker(self) -> Picker<'a> { let vec: Vec<&str> = self.iter().map(|s| s.as_str()).collect(); Picker { args: PickerArgs::Vec(vec), } } } impl<'a> IntoPicker<'a> for Vec<&'a str> { fn to_picker(self) -> Picker<'a> { Picker { args: PickerArgs::Vec(self), } } } impl<'a> IntoPicker<'a> for Vec { fn to_picker(self) -> Picker<'a> { Picker { args: PickerArgs::Owned(self), } } } impl<'a, T> IntoPicker<'a> for &'a T where T: Deref>, { fn to_picker(self) -> Picker<'a> { let vec: Vec<&str> = self.iter().map(|s| s.as_str()).collect(); Picker { args: PickerArgs::Vec(vec), } } }