Skip to main content

Implements Gherking language for REST services.

Project description

Build Status

Behave Restful is a Behavior Driven Development (BDD) framework based on behave, that implements a language suitable to test and validate REST APIs and Services. It leverages the power of the gherkin language to write business readable tests that validate the behavior of REST APIs.

Although, Behave Restful is implemented in python and uses behave as underlying framework, it can test services implemented in any language as easy as:

Feature: API to add a new book to our collection
    As a user, I want to add a new book to my "to-read" collection.

    Scenario: Add a new book to collection.
        Given a request url http://my.reads/api/books
            And a request json payload
                    "category": "reference",
                    "author": "Nigel Rees",
                    "title": "Sayings of the Century",
                    "price": 8.95,
                    "status": "to-read"
        When the request sends POST
        Then the response status is CREATED
            And the response json matches
                    "title": "BookObject",
                    "type": "object"
                    "properties": {
                        "id": {"type": "number"},
                        "category": {"type": "string"},
                        "author": {"type": "string"},
                        "title": {"type": "string"},
                        "price": {"type": "number"},
                        "status": {"type": "string", "enum": ["to-read", "reading", "read"]}
                    "required": ["id", "category", "title"]
            And the response json at $.id is equal to 100
            And the response json at $.category is equal to "reference"
            And the response json at $.title is equal to "Sayings of the Century"

As you can see in the example, we send a POST request to the specified url with a JSON payload, and we can validate the result very easy. First, we verify that the status of the response is CREATED (it succeeds). Then we validate the response JSON body using the expected JSON Schema. Finally, we validate specific values in the response using JSONPath


Use pip to install behave-restful in your project

pip install behave-restful


To add support for behave-restful steps in your .feature files, you need to include behave-restful’s environment and step definitions.

You can do this simply by adding two boilerplate files to your project:

In the root of your features directory, add this file:

# {your_project}/features/en/

import os

import as br_app

def before_all(context):
    this_directory = os.path.abspath(os.path.dirname(__file__))
    br_app.BehaveRestfulApp().initialize_context(context, this_directory)
    context.hooks.invoke(br_app.BEFORE_ALL, context)

def after_all(context):
    context.hooks.invoke(br_app.AFTER_ALL, context)

def before_feature(context, feature):
    context.hooks.invoke(br_app.BEFORE_FEATURE, context, feature)

def after_feature(context, feature):
    context.hooks.invoke(br_app.AFTER_FEATURE, context, feature)

def before_scenario(context, scenario):
    context.hooks.invoke(br_app.BEFORE_SCENARIO, context, scenario)

def after_scenario(context, scenario):
    context.hooks.invoke(br_app.AFTER_SCENARIO, context, scenario)

def before_step(context, step):
    context.hooks.invoke(br_app.BEFORE_STEP, context, step)

def after_step(context, step):
    context.hooks.invoke(br_app.AFTER_STEP, context, step)

def before_tag(context, tag):
    context.hooks.invoke(br_app.BEFORE_TAG, context, tag)

def after_tag(context, tag):
    context.hooks.invoke(br_app.AFTER_TAG, context, tag)

And under features/steps add this file:

# {your_project}/features/steps/
from behave_restful.lang import *

Project details

Download files

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

Files for behave-restful, version 0.4.0
Filename, size File type Python version Upload date Hashes
Filename, size behave_restful-0.4.0-py2.py3-none-any.whl (19.1 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size behave-restful-0.4.0.tar.gz (12.8 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page