madosuki / clack

Web server abstraction layer for Common Lisp

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.

Usage

(defvar *handler*
    (clack:clackup
      (lambda (env)
        (declare (ignore 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*).

Command-line interface

Clack provides a script to start a web server. It's useful when you deploy to production environment.

NOTE: Install Roswell before as it depends on it.

When you execute ros install clack, it copies clackup script to $HOME/.roswell/bin. Make sure the path is in your shell $PATH.

$ ros install clack
$ which clackup
/Users/nitro_idiot/.roswell/bin/clackup

$ cat <<EOF >> app.lisp
(lambda (env)
  (declare (ignore env))
  '(200 (:content-type "text/plain") ("Hello, Clack!")))
EOF
$ clackup app.lisp
Hunchentoot server is started.
Listening on localhost:5000.

Installation

(ql:quickload :clack)

Documentation

• Quickdocs Page

Resources

• How to build a web app with Clack/Lack (1)
• jasom/clack-tutorial

Server

• Hunchentoot
• Wookie
• Toot
• Woo

How to contribute

See CONTRIBUTING.md.

See Also

• Lack: Clack application builder

Author

• Eitaro Fukamachi ([email protected])

Copyright

Copyright (c) 2011 Eitaro Fukamachi & contributors

License

Licensed under the MIT License.