module::install::can(3pm) [debian man page]
Module::Install::Can(3pm) User Contributed Perl Documentation Module::Install::Can(3pm) NAME
Module::Install::Can - Utility functions for capability detection DESCRIPTION
"Module::Install::Can" contains a number of functions for authors to use when creating customised smarter installers. The functions simplify standard tests so that you can express your dependencies and conditions much more simply, and make your installer much easier to maintain. COMMANDS
can_use can_use('Module::Name'); can_use('Module::Name', 1.23); The "can_use" function tests the ability to load a specific named module. Currently it will also actually load the module in the process, although this may change in the future. Takes an optional second param of a version number. The currently installed version of the module will be tested to make sure it is equal to or greater than the specified version. Returns true if the module can be loaded, or false (in both scalar or list context) if not. can_run can_run('cvs'); The "can_run" function tests the ability to run a named command or program on the local system. Returns true if so, or false (both in scalar and list context) if not. can_cc can_cc(); The "can_cc" function tests the ability to locate a functioning C compiler on the local system. Returns true if the C compiler can be found, or false (both in scalar and list context) if not. can_xs can_xs(); The "can_xs" function tests for a functioning C compiler and the correct headers to build XS modules against the current instance of Perl. TO DO
Currently, the use of a "can_foo" command in a single problem domain (for example "can_use") results in the inclusion of additional functionality from different problem domains (for example "can_run"). This module should ultimately be broken up, and the individual functions redestributed to different domain-specific extensions. AUTHORS
Audrey Tang <autrijus@autrijus.org> Adam Kennedy <adamk@cpan.org> SEE ALSO
Module::Install, Class::Inspector COPYRIGHT
Copyright 2006 - 2012 Audrey Tang, 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> perl v5.14.2 2012-03-01 Module::Install::Can(3pm)
Check Out this Related Man Page
Module::Install::External(3) User Contributed Perl Documentation Module::Install::External(3) 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 Module::Install::Can, 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 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
Module::Install 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> perl v5.16.3 2012-03-01 Module::Install::External(3)