Curassow is a Swift Nest HTTP Server. It uses the pre-fork worker model and it's similar to Python's Gunicorn and Ruby's Unicorn.
It exposes a Nest-compatible interface for your application, allowing you to use Curassow with any Nest compatible web frameworks of your choice.
To use Curassow, you will need to install it via the Swift Package Manager,
you can add it to the list of dependencies in your Package.swift
:
import PackageDescription
let package = Package(
name: "HelloWorld",
dependencies: [
.Package(url: "https://github.com/kylef/Curassow.git", majorVersion: 0, minor: 1),
]
)
Afterwards you can place your web application implementation in Sources
and add the runner inside main.swift
which exposes a command line tool to
run your web application:
import Curassow
import Inquiline
serve { request in
return Response(.Ok, contentType: "text/plain", body: "Hello World")
}
$ swift build --configuration release
Curassow provides you with a command line interface to configure the address you want to listen on and the amount of workers you wish to use.
$ ./.build/release/HelloWorld --workers 3
[arbiter] Listening on 0.0.0.0:8000
[arbiter] Started worker process 18405
[arbiter] Started worker process 18406
[arbiter] Started worker process 18407
$ ./.build/release/HelloWorld --bind 127.0.0.1:9000
[arbiter] Listening on 127.0.0.1:9000
Curassow supports both Linux and OS X.
Yes, check out the Hello World example.
TTIN and TTOU signals can be sent to the master to increase or decrease the number of workers.
To increase the worker count by one, where $PID is the PID of the master process.
$ kill -TTIN $PID
To decrease the worker count by one:
$ kill -TTOU $PID
Currently, if your code causes a crash, the worker dies and Curassow doesn't yet automatically detect this and spawn new workers, see (#1).
Curassow is licensed under the BSD license. See LICENSE for more info.