bkutil/filament

HTTP server + reactor + fiber loop handler

Filament

• Reactor + IO.select based demuxer
• Event handler base class using Fibers
• HTTP server

To do

HTTP

• Rack interface (How does rack handle posts payload?)
• Correct POST / GET payload handling.
• Support for chunked encoding.

Code

• MRB gem.
• Perhaps split into separate gems.

Sockets

• Learn about socket options.
• Check correct connection handling with tcpdump.

Dependencies

• iij/mruby-env - ENV object for mruby
• Asmod4n/mruby-phr - mruby wrapper for https://github.com/h2o/picohttpparser
• mruby-socket
• mruby-io

Links & resources

MRuby

• Mgem list - A list of all GEMs for mruby to be managed by mgem
• katzer/mruby-logger - A simple but sophisticated logging utility that you can use to output messages

Sockets

• Detecting close 1
• Detecting close 2
• Detection of Half-Open (Dropped) TCP/IP Socket Connections
• Ruby TCPServer documentation
• Ruby IO documentation
• Unicorn HTTP detecting socket options
• mruby-io

Reactor

• Reactor gem - Pure Ruby implementation.
• Reactor paper - Reactor - An Object Behavioral Pattern for Demultiplexing and Dispatching Handles for Synchronous Events (Douglas C. Schmidt)
• Socketry Async Reactor
• Reactor pattern wikipedia
• Nio4 selector

HTTP

• Chunked transfer encoding
• Pico HTTP Parser MRI Ruby gem
• Ruby webrick HTTP server
• MRuby simple http server
• MRuby Phr - pico http parser
• rack/rack
• SO - How are parameters sent in an HTTP POST request?
• Puma rack handler
• Simple HTTP parsing example
• postmodern/net-http-server
• appsignal - building a http server
• rack wikipedia

Fibers

• Ruby Fiber documentation
• Fiberchat - A naive socket chat using select() and ruby fibers.