NAME

Net::MW::API - use Merriam-Webster dictionary API in Perl

SYNOPSIS

        use Net::MW::API;
        my $mw = Net::MW::API->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

Net::MW::API 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
        );

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