Project

zapp

0.0
No release in over a year
A Web Server based on Ractors, for Rack-based Ruby applications
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

~> 5.5.2
~> 2.2.3
~> 13.0
~> 3.0
 Project Readme

Zapp

CircleCI

Zapp is an experimental web server for Rack-based Ruby applications. It is based on the lightning fast Puma HTTP parser implemented in C, and the new parallelism implementation introduced with CRuby 3.0.0, Ractors

This is an experimental project as Ractors are very very new and the Ractor API may change at any moment. While I would not recommend using this server in production for that reason, if you do decide to do so, pin your ruby version to one of the versions this project is tested against (Currently only version 3.0.0).

Why is it named Zapp with 2 p's you may ask? Because Zap with 1 p was taken.

Also it's meant to be pretty fast

Installation

As a stand-alone ruby executable

gem install zapp

Or using Bundler, add the following to your gemfile

gem("zapp")

And then run

bundle

Usage

The CLI tool is meant to be dead simple, and all configuration should be done through a configuration file. By default Zapp will look for a config file located at ./config/zapp.rb from where the command is run. To change this you can provide the optional -c flag when running the command.

To use a config file at ./configuration/server.rb:

bundle exec zapp -c ./configuration/server.rb

An example config file using Zapp's DSL may look like the following

# frozen_string_literal: true

# A simple web server
class App
  def self.call(_env)
    [200, {}, ["Hello from Zapp"]]
  end
end

# Register the app
app(App)

# Launch 2 parallel Zapp workers
parallelism(2)

# Have Zapp be quiet
# (by default Zapp workers time requests and log when they have been processed)
log_requests(false)

# Let's bind to 0.0.0.0 instead of localhost
# since we may run the server from a Docker container
host("0.0.0.0")

# Use port 8080 (3000 is the default)
port(8080)

Run the app

bundle exec zapp

Implementation details

  • Parsing is done in a single thread
    • Puma's HTTP Parser can not be shared between Ractors, and it cannot be copied to a Ractor so parsing can be done in parallel, I have a suspicion this is due to it being a C extension. If you have any suggestions for how to implement parallel parsing, please file a PR or an issue.
  • Request processing is done in parallel using the Ractor API

TODO

  • Add way more tests to all parts of the library
  • Resolve Rails/Ractor compatibility issues
  • Add thread pool per worker
  • Add some benchmarks against Puma, quite interesting to see how Ractors perform
  • PID file support
  • Support for rack_options