Class: Kotoshu::Dictionaries::Catalog

Inherits:

Object

Object
Kotoshu::Dictionaries::Catalog

show all

Defined in:: lib/kotoshu/dictionaries/catalog.rb

Overview

Catalog of all available dictionaries from kotoshu/dictionaries repository

This class provides a structured registry of all available dictionaries with their metadata, URLs, and license information.

Examples:

Listing all dictionaries

catalog = Kotoshu::Dictionaries::Catalog.new
catalog.all.each do |dict|
  puts "#{dict.code}: #{dict.name} (#{dict.size} words)"
end

Finding dictionaries by language

catalog = Kotoshu::Dictionaries::Catalog.new
german_dicts = catalog.by_language("de")

Getting a specific dictionary

catalog = Kotoshu::Dictionaries::Catalog.new
dict = catalog.find("en-GB")
dict.load # => Kotoshu::Dictionary::Base subclass

Defined Under Namespace

Classes: DictionaryEntry

Constant Summary collapse

BASE_URL = Base URL for kotoshu/dictionaries repository

"https://raw.githubusercontent.com/kotoshu/dictionaries/main"

ALL_DICTIONARIES = All available dictionaries

[
  # Unix System Dictionaries (Plain Text)
  { code: "en-US-web2", name: "Webster's Second International", language: "en", region: "US",
    format: :plain_text, source: "FreeBSD", license: "Public Domain",
    word_count: 235_976,
    dic_url: "#{BASE_URL}/unix-words/web2.txt",
    metadata: { source_file: "web2.txt", year: 1934 } },

  { code: "en-US-web2a", name: "Webster's with Affix Flags", language: "en", region: "US",
    format: :plain_text, source: "FreeBSD", license: "Public Domain",
    word_count: 50_000,
    dic_url: "#{BASE_URL}/unix-words/web2a.txt",
    metadata: { source_file: "web2a.txt", has_affix_flags: true } },

  { code: "en-connectives", name: "English Connectives", language: "en",
    format: :plain_text, source: "FreeBSD", license: "Public Domain",
    word_count: 500,
    dic_url: "#{BASE_URL}/unix-words/connectives.txt",
    metadata: { source_file: "connectives.txt" } },

  { code: "en-propernames", name: "Proper Names", language: "en",
    format: :plain_text, source: "FreeBSD", license: "Public Domain",
    word_count: 2000,
    dic_url: "#{BASE_URL}/unix-words/propernames.txt",
    metadata: { source_file: "propernames.txt" } },

  # English (Hunspell from wooorm/dictionaries)
  { code: "en", name: "US English", language: "en", region: "US",
    format: :hunspell, source: "SCOWL", license: "LGPL/MPL/GPL",
    word_count: 500_000,
    dic_url: "#{BASE_URL}/en/index.dic",
    aff_url: "#{BASE_URL}/en/index.aff",
    metadata: { scowl_size: "large", source: "wooorm/dictionaries" } },

  { code: "en-GB", name: "British English (ise)", language: "en", region: "GB",
    format: :hunspell, source: "SCOWL", license: "LGPL/MPL/GPL",
    word_count: 450_000,
    dic_url: "#{BASE_URL}/en-GB/index.dic",
    aff_url: "#{BASE_URL}/en-GB/index.aff",
    metadata: { spelling_variant: "ise", source: "wooorm/dictionaries" } },

  { code: "en-CA", name: "Canadian English", language: "en", region: "CA",
    format: :hunspell, source: "SCOWL", license: "LGPL/MPL/GPL",
    word_count: 300_000,
    dic_url: "#{BASE_URL}/en-CA/index.dic",
    aff_url: "#{BASE_URL}/en-CA/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "en-AU", name: "Australian English", language: "en", region: "AU",
    format: :hunspell, source: "SCOWL", license: "LGPL/MPL/GPL",
    word_count: 250_000,
    dic_url: "#{BASE_URL}/en-AU/index.dic",
    aff_url: "#{BASE_URL}/en-AU/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "en-ZA", name: "South African English", language: "en", region: "ZA",
    format: :hunspell, source: "SCOWL", license: "LGPL/MPL/GPL",
    word_count: 200_000,
    dic_url: "#{BASE_URL}/en-ZA/index.dic",
    aff_url: "#{BASE_URL}/en-ZA/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # German
  { code: "de", name: "German", language: "de",
    format: :hunspell, source: "igerman98", license: "GPL",
    word_count: 300_000,
    dic_url: "#{BASE_URL}/de/index.dic",
    aff_url: "#{BASE_URL}/de/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "de-AT", name: "German (Austria)", language: "de", region: "AT",
    format: :hunspell, source: "igerman98", license: "GPL",
    word_count: 200_000,
    dic_url: "#{BASE_URL}/de-AT/index.dic",
    aff_url: "#{BASE_URL}/de-AT/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "de-CH", name: "German (Switzerland)", language: "de", region: "CH",
    format: :hunspell, source: "igerman98", license: "GPL",
    word_count: 200_000,
    dic_url: "#{BASE_URL}/de-CH/index.dic",
    aff_url: "#{BASE_URL}/de-CH/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "de-DE", name: "German (Germany)", language: "de", region: "DE",
    format: :hunspell, source: "igerman98", license: "GPL",
    word_count: 300_000,
    dic_url: "#{BASE_URL}/de-DE/index.dic",
    aff_url: "#{BASE_URL}/de-DE/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Spanish
  { code: "es", name: "Spanish", language: "es",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 500_000,
    dic_url: "#{BASE_URL}/es/index.dic",
    aff_url: "#{BASE_URL}/es/index.aff",
    metadata: { source: "wooorm/dictionaries", regional_variants: 21 } },

  { code: "es-AR", name: "Spanish (Argentina)", language: "es", region: "AR",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 400_000,
    dic_url: "#{BASE_URL}/es-AR/index.dic",
    aff_url: "#{BASE_URL}/es-AR/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-MX", name: "Spanish (Mexico)", language: "es", region: "MX",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 400_000,
    dic_url: "#{BASE_URL}/es-MX/index.dic",
    aff_url: "#{BASE_URL}/es-MX/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # French
  { code: "fr", name: "French", language: "fr",
    format: :hunspell, source: "Grammalecte", license: "MPL 2.0",
    word_count: 200_000,
    dic_url: "#{BASE_URL}/fr/index.dic",
    aff_url: "#{BASE_URL}/fr/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "fr-FR", name: "French (France)", language: "fr", region: "FR",
    format: :hunspell, source: "Grammalecte", license: "MPL 2.0",
    word_count: 200_000,
    dic_url: "#{BASE_URL}/fr-FR/index.dic",
    aff_url: "#{BASE_URL}/fr-FR/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Italian
  { code: "it", name: "Italian", language: "it",
    format: :hunspell, source: "LibreOffice", license: "GPL 3",
    word_count: 500_000,
    dic_url: "#{BASE_URL}/it/index.dic",
    aff_url: "#{BASE_URL}/it/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Portuguese
  { code: "pt", name: "Portuguese", language: "pt",
    format: :hunspell, source: "LibreOffice", license: "LGPLv3/MPL",
    word_count: 400_000,
    dic_url: "#{BASE_URL}/pt/index.dic",
    aff_url: "#{BASE_URL}/pt/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Russian
  { code: "ru", name: "Russian", language: "ru",
    format: :hunspell, source: "Alexander Lebedev", license: "BSD-style",
    word_count: 800_000,
    dic_url: "#{BASE_URL}/ru/index.dic",
    aff_url: "#{BASE_URL}/ru/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Dutch
  { code: "nl", name: "Dutch", language: "nl",
    format: :hunspell, source: "OpenTaal", license: "Revised BSD + CC BY 3.0",
    word_count: 400_000,
    dic_url: "#{BASE_URL}/nl/index.dic",
    aff_url: "#{BASE_URL}/nl/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Polish
  { code: "pl", name: "Polish", language: "pl",
    format: :hunspell, source: "Polish Native Lang Project", license: "GPL/LGPL/MPL/CC",
    word_count: 600_000,
    dic_url: "#{BASE_URL}/pl/index.dic",
    aff_url: "#{BASE_URL}/pl/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Additional European languages
  { code: "cs", name: "Czech", language: "cs",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 400_000,
    dic_url: "#{BASE_URL}/cs/index.dic",
    aff_url: "#{BASE_URL}/cs/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "sk", name: "Slovak", language: "sk",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 300_000,
    dic_url: "#{BASE_URL}/sk/index.dic",
    aff_url: "#{BASE_URL}/sk/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "hr", name: "Croatian", language: "hr",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 300_000,
    dic_url: "#{BASE_URL}/hr/index.dic",
    aff_url: "#{BASE_URL}/hr/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "sr", name: "Serbian (Cyrillic)", language: "sr",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 400_000,
    dic_url: "#{BASE_URL}/sr/index.dic",
    aff_url: "#{BASE_URL}/sr/index.aff",
    metadata: { source: "wooorm/dictionaries", script: "Cyrillic" } },

  { code: "sr-Latn", name: "Serbian (Latin)", language: "sr", region: "Latn",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 400_000,
    dic_url: "#{BASE_URL}/sr-Latn/index.dic",
    aff_url: "#{BASE_URL}/sr-Latn/index.aff",
    metadata: { source: "wooorm/dictionaries", script: "Latin" } },

  { code: "sl", name: "Slovenian", language: "sl",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 200_000,
    dic_url: "#{BASE_URL}/sl/index.dic",
    aff_url: "#{BASE_URL}/sl/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Baltic languages
  { code: "lt", name: "Lithuanian", language: "lt",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 200_000,
    dic_url: "#{BASE_URL}/lt/index.dic",
    aff_url: "#{BASE_URL}/lt/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "lv", name: "Latvian", language: "lv",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 250_000,
    dic_url: "#{BASE_URL}/lv/index.dic",
    aff_url: "#{BASE_URL}/lv/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "et", name: "Estonian", language: "et",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 200_000,
    dic_url: "#{BASE_URL}/et/index.dic",
    aff_url: "#{BASE_URL}/et/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Nordic languages
  { code: "da", name: "Danish", language: "da",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 300_000,
    dic_url: "#{BASE_URL}/da/index.dic",
    aff_url: "#{BASE_URL}/da/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "sv", name: "Swedish", language: "sv",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/sv/index.dic",
    aff_url: "#{BASE_URL}/sv/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "sv-FI", name: "Swedish (Finland)", language: "sv", region: "FI",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 300_000,
    dic_url: "#{BASE_URL}/sv-FI/index.dic",
    aff_url: "#{BASE_URL}/sv-FI/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "nb", name: "Norwegian (Bokmål)", language: "nb",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 300_000,
    dic_url: "#{BASE_URL}/nb/index.dic",
    aff_url: "#{BASE_URL}/nb/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "nn", name: "Norwegian (Nynorsk)", language: "nn",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 250_000,
    dic_url: "#{BASE_URL}/nn/index.dic",
    aff_url: "#{BASE_URL}/nn/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "fi", name: "Finnish", language: "fi",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 400_000,
    dic_url: "#{BASE_URL}/fi/index.dic",
    aff_url: "#{BASE_URL}/fi/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "is", name: "Icelandic", language: "is",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 200_000,
    dic_url: "#{BASE_URL}/is/index.dic",
    aff_url: "#{BASE_URL}/is/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "fo", name: "Faroese", language: "fo",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 100_000,
    dic_url: "#{BASE_URL}/fo/index.dic",
    aff_url: "#{BASE_URL}/fo/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Celtic languages
  { code: "ga", name: "Irish", language: "ga",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 50_000,
    dic_url: "#{BASE_URL}/ga/index.dic",
    aff_url: "#{BASE_URL}/ga/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "gd", name: "Scottish Gaelic", language: "gd",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 50_000,
    dic_url: "#{BASE_URL}/gd/index.dic",
    aff_url: "#{BASE_URL}/gd/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "cy", name: "Welsh", language: "cy",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 100_000,
    dic_url: "#{BASE_URL}/cy/index.dic",
    aff_url: "#{BASE_URL}/cy/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "br", name: "Breton", language: "br",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 50_000,
    dic_url: "#{BASE_URL}/br/index.dic",
    aff_url: "#{BASE_URL}/br/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "gv", name: "Manx", language: "gv",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 30_000,
    dic_url: "#{BASE_URL}/gv/index.dic",
    aff_url: "#{BASE_URL}/gv/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Other European languages
  { code: "el", name: "Greek", language: "el",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 400_000,
    dic_url: "#{BASE_URL}/el/index.dic",
    aff_url: "#{BASE_URL}/el/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "el-polyton", name: "Greek (Polytonic)", language: "el", region: "polyton",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 100_000,
    dic_url: "#{BASE_URL}/el-polyton/index.dic",
    aff_url: "#{BASE_URL}/el-polyton/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "tr", name: "Turkish", language: "tr",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 400_000,
    dic_url: "#{BASE_URL}/tr/index.dic",
    aff_url: "#{BASE_URL}/tr/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "hu", name: "Hungarian", language: "hu",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 400_000,
    dic_url: "#{BASE_URL}/hu/index.dic",
    aff_url: "#{BASE_URL}/hu/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "ro", name: "Romanian", language: "ro",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 300_000,
    dic_url: "#{BASE_URL}/ro/index.dic",
    aff_url: "#{BASE_URL}/ro/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "bg", name: "Bulgarian", language: "bg",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 300_000,
    dic_url: "#{BASE_URL}/bg/index.dic",
    aff_url: "#{BASE_URL}/bg/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "be", name: "Belarusian", language: "be",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 200_000,
    dic_url: "#{BASE_URL}/be/index.dic",
    aff_url: "#{BASE_URL}/be/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "uk", name: "Ukrainian", language: "uk",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 400_000,
    dic_url: "#{BASE_URL}/uk/index.dic",
    aff_url: "#{BASE_URL}/uk/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Regional languages
  { code: "ca", name: "Catalan", language: "ca",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 400_000,
    dic_url: "#{BASE_URL}/ca/index.dic",
    aff_url: "#{BASE_URL}/ca/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "ca-valencia", name: "Catalan (Valencia)", language: "ca", region: "valencia",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 400_000,
    dic_url: "#{BASE_URL}/ca-valencia/index.dic",
    aff_url: "#{BASE_URL}/ca-valencia/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "gl", name: "Galician", language: "gl",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 300_000,
    dic_url: "#{BASE_URL}/gl/index.dic",
    aff_url: "#{BASE_URL}/gl/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "eu", name: "Basque", language: "eu",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 200_000,
    dic_url: "#{BASE_URL}/eu/index.dic",
    aff_url: "#{BASE_URL}/eu/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "lb", name: "Luxembourgish", language: "lb",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 100_000,
    dic_url: "#{BASE_URL}/lb/index.dic",
    aff_url: "#{BASE_URL}/lb/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "li", name: "Limburgish", language: "li",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 50_000,
    dic_url: "#{BASE_URL}/li/index.dic",
    aff_url: "#{BASE_URL}/li/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "fy", name: "Western Frisian", language: "fy",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 100_000,
    dic_url: "#{BASE_URL}/fy/index.dic",
    aff_url: "#{BASE_URL}/fy/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "ltg", name: "Latgalian", language: "ltg",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 50_000,
    dic_url: "#{BASE_URL}/ltg/index.dic",
    aff_url: "#{BASE_URL}/ltg/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "ku", name: "Kurdish", language: "ku",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 50_000,
    dic_url: "#{BASE_URL}/ku/index.dic",
    aff_url: "#{BASE_URL}/ku/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Middle Eastern languages
  { code: "hy", name: "Armenian", language: "hy",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 200_000,
    dic_url: "#{BASE_URL}/hy/index.dic",
    aff_url: "#{BASE_URL}/hy/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "hyw", name: "Western Armenian", language: "hy", region: "western",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 100_000,
    dic_url: "#{BASE_URL}/hyw/index.dic",
    aff_url: "#{BASE_URL}/hyw/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "ka", name: "Georgian", language: "ka",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 200_000,
    dic_url: "#{BASE_URL}/ka/index.dic",
    aff_url: "#{BASE_URL}/ka/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "he", name: "Hebrew", language: "he",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 300_000,
    dic_url: "#{BASE_URL}/he/index.dic",
    aff_url: "#{BASE_URL}/he/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "fa", name: "Persian", language: "fa",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 200_000,
    dic_url: "#{BASE_URL}/fa/index.dic",
    aff_url: "#{BASE_URL}/fa/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Asian languages
  { code: "ko", name: "Korean", language: "ko",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 500_000,
    dic_url: "#{BASE_URL}/ko/index.dic",
    aff_url: "#{BASE_URL}/ko/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "vi", name: "Vietnamese", language: "vi",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 100_000,
    dic_url: "#{BASE_URL}/vi/index.dic",
    aff_url: "#{BASE_URL}/vi/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Constructed languages
  { code: "eo", name: "Esperanto", language: "eo",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 100_000,
    dic_url: "#{BASE_URL}/eo/index.dic",
    aff_url: "#{BASE_URL}/eo/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "ia", name: "Interlingua", language: "ia",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 50_000,
    dic_url: "#{BASE_URL}/ia/index.dic",
    aff_url: "#{BASE_URL}/ia/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  # Additional Spanish regional variants
  { code: "es-BO", name: "Spanish (Bolivia)", language: "es", region: "BO",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-BO/index.dic",
    aff_url: "#{BASE_URL}/es-BO/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-CO", name: "Spanish (Colombia)", language: "es", region: "CO",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-CO/index.dic",
    aff_url: "#{BASE_URL}/es-CO/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-CR", name: "Spanish (Costa Rica)", language: "es", region: "CR",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-CR/index.dic",
    aff_url: "#{BASE_URL}/es-CR/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-CU", name: "Spanish (Cuba)", language: "es", region: "CU",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-CU/index.dic",
    aff_url: "#{BASE_URL}/es-CU/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-DO", name: "Spanish (Dominican Republic)", language: "es", region: "DO",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-DO/index.dic",
    aff_url: "#{BASE_URL}/es-DO/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-EC", name: "Spanish (Ecuador)", language: "es", region: "EC",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-EC/index.dic",
    aff_url: "#{BASE_URL}/es-EC/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-GT", name: "Spanish (Guatemala)", language: "es", region: "GT",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-GT/index.dic",
    aff_url: "#{BASE_URL}/es-GT/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-HN", name: "Spanish (Honduras)", language: "es", region: "HN",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-HN/index.dic",
    aff_url: "#{BASE_URL}/es-HN/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-NI", name: "Spanish (Nicaragua)", language: "es", region: "NI",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-NI/index.dic",
    aff_url: "#{BASE_URL}/es-NI/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-PA", name: "Spanish (Panama)", language: "es", region: "PA",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-PA/index.dic",
    aff_url: "#{BASE_URL}/es-PA/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-PE", name: "Spanish (Peru)", language: "es", region: "PE",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-PE/index.dic",
    aff_url: "#{BASE_URL}/es-PE/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-PH", name: "Spanish (Philippines)", language: "es", region: "PH",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-PH/index.dic",
    aff_url: "#{BASE_URL}/es-PH/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-PR", name: "Spanish (Puerto Rico)", language: "es", region: "PR",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-PR/index.dic",
    aff_url: "#{BASE_URL}/es-PR/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-PY", name: "Spanish (Paraguay)", language: "es", region: "PY",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-PY/index.dic",
    aff_url: "#{BASE_URL}/es-PY/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-SV", name: "Spanish (El Salvador)", language: "es", region: "SV",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-SV/index.dic",
    aff_url: "#{BASE_URL}/es-SV/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-US", name: "Spanish (United States)", language: "es", region: "US",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-US/index.dic",
    aff_url: "#{BASE_URL}/es-US/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-UY", name: "Spanish (Uruguay)", language: "es", region: "UY",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-UY/index.dic",
    aff_url: "#{BASE_URL}/es-UY/index.aff",
    metadata: { source: "wooorm/dictionaries" } },

  { code: "es-VE", name: "Spanish (Venezuela)", language: "es", region: "VE",
    format: :hunspell, source: "LibreOffice", license: "GPL",
    word_count: 350_000,
    dic_url: "#{BASE_URL}/es-VE/index.dic",
    aff_url: "#{BASE_URL}/es-VE/index.aff",
    metadata: { source: "wooorm/dictionaries" } }
].freeze

Class Method Summary collapse

.all ⇒ Array<DictionaryEntry>

All dictionary entries.
.by_format(format) ⇒ Array<DictionaryEntry>

Find dictionaries by format.
.by_language(lang) ⇒ Array<DictionaryEntry>

Find dictionaries by language code.
.by_license(license) ⇒ Array<DictionaryEntry>

Find dictionaries by license.
.find(code) ⇒ DictionaryEntry^?

Find dictionary by code.
.hunspell ⇒ Array<DictionaryEntry>

Get all Hunspell dictionaries.
.languages ⇒ Array<String>

Get all unique language codes.
.licenses ⇒ Array<String>

Get all unique licenses.
.plain_text ⇒ Array<DictionaryEntry>

Get all plain text dictionaries.
.statistics ⇒ Hash

Get statistics about the catalog.

Class Method Details

.all ⇒ `Array<DictionaryEntry>`

Returns All dictionary entries.

Returns:

(Array<DictionaryEntry>) —

All dictionary entries



743
744
745

# File 'lib/kotoshu/dictionaries/catalog.rb', line 743

def self.all
  @entries
end

.by_format(format) ⇒ `Array<DictionaryEntry>`

Find dictionaries by format

Parameters:

format (Symbol) —

Format type (:hunspell or :plain_text)

Returns:

(Array<DictionaryEntry>) —

Dictionaries with the format



766
767
768

# File 'lib/kotoshu/dictionaries/catalog.rb', line 766

def self.by_format(format)
  all.select { |e| e.format == format }
end

.by_language(lang) ⇒ `Array<DictionaryEntry>`

Find dictionaries by language code

Parameters:

lang (String, Symbol) —

Language code (e.g., “en”, :de)

Returns:

(Array<DictionaryEntry>) —

Dictionaries for the language

# File 'lib/kotoshu/dictionaries/catalog.rb', line 758

def self.by_language(lang)
  lang_str = lang.to_s.downcase
  all.select { |e| e.language == lang_str }
end

.by_license(license) ⇒ `Array<DictionaryEntry>`

Find dictionaries by license

Parameters:

license (String, Symbol) —

License type (e.g., “GPL”, “Public Domain”)

Returns:

(Array<DictionaryEntry>) —

Dictionaries with the license

# File 'lib/kotoshu/dictionaries/catalog.rb', line 773

def self.by_license(license)
  license_str = license.to_s
  all.select { |e| e.license.include?(license_str) }
end

.find(code) ⇒ `DictionaryEntry`^?

Find dictionary by code

Parameters:

code (String, Symbol) —

Dictionary code (e.g., “en-GB”, :en_GB)

Returns:

(DictionaryEntry, nil) —

The dictionary entry or nil if not found

# File 'lib/kotoshu/dictionaries/catalog.rb', line 750

def self.find(code)
  code_str = code.to_s.gsub("_", "-")
  all.find { |e| e.code.casecmp(code_str).zero? }
end

.hunspell ⇒ `Array<DictionaryEntry>`

Get all Hunspell dictionaries

Returns:

(Array<DictionaryEntry>) —

All Hunspell dictionaries



780
781
782

# File 'lib/kotoshu/dictionaries/catalog.rb', line 780

def self.hunspell
  by_format(:hunspell)
end

.languages ⇒ `Array<String>`

Get all unique language codes

Returns:

(Array<String>) —

Unique language codes



806
807
808

# File 'lib/kotoshu/dictionaries/catalog.rb', line 806

def self.languages
  all.map(&:language).uniq.sort
end

.licenses ⇒ `Array<String>`

Get all unique licenses

Returns:

(Array<String>) —

Unique license types



812
813
814

# File 'lib/kotoshu/dictionaries/catalog.rb', line 812

def self.licenses
  all.map(&:license).uniq
end

.plain_text ⇒ `Array<DictionaryEntry>`

Get all plain text dictionaries

Returns:

(Array<DictionaryEntry>) —

All plain text dictionaries



786
787
788

# File 'lib/kotoshu/dictionaries/catalog.rb', line 786

def self.plain_text
  by_format(:plain_text)
end

.statistics ⇒ `Hash`

Get statistics about the catalog

Returns:

(Hash) —

Statistics hash

# File 'lib/kotoshu/dictionaries/catalog.rb', line 792

def self.statistics
  {
    total: all.size,
    hunspell: hunspell.size,
    plain_text: plain_text.size,
    languages: all.map(&:language).uniq.size,
    total_words: all.sum(&:word_count),
    formats: all.group_by(&:format).transform_values(&:size),
    licenses: all.group_by { |e| e.license.split.first }.transform_values(&:size)
  }
end

Class: Kotoshu::Dictionaries::Catalog

Overview

Examples:

Listing all dictionaries

Finding dictionaries by language

Getting a specific dictionary

Defined Under Namespace

Constant Summary collapse

Class Method Summary collapse

Class Method Details

.all ⇒ Array<DictionaryEntry>

.by_format(format) ⇒ Array<DictionaryEntry>

.by_language(lang) ⇒ Array<DictionaryEntry>

.by_license(license) ⇒ Array<DictionaryEntry>

.find(code) ⇒ DictionaryEntry?

.hunspell ⇒ Array<DictionaryEntry>

.languages ⇒ Array<String>

.licenses ⇒ Array<String>

.plain_text ⇒ Array<DictionaryEntry>

.statistics ⇒ Hash

.all ⇒ `Array<DictionaryEntry>`

.by_format(format) ⇒ `Array<DictionaryEntry>`

.by_language(lang) ⇒ `Array<DictionaryEntry>`

.by_license(license) ⇒ `Array<DictionaryEntry>`

.find(code) ⇒ `DictionaryEntry`^?

.hunspell ⇒ `Array<DictionaryEntry>`

.languages ⇒ `Array<String>`

.licenses ⇒ `Array<String>`

.plain_text ⇒ `Array<DictionaryEntry>`

.statistics ⇒ `Hash`