File Coverage

blib/lib/EVDB/API/YAML.pm

Criterion	Covered	Total	%
statement	10	19	52.6
branch	0	4	0.0
condition			n/a
subroutine	4	6	66.6
pod	3	3	100.0
total	17	32	53.1

package EVDB::API::YAML;

use strict;
use warnings;
use Carp;

=head1 NAME

EVDB::API::YAML - Use the YAML flavor of the Eventful API

=head1 SYNOPSIS

    my $evdb    = EVDB::API->new(app_key => $app_key, flavor => 'yaml');
    my $results = $evdb->call('events/get', { id => 'E0-001-001336058-5' });

=head1 DESCRIPTION

Parses YAML from the Eventful API.

=head1 METHODS

=head2 flavor

Return the flavor name.

=cut

sub flavor { 'yaml' }

=head2 ctype

Return a checkstring for the expected return content type.

=cut

sub ctype { 'yaml' }

=head2 parse

Parse YAML data from the Eventful API using L or L.

=cut

sub parse {
    my ($class, $data, $force_array) = @_;

    carp "Forcing arrays is not supported for API flavor " . $class->flavor
        if $force_array;

    eval { require YAML::Syck };
    if ($@) {
        require YAML;
        return YAML::Load($data);
    }
    else {
        return YAML::Syck::Load($data);
    }
}

=head1 AUTHORS

=over 4

=item * Daniel Westermann-Clark [e-mail]

=back

=head1 LICENSE

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

=head1 SEE ALSO

=over 4

=item * L

=item * L

=item * L

=back

=cut

1;