https://github.com/swuecho/webservice_merriamwebster
WebService::MerriamWebster - use Merriam-Webster dictionary API in Perl
https://github.com/swuecho/webservice_merriamwebster
Last synced: about 1 month ago
JSON representation
WebService::MerriamWebster - use Merriam-Webster dictionary API in Perl
- Host: GitHub
- URL: https://github.com/swuecho/webservice_merriamwebster
- Owner: swuecho
- License: other
- Created: 2013-04-17T20:32:01.000Z (about 12 years ago)
- Default Branch: master
- Last Pushed: 2018-02-11T18:35:11.000Z (about 7 years ago)
- Last Synced: 2025-01-22T15:46:00.458Z (3 months ago)
- Language: Perl
- Homepage:
- Size: 56.6 KB
- Stars: 0
- Watchers: 3
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: Changes
- License: LICENSE
Awesome Lists containing this project
README
# 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
# 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](https://metacpan.org/pod/XML::LibXML)