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.