A simple proxy service to provide an HTTP (REST) interface to a Dict protocol (RFC 2229) for the Dict protocol. Written in Go.

An instance can usually be access from http://felixhanley.info/projects/lahu/dictionary/

This project currently uses Golang 1.6's vendor folder structure. All dependencies are in this repository.

It should be as simple as this:

git clone https://github.com/felix/go-dict2rest
cd go-dict2rest
go install dict2rest  # or just 'make'
./bin/dict2rest --dicthost dict.org

The server binary has the following options:

$ dict2rest --help

Usage of dict2rest:
  -deflate
        Support DEFLATE compression
  -dicthost string
        Dict server name (default "localhost")
  -dictport string
        Dict server port (default "2628")
  -gzip
        Support gzip compression
  -port string
        Listen port (default "8080")

The URL endpoints try to match the commands defined in RFC 2229. Results are JSON and have the following format (newlines added for readability):

GET /databases

[
    {
        "name":"eng-lhu",
        "description":"English-Lahu Dictionary ver. 20160128"
    }, {
        "name":"lhu-eng",
        "description":"Lahu-English Dictionary ver. 20160128"
    }
]

GET /define/{word}
GET /define/{word}?dict=eng-lhu

[
    {
        "dictionary":"WordNet (r) 3.0 (2006)",
        "word":"lahu",
        "definition":"Lahu\n    n 1: a Loloish language\n"
    }
]

Where 'eng-lhu' is one of the names of the server's dictionaries.

RFC 2229 error codes are passed through as JSON:

{"code":552,"message":"no match"}

• Add strategy listing and lookups
• Add server and status commands
• Add tests

Copyright Felix Hanley, 2016

See LICENSE file.