# Lettuce Behaviour Driven Development for python

######## nutshell ########

install it

    user@machine:~$ [sudo] pip install lettuce

describe your first feature

    Feature: Manipulate strings
      In order to have some fun
      As a programming beginner
      I want to manipulate strings

      Scenario: Uppercased strings
        Given I have the string "lettuce leaves"
        When I put it in upper case
        Then I see the string is "LETTUCE LEAVES"

define its steps

watch it pass

    user@machine:~/Projects/my-project$ lettuce features/

# getting involved !

github project page

Fork it, propose features, explore the code

github.com/gabrielfalcao/lettuce.

feedback

issue tracker.

discuss

- lettuce users mailing list.

- lettuce development mailing list.

hack

:doc:/dev/index

donate

support lettuce development

# hands on!

Is this your first experience with Lettuce ?!?

So, why don't you go straight to the :ref:quick start tutorial <tutorial-simple> ?!

# introduction

what is Lettuce, and what it does

> - :ref:overview <intro-overview>
> - :ref:installation <intro-install>

## what the feature ?!

> - :ref:understand the terms behind Lettuce <intro-wtf>

# walkthrough

> - :ref:write your first feature <tutorial-simple>
> - :ref:handling data with tables <tutorial-tables>
> - :ref:multi-line strings <tutorial-multiline>
> - :ref:don't repeat yourself, meet scenario outlines <tutorial-scenario-outlines>
> - :ref:clean up your spec definitions, calling one step from another <tutorial-steps-from-step-definitions>

# integrate!

> - :ref:Lettuce and Django <recipes-django-lxml>, for the sake of web development fun

# furthermore

reference and concepts

> - :ref:the command line <reference-cli>, how to run lettuce with different verbosity levels, and other cli options
> - :ref:features, scenarios and steps <reference-features>, diving into lettuce's core
> - :ref:terrain, world and hooks <reference-terrain>, stuff about setting up a environment for lettuce
> - :ref:language support <reference-languages>

# recipes

make your own salad

> - :ref:nicer assertions with nose <recipes-nose>