dictionaryx #

English dictionary with about 120.000 entries, based on Wordnet.

Dictionaries #

This package offers four precompiled and optimized dart versions of the same base dictionary.

Additonally, a JSON-based dictionary is provided, which reads the entries from the file system and not from the memory.

The dictionaries offer meaning (M), synonym (S) and antonym (A). In some cases the meaning (M) is left out to reduce the file size.

Based on the selected dictionary, application startup time and memory footprint are impacted accordingly.

DictionaryMSAJson (1213 JSON files, each has a size of 15 KB)

• About 120.000 entries. Meanings, synonyms and antonyms.

DictionaryMSA (16.4 MB, Dart file)

• About 120.000 entries. Meanings, synonyms and antonyms.

DictionarySA (7.3 MB, Dart file)

• About 120.000 entries. Synonyms and antonyms.

DictionaryReducedMSA (1.8 MB, Dart file)

• About 3700 entries. Meanings, synonyms and antonyms.

DictionaryReducedSA (274 KB, Dart file)

• About 3700 entries. Synonyms and antonyms.

Outlook #

Explaination of how to use this pure dart package in a Flutter project will follow.

Installing #

In your pubspec.yaml:

dependencies:
  dictionaryx: ^0.3.1

How To Use #

import 'package:dictionaryx/dictionary_msa.dart';
import 'package:dictionaryx/dictionary_msa_json.dart';
import 'package:dictionaryx/dictionary_reduced_msa.dart';
import 'package:dictionaryx/dictionary_reduced_sa.dart';
import 'package:dictionaryx/dictionary_sa.dart';

void main() {

// =======================================================
// LOOKUP WORD IN JSON FILES (fast, but using file system)
// =======================================================

// -------------------------------------------------------
// With meanings (M) and synonyms (S) and antonyms (A).
// -------------------------------------------------------

  var dMSAJson = DictionaryMSAJson();

  var entry = dMSAJson.getEntry('meeting');

  // A meaning comes with a POS, description
  // and optional contextual-meanings and optional examples.

  print(entry.meanings.first.pos); // POS.NOUN
  print(entry.meanings.first.description); // a formally arranged gathering

  print(entry.meanings.first.hasMeanings()); // true
  print(entry.meanings.first.hasExamples()); // true

  print(entry.meanings.first.meanings.first); // Gathering
  print(entry.meanings.first.examples.first); //"next year the meeting (...)

// =======================================================
// LOOKUP WORD IN REDUCED DICTIONARY IN STATIC DART FILES 
// =======================================================

// -------------------------------------------------------
// Lookup an entry with synonyms (S) and antonyms (A).
// No meaing is provided.
// -------------------------------------------------------
  var dReducedSA = DictionaryReducedSA();

  print(dReducedSA.hasEntry('assafef')); // false
  print(dReducedSA.hasEntry('meeting')); // true

  var entry = dReducedSA.getEntry('meeting');
  print(entry.word); // meeting
  print(entry.synonyms); // [Assemble, Contact, Adjoin, Forgather, See]
  print(entry.antonyms); // [diverge]

// -------------------------------------------------------
// Lookup an entry with its meanings (M) and
// synonyms (S) and antonyms (A).
// A meaning-object comes with a list of optional explanations
// and a list of optional contextual-meanings.
// -------------------------------------------------------
  var dReducedMSA = DictionaryReducedMSA();

  entry = dReducedMSA.getEntry('meeting');
  print(entry.word); // meeting
  print(entry.synonyms); // [Assemble, Contact, Adjoin, Forgather, See]
  print(entry.antonyms); // [diverge]

  // A meaning comes with a POS, description
  // and optional contextual-meanings and optional examples.

  print(entry.meanings.first.pos); // POS.NOUN
  print(entry.meanings.first.description); // a formally arranged gathering

  print(entry.meanings.first.hasMeanings()); // true
  print(entry.meanings.first.hasExamples()); // true

  print(entry.meanings.first.meanings.first); // Gathering
  print(entry.meanings.first.examples.first); //"next year the meeting (...)

// =======================================================
// LOOKUP WORD IN COMPLETE DICTIONARY IN STATIC DART FILES 
// =======================================================

// -------------------------------------------------------
// In the same manner, the complete dictionary can be accessed.
// Compared to the reduced dictionary, the complete dictionary has
// a larger memory footprint.
// -------------------------------------------------------

// -------------------------------------------------------
// Smaller memory footprint, with no meanings.
// But synonyms (S) and antonyms (A).
// -------------------------------------------------------
  var dSA = DictionarySA();
  entry = dSA.getEntry('tree');

// -------------------------------------------------------
// Larger memory footprint, with meanings (M) and
// synonyms (S) and antonyms (A).
// -------------------------------------------------------
  var dMSA = DictionaryMSA();
  entry = dMSA.getEntry('tree');
}

Powershell #

> .\bin\dict.ps1 tree

WORD:tree 
EXPL:[[NOUN "a tall perennial woody plant having a main trunk and branches forming a distinct elevated crown; includes both gymnosperms and angiosperms" [Woody plant, Ligneous plant] []], [VERB "plant 
with trees" [Plant, Set] [this lot should be treed so that the house will be shaded in summer]], [VERB "chase an animal up a tree" [Chase, Chase after, Trail, Tail, Tag, Give chase, Dog, Go after, Track] [the hunters treed the bear with dogs and killed it, her dog likes to tree squirrels]], [VERB "stretch (a shoe) on a shoetree" [Elongate, Stretch] []]]
SYN:[Corner, Tree, Shoetree, Sir herbert beerbohm tree, Tree diagram]
ANT:[]

Command line #

Activate:

dart pub global activate dictionaryx

Deactivate:

dart pub global deactivate dictionaryx

> dict tree

WORD:tree 
EXPL:[[NOUN "a tall perennial woody plant having a main trunk and branches forming a distinct elevated crown; includes both gymnosperms and angiosperms" [Woody plant, Ligneous plant] []], [VERB "plant 
with trees" [Plant, Set] [this lot should be treed so that the house will be shaded in summer]], [VERB "chase an animal up a tree" [Chase, Chase after, Trail, Tail, Tag, Give chase, Dog, Go after, Track] [the hunters treed the bear with dogs and killed it, her dog likes to tree squirrels]], [VERB "stretch (a shoe) on a shoetree" [Elongate, Stretch] []]]
SYN:[Corner, Tree, Shoetree, Sir herbert beerbohm tree, Tree diagram]
ANT:[]

Bugs and Requests #

If you encounter any problems feel free to open an issue. If you feel the library is missing a feature, please raise a ticket on Github and I'll look into it. Pull request are also welcome.

https://github.com/xErik/dictionaryx/issues

Inspirations and Sources #

Wordnet License

https://wordnet.princeton.edu/license-and-commercial-use

Merged JSON

https://github.com/nightblade9/simple-english-dictionary

License #

This project is licensed under the MIT License - see the LICENSE file for details