- Why the name?
- SEE ALSO
Ryu - asynchronous stream building blocks
#!/usr/bin/env perl use strict; use warnings; use Ryu qw($ryu); my ($lines) = $ryu->from(\*STDIN) ->by_line ->filter(qr/\h/) ->count ->get; print "Had $lines line(s) containing whitespace\n";
Provides data flow processing for asynchronous coding purposes. It's a bit like ReactiveX in concept. Where possible, it tries to provide a similar API. It is not a directly-compatible implementation, however.
Eventually some documentation pages might appear, but at the moment they're unlikely to exist.
Network protocol implementations - if you're bored of stringing together
vec, try Ryu::Manual::Protocol
Extract, Transform, Load workflows (ETL) - need to pull data from somewhere, mangle it into shape, push it to a database? that'd be Ryu::Manual::ETL
Reactive event handling - Ryu::Manual::Reactive
As an expert software developer with a keen eye for useful code, you may already be bored of this documentation and on the verge of reaching for alternatives. The "SEE ALSO" section may speed you on your way.
A source emits items. See Ryu::Source.
Items can be any scalar value - some examples:
a single byte
a byte string
a character string
an object instance
an arrayref or hashref
A sink receives items. It's the counterpart to a source. See Ryu::Sink.
A stream is a thing with a source. See Ryu::Stream, which is likely to be something that does not yet exist.
Nothing. It's just a top-level loader for pulling in all the other components.
Multiple parameters are a shortcut for instantiating the given source or sink:
my $stream = Ryu::Stream->from( file => 'somefile.bin' );
is equivalent to
my $stream = Ryu::Stream->from( Ryu::Source->new( file => 'somefile.bin' ) );
$ryulines up with typical 4-character indentation settings.
there's Rx for other languages, and this is based on the same ideas
流 was too hard for me to type
Note that you're more likely to find useful methods in the following classes:
Helper method which returns a Ryu::Source from a list of items.
Helper method which returns a single-item Ryu::Source.
Some perl modules of relevance:
Future - fundamental building block for one-shot tasks
POE::Filter - venerable and battle-tested, but slightly short on features due to the focus on protocols
List::Gen - list mangling features
HOP::Stream - based on the Higher Order Perl book
Flux - more like the java8 streams API, sync-based
Perlude - combines features of the shell / UNIX streams and Haskell, pipeline syntax is "backwards" (same as grep/map chains in Perl)
There are various documents, specifications and discussions relating to the concepts we use. Here's a few:
<TEAM@cpan.org> with contributions from Mohammad S Anwar, Michael Mueller, Zak Elep and Mohanad Zarzour.
Copyright Tom Molesworth 2011-2020. Licensed under the same terms as Perl itself.