From: Nikolai Weibull <mailing-lists.ruby-talk@...>
Date: 2005-11-14T07:11:12+09:00
Subject: [ANN] Net::DICT 0.9.0

(WARNING: This is a lazy-pants announcement.  All I’ve done is
:r doc/README and added a couple of headings.)

Net::DICT README
================

Introduction
------------

Net::DICT is a library for Ruby that implements the client-side of the
Dictionary Server Protocol (DICT), described in
http://ietf.org/rfc/rfc2229.txt[RFC2229].  Documentation of the project
is provided in RDoc form, and can be generated by running the
`doc`-target of the Rakefile.

Authors
-------

Nikolai Weibull <nikolai@bitwi.se>

News
----

0.9.0
~~~~~

Initial release.

Download
--------

A gem can (temporarily) be found at http://bitwi.se/net-dict-0.9.0.gem
You can also git the source at http://git.bitwi.se/

Examples
--------

A couple of examples follow.

Define a word:

 require 'net/dict'

 dict = Net::DICT.new('dict.org')
 dict.client = 'Ruby-Net::DICT example'
 puts dict.define('ruby', 'foldoc')[0]
 dict.disconnect

Define a word using a pipeline (less traffic):

  require 'net/dict'

  dict = Net::DICT.new
  definitions, _ = dict.pipeline do
    dict.connect('dict.org')
    dict.client = 'Ruby-Net::DICT pipeline example'
    dict.define('ruby', 'foldoc')
    dict.disconnect
  end
  puts definitions[0]

Get a list of databases on the server using a session (execute a
pipeline):

  require 'net/dict'
  
  dbs, _ = Net::DICT.session('Ruby-Net::DICT db example', 'dict.org') do |dict|
    dict.databases
  end
  dbs.each{ |db, description| puts "#{db}: #{description}" }

Net::DICT also integrates with the URI and open-uri libraries:

  require 'net/dict'
  require 'uri/dict'
  require 'open-uri'

  open('dict://dict.org/d:word'){ |file| puts file.read }

A dict client using this library is being written, but nothing’s
stopping you from writing your own in the meantime ;-).

        nikolai

-- 
Nikolai Weibull: now available free of charge at http://bitwi.se/!
Born in Chicago, IL USA; currently residing in Gothenburg, Sweden.
main(){printf(&linux["\021%six\012\0"],(linux)["have"]+"fun"-97);}