Skip to main content

behave is behaviour-driven development, Python style

Project description

target: :alt: Travis CI Build Status
Latest PyPI version Number of PyPI downloads

behave is behavior-driven development, Python style.


Behavior-driven development (or BDD) is an agile software development technique that encourages collaboration between developers, QA and non-technical or business participants in a software project.

behave uses tests written in a natural language style, backed up by Python code.

First, install *behave*.

Now make a directory called “features/”. In that directory create a file called “example.feature” containing:

# -- FILE: features/example.feature
Feature: Showing off behave

  Scenario: Run a simple test
    Given we have behave installed
     When we implement 5 tests
     Then behave will test them for us!

Make a new directory called “features/steps/”. In that directory create a file called “” containing:

# -- FILE: features/steps/
from behave import given, when, then, step

@given('we have behave installed')
def step_impl(context):

@when('we implement {number:d} tests')
def step_impl(context, number):  # -- NOTE: number is converted into integer
    assert number > 1 or number == 0
    context.tests_count = number

@then('behave will test them for us!')
def step_impl(context):
    assert context.failed is False
    assert context.tests_count >= 0

Run behave:

$ behave
Feature: Showin off behave # features/example.feature:2

  Scenario: Run a simple test          # features/example.feature:4
    Given we have behave installed     # features/steps/
    When we implement 5 tests          # features/steps/
    Then behave will test them for us! # features/steps/

1 feature passed, 0 failed, 0 skipped
1 scenario passed, 0 failed, 0 skipped
3 steps passed, 0 failed, 0 skipped, 0 undefined

Now, continue reading to learn how to the most of behave. To get started, we recommend the tutorial and then the feature testing language and api references.

More Information

Testing Domains

Behave and other BDD frameworks allow you to provide step libraries to reuse step definitions in similar projects that address the same problem domain.

Support of the following testing domains is currently known:

Testing Domain Name Description
Command-line behave4cmd Test command-line tools, like behave, etc. (coming soon).
Web Apps django-behave Test Django Web apps with behave.
Web, SMS, … behaving Test Web Apps, Email, SMS, Personas (step library).

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for behave, version 1.2.3
Filename, size File type Python version Upload date Hashes
Filename, size behave-1.2.3.tar.gz (336.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page