Fixed docs
This commit is contained in:
		
							parent
							
								
									604a021a2a
								
							
						
					
					
						commit
						a8d7e513f4
					
				| 
						 | 
					@ -333,12 +333,12 @@ The result of this test will be successful::
 | 
				
			||||||
Parametrizing test methods through per-class configuration
 | 
					Parametrizing test methods through per-class configuration
 | 
				
			||||||
--------------------------------------------------------------
 | 
					--------------------------------------------------------------
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.. _`unittest parameterizer`: http://code.google.com/p/unittest-ext/source/browse/trunk/params.py
 | 
					.. _`unittest parametrizer`: http://code.google.com/p/unittest-ext/source/browse/trunk/params.py
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Here is an example ``pytest_generate_function`` function implementing a
 | 
					Here is an example ``pytest_generate_function`` function implementing a
 | 
				
			||||||
parametrization scheme similar to Michael Foord's `unittest
 | 
					parametrization scheme similar to Michael Foord's `unittest
 | 
				
			||||||
parameterizer`_ but in a lot less code::
 | 
					parametrizer`_ but in a lot less code::
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    # content of ./test_parametrize.py
 | 
					    # content of ./test_parametrize.py
 | 
				
			||||||
    import pytest
 | 
					    import pytest
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -175,7 +175,7 @@ And then if you have a module file like this::
 | 
				
			||||||
and a setup.py dummy file like this::
 | 
					and a setup.py dummy file like this::
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    # content of setup.py
 | 
					    # content of setup.py
 | 
				
			||||||
    0/0  # will raise exeption if imported
 | 
					    0/0  # will raise exception if imported
 | 
				
			||||||
 | 
					
 | 
				
			||||||
then a pytest run on python2 will find the one test when run with a python2
 | 
					then a pytest run on python2 will find the one test when run with a python2
 | 
				
			||||||
interpreters and will leave out the setup.py file::
 | 
					interpreters and will leave out the setup.py file::
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -313,7 +313,7 @@ profiling test duration
 | 
				
			||||||
.. versionadded: 2.2
 | 
					.. versionadded: 2.2
 | 
				
			||||||
 | 
					
 | 
				
			||||||
If you have a slow running large test suite you might want to find
 | 
					If you have a slow running large test suite you might want to find
 | 
				
			||||||
out which tests are the slowest. Let's make an artifical test suite::
 | 
					out which tests are the slowest. Let's make an artificial test suite::
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    # content of test_some_are_slow.py
 | 
					    # content of test_some_are_slow.py
 | 
				
			||||||
 | 
					
 | 
				
			||||||
| 
						 | 
					@ -427,7 +427,7 @@ by placing fixture functions in a ``conftest.py`` file in that directory
 | 
				
			||||||
You can use all types of fixtures including :ref:`autouse fixtures
 | 
					You can use all types of fixtures including :ref:`autouse fixtures
 | 
				
			||||||
<autouse fixtures>` which are the equivalent of xUnit's setup/teardown
 | 
					<autouse fixtures>` which are the equivalent of xUnit's setup/teardown
 | 
				
			||||||
concept.  It's however recommended to have explicit fixture references in your
 | 
					concept.  It's however recommended to have explicit fixture references in your
 | 
				
			||||||
tests or test classes rather than relying on implicitely executing
 | 
					tests or test classes rather than relying on implicitly executing
 | 
				
			||||||
setup/teardown functions, especially if they are far away from the actual tests.
 | 
					setup/teardown functions, especially if they are far away from the actual tests.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Here is a an example for making a ``db`` fixture available in a directory::
 | 
					Here is a an example for making a ``db`` fixture available in a directory::
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -60,7 +60,7 @@ and customizable testing framework for Python.   Note, however, that
 | 
				
			||||||
thus likely not something for Python beginners.
 | 
					thus likely not something for Python beginners.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
A second "magic" issue was the assert statement debugging feature.
 | 
					A second "magic" issue was the assert statement debugging feature.
 | 
				
			||||||
Nowadays, ``pytest`` explicitely rewrites assert statements in test modules
 | 
					Nowadays, ``pytest`` explicitly rewrites assert statements in test modules
 | 
				
			||||||
