The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

OpenInteract2::Manage::Package::CreateCPAN - Create a CPAN distribution from a package

SYNOPSIS

 # From command-line:
 
 $ oi2_manage create_cpan
 
 # Programmatically:
 
 #!/usr/bin/perl
 
 use strict;
 use OpenInteract2::Manage;
 
 my $website_dir = '/home/httpd/mysite';
 my %PARAMS = ( package_dir = '/path/to/my/package' );
 my $task = OpenInteract2::Manage->new(
                      'create_cpan', \%PARAMS );
 my @status = $task->execute;
 foreach my $s ( @status ) {
     my $ok_label      = ( $s->{is_ok} eq 'yes' )
                           ? 'OK' : 'NOT OK';
     print "Status? $ok_label\n",
           "$s->{message}\n";
 }

DESCRIPTION

This task creates a CPAN distribution from your package contents and metadata. You should be able to send the generated distribution to anyone else for them to run the standard install:

 perl Makefile.PL
 make
 make test
 make install

For installing directly to a webserver you can do:

 perl Makefile.PL WEBSITE_DIR=/path/to/mysite
 make
 make test
 make install

And the files will be copied to the right place.

OPTIONS

Required

package_dir=/path/to/package

Path to your package; defaults to current directory if not given.

make_bin=nmake

Name of your 'make' command; defaults to 'make' if not given.

Optional

keep_dir=yes/no

Whether to keep the directory we use to create the CPAN package; defaults to 'no'.

STATUS INFORMATION

Includes no additional status information.

COPYRIGHT

Copyright (C) 2005 Chris Winters. All rights reserved.

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

AUTHORS

Chris Winters, <chris@cwinters.com>