///|
/// Decodes a whole Brotli stream held in memory. `max_output` caps the
/// decoded size (unlimited by default) and raises
/// `LimitExceeded({ resource: Output, .. })` past it, with `max_output` (0
/// for a negative one) as the limit; `max_window_bits` and `dictionary` are
/// as for `Decoder`.
pub fn decompress(
input : BytesView,
max_output? : Int32,
max_window_bits~ : Int32 = 24,
dictionary? : Dictionary,
) -> Bytes raise @codec.CodecError {
let decoder = Decoder(max_window_bits~, dictionary?)
let chunk = FixedArray::make(1 << 16, b'\x00')
let out = Buffer()
let mut rest = input
for ;; {
let status = decoder.step_into(rest, chunk, end=true)
rest = rest[decoder.last_consumed():]
let produced = decoder.last_produced()
// `out` holds at most `limit` bytes, so this cannot overflow.
if max_output is Some(limit) && produced > limit - out.length() {
raise @codec.CodecError(
LimitExceeded({
resource: Output,
needed: None,
limit: limit.max(0).to_uint64(),
}),
"the output exceeds \{limit} bytes",
)
}
out.write_bytesview(Bytes::from_array(chunk[:produced])[:])
if status is Done {
return out.to_bytes()
}
}
}