SeqGen

Sequence generation library

SeqGen is a library written in Rust 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:

In the previous versions creating a range part would generate all the elements contained in this range. In this version range creation is lazy (creating range does not generate the elements contained in this range, elements generation is now on demand).

The API for creating ranges is the same.

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.8"

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); // more than 185 would cause u128 overflow.

    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.