.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is turned on, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .ie \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . nr % 0 . rr F .\} .el \{\ . de IX .. .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "Perlanet 3pm" .TH Perlanet 3pm "2012-03-17" "perl v5.14.2" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" Perlanet \- A program for creating programs that aggregate web feeds (both RSS and Atom). .SH "SYNOPSIS" .IX Header "SYNOPSIS" .Vb 2 \& my $perlanet = Perlanet\->new; \& $perlanet\->run; .Ve .SH "DESCRIPTION" .IX Header "DESCRIPTION" Perlanet is a program for creating programs that aggregate web feeds (both \&\s-1RSS\s0 and Atom). Web pages like this are often called \*(L"Planets\*(R" after the Python software which originally popularised them. Perlanet is a planet builder written in Perl \- hence \*(L"Perlanet\*(R". .PP You are probably interested in Perlanet::Simple to get started straight out of the box, batteries included style. .PP 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. .PP 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. .SH "CONSTRUCTOR" .IX Header "CONSTRUCTOR" .SS "new" .IX Subsection "new" .Vb 1 \& my $perlanet = Perlanet\->new .Ve .PP The constructor method. Can be passed a hashref of initialisers. .PP See \*(L"\s-1ATTRIBUTES\s0\*(R" below for details of the key/value pairs to pass in. .SH "ATTRIBUTES" .IX Header "ATTRIBUTES" .IP "ua" 4 .IX Item "ua" An instance of LWP::UserAgent. Defaults to a simple agent using \f(CW\*(C`$cfg\->{agent}\*(C'\fR as the user agent name, or \f(CW\*(C` Perlanet/$VERSION \*(C'\fR. .IP "cutoff" 4 .IX Item "cutoff" An instance of DateTime which represents the earliest date for which feed posts will be fetched/shown. .IP "feeds" 4 .IX Item "feeds" An arrayref of Perlanet::Feed objects representing the feeds to collect data from. .SH "METHODS" .IX Header "METHODS" .SS "fetch_page" .IX Subsection "fetch_page" Attempt to fetch a web page and a returns a URI::Fetch::Response object. .SS "fetch_feeds" .IX Subsection "fetch_feeds" Called internally by \*(L"run\*(R" and passed the list of feeds in \*(L"feeds\*(R". .PP Attempt to download all given feeds, as specified in the \f(CW\*(C`feeds\*(C'\fR attribute. Returns a list of Perlanet::Feed objects, with the actual feed data loaded. .PP \&\s-1NB:\s0 This method also modifies the contents of \*(L"feeds\*(R". .SS "select_entries" .IX Subsection "select_entries" Called internally by \*(L"run\*(R" and passed the list of feeds from \&\*(L"fetch_feeds\*(R". .PP Returns a combined list of Perlanet::Entry objects from all given feeds. .SS "sort_entries" .IX Subsection "sort_entries" Called internally by \*(L"run\*(R" and passed the list of entries from \&\*(L"select_entries\*(R". .PP Sort the given list of entries into created/modified order for aggregation, and filters them if necessary. .PP Takes a list of Perlanet::Entrys, and returns an ordered list. .SS "build_feed" .IX Subsection "build_feed" Called internally by \*(L"run\*(R" and passed the list of entries from \&\*(L"sort_entries\*(R". .PP Takes a list of Perlanet::Entrys, and returns a Perlanet::Feed that is the actual feed for the planet. .SS "clean_html" .IX Subsection "clean_html" Clean a \s-1HTML\s0 string so it is suitable for display. .PP Takes a \s-1HTML\s0 string and returns a \*(L"cleaned\*(R" \s-1HTML\s0 string. .SS "clean_entries" .IX Subsection "clean_entries" Clean all entries for the planet. .PP Takes a list of entries, runs them through \f(CW\*(C`clean\*(C'\fR and returns a list of cleaned entries. .SS "render" .IX Subsection "render" Called internally by \*(L"run\*(R" and passed the feed from \*(L"build_feed\*(R". .PP 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 \s-1HTML\s0 templating library, etc) .PP Takes a Perlanet::Feed as input (as generated by build_feed. .SS "run" .IX Subsection "run" The main method which runs the perlanet process. .SH "TO DO" .IX Header "TO DO" See http://wiki.github.com/davorg/perlanet .SH "SUPPORT" .IX Header "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 .PP To report bugs in Perlanet, please use the \s-1CPAN\s0 request tracker. You can either use the web page at or send an email to bug\-Perlanet@rt.cpan.org. .SH "SEE ALSO" .IX Header "SEE ALSO" .IP "\(bu" 4 perlanet .IP "\(bu" 4 Plagger .SH "AUTHOR" .IX Header "AUTHOR" Dave Cross, .SH "COPYRIGHT AND LICENSE" .IX Header "COPYRIGHT AND LICENSE" Copyright (c) 2010 by Magnum Solutions Ltd. .PP 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.