#latin #classical #dictionary #word #botanical #decliner #conjugator

botanical-latin

Decliner / conjugator / inflector for classical / botanical Latin

7 releases

0.0.7 Jul 16, 2024
0.0.6 Jul 16, 2024

#619 in Text processing

Download history 75/week @ 2024-07-05 432/week @ 2024-07-12 48/week @ 2024-07-19

176 downloads per month

MIT/Apache

1.5MB
1K SLoC

botanical-latin "Decliner / conjugator / inflector for classical / botanical Latin."

Crates.io Documentation License Downloads

This crate provides a decliner/conjugator/inflector for classical / botanical Latin.

It uses data extracted from Wiktionary to create dictionaries from which it pulls words, if a word is not found in the dictionary it makes an educated guess as to the stem of the word (and gender for nouns), and declines accordingly. Right now Nouns and Adjectives are almost completely finished in their implementation, whereas Verbs only support the present tense and need a good bit more work, but it should be already useful for many tasks.

Sample usage:

use botanical_latin::*;
fn main() {
    // Load the Latin conjugator with csv dictionaries, provided in the github repo
    let inflector = Latin::new(
        "nouns.csv".into(),
        "adjectives.csv".into(),
        "verbs.csv".into(),
    );

    // Optionally define a ComplexNoun to decline a Noun phrase that can include multiple adjectives and nouns in apposition
    let complexik = ComplexNoun {
        head_noun: "lorica".into(),
        adjective: vec!["hamatus".into(), "grandis".into()],
        adposition_noun: vec!["manica".into()],
    };

    // Inflect the complex noun as so. Returns a String
    let complex = inflector.complex_noun(&complexik, &Case::Abl, &Number::Singular);
    println!("{:#?}", complex);
    //Output: "lorica manica hamata grandi"

    // To conjugate a noun by itself use the noun() function from the inflector,
    // it outputs a tuple that contains the inflected string as the first(0th) element, and the Gender as the second element
    let noun = inflector.noun("agricola", &Case::Acc, &Number::Plural);
    println!("{:#?}", noun.0);
    //Output: "agricolas"

    //Adjectives are similar to nouns, but require an additional Gender argument. Returns an inflected String
    let adj = inflector.adjective("integer", &Case::Nom, &Number::Singular, &Gender::Feminine);
    println!("{:#?}", adj);
    //Output: "integra"

    //You can guess nouns and adjectives without instantiating the conjugator with dictionaries if you so desire.
    // But instantiating with the csv dictionaries gives a superior result.
    let guessed_adjective = Latin::guess_adjective(
        "schoenoides",
        &Case::Gen,
        &Number::Plural,
        &Gender::Feminine,
    );
    println!("{:#?}", guessed_adjective);
    // Output: "schoenoidum"

    let guessed_noun = Latin::guess_noun("hibiscus", &Case::Gen, &Number::Plural);
    println!("{:#?}", guessed_noun.0);
    //Output: "hibiscorum"

    // Some words can have the same nominative but different declension classes such as "os" can be either mouth or bone.
    // Append a 2 to the word_id to get the second conjugation, consult the csv dictionary for availability.
    let os1 = inflector.noun("os", &Case::Gen, &Number::Singular);
    println!("{:#?}", os1.0);
    //Output: "oris"
    let os2 = inflector.noun("os2", &Case::Gen, &Number::Singular);
    println!("{:#?}", os2.0);
    //Output: "ossis"
}

Dependencies

~1.4–2.2MB
~34K SLoC