Minimal web framework and middleware for Swift
Swift Objective-C
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
OSX Projects/Kunugi
Sources Nest interface compatibility Jan 15, 2016
.gitignore
LICENSE
Package.swift
README.md

README.md

Kunugi

Kunugi(椚) is minimal web framework and middleware systems for Swift. This is inpired by Node.js' Koa.

Kunugi doesn't provide http server its self. It provides Nest Interface.

See some example projects until documents is done.

Note: This is in early development project.

Usage

Define your context and app.

import Kunugi
import Nest

class Context: ContextBox {
    var context: [ContextType] = []
    var request: Request
    
    var method: Method
    var path: String
    var parameters: [String: String] = [:]
    
    init(request: Request) {
    	self.request = request
    	self.path = request.path
    	self.method = Method(request.method)
    }
}

class App: AppType {

    var wrap: [WrapMiddleware] = []
    var middleware: [MiddlewareType] = []
    
    func use(m: WrapMiddleware) {
        wrap.append(m)
    }
    
    func use(m: MiddlewareType) {
        middleware.append(m)
    }
    
    var application: Application {
    	... // root handler for your server
	}
}

Create your request handler.

// Closure style handler with routes
let router = Router()
router.get("/hello") { ctx in
    return .Respond(Response(.Ok, body: "world"))
}

// Controller style handler
struct HelloController: ControllerMiddleware, AnyRequestHandleable {
    func post(ctx: ContextBox) throws -> MiddlewareResult {
        return .Respond(Response(.Ok, body: "hello world"))
    }
}

Stack your middleware to the app and start your server.

let app = App()

app.use(Logger())
app.use(BodyParser())

app.use(router)
app.use( Route("/helloworld", HelloController()) )

Server(port: 3000, app.application).start()

Requirements

  • Swift 2.1 or Later (includes Linux support)
  • OS X 10.10 or Later

License

MIT