README.markdown

Clack - Web Application Environment for Common Lisp

Clack is a web application environment for Common Lisp inspired by Python's WSGI and Ruby's Rack. Your awesome framework should base on this.

Usage

(defpackage simple-app
  (:use :cl
        :clack))
(in-package :simple-app)

(defvar *handler*
    (clackup
      #'(lambda (env)
          '(200 (:content-type "text/plain") ("Hello, Clack!")))))

Open your web browser and go to http://localhost:5000/. You should get "Hello, Clack!".

To stop the server, use (clack:stop *handler*).

Installation

Clack is available on Quicklisp.

(ql:quickload :clack)

Documentation

• Tutorial
• Quickdocs Page

Server

• Hunchentoot
• Apache2 (mod_lisp2)
• FastCGI
• Toot

Middleware

Middleware is a type of Clack components, which modifies the behavior of a Clack application without modifing the Clack application's code.

Bundle Middleware

• Clack.Middleware.Static - returns static files
• Clack.Middleware.Logger - logs messages
• Clack.Middleware.Session - manages sessions
• Clack.Middleware.Conditional - enables a middleware to conditionally wraps components
• Clack.Middleware.Auth.Basic - provides basic authentication

Contrib Middleware

• Clack.Middleware.Dbi - manages CL-DBI connections
• Clack.Middleware.Csrf - provides an easy way to protect an application from CSRF attacks
• Clack.Middleware.Clsql - manages CLSQL connections
• Clack.Middleware.Postmodern - manages POSTMODERN connections
• Clack.Middleware.Rucksack - wraps Rucksack transaction.
• Clack.Middleware.OAuth - provides OAuth authorization

Author

• Eitarow Fukamachi ([email protected])

Copyright

Copyright (c) 2011-2014 Eitarow Fukamachi

Contributors

• https://github.com/fukamachi/clack/graphs/contributors

License

Licensed under the LLGPL License.