diff --git a/doc/en/announce/index.txt b/doc/en/announce/index.txt index 33072fc34..333542b98 100644 --- a/doc/en/announce/index.txt +++ b/doc/en/announce/index.txt @@ -5,6 +5,7 @@ Release announcements .. toctree:: :maxdepth: 2 + release-2.3.5 release-2.3.4 release-2.3.3 release-2.3.2 diff --git a/doc/en/index.txt b/doc/en/index.txt index bb1172cd2..912d6a4be 100644 --- a/doc/en/index.txt +++ b/doc/en/index.txt @@ -11,8 +11,11 @@ pytest: helps you write better programs - runs on Posix/Windows, Python 2.4-3.3, PyPy and Jython-2.5.1 - :ref:`comprehensive online ` and `PDF documentation `_ + - many :ref:`third party plugins ` and + :ref:`builtin helpers ` - used in :ref:`many projects and organisations `, in test - suites ranging from 10 to 10s of thousands of tests + suites with up to twenty thousand tests + - strict policy of remaining backward compatible across releases - comes with many :ref:`tested examples ` **provides easy no-boilerplate testing** @@ -26,13 +29,13 @@ pytest: helps you write better programs **scales from simple unit to complex functional testing** - - (new in 2.3) :ref:`modular parametrizeable fixtures ` + - :ref:`modular parametrizeable fixtures ` (new in 2.3, + improved in 2.4) - :ref:`parametrized test functions ` - :ref:`mark` - - :ref:`skipping` + - :ref:`skipping` (improved in 2.4) - can :ref:`distribute tests to multiple CPUs ` through :ref:`xdist plugin ` - can :ref:`continuously re-run failing tests ` - - many :ref:`builtin helpers ` and :ref:`plugins ` - flexible :ref:`Python test discovery` **integrates many common testing methods**: @@ -50,8 +53,8 @@ pytest: helps you write better programs **extensive plugin and customization system**: - all collection, reporting, running aspects are delegated to hook functions - - customizations can be per-directory, per-project or per PyPI released plugins - - it is easy to add command line options or do other kind of add-ons and customizations. + - customizations can be per-directory, per-project or per PyPI released plugin + - it is easy to add command line options or customize existing behaviour .. _`Javascript unit- and functional testing`: http://pypi.python.org/pypi/oejskit diff --git a/doc/en/plugins.txt b/doc/en/plugins.txt index ee941619b..1893ef3e0 100644 --- a/doc/en/plugins.txt +++ b/doc/en/plugins.txt @@ -78,12 +78,22 @@ there is no need to activate it. Here is a initial list of known plugins: * `pytest-capturelog `_: to capture and assert about messages from the logging module +* `pytest-cov `_: + coverage reporting, compatible with distributed testing + * `pytest-xdist `_: to distribute tests to CPUs and remote hosts, to run in boxed mode which allows to survive segmentation faults, to run in looponfailing mode, automatically re-running failing tests on file changes, see also :ref:`xdist` +* `pytest-instafail `_: + to report failures while the test run is happening. + +* `pytest-bdd `_ and + `pytest-konira `_ + to write tests using behaviour-driven testing. + * `pytest-timeout `_: to timeout tests based on function marks or global definitions. @@ -91,9 +101,6 @@ there is no need to activate it. Here is a initial list of known plugins: to interactively re-run failing tests and help other plugins to store test run information across invocations. -* `pytest-cov `_: - coverage reporting, compatible with distributed testing - * `pytest-pep8 `_: a ``--pep8`` option to enable PEP8 compliance checking.