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.