Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Clucumber, the CL Cucumber adapter

This is a (somewhat complete) implementation of the cucumber wire protocol in (as portable as possible) Common Lisp. This means you can write cucumber features, and write lisp code to execute your steps.

Using clucumber

First, install the clucumber gem via rubygems:

gem install clucumber

On the lisp side, clucumber depends on cl-interpol, cl-ppcre, trivial-backtrace, usocket and st-json. All of these are available in quicklisp, and I recommend you use this to manage your lisp libraries.

Getting started

First, you write your cucumber features like you would any other.

Then you define cucumber steps in CL: Just place them in features/step_definitions/*.lisp.

If your application needs any support code, place that in support/*.lisp.

Files in support and step_definitions/ are loaded (not file-compiled) in alphabetical order, with support/ files being loaded before step definitions.

Put a .wire file into your step_definitions dir; I like to name it features/step_definitions/clucumber.wire. See examples/clucumber.wire for one that works for me.

In your features/support/env.rb, you use something like the included example code.

The code in this file will launch a lisp with clucumber loaded (pass :lisp parameter to to specify which lisp, it defaults to sbcl), and (if you used the examples/clucumber.wire file) start listening on port 42427.

Then, on the command line, you run cucumber:

    $ cucumber

And you watch the green or yellow lines zip by.

To see an example of a test suite that uses clucumber, see the features directory in cl-beanstalk. It comes with steps defined in ruby and Common Lisp.


Test drive your Common Lisp application from Cucumber!







No packages published