NAME

WebService::MerriamWebster - use Merriam-Webster dictionary API in Perl

SYNOPSIS

    use WebService::MerriamWebster;
    my $mw = WebService::MerriamWebster->new(dict => "collegiate", word => "$the-word-to-query", key => "$your-key-here");
    my $xml = $mw->raw_xml;  # a string
    my $dom = $mw->dom; # XML::LibXML::Document
    my @entries = $mw->entries(); # @entries is list of XML::LibXML::Element
    my $audio_uri = $mw->audio_url;  # ex. http://media.merriam-webster.com/soundc11/t/test0001.wav

DESCRIPTION

WebService::MerriamWebster is an api to merriam-webster.com dictionary. It gives you xml result based on your query. it use XML::LibXML to process the XML result (very basic). If you need to get the value of specific node, probably you need to deal with the xml yourself.

Attributes

dict

    has 'dict' => (
            is => 'rw',
            isa => 'Str',
            required => 1
    );

the dictionary you want to use

word

    has 'word' => (
        is => 'rw',
        isa => 'Str',
        required => 1
    );

the word to query

key

    has 'key' => (
        is => 'ro',
        isa => 'Str',
        required => 1
    );

ver

    has 'ver' => (
          is  => 'ro',
          isa => 'Str',
          default => sub { 1 },
    );

version of api, v1, v2

url

the query url based on $dict, $word, $key

    reference: http://www.dictionaryapi.com/api/v1/references/$dic/xml/$word?key=$key

raw_xml

the xml you get based on your query

dom

the dom (XML::LibXML::Document) base on your query

Method

entries

the @entries of dom

audio_url

the audio url of the query word

AUTHOR

Hao Wu echowuhao@gmail.com

COPYRIGHT

Copyright 2013- Hao Wu

LICENSE

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO

XML::LibXML