class Async::HTTP::Protocol::HTTP2::Output

def close(error = nil)

This method should only be called from within the context of the output task.
def close(error = nil)
	if @stream
		@stream.finish_output(error)
		@stream = nil
	end
end

def initialize(stream, body, trailers = nil)

def initialize(stream, body, trailers = nil)
	@stream = stream
	@body = body
	@trailers = trailers
	
	@task = nil
	
	@window_updated = Async::Condition.new
end

def passthrough(task)

Reads chunks from the given body and writes them to the stream as fast as possible.
def passthrough(task)
	task.annotate("Writing #{@body} to #{@stream}.")
	
	while chunk = @body&.read
		self.write(chunk)
		# TODO this reduces memory usage?
		# chunk.clear unless chunk.frozen?
		# GC.start
	end
	
	self.close
ensure
	@body&.close($!)
	@body = nil
end

def send_data(chunk, maximum_size)

Returns:
  • (String, nil) - any data that could not be written.

Parameters:
  • stream (Stream) -- the stream to use for sending data frames.
  • maximum_size (Integer) -- send up to this many bytes of data.
def send_data(chunk, maximum_size)
	if chunk.bytesize <= maximum_size
		@stream.send_data(chunk, maximum_size: maximum_size)
	else
		@stream.send_data(chunk.byteslice(0, maximum_size), maximum_size: maximum_size)
		
		# The window was not big enough to send all the data, so we save it for next time:
		return chunk.byteslice(maximum_size, chunk.bytesize - maximum_size)
	end
	
	return nil
end

def start(parent: Task.current)

def start(parent: Task.current)
	raise "Task already started!" if @task
	
	if @body.respond_to?(:call)
		@task = parent.async(&self.method(:stream))
	else
		@task = parent.async(&self.method(:passthrough))
	end
end

def stop(error)

This method should only be called from within the context of the HTTP/2 stream.
def stop(error)
	@task&.stop
	@task = nil
end

def stream(task)

def stream(task)
	task.annotate("Streaming #{@body} to #{@stream}.")
	
	input = @stream.wait_for_input
	
	@body.call(Body::Stream.new(input, self))
rescue Async::Stop
	# Ignore.
end

def window_updated(size)

def window_updated(size)
	@window_updated.signal
end

def write(chunk)

def write(chunk)
	until chunk.empty?
		maximum_size = @stream.available_frame_size
		
		while maximum_size <= 0
			@window_updated.wait
			
			maximum_size = @stream.available_frame_size
		end
		
		break unless chunk = send_data(chunk, maximum_size)
	end
end