Crates.io | botanical-latin |
lib.rs | botanical-latin |
version | 0.0.7 |
source | src |
created_at | 2024-07-11 02:25:02.38035 |
updated_at | 2024-07-16 07:55:44.833269 |
description | Decliner / conjugator / inflector for classical / botanical Latin. |
homepage | |
repository | https://github.com/gold-silver-copper/botanical-latin |
max_upload_size | |
id | 1298995 |
size | 8,074,857 |
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"
}