Data-Tubes

 view release on metacpan or  search on metacpan

README  view on Meta::CPAN

       # no additional parameters
       $files = tube('Source::iterate_files');
    
       # set some parameters for iterate_files
       $files = tube('Source::iterate_files', binmode => ':raw');

    Most of the times, you are probably looking for "pipeline" above, as
    that will eventually call tube automatically.

BUGS AND LIMITATIONS

    Report bugs through GitHub (patches welcome) at
    https://github.com/polettix/Data-Tubes.

AUTHOR

    Flavio Poletti <polettix@cpan.org>

COPYRIGHT AND LICENSE

lib/Data/Tubes.pod  view on Meta::CPAN

   # no additional parameters
   $files = tube('Source::iterate_files');

   # set some parameters for iterate_files
   $files = tube('Source::iterate_files', binmode => ':raw');

Most of the times, you are probably looking for L</pipeline> above,
as that will eventually call C<tube> automatically.

=head1 BUGS AND LIMITATIONS

Report bugs through GitHub (patches welcome) at
L<https://github.com/polettix/Data-Tubes>.

=head1 AUTHOR

Flavio Poletti <polettix@cpan.org>

=head1 COPYRIGHT AND LICENSE

lib/Data/Tubes/Plugin/Parser.pod  view on Meta::CPAN

=item C<name>

name of the tube, useful for debugging;

=item C<output>

name of the output field, defaults to C<structured>;

=back

=head1 BUGS AND LIMITATIONS

Report bugs either through RT or GitHub (patches welcome).

=head1 AUTHOR

Flavio Poletti <polettix@cpan.org>

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2016 by Flavio Poletti <polettix@cpan.org>

lib/Data/Tubes/Plugin/Plumbing.pod  view on Meta::CPAN

   while (my ($output_record) = $it1->()) {
      # work with $output_record here, it's your output record!
   }

   # if you're waiting for a single output record, use if
   my $it2 = $sequence2->($input_record)->{iterator};
   if (my ($output_record) = $it2->()) {
      # work with $output_record here, it's your output record!
   }

=head1 BUGS AND LIMITATIONS

Report bugs either through RT or GitHub (patches welcome).

=head1 AUTHOR

Flavio Poletti <polettix@cpan.org>

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2016 by Flavio Poletti <polettix@cpan.org>

lib/Data/Tubes/Plugin/Reader.pod  view on Meta::CPAN

Alias for L</by_paragraph>.

=head2 B<< read_by_record_reader >>

Alias for L</by_record_reader>.

=head2 B<< read_by_separator >>

Alias for L</by_separator>.

=head1 BUGS AND LIMITATIONS

Report bugs either through RT or GitHub (patches welcome).

=head1 AUTHOR

Flavio Poletti <polettix@cpan.org>

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2016 by Flavio Poletti <polettix@cpan.org>

lib/Data/Tubes/Plugin/Renderer.pod  view on Meta::CPAN

C<template_perlish> or the auto-generated instance;

=item C<variables>

hash reference with variables that will always be available when
expanding the template. Defaults to the empty hash. Will be ignored if
C<template_perlish> is present in the arguments.

=back

=head1 BUGS AND LIMITATIONS

Report bugs either through RT or GitHub (patches welcome).

=head1 AUTHOR

Flavio Poletti <polettix@cpan.org>

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2016 by Flavio Poletti <polettix@cpan.org>

lib/Data/Tubes/Plugin/Source.pod  view on Meta::CPAN

=item C<name>

=item C<open_file>

optional hash with arguments for the L</open_file> sub-tube, defaults to
the empty hash which means taking all defaults from L</open_file>.

=back

=head1 BUGS AND LIMITATIONS

Report bugs either through RT or GitHub (patches welcome).

=head1 AUTHOR

Flavio Poletti <polettix@cpan.org>

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2016 by Flavio Poletti <polettix@cpan.org>

lib/Data/Tubes/Plugin/Util.pod  view on Meta::CPAN

   @tubes = tubify(
      'Reader::by_line',
      ['Parser::by_format', format => 'foo,bar,baz'],
      ($foobar && sub { die unless $_[0]->{structured}}),
   );

You can optionally pass a I<hash reference> of options as the first
parameter. This allows you to set any option available through
L<Data::Tubes/tube>, e.g. C<prefix>.

=head1 BUGS AND LIMITATIONS

Report bugs either through RT or GitHub (patches welcome).

=head1 AUTHOR

Flavio Poletti <polettix@cpan.org>

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2016 by Flavio Poletti <polettix@cpan.org>

lib/Data/Tubes/Plugin/Validator.pod  view on Meta::CPAN

=head2 B<< with_subs >>

   $tube = with_subs(@validators); # OR
   $tube = with_subs(@validators, \%args);

This function is DEPRECATED and currently aliased to L</thoroughly>. It
used to do all that L</thoroughly> does, except handling regular
expression validators; now ith supports them too, which is why a name
change was necessary.

=head1 BUGS AND LIMITATIONS

Report bugs either through RT or GitHub (patches welcome).

=head1 AUTHOR

Flavio Poletti <polettix@cpan.org>

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2016 by Flavio Poletti <polettix@cpan.org>

lib/Data/Tubes/Plugin/Writer.pod  view on Meta::CPAN

a policy object where you can set thresholds for limiting the
content/size of generated files. See L<Data::Tubes::Util::Output>.

=back

=head2 B<< write_to_files >>

Alias for L</to_files>.

=head1 BUGS AND LIMITATIONS

Report bugs either through RT or GitHub (patches welcome).

=head1 AUTHOR

Flavio Poletti <polettix@cpan.org>

=head1 COPYRIGHT AND LICENSE

Copyright (C) 2016 by Flavio Poletti <polettix@cpan.org>

script/tubergen  view on Meta::CPAN

 
 =head1 CONFIGURATION AND ENVIRONMENT
 
 =for author, to fill in
     Explain any configuration that can be used by the program, via some
     file or via environment variables.
 
 [% name %] requires no configuration files or environment variables.
 
 
 =head1 BUGS AND LIMITATIONS
 
 =for author, to fill in
     List any known bugs and limitations of your program
 
 No bugs have been reported.
 
 
 =head1 AUTHOR
 
 [% author %] <[% email %]>

script/tubergen  view on Meta::CPAN

=head1 DIAGNOSTICS

tubergen will complain if any of the required option is missing. It will
also complain if you try to define unknown options.

=head1 CONFIGURATION AND ENVIRONMENT

tubergen requires no configuration files or environment variables.


=head1 BUGS AND LIMITATIONS

No bugs have been reported, but you can do this through Issues at
L<https://github.com/polettix/Data-Tubes/issues>.


=head1 AUTHOR

Flavio Poletti polettix@cpan.org