WWW::OpenSearch::Description(3pm)

WWW::OpenSearch::Description3pm

Encapsulate an opensearch description provided by an a9 opensearch compatible engine

Usage

    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

Overview

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( )

Releases

10 releases since Debian 4.0 (Etch); the text changed 6 times.

  1. 4.0
  2. 5.0
  3. 6.0
  4. 7
  5. 8–10
  6. 11
  7. 12–13

Author

•

Tatsuhiko Miyagawa <[email protected]>

•

Brian Cassidy <[email protected]>

From libwww-opensearch-perl 0.17-2 in Debian 13 (Trixie). Parsed by carta from the page's man source.