Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
tree: 4d4ca9d3c2
Fetching contributors…

Cannot retrieve contributors at this time

83 lines (65 sloc) 2.236 kb

Hinge. A synonym for node.

Something resembling an evented framework for Common Lisp.

Driven by libev, like the cool kids.


Clone and init the project

# Clone the repo
$ git clone
$ cd hinge

# Init the enviornment
$ make develop

Fire up the REPL and evaluate the following. It should boot up and keep running an echo server on port 4545

(ql:quickload :hinge)
(in-package :hinge)

(let ((server (make-instance 'server)))
  (add-listener server "listening"
                (lambda (server)
                  (format t "~A is listening!~%" server)))

  (add-listener server "connection"
                (lambda (peer)
                  (format t "New client: ~A~%" peer)

                  (add-listener peer "data"
                                (lambda (data)
                                  (format t "Echoing: ~S~&" (babel:octets-to-string data))
                                  (send peer data
                                        (lambda (sock)
                                          (format t "Data written to peer.~&")))))

                  (add-listener peer "close"
                                (lambda (sock)
                                  (format t "Peer: ~A left.~%" sock)))))

  (bind server 4545))

  (format t "Starting echo server at ~A~%" (get-universal-time))

This should print some information stating the server is running and listening. From another shell you should now be able to communicate with the echo server by connecting to TCP port 4545 and sending data.

$ nc localhost 4545
Hello World.
Hello World. # Output
Echo # Output

You can watch the server react in the REPL. Somewhat like this:

Starting echo server at 3541190006
#<SERVER {1007B10003}> is listening!
New client: #<SOCKET {10053E2B03}>
Echoing: "Hello World.
Invoking callback: #<FUNCTION (LAMBDA (SOCK)) {1007E0DD2B}>
Data written to peer.
Socket drained: #<SOCKET {10053E2B03}>
Echoing: "Echo
Invoking callback: #<FUNCTION (LAMBDA (SOCK)) {1007E0DD2B}>
Data written to peer.
Socket drained: #<SOCKET {10053E2B03}>
Peer: #<SOCKET {10053E2B03}> left.
Jump to Line
Something went wrong with that request. Please try again.