SeqGen

Sequence generation library

SeqGen is a library that lets you generate sequences in a performant and easy way. SeqGen is lazy meaning the elements won't be generated until needed or explicitly requested. The sequences generated by SeqGen implement the Iterator trait so manipulation is done using familiar rust iterators syntax.

New is this release:

• Better performance.
• Better API.
• Initial elements are no longer required to generate elements but they can be defined.
• New function to create sequences (seq_with_initial_elements, seq_without_initial_elements).

Install:

From the commend line in your project directory run the following

$ cargo add seqgen

Or add this under [[dependencies]] in Cargo.toml file

seqgen = "0.2.7"

Examples:

Fibonacci sequence

use seqgen::prelude::*;

fn main() {
    let fib_seq = Sequence::new()
        .initial_elements(vec![0, 1_u128])
        .transition_function(|alive_elements, current_index| {
            alive_elements.nth_element(current_index - 1).unwrap()
                + alive_elements.nth_element(current_index - 2).unwrap()
        })
        .pre_generate(185);

    fib_seq
        .alive_elements()
        .for_each(|element| println!("{element}"));
}

An x-y sequence

use seqgen::prelude::*;

fn main() {
    let mut seq = Sequence::new()
        .initial_elements(vec!["x".to_string(), "y".to_string()])
        .transition_function(|alive_elements, current_element_index| {
            let mut string = String::from(
                alive_elements
                    .nth_element(current_element_index - 2)
                    .unwrap(),
            );

            string.push_str(
                alive_elements
                    .nth_element(current_element_index - 1)
                    .unwrap(),
            );

            string
        });

    seq.range(0, 10)
        .unwrap()
        .for_each(|element| println!("{element}"));
}

Range of sequence

use seqgen::prelude::*;

fn main() {
    let mut seq = Sequence::new()
        .transition_function(|alive_elements, current_element_index| {
            alive_elements
                .last_element()
                .map_or(current_element_index, |element| element + 1)
        });

    let range_res = seq.range(0, 10);

    if let Ok(range) = range_res {
        range.for_each(|element| println!("{element}"));
    }
}

Have suggestions? contribute to the project or open an issue on GitHub.