Module::Install::External - Specify dependencies on external non-Perl things



NAME

Module::Install::External - Specify dependencies on external non-Perl things


DESCRIPTION

Module::Install::External provides command that allow you to declaratively specify a dependency on a program or system that is not Perl.

The commands it provides are similar to those in the Module::Install::Can manpage, except that they implement an explicit dependency, in addition to just working out if the particular thing is available.


COMMANDS

requires_xs

  requires_xs;

The requires_xs command explicitly specifies that a C compiler and the perl header files are required in order to build (at make-time) the distribution (specifically XS files).

It does not take any params, and aborts the Makefile.PL execution in a way that an automated installation or testing system will interpret as a NA (``not applicable to this platform'') result.

This may be changed to an alternative abort result at a later time.

Returns true as a convenience.

requires_external_cc

  requires_external_cc;

The requires_external_cc command explicitly specifies that a C compiler is required in order to build (at make-time) the distribution.

It does not take any params, and aborts the Makefile.PL execution in a way that an automated installation or testing system will interpret as a NA (``not applicable to this platform'') result.

This may be changed to an alternative abort result at a later time.

Returns true as a convenience.

requires_external_bin

  requires_external_bin 'cvs';

The requires_external_bin command takes the name of a system command or program, similar to the can_run command, except that requires_external_bin checks in a way that is a declarative explicit dependency.

The takes a single param of the command/program name, and aborts the Makefile.PL execution in a way that an automated installation or testing system will interpret as a NA (``not applicable to this platform'') result.

Returns true as a convenience.


TO DO

Work out how to save the external dependency metadata, in agreement with the larger Perl community.

Implement the agreed external dependency metadata solution.


AUTHORS

Adam Kennedy <adamk@cpan.org>


SEE ALSO

the Module::Install manpage


COPYRIGHT

Copyright 2006 Adam Kennedy.

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

See http://www.perl.com/perl/misc/Artistic.html

 Module::Install::External - Specify dependencies on external non-Perl things