Go to file
Jurko Gospodnetić 6910641266 reword PDB usage documentation
Documented that since pytest 2.4.0 you can use the raw pdb.set_trace() call
directly without the pytest.set_trace() wrapper or explicitly disabling pytest's
output capture using 'py.test -s'.

Clearly stated how pytest (since version 2.0.0.) automatically disables its
output capture when entering an interactive PDB debugger. This avoids confusing
new users because their tests display different output when running with or
without entering an interactive debugger (even if user does nothing in that
interactive debugger session other than exit it and continue with the regular
test execution).

--HG--
branch : pdb_doc_update
2014-02-01 10:19:09 +01:00
_pytest add release announcement, bump version to 2.5.2, 2014-01-29 13:47:11 +01:00
bench replace py.test module references with pytest 2014-01-18 12:31:33 +01:00
doc reword PDB usage documentation 2014-02-01 10:19:09 +01:00
extra fix issue221 - handle importing of namespace-package with no 2013-11-20 21:04:19 +01:00
testing make it clear that this xfail is an unimplemented feature, nothing more. 2014-01-29 13:56:24 +01:00
.gitignore .gitignore: Removed *.html rule 2013-12-12 18:48:09 +01:00
.hgignore ignores 2013-08-14 10:09:02 +02:00
.hgtags Added tag 2.5.2 for changeset 421d3b4d150d 2014-01-29 14:09:33 +01:00
.travis.yml have travis use the devpi index to get the pylib dependency 2014-01-23 12:18:20 +01:00
AUTHORS add Jurko to authors/contributors file 2014-01-23 15:08:24 +01:00
CHANGELOG add release announcement, bump version to 2.5.2, 2014-01-29 13:47:11 +01:00
CONTRIBUTING.rst Contribution guide: added pull request button image 2014-01-24 20:01:04 +01:00
ISSUES.txt replace py.test module references with pytest 2014-01-18 12:31:33 +01:00
LICENSE * use the MIT license for the py lib 2009-10-03 01:11:04 +02:00
MANIFEST.in fix manifest 2013-08-15 13:05:01 +02:00
README.rst add changelog entry about issue429, adapt README 2014-01-29 09:00:14 +01:00
plugin-test.sh add pluginmanager.do_configure(config) as a link to 2013-10-04 11:36:45 +02:00
pytest.py some more separation of core pluginmanager from pytest specific functionality. 2013-09-30 13:14:14 +02:00
runtox.py refine contributing text in several places 2014-01-23 11:38:05 +01:00
setup.cfg add setup.cfg for building sphinx_docs 2013-10-03 12:35:13 +02:00
setup.py add release announcement, bump version to 2.5.2, 2014-01-29 13:47:11 +01:00
tox.ini allow positional args to tox invocation 2014-01-27 12:42:06 +01:00

README.rst

Documentation: http://pytest.org/latest/

Changelog: http://pytest.org/latest/changelog.html

Issues: https://bitbucket.org/hpk42/pytest/issues?status=open

The ``pytest`` testing tool makes it easy to write small tests, yet
scales to support complex functional testing.  It provides

- `auto-discovery
  <http://pytest.org/latest/goodpractises.html#python-test-discovery>`_
  of test modules and functions,
- detailed info on failing `assert statements <http://pytest.org/latest/assert.html>`_ (no need to remember ``self.assert*`` names)
- `modular fixtures <http://pytest.org/latest/fixture.html>`_  for
  managing small or parametrized long-lived test resources.
- multi-paradigm support: you can use ``pytest`` to run test suites based
  on `unittest <http://pytest.org/latest/unittest.html>`_ (or trial),
  `nose <http://pytest.org/latest/nose.html>`_
- single-source compatibility to Python2.5 all the way up to Python3.3,
  PyPy-1.9 and Jython-2.5.1.

- many `external plugins <http://pytest.org/latest/plugins.html#installing-external-plugins-searching>`_.

A simple example for a test::

    # content of test_module.py
    def test_function():
        i = 4
        assert i == 3

which can be run with ``py.test test_module.py``.  See `getting-started <http://pytest.org/latest/getting-started.html#our-first-test-run>`_ for more examples.

For much more info, including PDF docs, see

    http://pytest.org

and report bugs at:

    http://bitbucket.org/hpk42/pytest/issues/

and checkout or fork repo at:

    http://bitbucket.org/hpk42/pytest/


Copyright Holger Krekel and others, 2004-2014
Licensed under the MIT license.