« Changelog History


streaming-concurrency v0.3.0.0 Release Notes

Release Date: 2017-07-05 // almost 7 years ago

    • ✂ Removed support for streaming ByteStrings.

      The ByteString-related functions which were previously implemented are broken conceptually and should not be used.

      A ByteString consists of a stream of bytes; the meaning of each byte is dependent upon its position in the overall stream.

      In terms of implementation, these bytes are accumulated into chunks, each of which may very well be of a different size.

      As such, if such a chunk is fed into a buffer with multiple readers, then there is no guarantee which reader will actually receive it or if it makes sense about what it is in isolation (e.g. it could be split mid-word, or possibly even in the middle of a Unicode character).

      If, however, multiple ByteStrings are fed into a buffer with a single reader, the order it has when coming out is similarly undeterministic: it isn't possible to coherently ensure the sanity of the resulting ByteString.

      As such, unless you really want to consider it as a stream of raw 8-bit numbers, trying to do any concurrency with a ByteString will only lead to trouble. If you do need such functionality, you can implement it yourself using buffers containing Word8 values (in which case you can use Data.ByteString.Streaming.unpack).

    • 🛠 Fix lower bound of lifted-async (replicateConcurrently_ was added in 0.9.3).