Struct Text 

pub struct Text { /* private fields */ }

A Markov chain text model for generating random sentences

Implementations

impl Text

pub fn new( input_text: &str, state_size: usize, retain_original: bool, well_formed: bool, reject_reg: Option<&str>, ) -> Result<Self>

Create a new Text model from input text

Arguments

• input_text - The source text to build the model from
• state_size - Number of words in the model’s state (default: 2)
• retain_original - Whether to keep the original corpus for overlap checking
• well_formed - Whether to reject sentences with unmatched quotes/parenthesis
• reject_reg - Optional custom regex pattern for rejecting sentences

pub fn from_chain( chain: Chain, parsed_sentences: Option<Vec<Vec<String>>>, retain_original: bool, ) -> Self

Create a Text model from an existing chain

pub fn sentence_split(&self, text: &str) -> Vec<String>

Split text into sentences

pub fn sentence_join(&self, sentences: &[String]) -> String

Join sentences into text

pub fn word_split(&self, sentence: &str) -> Vec<String>

Split a sentence into words

pub fn word_join(&self, words: &[String]) -> String

Join words into a sentence

pub fn test_sentence_input(&self, sentence: &str) -> bool

Test if a sentence input is valid

pub fn make_sentence( &self, init_state: Option<&[String]>, tries: Option<usize>, max_overlap_ratio: Option<f64>, max_overlap_total: Option<usize>, test_output: Option<bool>, max_words: Option<usize>, min_words: Option<usize>, ) -> Option<String>

Generate a random sentence

Arguments

• init_state - Optional starting state (tuple of words)
• tries - Maximum number of attempts (default: 10)
• max_overlap_ratio - Maximum overlap ratio with original text (default: 0.7)
• max_overlap_total - Maximum overlap total with original text (default: 15)
• test_output - Whether to test output for overlap (default: true)
• max_words - Maximum number of words in the sentence
• min_words - Minimum number of words in the sentence

pub fn make_short_sentence( &self, max_chars: usize, min_chars: Option<usize>, init_state: Option<&[String]>, tries: Option<usize>, max_overlap_ratio: Option<f64>, max_overlap_total: Option<usize>, test_output: Option<bool>, max_words: Option<usize>, min_words: Option<usize>, ) -> Option<String>

Generate a short sentence with a maximum character count

pub fn make_sentence_with_start( &self, beginning: &str, strict: bool, tries: Option<usize>, max_overlap_ratio: Option<f64>, max_overlap_total: Option<usize>, test_output: Option<bool>, max_words: Option<usize>, min_words: Option<usize>, ) -> Result<String>

Generate a sentence that starts with a specific string

pub fn compile(&self) -> Self

Compile the model for faster generation

pub fn compile_inplace(&mut self)

Compile the model in place (returns self)

pub fn state_size(&self) -> usize

Get the state size

pub fn chain(&self) -> &Chain

Get the chain

pub fn to_json(&self) -> Result<String>

Serialize to JSON

pub fn from_json(json_str: &str) -> Result<Self>

Deserialize from JSON

pub fn retain_original(&self) -> bool

Check if the model retains original sentences

pub fn parsed_sentences(&self) -> Option<&Vec<Vec<String>>>

Get the parsed sentences if available

Trait Implementations

impl Clone for Text

fn clone(&self) -> Text

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Text

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

Formats the value using the given formatter.