pytest-bdd

Added

Changed

• Step arguments "datatable" and "docstring" are now reserved, and they can't be used as step argument names. An error is raised if a step parser uses these names.

• Scenario description field is now set for Cucumber JSON output.

Deprecated

Removed

Fixed

• Fixed an issue with the upcoming pytest release related to the use of @pytest.mark.usefixtures with an empty list.

• Render template variables in docstrings and datatable cells with example table entries, as we already do for steps definitions.

Security

Added

• Gherkin keyword aliases can now be used and correctly reported in json and terminal output (see Keywords for permitted list).

• Added localization support. The language of the feature file can be specified using the # language: <language> directive at the beginning of the file.

• Rule keyword can be used in feature files (see Rule)

• Added support for multiple example tables

• Added filtering by tags against example tables

• Since the 7.x series: * Tags can now be on multiple lines (stacked) * Continuation of steps using asterisks (*) instead of And/But supported. * Added datatable argument for steps that contain a datatable (see Data Tables). * Added docstring argument for steps that contain a docstring (see Doc Strings).

Changed

• Changelog format updated to follow Keep a Changelog.

• Text after the # character is no longer stripped from the Scenario and Feature name.

• Since the 7.x series:

  • Use the gherkin-official parser, replacing the custom parsing logic. This will make pytest-bdd more compatible with the Gherkin specification.

  • Multiline steps must now always use triple-quotes for the additional lines.

  • All feature files must now use the keyword Feature: to be considered valid.

  • Tags can no longer have spaces (e.g. @tag one and @tag two are no longer valid).

  • Text after the # character is no longer stripped from the Step name.

  • Multiline strings no longer match name based on multiple lines - only on the actual step text on the step line.

Removed

• Dropped support for python 3.8. Supported python versions: 3.9, 3.10, 3.11, 3.12, 3.13.

• Since the 7.x series:

  • Drop compatibility with pytest < 7.0.0.

Fixed

• Since the 7.x series:

  • Updated documentation to clarify that --gherkin-terminal-reporter needs to be used with -v or -vv.

• Updated documentation to clarify that --gherkin-terminal-reporter needs to be used with -v or -vv.

• Drop compatibility with pytest < 7.0.0.

• Continuation of steps using asterisks instead of And/But supported.

• Added datatable argument for steps that contain a datatable (see Data Tables).

• Added docstring argument for steps that contain a docstring (see Doc Strings).

• Multiline strings no longer match name based on multiple lines - only on the actual step text on the step line.

Bump version to 8.0.0b1

• Fix an issue when only the first Step would inject a fixture, while later steps would not be able to.

• Test against the latest versions of pytest (8.2, 8.3).

Bump version 7.2.0, add changelog entry

• Address another compatibility issue with pytest 8.1 (fixture registration). #680

• Address a bug introduced in pytest-bdd 7.1 caused by incorrect pytest version check.

• Address compatibility issue with pytest 8.1. #666

• Fix errors occurring if pytest_unconfigure is called before pytest_configure. #362 #641

• ⚠️ Backwards incompatible: - parsers.re now does a fullmatch instead of a partial match. This is to make it work just like the other parsers, since they don't ignore non-matching characters at the end of the string. #539

• Drop python 3.7 compatibility, as it's no longer supported. #627

• Declare official support for python 3.12 #628

• Improve parser performance by 15% #623 by @dcendents

• Add support for Scenarios and Scenario Outlines to have descriptions. #600

• Fix regression introduced in version 6.1.0 where the pytest_bdd_after_scenario hook would be called after every step instead of after the scenario. #577

• Fix bug where steps without parsers would take precedence over steps with parsers. #534

• Step functions can now be decorated multiple times with @given, @when, @then. Previously every decorator would override converters and target_fixture every at every application. #534 #544 #525

• Require pytest>=6.2 #534

• Using modern way to specify hook options to avoid deprecation warnings with pytest >=7.2.

• Add generic step decorator that will be used for all kind of steps #548

• Add stacklevel param to given, when, then, step decorators. This allows for programmatic step generation #548

• Hide pytest-bdd internal method in user tracebacks #557.

• Make the package PEP 561-compatible #559 #563.

• Configuration option bdd_features_base_dir is interpreted as relative to the pytest root directory (previously it was relative to the current working directory). #573

• Fix regression introduced in 6.0.0 where a step function decorated multiple using a parsers times would not be executed correctly. #530 #528

This release introduces breaking changes in order to be more in line with the official gherkin specification.

• Cleanup of the documentation and tests related to parametrization (elchupanebrej) #469

• Removed feature level examples for the gherkin compatibility (olegpidsadnyi) #490

• Removed vertical examples for the gherkin compatibility (olegpidsadnyi) #492

• Step arguments are no longer fixtures (olegpidsadnyi) #493

• Drop support of python 3.6, pytest 4 (elchupanebrej) #495 #504

• Step definitions can have "yield" statements again (4.0 release broke it). They will be executed as normal fixtures: code after the yield is executed during teardown of the test. (youtux) #503

• Scenario outlines unused example parameter validation is removed (olegpidsadnyi) #499

• Add type annotations (youtux) #505

• pytest_bdd.parsers.StepParser now is an Abstract Base Class. Subclasses must make sure to implement the abstract methods. (youtux) #505

• Angular brackets in step definitions are only parsed in "Scenario Outline" (previously they were parsed also in normal "Scenario"s) (youtux) #524.

This release introduces breaking changes, please refer to the Migration from 4.x.x.

• Rewrite the logic to parse Examples for Scenario Outlines. Now the substitution of the examples is done during the parsing of Gherkin feature files. You won't need to define the steps twice like @given("there are <start> cucumbers") and @given(parsers.parse("there are {start} cucumbers")). The latter will be enough.

