1 # $Id: Atom.pm 1958 2006-08-14 05:31:27Z btrott $
3 package XML::Feed::Format::Atom;
6 use base qw( XML::Feed );
8 use XML::Atom::Util qw( iso2dt );
9 use List::Util qw( first );
10 use DateTime::Format::W3CDTF;
13 XML::Atom::Entry->mk_elem_accessors(qw( lat long ), ['http://www.w3.org/2003/01/geo/wgs84_pos#']);
15 use XML::Atom::Content;
20 my $tag = $class->_get_first_tag($xml);
21 return ($tag eq 'feed');
26 my ($feed, %args) = @_;
27 $args{'Version'} ||= '1.0';
29 $feed->{atom} = XML::Atom::Feed->new(%args);
37 $feed->{atom} = XML::Atom::Feed->new(Stream => $str)
38 or return $feed->error(XML::Atom::Feed->errstr);
45 sub title { shift->{atom}->title(@_) }
49 $feed->{atom}->add_link({ rel => 'alternate', href => $_[0],
50 type => 'text/html', });
52 my $l = first { !defined $_->rel || $_->rel eq 'alternate' } $feed->{atom}->link;
53 $l ? $l->href : undef;
61 $feed->{atom}->add_link({type => "application/atom+xml", rel => "self", href => $uri});
68 { !defined $_->rel || $_->rel eq 'self' }
72 return $l ? $l->href : undef;
76 sub description { shift->{atom}->tagline(@_) }
77 sub copyright { shift->{atom}->copyright(@_) }
78 sub language { shift->{atom}->language(@_) }
79 sub generator { shift->{atom}->generator(@_) }
80 sub id { shift->{atom}->id(@_) }
81 sub updated { shift->{atom}->updated(@_) }
82 sub add_link { shift->{atom}->add_link(@_) }
83 sub base { shift->{atom}->base(@_) }
88 my $person = XML::Atom::Person->new(Version => 1.0);
90 $feed->{atom}->author($person);
92 $feed->{atom}->author ? $feed->{atom}->author->name : undef;
102 $feed->{atom}->modified(DateTime::Format::W3CDTF->format_datetime($_[0]));
104 return iso2dt($feed->{atom}->modified) if $feed->{atom}->modified;
105 return iso2dt($feed->{atom}->updated) if $feed->{atom}->updated;
112 for my $entry ($_[0]->{atom}->entries) {
113 push @entries, XML::Feed::Entry::Format::Atom->wrap($entry);
121 my $entry = shift || return;
122 $entry = $feed->_convert_entry($entry);
123 $feed->{atom}->add_entry($entry->unwrap);
126 sub as_xml { $_[0]->{atom}->as_xml }
128 package XML::Feed::Entry::Format::Atom;
131 use base qw( XML::Feed::Entry );
132 use XML::Atom::Util qw( iso2dt );
133 use XML::Feed::Content;
134 use XML::Atom::Entry;
135 use List::Util qw( first );
139 $entry->{entry} = XML::Atom::Entry->new(Version => 1.0);
143 sub format { 'Atom' }
145 sub title { shift->{entry}->title(@_) }
146 sub source { shift->{entry}->source(@_) }
147 sub updated { shift->{entry}->updated(@_) }
148 sub base { shift->{entry}->base(@_) }
153 $entry->{entry}->add_link({ rel => 'alternate', href => $_[0],
154 type => 'text/html', });
156 my $l = first { !defined $_->rel || $_->rel eq 'alternate' } $entry->{entry}->link;
157 $l ? $l->href : undef;
165 if (ref($_[0]) eq 'XML::Feed::Content') {
166 %param = (Body => $_[0]->body);
168 %param = (Body => $_[0]);
170 $entry->{entry}->summary(XML::Atom::Content->new(%param, Version => 1.0));
172 my $s = $entry->{entry}->summary;
173 # map Atom types to MIME types
174 my $type = ($s && ref($s) eq 'XML::Feed::Content') ? $s->type : undef;
176 $type = 'text/html' if $type eq 'xhtml' || $type eq 'html';
177 $type = 'text/plain' if $type eq 'text';
180 if (defined $s && ref($s) eq 'XML::Feed::Content') {
183 XML::Feed::Content->wrap({ type => $type,
189 'text/xhtml' => 'xhtml',
190 'text/html' => 'html',
191 'text/plain' => 'text',
199 if (ref($_[0]) eq 'XML::Feed::Content') {
200 if (defined $_[0]->type && defined $types{$_[0]->type}) {
201 %param = (Body => $_[0]->body, Type => $types{$_[0]->type});
203 %param = (Body => $_[0]->body);
205 $base = $_[0]->base if defined $_[0]->base;
207 %param = (Body => $_[0]);
209 $entry->{entry}->content(XML::Atom::Content->new(%param, Version => 1.0));
210 $entry->{entry}->content->base($base) if defined $base;
212 my $c = $entry->{entry}->content;
214 # map Atom types to MIME types
215 my $type = $c ? $c->type : undef;
217 $type = 'text/html' if $type eq 'xhtml' || $type eq 'html';
218 $type = 'text/plain' if $type eq 'text';
221 XML::Feed::Content->wrap({ type => $type,
222 base => $c ? $c->base : undef,
223 body => $c ? $c->body : undef });
229 my $ns = XML::Atom::Namespace->new(dc => 'http://purl.org/dc/elements/1.1/');
231 $entry->{entry}->add_category({ term => $_[0] });
233 my $category = $entry->{entry}->category;
234 my @return = $category ? ($category->label || $category->term) : $entry->{entry}->getlist($ns, 'subject');
235 return wantarray? @return : $return[0];
242 my $person = XML::Atom::Person->new(Version => 1.0);
243 $person->name($_[0]);
244 $entry->{entry}->author($person);
246 $entry->{entry}->author ? $entry->{entry}->author->name : undef;
250 sub id { shift->{entry}->id(@_) }
255 $entry->{entry}->issued(DateTime::Format::W3CDTF->format_datetime($_[0])) if $_[0];
257 $entry->{entry}->issued ? iso2dt($entry->{entry}->issued) : undef;
264 $entry->{entry}->modified(DateTime::Format::W3CDTF->format_datetime($_[0])) if $_[0];
266 return iso2dt($entry->{entry}->modified) if $entry->{entry}->modified;
267 return iso2dt($entry->{entry}->updated) if $entry->{entry}->updated;
275 $entry->{entry}->lat($_[0]) if $_[0];
277 $entry->{entry}->lat;
284 $entry->{entry}->long($_[0]) if $_[0];
286 $entry->{entry}->long;
295 my $enclosure = shift;
296 # TODO Atom can have multiple enclosures
297 $entry->{entry}->link({ rel => 'enclosure', href => $enclosure->{url},
298 length => $enclosure->{length},
299 type => $enclosure->{type} });
302 my $l = first { defined $_->rel && $_->rel eq 'enclosure' } $entry->{entry}->link;
303 return undef unless $l;
304 return XML::Feed::Enclosure->new({ url => $l->href, length => $l->length, type => $l->type });