GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  PERLANET (3)

.ds Aq ’

NAME

Perlanet - A program for creating programs that aggregate web feeds (both RSS and Atom).

CONTENTS

SYNOPSIS



  my $perlanet = Perlanet->new;
  $perlanet->run;



DESCRIPTION

Perlanet is a program for creating programs that aggregate web feeds (both RSS and Atom). Web pages like this are often called Planets after the Python software which originally popularised them. Perlanet is a planet builder written in Perl - hence Perlanet.

You are probably interested in Perlanet::Simple to get started straight out of the box, batteries included style.

Perlanet itself is the driving force behind everything, however. Perlanet reads a series of web feeds (filtering only those that are valid), sorts and selects entries from these web feeds, and then creates a new aggregate feed and renders this aggregate feed. Perlanet allows the user to customize all of these steps through subclassing and roles.

For most uses, you probably don’t want to use the Perlanet module. The perlanet command line program is far more likely to be useful.

CONSTRUCTOR

    new



  my $perlanet = Perlanet->new



The constructor method. Can be passed a hashref of initialisers.

See ATTRIBUTES below for details of the key/value pairs to pass in.

ATTRIBUTES

ua An instance of LWP::UserAgent. Defaults to a simple agent using $cfg->{agent} as the user agent name, or Perlanet/$VERSION .
cutoff An instance of DateTime which represents the earliest date for which feed posts will be fetched/shown.
feeds An arrayref of Perlanet::Feed objects representing the feeds to collect data from.

METHODS

    fetch_page

Attempt to fetch a web page and a returns a URI::Fetch::Response object.

    fetch_feeds

Called internally by run and passed the list of feeds in feeds.

Attempt to download all given feeds, as specified in the feeds attribute. Returns a list of Perlanet::Feed objects, with the actual feed data loaded.

NB: This method also modifies the contents of feeds.

    select_entries

Called internally by run and passed the list of feeds from fetch_feeds.

Returns a combined list of Perlanet::Entry objects from all given feeds.

    sort_entries

Called internally by run and passed the list of entries from select_entries.

Sort the given list of entries into created/modified order for aggregation, and filters them if necessary.

Takes a list of Perlanet::Entrys, and returns an ordered list.

    build_feed

Called internally by run and passed the list of entries from sort_entries.

Takes a list of Perlanet::Entrys, and returns a Perlanet::Feed that is the actual feed for the planet.

    clean_html

Clean a HTML string so it is suitable for display.

Takes a HTML string and returns a cleaned HTML string.

    clean_entries

Clean all entries for the planet.

Takes a list of entries, runs them through clean and returns a list of cleaned entries.

    render

Called internally by run and passed the feed from build_feed.

This is the hook where you generate some type of page to display the result of aggregating feeds together (ie, inserting the posts into a database, running a HTML templating library, etc)

Takes a Perlanet::Feed as input (as generated by build_feed.

    run

The main method which runs the perlanet process.

TO DO

See http://wiki.github.com/davorg/perlanet

SUPPORT

There is a mailing list which acts as both a place for developers to talk about maintaining and improving Perlanet and also for users to get support. You can sign up to this list at <http://lists.mag-sol.com/mailman/listinfo/perlanet>

To report bugs in Perlanet, please use the CPAN request tracker. You can either use the web page at <http://rt.cpan.org/Public/Bug/Report.html?Queue=Perlanet> or send an email to bug-Perlanet@rt.cpan.org.

SEE ALSO

o perlanet
o Plagger

AUTHOR

Dave Cross, <dave@mag-sol.com>

COPYRIGHT AND LICENSE

Copyright (c) 2010 by Magnum Solutions Ltd.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.10.0 or, at your option, any later version of Perl 5 you may have available.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 PERLANET (3) 2016-04-04

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.