uplex

µPlex

Tiny, fast multiplexer

Why?

I took a look at current multiplexers and found them to complicated. That's why.

API

uplex(conn):

• Creates a new uplex instance
• conn: pull-stream duplex stream
• Returns Uplex muxer

.createConnection()

• Creates a new muxed ready-to-use duplex connection
• Returns Duplex

.stop(force)

• Stops the multiplexer
• force: Boolean to force-close even with open connections
• Returns undefined
• Throws if there are open connections and force is false

.on('conn', conn => {}):

• Event that gets emitted when the other side creates a duplex

Libp2p integration

Simply require uplex/libp2p and add it under connection.streamMuxer

Benchmarks (run node bench && TINY_CHUNKS=1 node bench)

Machine used: Ubuntu 16.04 amd64, Node v10.8.0, CPU AMD FX-6300

Big chunks:

Muxer#spdy x 8.59 ops/sec ±1.22% (44 runs sampled)
Muxer#mplex x 4.31 ops/sec ±2.11% (15 runs sampled)
Muxer#uplex x 21.78 ops/sec ±1.21% (30 runs sampled)
Fastest is Muxer#uplex

Small chunks:

Muxer#spdy x 7.52 ops/sec ±2.44% (40 runs sampled)
Muxer#mplex x 4.54 ops/sec ±5.64% (26 runs sampled)
Muxer#uplex x 13.67 ops/sec ±1.24% (65 runs sampled)
Fastest is Muxer#uplex