• Removed example_converters from scenario(...) signature. You should now use just the converters parameter for given, when, then.

• Removed --cucumberjson-expanded and --cucumber-json-expanded options. Now the JSON report is always expanded.

• Removed --gherkin-terminal-reporter-expanded option. Now the terminal report is always expanded.

• when and then steps now can provide a target_fixture, just like given does. Discussion at https://github.com/pytest-dev/pytest-bdd/issues/402.

• Drop compatibility for python 2 and officially support only python >= 3.6.

• Fix error when using --cucumber-json-expanded in combination with example_converters (marcbrossaissogeti).

• Fix --generate-missing not correctly recognizing steps with parsers

• Fix a bug that prevents using comments in the Examples: section. (youtux)

• Fixed performance regression introduced in 4.0.0 where collection time of tests would take way longer than before. (youtux)

This release introduces breaking changes, please refer to the Migration from 3.x.x.

• Strict Gherkin option is removed (@scenario() does not accept the strict_gherkin parameter). (olegpidsadnyi)

• @scenario() does not accept the undocumented parameter caller_module anymore. (youtux)

• Given step is no longer a fixture. The scope parameter is also removed. (olegpidsadnyi)

• Fixture parameter is removed from the given step declaration. (olegpidsadnyi)

• pytest_bdd_step_validation_error hook is removed. (olegpidsadnyi)

• Fix an error with pytest-pylint plugin #374. (toracle)

• Fix pytest-xdist 2.0 compatibility #369. (olegpidsadnyi)

• Fix compatibility with pytest 6 --import-mode=importlib option. (youtux)

• Parse multiline steps according to the gherkin specification #365.

• Drop support for pytest < 4.3.

• Fix a Python 4.0 bug.

• Fix pytest --generate-missing functionality being broken.

• Fix problematic missing step definition from strings containing quotes.

• Implement parsing escaped pipe characters in outline parameters (Mark90) #337.

• Disable the strict Gherkin validation in the steps generation (v-buriak) #356.

• Fix regression introduced in 3.2.0 where pytest-bdd would break in presence of test items that are not functions.

• Fix Python 3.8 support

• Remove code that rewrites code. This should help with the maintenance of this project and make debugging easier.

• Allow unicode string in @given() step names when using python2. This makes the transition of projects from python 2 to 3 easier.

• Drop support for pytest < 3.3.2.

• Step definitions generated by $ pytest-bdd generate will now raise NotImplementedError by default.

• @given(...) no longer accepts regex objects. It was deprecated long ago.

• Improve project testing by treating warnings as exceptions.

• pytest_bdd_step_validation_error will now always receive step_func_args as defined in the signature.

• Add compatibility with pytest 4.2 (sliwinski-milosz) #288.

• Minimal supported version of pytest is now 2.9.0 as lower versions do not support bool type ini options (sliwinski-milosz) #260

• Fix RemovedInPytest4Warning warnings (sliwinski-milosz) #261.

• Fixtures pytestbdd_feature_base_dir and pytestbdd_strict_gherkin have been removed. Check the Migration of your tests from versions 2.x.x for more information (sliwinski-milosz) #255

• Fix step definitions not being found when using parsers or converters after a change in pytest (youtux) #257

• Gherkin terminal reporter expanded format (pauk-slon)

• Added support for But steps (olegpidsadnyi)

• Fixed compatibility with pytest 3.3.2 (olegpidsadnyi)

• MInimal required version of pytest is now 2.8.1 since it doesn't support earlier versions (olegpidsadnyi)

• Added --cucumber-json-expanded option for explicit selection of expanded format (mjholtkamp)

• Step names are filled in when --cucumber-json-expanded is used (mjholtkamp)

• Fix check for out section steps definitions for no strict gherkin feature

• Relay fixture results to recursive call of 'get_features' (coddingtonbear)

• Add gherkin terminal reporter (spinus + thedrow)

• Add support for pytest 3.0

• Fix FixtureDef signature for newer pytest versions (The-Compiler)

• Better error explanation for the steps defined outside of scenarios (olegpidsadnyi)

• Add a pytest_bdd_apply_tag hook to customize handling of tags (The-Compiler)

• Allow spaces in tag names. This can be useful when using the pytest_bdd_apply_tag hook with tags like @xfail: Some reason.

• Cleaned up hooks of the plugin (olegpidsadnyi)

• Fixed report serialization (olegpidsadnyi)

• Fixed deprecation warnings with pytest 2.8 (The-Compiler)

• Fixed deprecation warnings with Python 3.5 (The-Compiler)

• Add examples data in the scenario report (bubenkoff)

• Properly parse feature description (bubenkoff)

• Avoid potentially random collection order for xdist compartibility (bubenkoff)

• Pass additional arguments to parsers (bubenkoff)

• Add validation check which prevents having multiple features in a single feature file (bubenkoff)

• Allow mixing feature example table with scenario example table (bubenkoff, olegpidsadnyi)

• Feature example table (bubenkoff, sureshvv)

• Make it possible to relax strict Gherkin scenario validation (bubenkoff)

• Fix minimal six version (bubenkoff, dustinfarris)

• Mention step type on step definition not found errors and in code generation (bubenkoff, lrowe)

• Prefix step definition fixture names to avoid name collisions (bubenkoff, lrowe)

• Make feature and scenario tags to be fully compartible with pytest markers (bubenkoff, kevinastone)

• Fixed FeatureError string representation to correctly support python3 (bubenkoff, lrowe)

• Added possibility to inject fixtures from given keywords (bubenkoff)