Skip to content
tmcgilchristPublic

About

Helium + Webmachine = Airship. A toolkit for building declarative, RESTful web apps.

Topics

Resources

Stars

245 stars

Watchers

34 watching

Forks

Latest commit

 

History

341 Commits

Folders and files

Repository files navigation

Airship

GitHub CI docs

Airship is a Haskell library for handling and serving HTTP requests in a RESTful fashion. It is heavily inspired by Webmachine and works with any WAI-compatible web server such as Warp.

It aims to be small, fast, and flexible.

How does it work?

Airship resources are represented with a Resource record type. Each field in Resource corresponds to an action taken in the Webmachine decision tree. Airship provides a defaultResource with sensible defaults for each of these actions; you build web services by overriding fields in the default resource with your own.

Routes are declared with a simple monadic syntax:

routes = do
    root                        #> someRootResource
    "account" </> var "name"    #> accountResource

For a simple example that handles HTTP GET and POST requests, please check example/Basic.hs. For a slightly more involved example that generates HTML and manages a pool of resources, please check the blimp repository.

Airship is copyright © 2015 Helium Systems, Inc., and released to the public under the terms of the MIT license.

About

Helium + Webmachine = Airship. A toolkit for building declarative, RESTful web apps.

Topics

Resources

Stars

245 stars

Watchers

34 watching

Forks

Releases

Packages

Used by

Contributors

Languages