in order to provide more useful :ref:`assert feedback <assertfeedback>`.
 | 
					in order to provide more useful :ref:`assert feedback <assertfeedback>`.
 | 
				
			||||||
This completely avoids previous issues of confusing assertion-reporting.
 | 
					This completely avoids previous issues of confusing assertion-reporting.
 | 
				
			||||||
It also means, that you can use Python's ``-O`` optimization without losing
 | 
					It also means, that you can use Python's ``-O`` optimization without losing
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -209,7 +209,7 @@ fixtures:
 | 
				
			||||||
  and let pytest figure things out for you.
 | 
					  and let pytest figure things out for you.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
* if you used parametrization and funcarg factories which made use of
 | 
					* if you used parametrization and funcarg factories which made use of
 | 
				
			||||||
  ``request.cached_setup()`` it is recommeneded to invest a few minutes
 | 
					  ``request.cached_setup()`` it is recommended to invest a few minutes
 | 
				
			||||||
  and simplify your fixture function code to use the :ref:`@pytest.fixture`
 | 
					  and simplify your fixture function code to use the :ref:`@pytest.fixture`
 | 
				
			||||||
  decorator instead.  This will also allow to take advantage of 
 | 
					  decorator instead.  This will also allow to take advantage of 
 | 
				
			||||||
  the automatic per-resource grouping of tests.
 | 
					  the automatic per-resource grouping of tests.
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -126,7 +126,7 @@ when writing the class-scoped fixture function above.
 | 
				
			||||||
autouse fixtures and accessing other fixtures
 | 
					autouse fixtures and accessing other fixtures
 | 
				
			||||||
-------------------------------------------------------------------
 | 
					-------------------------------------------------------------------
 | 
				
			||||||
 | 
					
 | 
				
			||||||
Although it's usually better to explicitely declare use of fixtures you need
 | 
					Although it's usually better to explicitly declare use of fixtures you need
 | 
				
			||||||
for a given test, you may sometimes want to have fixtures that are 
 | 
					for a given test, you may sometimes want to have fixtures that are 
 | 
				
			||||||
automatically used in a given context.  After all, the traditional 
 | 
					automatically used in a given context.  After all, the traditional 
 | 
				
			||||||
style of unittest-setup mandates the use of this implicit fixture writing
 | 
					style of unittest-setup mandates the use of this implicit fixture writing
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -123,7 +123,7 @@ automatically disables its output capture when you enter PDB_ tracing:
 | 
				
			||||||
  such.
 | 
					  such.
 | 
				
			||||||
* Any later output produced within the same test will not be captured and will
 | 
					* Any later output produced within the same test will not be captured and will
 | 
				
			||||||
  instead get sent directly to ``sys.stdout``. Note that this holds true even
 | 
					  instead get sent directly to ``sys.stdout``. Note that this holds true even
 | 
				
			||||||
  for test output occuring after you exit the interactive PDB_ tracing session
 | 
					  for test output occurring after you exit the interactive PDB_ tracing session
 | 
				
			||||||
  and continue with the regular test run.
 | 
					  and continue with the regular test run.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.. versionadded: 2.4.0
 | 
					.. versionadded: 2.4.0
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
| 
						 | 
					@ -204,7 +204,7 @@ plugin.  Given that you have an installed plugin you can enable the
 | 
				
			||||||
:py:class:`testdir <_pytest.pytester.Testdir>` fixture via specifying a
 | 
					:py:class:`testdir <_pytest.pytester.Testdir>` fixture via specifying a
 | 
				
			||||||
command line option to include the pytester plugin (``-p pytester``) or
 | 
					command line option to include the pytester plugin (``-p pytester``) or
 | 
				
			||||||
by putting ``pytest_plugins = "pytester"`` into your test or
 | 
					by putting ``pytest_plugins = "pytester"`` into your test or
 | 
				
			||||||
``conftest.py`` file.  You then will have a ``testdir`` fixure which you
 | 
					``conftest.py`` file.  You then will have a ``testdir`` fixture which you
 | 
				
			||||||
can use like this::
 | 
					can use like this::
 | 
				
			||||||
 | 
					
 | 
				
			||||||
    # content of test_myplugin.py
 | 
					    # content of test_myplugin.py
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Loading…
	
		Reference in New Issue