SYNOPSIS

use WWW::OpenSearch;

my $url = "http://bulkfeeds.net/opensearch.xml";
my $engine = WWW::OpenSearch->new($url);
my $description = $engine->description;

my $format = $description->Format; # or $description->format
my $longname = $description->LongName; # or $description->longname

DESCRIPTION

WWW::OpenSearch::Description is a module designed to encapsulate an OpenSearch Description provided by an A9 OpenSearch compatible engine. See http://opensearch.a9.com/spec/1.1/description/ for details.

CONSTRUCTOR

new( [ $xml ] )

Constructs a new instance of WWW::OpenSearch::Description. If scalar parameter $xml is provided, data will be automatically loaded from it using load( $xml ).

METHODS

load( $xml )

Loads description data by parsing provided argument using XML::LibXML.

urls( )

Return all of the urls associated with this description in an array.

get_best_url( )

Attempts to retrieve the best URL associated with this description, based on the following content types (from most preferred to least preferred):

• application/atom+xml
• application/rss+xml
• text/xml

get_url_by_type( $type )

Retrieves the first WWW::OpenSearch::URL associated with this description whose type is equal to $type.

ACCESSORS

version( )

ns( )

AdultContent( )

Attribution( )

Contact( )

Description( )

Developer( )

Format( )

InputEncoding( )

Image( )

Language( )

LongName( )

OutputEncoding( )

Query( )

SampleSearch( )

ShortName( )

SyndicationRight( )

Tags( )

Url( )

AUTHOR

• Tatsuhiko Miyagawa <[email protected]>
• Brian Cassidy <[email protected]>

COPYRIGHT AND LICENSE

Copyright 2005-2013 by Tatsuhiko Miyagawa and Brian Cassidy

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