File Coverage

blib/lib/App/cpanurl.pm

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

use 5.008001;
package App::cpanurl;

our $VERSION = '0.04';

1;

=head1 NAME

App::cpanurl - Get distribution URL from module name and version

=head1 CAUTION

B

(2013/3/20)

Sorry. This module is DEPRECATED because L and L is much better.

If you want to install moudles, use L and L instead.

See L

This module will be removed from CPAN on 2014/3/1

=head1 SYNOPSIS

  # http://cpan.metacpan.org/authors/id/S/SR/SRI/Mojolicious-3.82.tar.gz
  cpanurl Mojolicious 3.82

  # http://cpan.metacpan.org/authors/id/G/GA/GAAS/libwww-perl-6.04.tar.gz
  cpanurl LWP 6.04
  cpanurl libwww-perl-6.04

  # http://cpan.metacpan.org/authors/id/S/SR/SRI/Mojolicious-3.82.tar.gz
  # http://cpan.metacpan.org/authors/id/K/KI/KIMOTO/DBIx-Custom-0.23.tar.gz
  cpanurl -f module.txt

  # module.txt
  Mojolicious 3.82
  DBIx::Custom 0.23

=head1 DESCRIPTIONS

=head2 Get module URL

You can get module URL.

  # http://cpan.metacpan.org/authors/id/S/SR/SRI/Mojolicious-3.82.tar.gz
  cpanurl Mojolicious 3.82

If you want to get many module urls, you can use C<-f> option and module file.

  cpanurl -f module.txt

Module file is the following format.

  Mojolicious 3.82
  DBIx::Custom 0.23

You can get the following output

  http://cpan.metacpan.org/authors/id/S/SR/SRI/Mojolicious-3.82.tar.gz
  http://cpan.metacpan.org/authors/id/K/KI/KIMOTO/DBIx-Custom-0.23.tar.gz

=head2 Module installation

Use L with C to install modules.

  cpanurl Mojolicious 3.82 | cpanm

If you want to install many modules, you can create module file.

  # module.txt
  Mojolicious 3.82
  DBIx::Custom 0.23

And use C<-f> option to read this file.

  cpanurl -f module.txt | cpanm

=head2 Module name is different from distribution name

Some module name is different from disttribution name.
C is automatically resolve this relation.

  # Module name       Distribution name
  LWP                 libwww-perl
  IO::Compress::Base  IO-Compress
  Cwd                 PathTools
  File::Spec          PathTools
  List::Util          Scalar-List-Utils
  Scalar::Util        Scalar-List-Utils
  Template            Template-Toolkit

If you want to use distribution name, pass one argument.

  cpanurl libwww-perl-6.04

You can use Module name or distribution name.

  # both OK
  cpanurl LWP 6.04
  cpanurl libwww-perl-6.04

  # both OK
  cpanurl Cwd 3.40
  cpanurl PathTools-3.40

=head2 When URL is passwd to argument

  cpanurl http://somehost.com/Foo-0.01.tar.gz
  cpanurl https://somehost.com/Foo-0.01.tar.gz

If URL which start C or C is passed to argument,
That URL is passed through to output.

  # Output
  http://somehost.com/Foo-0.01.tar.gz
  https://somehost.com/Foo-0.01.tar.gz

=head2 HTTP client

L use two HTTP client as necessary.

=over 2

=item 1. LWP::UserAgent

=item 2. HTTP::Tiny

=back

These module is used to get module URLs from metaCPAN.

If L 5.802+ is installed, L
is seleced. If not, L is selected.

C<--lwp> option force L.

  cpanurl --lwp Mojolicious 3.82

C<--no-lwp> option force L.

  cpanurl --no-lwp Mojolicious 3.82

=head2 HTTP proxy

  export http_proxy=http://hostname:3001

C environment variable enable you to use proxy server.

=head2 HTTP proxy authentication

  export http_proxy=http://username:password@hostname:3001

If L 5.802+ is installed,
proxy authentication is available.
L don't support proxy authentication.

=head1 LICENSE AND COPYRIGHT

Copyright 2013 Yuki Kimoto.

This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.

=cut