chocolateboy > Shell-Autobox > Shell::Autobox

Download:
Shell-Autobox-0.03.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  1
Open  0
View/Report Bugs
Module Version: 0.03   Source  

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, it 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 scalar is written to a temporary file, and the name of this file is appended to the program name and the supplied options, so commands that expect their input to be supplied in some other fashion may need to be massaged.

e.g.

        $foo->bar('-input')->baz(...)

        # or
        
        $foo->bar('--option1', '--option2', '<')->baz(...)

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.

SEE ALSO ^

autobox, autobox::Core, Shell

AUTHOR ^

chocolateboy <chocolate.boy@email.com>

COPYRIGHT AND LICENSE ^

Copyright (c) 2005 by chocolateboy

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself, either Perl version 5.8.6 or, at your option, any later version of Perl 5 you may have available.

VERSION ^

0.03

syntax highlighting: