min-stream

A meta-package for min-stream helper modules.

min-stream

A meta-package for min-stream helper modules. This contains several useful and related modules for working with min-streams. Note that implementations of min-stream should not need to depend on this library.

The min-stream system is an interface more than anything. This has three main types: sources, filters, and sinks.

TODO: Explain source

TODO: Explain filter

TODO: Explain sink.

Now that you know what min-streams are, you'll find that working with them directly is sometimes challenging. Their goal was to be minimal and easy to implement. This library makes them easy to use and very powerful as well!

TODO: document the pipe module.

TODO: document the cat module.

TODO: document the merge module.

TODO: document the dup module.

TODO: document the mux module.

TODO: document the demux module.

TODO: Hyperlink these projects or move to wiki.

There are many packaged and modules out there that implement this interface. Some interesting ones are:

  • min-stream-node - A node.js adapter that provides tcp client and server as well as file streams using min-streams.
  • min-stream-uv - A crazy experiment to implement the same interface as min-stream-node, but using node's private internal libuv bindings for maximum speed and unstability.
  • min-stream-chrome - Another implementation of the tcp and fs API, but wrapping chrome packaged apps's special APIs.
  • min-stream-http-codec - A set of filters that makes implementing HTTP server and client programs easy on top of the tcp adapters.
  • js-git - The project that started all this. An implementation of git in JavaScript. Uses min-streams throughout.