clack

2024-10-12

Web application environment for Common Lisp

Upstream URL

github.com/fukamachi/clack

Author

Eitaro Fukamachi

License

MIT
README

Clack - Web Application Environment for Common Lisp

Build Status Coverage Status Quicklisp dist

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

Resources

Server

How to contribute

See CONTRIBUTING.md.

See Also

  • Lack: Clack application builder

Author

Copyright

Copyright (c) 2011 Eitaro Fukamachi & contributors

License

Licensed under the MIT License.

Dependencies (21)

  • alexandria
  • babel
  • bordeaux-threads
  • cl-async
  • cl-ppcre
  • dexador
  • fast-http
  • fast-io
  • flexi-streams
  • http-body
  • hunchentoot
  • ironclad
  • lack
  • quri
  • rove
  • slime
  • split-sequence
  • toot
  • uiop
  • usocket
  • wookie
  • GitHub
  • Quicklisp