NAME

WWW::OpenSearch::Description - Encapsulate an OpenSearch Description provided by an A9 OpenSearch compatible engine

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 <miyagawa@bulknews.net>

• Brian Cassidy <bricas@cpan.org>

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.

cpanm WWW::OpenSearch

perl -MCPAN -e shell
install WWW::OpenSearch