File Coverage

blib/lib/Template/Plugin/Gravatar.pm

Criterion	Covered	Total	%
statement	47	47	100.0
branch	12	12	100.0
condition	18	27	66.6
subroutine	8	8	100.0
pod	1	1	100.0
total	86	95	90.5

package Template::Plugin::Gravatar;
use warnings;
use strict;
use base "Template::Plugin";
use Carp qw( carp croak );
use URI ();
use Digest::MD5 ();

our $VERSION = "0.10";
our $AUTHORITY = "cpan:ASHLEY";
our $Gravatar_Base = "https://gravatar.com/avatar/";

sub new {
    my ( $class, $context, $instance_args ) = @_;
    $instance_args ||= {}; # the USE'd object.
    my $config = $context->{CONFIG}{GRAVATAR} || {}; # from TT config.
    my %args;

    $args{default} = $instance_args->{default} || $config->{default};
    $args{rating} = $instance_args->{rating} || $config->{rating};
    $args{border} = $instance_args->{border} || $config->{border};
    $args{size} = $instance_args->{size} || $config->{size};

    # Overriding the base might be nice for some developers.
    $args{base} = $instance_args->{base} || $config->{base} ||
        $Gravatar_Base;

    return sub {
        my $args = shift || {};
        $args = {
            %args,
            %{$args}
        };
        $args->{email} || croak "Cannot generate a Gravatar URI without an email address";
        if ( $args->{size} ) {
            $args->{size} >= 1 and $args->{size} <= 2048
                or croak "Gravatar size must be 1 .. 2048";
        }
        if ( $args->{rating} ) {
            $args->{rating} =~ /\A(?:G|PG|R|X)\z/
                or croak "Gravatar rating can only be G, PG, R, or X";
        }
        if ( $args->{border} ) {
            carp "Border is deprecated! Dropping it.";
        }

        my $email = $args->{email};
        s/\A\s+//, s/\s+\z// for $email;
        $email = lc $email; # Might need to consider charset here or document consideration...
        $args->{gravatar_id} = Digest::MD5::md5_hex($email);

        my $uri = URI->new( $args->{base} || $Gravatar_Base );
        my @ordered = map { $_, $args->{$_} }
            grep $args->{$_},
            qw( gravatar_id rating size default );
        $uri->query_form(@ordered);
        $uri;
    }
}

1;

__END__