teepeedee2

teepeedee2 
================================

Homepage
--------
See http://common-lisp.net/projects/teepeedee2.

What's this?
--------

teepeedee2 is a webapplication framework for dynamic webpages. It's
goal is to be fast. It only works on Linux.

Quickstart
--------

You need SBCL. On Ubuntu or Debian

    $ sudo apt-get install sbcl

Untar or git clone

      $ git clone git://github.com/vii/teepeedee2.git

      $ cd teepeedee2

Start sbcl and run the quickstart.lisp
      
      $ sbcl --load quickstart.lisp

This will download the following packages with asdf-install, and their
dependencies: iterate cffi cl-irregsexp trivial-backtrace

Note that it DISABLES the GPG signature checking! You will be running
UNVERIFIED CODE.

	      It will try to download the following packages with 
	      Install where?
	      1) System-wide install: 
	         System in /usr/lib/sbcl/site-systems/
	         Files in /usr/lib/sbcl/site/ 
	      2) Personal installation: 
	         System in /home/username/.sbcl/systems/
	         Files in /home/username/.sbcl/site/ 
	       --> 

Enter "2" and press enter.

Lots of downloading and compiling will occur.

Then visit http://localhost:8080/hello

You can now enter new pages at the SBCL REPL

    * (in-package #:teepeedee2.quickstart)

    * (defpage "/goodbye" ((name "Friend"))
    		(<div (<h1 "Bye bye " name) (<p "The universal time is " (get-universal-time))))


Benchmarking
--------

	(in-package #:tpd2)
	(defpage "/test" (name) :create-frame nil
	    (tpd2.ml.html:<h1 "Hello " name))

	(http-start-server 8080)

	(event-loop)

Use apachebench

	$ ab -n 100000 -c10 http://127.0.0.1:8080/test?name=John



More info
--------

This webserver is not finished and I wrote it to learn and experiment
with Common Lisp. There is a lot to be tidied up, now I know the
language better. If you have any interest in using it, please get in
touch with me, John Fremlin <john@freml.in>, or
http://john.fremlin.org/contact.html

It is faster than all(?) other web application frameworks for serving
small dynamic webpages. Please let me know if you have a case where
another framework is faster!

You can see benchmarks comparing it to other web application platforms
like PHP and Rails in this presentation
http://tlug.jp/meetings/2008/11/serving-dynamic-webpages-in-less-then-a-millisecond_john-fremlin_handout.pdf

You can see an example of it running a blog on http://john.freml.in.

It is designed so that small fragments of JavaScript can be delivered
at low overhead to many clients.

However, it also includes general support libraries for quickly
generating XML/HTML (tpd2.ml2), for doing fast networking in a
continuation passing style, i.e. fast event driven userspace
threading (tpd2.io).

Note that it trusts the last value of X-Forwarded-For.

For an example application, loaded by default, see the src/game directory.

The addons/ directory contains a few of the other projects (but not
all) that teepeedee2 depends on. They are released under their own
licence.

The licence for most of tpd2 is the Lisp LGPL. However, I take no profit
from making this, and request that if you make an application with it,
please release the source so others can learn from it. Don't be
selfish!

It runs on SBCL and ClozureCL. It shouldn't be hard to port to other
modern Common Lisps.


alexandria

cffi

cl-cont

cl-irregsexp

iterate

parenscript

trivial-backtrace

trivial-garbage

fiveam

teepeedee2-test

teepeedee2

Upstream URL

Author

License

teepeedee2

Version:

Authors:

Dependencies:

teepeedee2-test

Version:

Authors:

Dependencies:

Dependencies (9)

Dependents (0)