kemal/README.md
Sdogruyol d50d305e99 v0.4.0
- Built-in super simple & fast  WebSocket support
- Remove experimental fork mode
- Improve view macros (Thanks @f)
2015-12-19 10:05:28 +02:00

1.9 KiB

# Kemal [![Build Status](https://travis-ci.org/sdogruyol/kemal.svg?branch=master)](https://travis-ci.org/sdogruyol/kemal)

Join the chat at https://gitter.im/sdogruyol/kemal

Lightning Fast, Super Simple web framework for Crystal. Inspired by Sinatra but with superior performance and built-in WebSocket support.

Kemal is under heavy development and currently supports Crystal 0.9.1.

Super Simple <3

require "kemal"

# Matches GET "http://host:port/"
get "/" do
  "Hello World!"
end

# Creates a WebSocket handler.
# Matches "ws://host:port/socket"
ws "/socket" do |socket|
  socket.send "Hello from Kemal!"
end

Build and run!

crystal run src/kemal_sample.cr

Go to http://localhost:3000

Check documentation or samples for more.

Super Fast <3

Numbers speak louder than words.

Framework Request Per Second Avg. Response Time
Kemal (Production) 64986 170μs
Sinatra (Thin) 2274 43.82ms

These results were achieved with wrk on a Macbook Pro Late 2013. (2Ghz i7 8GB Ram OS X Yosemite)

Features

  • Support all REST verbs
  • Websocket support
  • Request/Response context, easy parameter handling
  • Middlewares
  • Built-in JSON support
  • Built-in static file serving
  • Built-in view templating via ecr

Documentation

You can read the documentation under docs folder.

Thanks

Thanks to Manas for their awesome work on Frank.