amphp/byte-stream

• Fixed throwing an Error when invoking getStdin(), getStdout(), and getStderr() if the corresponding STDIO stream had been previously closed. Instead, an already closed stream instance is returned.

• Fixed ReadableResourceStream calling Suspension::resume() when destroyed, which could throw an exception when suspending from {main} and an uncaught exception was thrown from the event loop.

Initial stable release compatible with AMPHP v3 and fibers.

There are a number of renaming and compatibility breaks with 1.x versions:

• Added interface ResourceStream
• InputStream has been renamed to ReadableStream and now extends Amp\Closable. The read() method now supports an optional Cancellation parameter.
• OutputStream has been renamed to WritableStream and now extends Amp\Closable. WritableStream::end() no longer accepts an optional data chunk as parameter.
• IteratorStream has been repalced by ReadableIterableStream, which accepts any iterable of strings (particularly useful with Generator or Pipeline).
• ResourceInputStream has been renamed to ReadableResourceStream. The read() method has an additional, optional $limit parameter to specify the maximum number of bytes to read.
• ResourceOutputStream has been renamed to WritableResourceStream.
• InMemoryStream has been renamed to ReadableBuffer.
• OutputBuffer has been renamed to WritableBuffer.
• Payload now accepts a string in addition to a ReadableStream and is final now. Payload::buffer() may only be called once.
• Added a $limit param to Amp\ByteStream\buffer() and Payload::buffer() to set a limit on the maximum bytes that can be buffered.
• Added BufferedReader, a helper class for reading from ReadableStream using fixed lengths or delimiters found within the stream (#94)
• Added Pipe.
• Added StreamChannel implementing the Channel interface from amphp/sync.
• The zlib streams have been moved into the Compression sub-namespace and renamed to CompressingWritableStream and DecompressingReadableStream.
• Add CompressingReadableStream (#99)
• Add DecompressingWritableStream (#99)
• The base64 streams have been renamed to reflect the new interface names.
• InputStreamChain has been renamed to ReadableStreamChain.
• Renamed the $options param of parseLineDelimitedJson to $flags to match the json_decode function.

What's Changed

• Iterator Stream documentation by @tncrazvan in #80
• Add psalm.xml and .github configs to .gitattributes by @sidz in #85
• Update https instead of http in composer.json by @S-Tian86 in #88
• Fix psalm annotation by @sokil in #98
• Add explicit nullable types by @alexandre-daubois in #111

New Contributors

• @tncrazvan made their first contribution in #80
• @sidz made their first contribution in #85
• @S-Tian86 made their first contribution in #88
• @sokil made their first contribution in #98
• @alexandre-daubois made their first contribution in #111

Full Changelog: v1.8.1...v1.8.2