Scroll to navigation

System::Sub::AutoLoad(3pm) User Contributed Perl Documentation System::Sub::AutoLoad(3pm)

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.

2022-12-06 perl v5.36.0