NAME

Sub::Install - install subroutines into packages easily

VERSION

version 0.929

SYNOPSIS

use Sub::Install;Sub::Install::install_sub({  code => sub { ... },  into => $package,  as   => $subname});

DESCRIPTION

This module makes it easy to install subroutines into packages without the unsightly mess ofno strict or typeglobs lying about where just anyone can see them.

PERL VERSION

This library should run on perls released even an extremely long time ago. It should work on any version of perl released in the last ten years.

Although it may work on older versions of perl, no guarantee is made that the minimum required version will not be increased. The version may be increased for any reason, and there is no promise that patches will be accepted to lower the minimum required perl.

FUNCTIONS

install_sub

Sub::Install::install_sub({ code => \&subroutine, into => "Finance::Shady", as   => 'launder',});

This routine installs a given code reference into a package as a normal subroutine. The above is equivalent to:

no strict 'refs';*{"Finance::Shady" . '::' . "launder"} = \&subroutine;

Ifinto is not given, the sub is installed into the calling package.

Ifcode is not a code reference, it is looked for as an existing sub in the package named in thefrom parameter. Iffrom is not given, it will look in the calling package.

Ifas is not given, and ifcode is a name,as will default tocode. Ifas is not given, but ifcode is a code ref, Sub::Install will try to find the name of the given code ref and use that asas.

That means that this code:

Sub::Install::install_sub({  code => 'twitch',  from => 'Person::InPain',  into => 'Person::Teenager',  as   => 'dance',});

is the same as:

package Person::Teenager;Sub::Install::install_sub({  code => Person::InPain->can('twitch'),  as   => 'dance',});

reinstall_sub

This routine behaves exactly like"install_sub", but does not emit a warning if warnings are on and the destination is already defined.

install_installers

This routine is provided to allow Sub::Install compatibility with Sub::Installer. It installsinstall_sub andreinstall_sub methods into the package named by its argument.

Sub::Install::install_installers('Code::Builder'); # just for us, pleaseCode::Builder->install_sub({ name => $code_ref });Sub::Install::install_installers('UNIVERSAL'); # feeling lucky, punk?Anything::At::All->install_sub({ name => $code_ref });

The installed installers are similar, but not identical, to those provided by Sub::Installer. They accept a single hash as an argument. The key/value pairs are used as theas andcode parameters to theinstall_sub routine detailed above. The package name on which the method is called is used as theinto parameter.

Unlike Sub::Installer'sinstall_sub will not eval strings into code, but will look for named code in the calling package.

EXPORTS

Sub::Install exportsinstall_sub andreinstall_sub only if they are requested.

exporter

Sub::Install has a never-exported subroutine calledexporter, which is used to implement itsimport routine. It takes a hashref of named arguments, only one of which is currently recognize:exports. This must be an arrayref of subroutines to offer for export.

This routine is mainly for Sub::Install's own consumption. Instead, considerSub::Exporter.

SEE ALSO

Sub::Installer

This module is (obviously) a reaction to Damian Conway's Sub::Installer, which does the same thing, but does it by getting its greasy fingers all over UNIVERSAL. I was really happy about the idea of making the installation of coderefs less ugly, but I couldn't bring myself to replace the ugliness of typeglobs and loosened strictures with the ugliness of UNIVERSAL methods.

Sub::Exporter

This is a complete Exporter.pm replacement, built atop Sub::Install.

EXTRA CREDITS

Several of the tests are adapted from tests that shipped with Damian Conway's Sub-Installer distribution.

AUTHOR

Ricardo SIGNES <cpan@semiotic.systems>

CONTRIBUTORS

• Chad Granum <chad.granum@dreamhost.com>

• David Steinbrunner <dsteinbrunner@pobox.com>

• Ricardo SIGNES <rjbs@codesimply.com>

• Ricardo Signes <rjbs@semiotic.systems>

COPYRIGHT AND LICENSE

This software is copyright (c) 2005 by Ricardo SIGNES.

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