Skip to content

Duct module for running web applications

Notifications You must be signed in to change notification settings

biotz/module.web

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Duct module.web

Build Status

A Duct module that adds a web server and useful middleware to a configuration. This is the basis of all web applications built with Duct.

Installation

To install, add the following to your project :dependencies:

[duct/module.web "0.7.0"]

Usage

To add this module to your configuration, add a reference to :duct.module.web/api if you want to develop a web service:

{:duct.core/project-ns foo
 :duct.module.web/api  {}}

Or :duct.module.web/site if you want to develop a user-facing web application:

{:duct.core/project-ns foo
 :duct.module.web/site {}}

Or :duct.module/web if you want the bare-bones approach and want to handle most things yourself.

Note that the :duct.core/project-ns key must also be set, to allow the module to find the right resources.

By default, the module uses the :duct.server.http/jetty key for the webserver, as supplied by the server.http.jetty library. However, if a key deriving from :duct.server/http already exists in the configuration, the module will use that instead.

Similarly, the module includes the :duct.router/cascading key for routing. This is a simple router that takes an ordered vector of handlers, and will return the first non-nil response for a given request.

For example:

{:duct.router/cascading [#ig/ref :foo.endpoint/example1
                         #ig/ref :foo.endpoint/example2]
 :foo.endpoint/example1 {}
 :foo.endpoint/example2 {}}

If a key deriving from :duct/router exists in the configuration already, then that is used instead.

License

Copyright © 2017 James Reeves

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.

About

Duct module for running web applications

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Clojure 91.3%
  • CSS 4.7%
  • HTML 4.0%