File Coverage

blib/lib/WWW/Shorten/IsGd.pm

Criterion	Covered	Total	%
statement	32	33	96.9
branch	11	16	68.7
condition			n/a
subroutine	8	8	100.0
pod	2	2	100.0
total	53	59	89.8

package WWW::Shorten::IsGd;
# ABSTRACT: shorten (or lengthen) URLs with http://is.gd
use strict;
use warnings;
use 5.006;
our $VERSION = '0.003'; # VERSION


use base qw( WWW::Shorten::generic Exporter );
our @EXPORT = qw( makeashorterlink makealongerlink );
use Carp;
use URI;


sub makeashorterlink {
    my $url = shift or croak 'No URL passed to makeashorterlink';
    my $ua = __PACKAGE__->ua();
    my $response = $ua->post('http://is.gd/create.php', [
        url => $url,
        source => 'PerlAPI-' . (defined __PACKAGE__->VERSION ? __PACKAGE__->VERSION : 'dev'),
        format => 'simple',
	]);
    return unless $response->is_success;
    my $shorturl = $response->{_content};
    return if $shorturl =~ m/Error/;
    if ($response->content =~ m{(\Qhttp://is.gd/\E[\w_]+)}) {
		return $1;
    }
    return;
}


sub makealongerlink {
    my $url = shift or croak 'No is.gd key/URL passed to makealongerlink';
    my $ua = __PACKAGE__->ua();

	$url = "http://is.gd/$url" unless $url =~ m{^https?://}i;
    my $response = $ua->get($url);

    return unless $response->is_redirect;
    return $response->header('Location');
}

1;



=pod

=encoding utf-8

=head1 NAME

WWW::Shorten::IsGd - shorten (or lengthen) URLs with http://is.gd

=head1 VERSION

version 0.003

=head1 SYNOPSIS

	use WWW::Shorten::IsGd;
	use WWW::Shorten 'IsGd';

    my $url = q{http://averylong.link/wow?thats=really&really=long};
    my $short_url = makeashorterlink($url);
    my $long_url  = makealongerlink($short_url); # eq $url

=head1 DESCRIPTION

A Perl interface to the web site L. is.gd simply maintains
a database of long URLs, each of which has a unique identifier.

=head1 FUNCTIONS

=head2 makeashorterlink

The function C will call the is.gd web site passing
it your long URL and will return the shortened link.

=head2 makealongerlink

The function C does the reverse. C
will accept as an argument either the full TinyURL URL or just the
TinyURL identifier.

If anything goes wrong, then either function will return C.

=head1 AVAILABILITY

The project homepage is L.

The latest version of this module is available from the Comprehensive Perl
Archive Network (CPAN). Visit L to find a CPAN
site near you, or see L.

The development version lives at L
and may be cloned from L.
Instead of sending patches, please fork this project using the standard
git and github infrastructure.

=head1 SOURCE

The development version is on github at L
and may be cloned from L

=head1 BUGS AND LIMITATIONS

No bugs have been reported.

Please report any bugs or feature requests through the web interface at
L.

=head1 AUTHOR

Mike Doherty

=head1 COPYRIGHT AND LICENSE

This software is copyright (c) 2011 by Mike Doherty.

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

=cut


__END__