System::Sub::AutoLoad(3)

NAME
System::Sub::AutoLoad - Auto-wrap external commands as DWIM subs

VERSION
version 0.162800

SYNOPSIS

  Basic usage
Any unknown sub will become a "System::Sub".

    use System::Sub::AutoLoad;

    my $hostname = hostname();

  Usage with forward declaration
Allows to avoid using parentheses. "System::Sub" import stays lazy.

    use System::Sub::AutoLoad qw(hostname);

    my $hostname = hostname;

  Usage with forward declaration command options
Options definitions will be checked lazily at the first call to the AUTOLOAD for that sub.

    use System::Sub::AutoLoad hostname => [ 0 => '/bin/hostname' ];

    my $hostname = hostname;

DESCRIPTION
Any unknown sub in your code will be transformed into a "System::Sub" at its first call. This is lazy <http://en.wikipedia.org/wiki/Lazy_evaluation> import for "System::Sub".

To avoid using parentheses after the sub name, you usually have to predeclare the sub with either a forward declaration (a sub without body such as "sub foo;") or with the "subs" module. With "Sytem::Sub::AutoLoad" you can simply list the subs names on the "use" line and that will be done for you.

You can also pass "System::Sub" options to the sub, but they will be lazily analysed: this is the full "System::Sub" power, but with lazy import.

  Implementation details
This module exports an AUTOLOAD sub that will import the sub with "System::Sub" at its first call.

AUTHOR
Olivier Mengué, "dolmen@cpan.org".

COPYRIGHT & LICENSE
Copyright © 2012 Olivier Mengué.

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