1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
|
Metadata-Version: 1.2
Name: behave
Version: 1.2.6
Summary: behave is behaviour-driven development, Python style
Home-page: http://github.com/behave/behave
Author: Jens Engel, Benno Rice and Richard Jones
Author-email: behave-users@googlegroups.com
License: BSD
Description-Content-Type: UNKNOWN
Description: .. image:: https://img.shields.io/travis/behave/behave/master.svg
:target: https://travis-ci.org/behave/behave
:alt: Travis CI Build Status
.. image:: https://readthedocs.org/projects/behave/badge/?version=latest
:target: http://behave.readthedocs.io/en/latest/?badge=latest
:alt: Documentation Status
.. image:: https://img.shields.io/pypi/v/behave.svg
:target: https://pypi.python.org/pypi/behave
:alt: Latest Version
.. image:: https://img.shields.io/pypi/dm/behave.svg
:target: https://pypi.python.org/pypi/behave
:alt: Downloads
.. image:: https://img.shields.io/pypi/l/behave.svg
:target: https://pypi.python.org/pypi/behave/
:alt: License
.. image:: https://badges.gitter.im/Join%20Chat.svg
:alt: Join the chat at https://gitter.im/behave/behave
:target: https://gitter.im/behave/behave?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge
.. |logo| image:: https://raw.github.com/behave/behave/master/docs/_static/behave_logo1.png
behave is behavior-driven development, Python style.
|logo|
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:
.. code-block:: gherkin
# -- 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 "example_steps.py" containing:
.. code-block:: python
# -- FILE: features/steps/example_steps.py
from behave import given, when, then, step
@given('we have behave installed')
def step_impl(context):
pass
@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:
.. code-block:: bash
$ behave
Feature: Showing off behave # features/example.feature:2
Scenario: Run a simple test # features/example.feature:4
Given we have behave installed # features/steps/example_steps.py:4
When we implement 5 tests # features/steps/example_steps.py:8
Then behave will test them for us! # features/steps/example_steps.py:13
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 get the most out of *behave*. To get started,
we recommend the `tutorial`_ and then the `feature testing language`_ and
`api`_ references.
.. _`Install *behave*.`: http://pythonhosted.org/behave/install.html
.. _`tutorial`: http://pythonhosted.org/behave/tutorial.html#features
.. _`feature testing language`: http://pythonhosted.org/behave/gherkin.html
.. _`api`: http://pythonhosted.org/behave/api.html
More Information
-------------------------------------------------------------------------------
* `behave documentation`_: `latest edition`_, `stable edition`_, `PDF`_
* `behave.example`_: Behave Examples and Tutorials (docs, executable examples).
* `changelog`_ (latest changes)
.. _behave documentation: http://behave.readthedocs.io/
.. _changelog: https://github.com/behave/behave/blob/master/CHANGES.rst
.. _behave.example: https://github.com/behave/behave.example
.. _`latest edition`: http://behave.readthedocs.io/en/latest/
.. _`stable edition`: http://behave.readthedocs.io/en/stable/
.. _PDF: https://media.readthedocs.org/pdf/behave/latest/behave.pdf
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.6
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: Jython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Topic :: Software Development :: Testing
Classifier: License :: OSI Approved :: BSD License
Provides: behave
Provides: setuptools_behave
Requires-Python: >=2.6, !=3.0.*, !=3.1.*, !=3.2.*
|
