Crate jmdict

The JMdict file is a comprehensive multilingual dictionary of the Japanese language. The original JMdict file, included in this repository (and hence, in releases of this crate) comes as XML. Instead of stuffing the XML in the binary directly, this crate parses the XML at compile-time and generates an optimized representation that is compiled into the binary. The crate’s API affords type-safe access to this embedded database.

WARNING: Licensing on database files

The database files compiled into the crate are licensed from the Electronic Dictionary Research and Development Group under Creative Commons licenses. Applications linking this crate directly oder indirectly must display appropriate copyright notices to users. Please refer to the EDRDG’s license statement for details.

Basic usage

The database is accessed through the entries() function which provides an iterator over all database entries compiled into the application. While traversing the database and its entries, you will find that, whenever you expect a list of something, you will get an iterator instead. These iterators provide an abstraction between you as the user of the library, and the physical representation of the database as embedded in the binary.

The following example looks up the reading for お母さん in the database:

let kanji_form = "お母さん";

let entry = jmdict::entries().find(|e| {
    e.kanji_elements().any(|k| k.text == kanji_form)
}).unwrap();

let reading_form = entry.reading_elements().next().unwrap().text;
assert_eq!(reading_form, "おかあさん");

Cargo features

Common configurations

• The default feature includes the most common words (about 30000 entries) and only their English translations.
• The full feature includes everything in the JMdict.

Entry selection

• The scope-uncommon feature includes uncommon words and glosses.
• The scope-archaic feature includes glosses with the “archaic” label. If disabled, the PartOfSpeech enum will not include variants that are only relevant for archaic vocabulary, such as obsolete conjugation patterns. (The AllPartOfSpeech enum always contains all variants.)

Target languages

At least one target language must be selected. Selecting a target language will include all available translations in that language. Entries that do not have any translation in any of the selected languages will be skipped.

• translations-eng: English (included in default)
• translations-dut: Dutch
• translations-fre: French
• translations-ger: German
• translations-hun: Hungarian
• translations-rus: Russian
• translations-slv: Slovenian
• translations-spa: Spanish
• translations-swe: Swedish

The GlossLanguage enum will only contain variants corresponding to the enabled target languages. For example, in the default configuration, GlossLanguage::English will be the only variant. (The AllGlossLanguage enum always contains all variants.)

Crippled builds: db-minimal

When the db-minimal feature is enabled, only a severly reduced portion of the JMdict will be parsed (to be exact, only chunks 000, 100 and 999). This is also completely useless for actual usage, but allows for quick edit-compile-test cycles while working on this crate’s code.

Crippled builds: db-empty

When the db-empty feature is enabled, downloading and parsing of the JMdict contents is disabled entirely. The crate is compiled as usual, but entries() will be an empty list. This is useful for documentation builds like for docs.rs, where --all-features is given.

Structs

• Dialects
  An iterator providing fast access to objects in the database. Instances of this iterator can be copied cheaply.
• DisabledVariant
  Error type for all enum conversions of the form impl TryFrom<AllFoo> for Foo.
• Entries
  An iterator providing fast access to objects in the database. Instances of this iterator can be copied cheaply.
• Entry
  An entry in the JMdict dictionary.
• Gloss
  A particular translation or explanation for a Japanese word or phrase in a different language.
• Glosses
  An iterator providing fast access to objects in the database. Instances of this iterator can be copied cheaply.
• KanjiElement
  A representation of a dictionary entry using kanji or other non-kana scripts.
• KanjiElements
  An iterator providing fast access to objects in the database. Instances of this iterator can be copied cheaply.
• KanjiInfos
  An iterator providing fast access to objects in the database. Instances of this iterator can be copied cheaply.
• LoanwordSource
  A source word in other language which a particular Sense of an Entry has been borrowed from.
• LoanwordSources
  An iterator providing fast access to objects in the database. Instances of this iterator can be copied cheaply.
• PartsOfSpeech
  An iterator providing fast access to objects in the database. Instances of this iterator can be copied cheaply.
• Priority
  Relative priority of a ReadingElement or KanjiElement.
• ReadingElement
  A representation of a dictionary entry using only kana.
• ReadingElements
  An iterator providing fast access to objects in the database. Instances of this iterator can be copied cheaply.
• ReadingInfos
  An iterator providing fast access to objects in the database. Instances of this iterator can be copied cheaply.
• Sense
  The translational equivalent of a Japanese word or phrase.
• SenseInfos
  An iterator providing fast access to objects in the database. Instances of this iterator can be copied cheaply.
• SenseTopics
  An iterator providing fast access to objects in the database. Instances of this iterator can be copied cheaply.
• Senses
  An iterator providing fast access to objects in the database. Instances of this iterator can be copied cheaply.
• Strings
  An iterator providing fast access to objects in the database. Instances of this iterator can be copied cheaply.

Enums

• AllGlossLanguage
  The language of a particular Gloss. This enum contains all possible variants, including those that have been disabled by compile-time flags in enum GlossLanguage.
• AllPartOfSpeech
  Where a word can appear in a sentence for a particular Sense of the word. This enum contains all possible variants, including those that have been disabled by compile-time flags in enum PartOfSpeech.
• Dialect
  Dialect of Japanese in which a certain vocabulary occurs.
• GlossLanguage
  The language of a particular Gloss.
• GlossType
  Type of gloss.
• KanjiInfo
  Information regarding a certain KanjiElement.
• PartOfSpeech
  Where a word can appear in a sentence for a particular Sense of the word.
• PriorityInCorpus
  PriorityInCorpus appears in struct Priority. It describes how often a dictionary entry appears in a certain corpus of text.
• ReadingInfo
  Information regarding a certain ReadingElement.
• SenseInfo
  Information regarding a certain Sense.
• SenseTopic
  Field of study where a certain Sense originates.

Traits

• Enum
  Common methods provided by all enums in this crate.

Functions

• entries
  Returns an iterator over all entries in the database.