aboutsummaryrefslogtreecommitdiffstats
path: root/devel/p5-POEx-Role-Streaming/pkg-descr
diff options
context:
space:
mode:
Diffstat (limited to 'devel/p5-POEx-Role-Streaming/pkg-descr')
-rw-r--r--devel/p5-POEx-Role-Streaming/pkg-descr13
1 files changed, 13 insertions, 0 deletions
diff --git a/devel/p5-POEx-Role-Streaming/pkg-descr b/devel/p5-POEx-Role-Streaming/pkg-descr
new file mode 100644
index 000000000000..c0dae1c3b909
--- /dev/null
+++ b/devel/p5-POEx-Role-Streaming/pkg-descr
@@ -0,0 +1,13 @@
+POEx::Role::Streaming provides a common idiom for streaming data from
+one filehandle to another. It accomplishes this by making good use of
+sysread and POE::Wheel::ReadWrite. This Role errs on the side of
+doing as many blocking reads of the "input_handle" as possible up
+front (until the high water mark is hit on the Wheel). If this
+default isn't suitable for the consumer, simply override
+"get_data_from_input_handle". After Streamer has exhausted the
+source, and flushed the last of the output, it will clean up after
+itself by closing the wheel, the handles, and sending all of them out
+of scope. If an exception happens, it will clean up after itself, and
+let the DIE signal propagate.
+
+WWW: http://search.cpan.org/dist/POEx-Role-Streaming/