NAME

Shell::Autobox - pipe Perl strings through shell commands

SYNOPSIS

use Shell::Autobox qw(xmllint);

my $xml = '<foo bar="baz"><bar /><baz /></foo>';
my $pretty = $xml->xmllint('--format -');

DESCRIPTION

Shell::Autobox provides an easy way to pipe Perl strings through shell commands. Commands passed as arguments to the use Shell::Autobox statement are installed as subroutines in the calling package, and that package is then registered as the handler for methods called on ordinary (i.e. non-reference) scalars.

When a method corresponding to a registered command is called on a scalar, the scalar is passed as the command's standard input; additional arguments are passed through as a space-delimited list of options, and - if no error occurs - the command's standard output is returned. This can then be piped into other commands.

The registered methods can also be called as regular functions, e.g.

use Shell::Autobox qw(cut);

my $bar = cut("foo:bar:baz", "-d':' -f2");

EXPORT

None by default.

VERSION

1.0.0

SEE ALSO

• autobox

• autobox::Core

• Shell

AUTHOR

chocolateboy <chocolate@cpan.org>

COPYRIGHT AND LICENSE

Copyright (c) 2005-2021 by chocolateboy.

This library is free software; you can redistribute it and/or modify it under the terms of the Artistic License 2.0.