---
name: "System::Sub::AutoLoad"
section: "3pm"
platform: "linux"
package: "libsystem-sub-perl"
version: "0.162800-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/System::Sub::AutoLoad"
---

# System::Sub::AutoLoad(3pm)

Auto-wrap external commands as DWIM subs

## 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.