#crossword #word #generator #generate #position #direction #stream

crossword_generator

A library for generating crossword from provided words

1 unstable release

0.0.1 Apr 25, 2024

#8 in #crossword

Download history 101/week @ 2024-04-22

101 downloads per month

MIT license

76KB
1K SLoC

Crossword_Generator

Crossword_generator is a library for creating crosswords from provided words. It determines the positions and directions of the words, but does not generate a finished blank crossword puzzle to solve.

Works in an async runtime.

use crossword_generator::{crossword::Crossword, generator::{CrosswordGenerationRequest, CrosswordGenerator, CrosswordGeneratorSettings}, word::Word};
use tokio_stream::StreamExt;

// Function to print the crossword to the console
fn print_crossword(cw: &Crossword<u8, String>)
{
    let table = cw.generate_char_table();
    println!(" {} ", vec!['-'; table.len() * 2 - 1].into_iter().collect::<String>());
    for i in 0..table.len()
    {
        print!("|");
        for j in 0..table[0].len()
        {
            print!("{}", (if table[i][j] != 0 {table[i][j]} else {32}) as char);
            if j != table[0].len() - 1 { print!(" "); } 
        }
        println!("|");
    }
    println!(" {} ", vec!['-'; table.len() * 2 - 1].into_iter().collect::<String>());
}

#[tokio::main]
async fn main()
{
    // Create a generator.
    let mut generator = CrosswordGenerator::<u8, String>::default();

    // Set some settings.
    generator.settings = CrosswordGeneratorSettings::default();

    // Specify the words crosswords will be consisted from.
    generator.words = vec!["hello", "world", "foo", "raw"].into_iter().map(|s| Word::new(s.to_lowercase(), None)).collect();
    
    // Create the crossword stream, this will generate crosswords and return them to you. If you wait long enough, you will get every possible crossword that satisfies the settings.
    let mut str = generator.crossword_stream(|s| String::from_utf8(s.to_owned()).expect("The word is not in proper utf8 format"));

    // You can request a concrete number of crosswords, or all of them.
    str.request_crossword(CrosswordGenerationRequest::All).await;
    while let Some(cw) = str.next().await 
    {
        print_crossword(&cw);
        println!("");
    }
}

Dependencies

~4–6MB
~108K SLoC