File Coverage

blib/lib/Catalyst/View/XML/Generator.pm

Criterion	Covered	Total	%
statement	1	3	33.3
branch			n/a
condition			n/a
subroutine	1	1	100.0
pod			n/a
total	2	4	50.0

package Catalyst::View::XML::Generator;
use Moose;
BEGIN { extends 'Catalyst::View' }

use XML::SAX::Writer;
use XML::Generator::PerlData;
use namespace::clean;

=head1 NAME

Catalyst::View::XML::Generator - Serialize the stash as XML using XML::Generator::PerlData

=head1 VERSION

Version 0.02

=cut

our $VERSION = '0.02';

=head1 SYNOPSIS

    __PACKAGE__->config(
        'XML::Generator' => {
            rootname => 'document',
            attrmap => {
                action => [qw( class name )],
                view   => [qw( type )]
            }
        }
    );

=head1 DESCRIPTION

This Catalyst view renders the context stash as XML using L<XML::Generator::PerlData>.  This enables you
to quickly render customized XML output using a set of rules to dictate which hash parameters will be stored
as attributes, elements, and other configuration options.

=cut

sub process {
    my ($self, $c) = @_;

    my $conf = $c->config->{'View::XML'};

    my $content = '';
    my $builder = XML::SAX::Writer->new(Output => \$content);
    my $generator = XML::Generator::PerlData->new(
        Handler => $builder,
        %{ $conf }
    );

    my $dom = $generator->parse($c->stash);

    $c->response->content_type("text/xml");
    $c->response->body($content);
    1;
}

=head1 AUTHOR

Michael Nachbaur, C<< <[e-mail]> >>

=head1 BUGS

Please report any bugs or feature requests to C<bug-catalyst-view-xml-generator at rt.cpan.org>, or through
the web interface at L<http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Catalyst-View-XML-Generator>.  I will be notified, and then you'll
automatically be notified of progress on your bug as I make changes.

=head1 SEE ALSO

L<Catalyst>, L<Catalyst::View>, L<XML::Generator::PerlData>

=head1 SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc Catalyst::View::XML::Generator

You can also look for information at:

=over 4

=item * RT: CPAN's request tracker

L<http://rt.cpan.org/NoAuth/Bugs.html?Dist=Catalyst-View-XML-Generator>

=item * AnnoCPAN: Annotated CPAN documentation

L<http://annocpan.org/dist/Catalyst-View-XML-Generator>

=item * CPAN Ratings

L<http://cpanratings.perl.org/d/Catalyst-View-XML-Generator>

=item * Search CPAN

L<http://search.cpan.org/dist/Catalyst-View-XML-Generator/>

=item * Download the source from Github

L<http://github.com/NachoMan/Catalyst-View-XML-Generator/>

=back

=head1 COPYRIGHT & LICENSE

Copyright (c) 2009 Michael Nachbaur

This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.

=cut

1;