summaryrefslogtreecommitdiff
path: root/ruby_1_9_3/ext/psych/lib/psych/stream.rb
diff options
context:
space:
mode:
Diffstat (limited to 'ruby_1_9_3/ext/psych/lib/psych/stream.rb')
-rw-r--r--ruby_1_9_3/ext/psych/lib/psych/stream.rb36
1 files changed, 36 insertions, 0 deletions
diff --git a/ruby_1_9_3/ext/psych/lib/psych/stream.rb b/ruby_1_9_3/ext/psych/lib/psych/stream.rb
new file mode 100644
index 0000000000..567c1bb790
--- /dev/null
+++ b/ruby_1_9_3/ext/psych/lib/psych/stream.rb
@@ -0,0 +1,36 @@
+module Psych
+ ###
+ # Psych::Stream is a streaming YAML emitter. It will not buffer your YAML,
+ # but send it straight to an IO.
+ #
+ # Here is an example use:
+ #
+ # stream = Psych::Stream.new($stdout)
+ # stream.start
+ # stream.push({:foo => 'bar'})
+ # stream.finish
+ #
+ # YAML will be immediately emitted to $stdout with no buffering.
+ #
+ # Psych::Stream#start will take a block and ensure that Psych::Stream#finish
+ # is called, so you can do this form:
+ #
+ # stream = Psych::Stream.new($stdout)
+ # stream.start do |em|
+ # em.push(:foo => 'bar')
+ # end
+ #
+ class Stream < Psych::Visitors::YAMLTree
+ class Emitter < Psych::Emitter # :nodoc:
+ def end_document implicit_end = !streaming?
+ super
+ end
+
+ def streaming?
+ true
+ end
+ end
+
+ include Psych::Streaming
+ end
+end