[py-svn] commit/pytest: hpk42: - add a Package/dir level setup example

Bitbucket commits-noreply at bitbucket.org
Wed Nov 7 11:12:51 CET 2012


1 new commit in pytest:


https://bitbucket.org/hpk42/pytest/changeset/81580e70517e/
changeset:   81580e70517e
user:        hpk42
date:        2012-11-07 11:11:40
summary:     - add a Package/dir level setup example
- make tox.ini's doc/regen use pytest release instead of dev version
affected #:  15 files

diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 CHANGELOG
--- a/CHANGELOG
+++ b/CHANGELOG
@@ -1,3 +1,8 @@
+Changes between 2.3.3 and 2.3.4.dev
+-----------------------------------
+
+- fix issue91 - add/discuss package/directory level setups in example
+
 Changes between 2.3.2 and 2.3.3
 -----------------------------------
 


diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 doc/en/capture.txt
--- a/doc/en/capture.txt
+++ b/doc/en/capture.txt
@@ -78,7 +78,7 @@
     
     test_module.py:9: AssertionError
     ----------------------------- Captured stdout ------------------------------
-    setting up <function test_func2 at 0x2d63d70>
+    setting up <function test_func2 at 0x2d9dde8>
     ==================== 1 failed, 1 passed in 0.01 seconds ====================
 
 Accessing captured output from a test function


diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 doc/en/conf.py
--- a/doc/en/conf.py
+++ b/doc/en/conf.py
@@ -17,7 +17,7 @@
 #
 # The full version, including alpha/beta/rc tags.
 # The short X.Y version.
-version = release = "2.3.3"
+version = release = "2.3.3.1"
 
 import sys, os
 


diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 doc/en/doctest.txt
--- a/doc/en/doctest.txt
+++ b/doc/en/doctest.txt
@@ -49,4 +49,4 @@
     
     mymodule.py .
     
-    ========================= 1 passed in 0.02 seconds =========================
+    ========================= 1 passed in 0.11 seconds =========================


diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 doc/en/example/markers.txt
--- a/doc/en/example/markers.txt
+++ b/doc/en/example/markers.txt
@@ -32,7 +32,7 @@
     test_server.py:3: test_send_http PASSED
     
     =================== 1 tests deselected by "-m 'webtest'" ===================
-    ================== 1 passed, 1 deselected in 0.02 seconds ==================
+    ================== 1 passed, 1 deselected in 0.01 seconds ==================
 
 Or the inverse, running all tests except the webtest ones::
     
@@ -356,7 +356,7 @@
     
     test_plat.py s.s.
     ========================= short test summary info ==========================
-    SKIP [2] /tmp/doc-exec-57/conftest.py:12: cannot run on platform linux2
+    SKIP [2] /tmp/doc-exec-135/conftest.py:12: cannot run on platform linux2
     
     =================== 2 passed, 2 skipped in 0.01 seconds ====================
 


diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 doc/en/example/nonpython.txt
--- a/doc/en/example/nonpython.txt
+++ b/doc/en/example/nonpython.txt
@@ -37,7 +37,7 @@
     usecase execution failed
        spec failed: 'some': 'other'
        no further details known at this point.
-    ==================== 1 failed, 1 passed in 0.04 seconds ====================
+    ==================== 1 failed, 1 passed in 0.05 seconds ====================
 
 You get one dot for the passing ``sub1: sub1`` check and one failure.
 Obviously in the above ``conftest.py`` you'll want to implement a more
@@ -67,7 +67,7 @@
     usecase execution failed
        spec failed: 'some': 'other'
        no further details known at this point.
-    ==================== 1 failed, 1 passed in 0.04 seconds ====================
+    ==================== 1 failed, 1 passed in 0.05 seconds ====================
 
 While developing your custom test collection and execution it's also
 interesting to just look at the collection tree::


diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 doc/en/example/parametrize.txt
--- a/doc/en/example/parametrize.txt
+++ b/doc/en/example/parametrize.txt
@@ -195,7 +195,7 @@
     ================================= FAILURES =================================
     _________________________ test_db_initialized[d2] __________________________
     
-    db = <conftest.DB2 instance at 0x1d8aef0>
+    db = <conftest.DB2 instance at 0x27a3ea8>
     
         def test_db_initialized(db):
             # a dummy test
@@ -250,7 +250,7 @@
     ================================= FAILURES =================================
     ________________________ TestClass.test_equals[1-2] ________________________
     
-    self = <test_parametrize.TestClass instance at 0x1628cb0>, a = 1, b = 2
+    self = <test_parametrize.TestClass instance at 0x2249c68>, a = 1, b = 2
     
         def test_equals(self, a, b):
     >       assert a == b


diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 doc/en/example/reportingdemo.txt
--- a/doc/en/example/reportingdemo.txt
+++ b/doc/en/example/reportingdemo.txt
@@ -30,7 +30,7 @@
     failure_demo.py:15: AssertionError
     _________________________ TestFailing.test_simple __________________________
     
-    self = <failure_demo.TestFailing object at 0x1136710>
+    self = <failure_demo.TestFailing object at 0x2628750>
     
         def test_simple(self):
             def f():
@@ -40,13 +40,13 @@
         
     >       assert f() == g()
     E       assert 42 == 43
-    E        +  where 42 = <function f at 0x1146410>()
-    E        +  and   43 = <function g at 0x1146488>()
+    E        +  where 42 = <function f at 0x25b6488>()
+    E        +  and   43 = <function g at 0x25b6500>()
     
     failure_demo.py:28: AssertionError
     ____________________ TestFailing.test_simple_multiline _____________________
     
-    self = <failure_demo.TestFailing object at 0x11329d0>
+    self = <failure_demo.TestFailing object at 0x26249d0>
     
         def test_simple_multiline(self):
             otherfunc_multi(
@@ -66,19 +66,19 @@
     failure_demo.py:11: AssertionError
     ___________________________ TestFailing.test_not ___________________________
     
-    self = <failure_demo.TestFailing object at 0x10d09d0>
+    self = <failure_demo.TestFailing object at 0x25c2a10>
     
         def test_not(self):
             def f():
                 return 42
     >       assert not f()
     E       assert not 42
-    E        +  where 42 = <function f at 0x1146848>()
+    E        +  where 42 = <function f at 0x25b68c0>()
     
     failure_demo.py:38: AssertionError
     _________________ TestSpecialisedExplanations.test_eq_text _________________
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x10ca210>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x25bc250>
     
         def test_eq_text(self):
     >       assert 'spam' == 'eggs'
@@ -89,7 +89,7 @@
     failure_demo.py:42: AssertionError
     _____________ TestSpecialisedExplanations.test_eq_similar_text _____________
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x11368d0>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x26282d0>
     
         def test_eq_similar_text(self):
     >       assert 'foo 1 bar' == 'foo 2 bar'
@@ -102,7 +102,7 @@
     failure_demo.py:45: AssertionError
     ____________ TestSpecialisedExplanations.test_eq_multiline_text ____________
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x11340d0>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x2626790>
     
         def test_eq_multiline_text(self):
     >       assert 'foo\nspam\nbar' == 'foo\neggs\nbar'
@@ -115,7 +115,7 @@
     failure_demo.py:48: AssertionError
     ______________ TestSpecialisedExplanations.test_eq_long_text _______________
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x10cfd90>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x25c1e50>
     
         def test_eq_long_text(self):
             a = '1'*100 + 'a' + '2'*100
@@ -132,7 +132,7 @@
     failure_demo.py:53: AssertionError
     _________ TestSpecialisedExplanations.test_eq_long_text_multiline __________
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x10d0b10>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x25c2bd0>
     
         def test_eq_long_text_multiline(self):
             a = '1\n'*100 + 'a' + '2\n'*100
@@ -156,7 +156,7 @@
     failure_demo.py:58: AssertionError
     _________________ TestSpecialisedExplanations.test_eq_list _________________
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x1142dd0>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x2634d10>
     
         def test_eq_list(self):
     >       assert [0, 1, 2] == [0, 1, 3]
@@ -166,7 +166,7 @@
     failure_demo.py:61: AssertionError
     ______________ TestSpecialisedExplanations.test_eq_list_long _______________
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x1136850>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x2628310>
     
         def test_eq_list_long(self):
             a = [0]*100 + [1] + [3]*100
@@ -178,7 +178,7 @@
     failure_demo.py:66: AssertionError
     _________________ TestSpecialisedExplanations.test_eq_dict _________________
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x1134e10>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x2626350>
     
         def test_eq_dict(self):
     >       assert {'a': 0, 'b': 1} == {'a': 0, 'b': 2}
@@ -191,7 +191,7 @@
     failure_demo.py:69: AssertionError
     _________________ TestSpecialisedExplanations.test_eq_set __________________
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x1169c90>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x265acd0>
     
         def test_eq_set(self):
     >       assert set([0, 10, 11, 12]) == set([0, 20, 21])
@@ -207,7 +207,7 @@
     failure_demo.py:72: AssertionError
     _____________ TestSpecialisedExplanations.test_eq_longer_list ______________
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x1142c50>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x2627b10>
     
         def test_eq_longer_list(self):
     >       assert [1,2] == [1,2,3]
@@ -217,7 +217,7 @@
     failure_demo.py:75: AssertionError
     _________________ TestSpecialisedExplanations.test_in_list _________________
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x10d0d90>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x25c23d0>
     
         def test_in_list(self):
     >       assert 1 in [0, 2, 3, 4, 5]
@@ -226,7 +226,7 @@
     failure_demo.py:78: AssertionError
     __________ TestSpecialisedExplanations.test_not_in_text_multiline __________
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x10e0110>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x25d2190>
     
         def test_not_in_text_multiline(self):
             text = 'some multiline\ntext\nwhich\nincludes foo\nand a\ntail'
@@ -244,7 +244,7 @@
     failure_demo.py:82: AssertionError
     ___________ TestSpecialisedExplanations.test_not_in_text_single ____________
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x10ca7d0>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x25c1590>
     
         def test_not_in_text_single(self):
             text = 'single foo line'
@@ -257,7 +257,7 @@
     failure_demo.py:86: AssertionError
     _________ TestSpecialisedExplanations.test_not_in_text_single_long _________
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x1142750>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x265af10>
     
         def test_not_in_text_single_long(self):
             text = 'head ' * 50 + 'foo ' + 'tail ' * 20
@@ -270,7 +270,7 @@
     failure_demo.py:90: AssertionError
     ______ TestSpecialisedExplanations.test_not_in_text_single_long_term _______
     
-    self = <failure_demo.TestSpecialisedExplanations object at 0x1134410>
+    self = <failure_demo.TestSpecialisedExplanations object at 0x2626dd0>
     
         def test_not_in_text_single_long_term(self):
             text = 'head ' * 50 + 'f'*70 + 'tail ' * 20
@@ -289,7 +289,7 @@
             i = Foo()
     >       assert i.b == 2
     E       assert 1 == 2
-    E        +  where 1 = <failure_demo.Foo object at 0x10e07d0>.b
+    E        +  where 1 = <failure_demo.Foo object at 0x2634950>.b
     
     failure_demo.py:101: AssertionError
     _________________________ test_attribute_instance __________________________
@@ -299,8 +299,8 @@
                 b = 1
     >       assert Foo().b == 2
     E       assert 1 == 2
-    E        +  where 1 = <failure_demo.Foo object at 0x1132390>.b
-    E        +    where <failure_demo.Foo object at 0x1132390> = <class 'failure_demo.Foo'>()
+    E        +  where 1 = <failure_demo.Foo object at 0x2624110>.b
+    E        +    where <failure_demo.Foo object at 0x2624110> = <class 'failure_demo.Foo'>()
     
     failure_demo.py:107: AssertionError
     __________________________ test_attribute_failure __________________________
@@ -316,7 +316,7 @@
     failure_demo.py:116: 
     _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ _ 
     
-    self = <failure_demo.Foo object at 0x1136fd0>
+    self = <failure_demo.Foo object at 0x2627b50>
     
         def _get_b(self):
     >       raise Exception('Failed to get attrib')
@@ -332,15 +332,15 @@
                 b = 2
     >       assert Foo().b == Bar().b
     E       assert 1 == 2
-    E        +  where 1 = <failure_demo.Foo object at 0x1134c50>.b
-    E        +    where <failure_demo.Foo object at 0x1134c50> = <class 'failure_demo.Foo'>()
-    E        +  and   2 = <failure_demo.Bar object at 0x1134790>.b
-    E        +    where <failure_demo.Bar object at 0x1134790> = <class 'failure_demo.Bar'>()
+    E        +  where 1 = <failure_demo.Foo object at 0x25c12d0>.b
+    E        +    where <failure_demo.Foo object at 0x25c12d0> = <class 'failure_demo.Foo'>()
+    E        +  and   2 = <failure_demo.Bar object at 0x25c19d0>.b
+    E        +    where <failure_demo.Bar object at 0x25c19d0> = <class 'failure_demo.Bar'>()
     
     failure_demo.py:124: AssertionError
     __________________________ TestRaises.test_raises __________________________
     
-    self = <failure_demo.TestRaises instance at 0x10dc098>
+    self = <failure_demo.TestRaises instance at 0x265bb90>
     
         def test_raises(self):
             s = 'qwe'
@@ -355,7 +355,7 @@
     <0-codegen /home/hpk/p/pytest/.tox/regen/lib/python2.7/site-packages/_pytest/python.py:851>:1: ValueError
     ______________________ TestRaises.test_raises_doesnt _______________________
     
-    self = <failure_demo.TestRaises instance at 0x10d8320>
+    self = <failure_demo.TestRaises instance at 0x26372d8>
     
         def test_raises_doesnt(self):
     >       raises(IOError, "int('3')")
@@ -364,7 +364,7 @@
     failure_demo.py:136: Failed
     __________________________ TestRaises.test_raise ___________________________
     
-    self = <failure_demo.TestRaises instance at 0x10c0680>
+    self = <failure_demo.TestRaises instance at 0x264ae60>
     
         def test_raise(self):
     >       raise ValueError("demo error")
@@ -373,7 +373,7 @@
     failure_demo.py:139: ValueError
     ________________________ TestRaises.test_tupleerror ________________________
     
-    self = <failure_demo.TestRaises instance at 0x11604d0>
+    self = <failure_demo.TestRaises instance at 0x2639368>
     
         def test_tupleerror(self):
     >       a,b = [1]
@@ -382,7 +382,7 @@
     failure_demo.py:142: ValueError
     ______ TestRaises.test_reinterpret_fails_with_print_for_the_fun_of_it ______
     
-    self = <failure_demo.TestRaises instance at 0x10e2290>
+    self = <failure_demo.TestRaises instance at 0x25c3d40>
     
         def test_reinterpret_fails_with_print_for_the_fun_of_it(self):
             l = [1,2,3]
@@ -395,7 +395,7 @@
     l is [1, 2, 3]
     ________________________ TestRaises.test_some_error ________________________
     
-    self = <failure_demo.TestRaises instance at 0x10e2f80>
+    self = <failure_demo.TestRaises instance at 0x2630f80>
     
         def test_some_error(self):
     >       if namenotexi:
@@ -423,7 +423,7 @@
     <2-codegen 'abc-123' /home/hpk/p/pytest/doc/en/example/assertion/failure_demo.py:162>:2: AssertionError
     ____________________ TestMoreErrors.test_complex_error _____________________
     
-    self = <failure_demo.TestMoreErrors instance at 0x10d1b90>
+    self = <failure_demo.TestMoreErrors instance at 0x262cb48>
     
         def test_complex_error(self):
             def f():
@@ -452,7 +452,7 @@
     failure_demo.py:5: AssertionError
     ___________________ TestMoreErrors.test_z1_unpack_error ____________________
     
-    self = <failure_demo.TestMoreErrors instance at 0x114f3b0>
+    self = <failure_demo.TestMoreErrors instance at 0x262c290>
     
         def test_z1_unpack_error(self):
             l = []
@@ -462,7 +462,7 @@
     failure_demo.py:179: ValueError
     ____________________ TestMoreErrors.test_z2_type_error _____________________
     
-    self = <failure_demo.TestMoreErrors instance at 0x11496c8>
+    self = <failure_demo.TestMoreErrors instance at 0x2637c68>
     
         def test_z2_type_error(self):
             l = 3
@@ -472,19 +472,19 @@
     failure_demo.py:183: TypeError
     ______________________ TestMoreErrors.test_startswith ______________________
     
-    self = <failure_demo.TestMoreErrors instance at 0x10cec20>
+    self = <failure_demo.TestMoreErrors instance at 0x2623b48>
     
         def test_startswith(self):
             s = "123"
             g = "456"
     >       assert s.startswith(g)
-    E       assert <built-in method startswith of str object at 0x113b918>('456')
-    E        +  where <built-in method startswith of str object at 0x113b918> = '123'.startswith
+    E       assert <built-in method startswith of str object at 0x262d918>('456')
+    E        +  where <built-in method startswith of str object at 0x262d918> = '123'.startswith
     
     failure_demo.py:188: AssertionError
     __________________ TestMoreErrors.test_startswith_nested ___________________
     
-    self = <failure_demo.TestMoreErrors instance at 0x10c87a0>
+    self = <failure_demo.TestMoreErrors instance at 0x26496c8>
     
         def test_startswith_nested(self):
             def f():
@@ -492,15 +492,15 @@
             def g():
                 return "456"
     >       assert f().startswith(g())
-    E       assert <built-in method startswith of str object at 0x113b918>('456')
-    E        +  where <built-in method startswith of str object at 0x113b918> = '123'.startswith
-    E        +    where '123' = <function f at 0x10bea28>()
-    E        +  and   '456' = <function g at 0x10beaa0>()
+    E       assert <built-in method startswith of str object at 0x262d918>('456')
+    E        +  where <built-in method startswith of str object at 0x262d918> = '123'.startswith
+    E        +    where '123' = <function f at 0x264daa0>()
+    E        +  and   '456' = <function g at 0x264db18>()
     
     failure_demo.py:195: AssertionError
     _____________________ TestMoreErrors.test_global_func ______________________
     
-    self = <failure_demo.TestMoreErrors instance at 0x10c5488>
+    self = <failure_demo.TestMoreErrors instance at 0x25d61b8>
     
         def test_global_func(self):
     >       assert isinstance(globf(42), float)
@@ -510,18 +510,18 @@
     failure_demo.py:198: AssertionError
     _______________________ TestMoreErrors.test_instance _______________________
     
-    self = <failure_demo.TestMoreErrors instance at 0x113f710>
+    self = <failure_demo.TestMoreErrors instance at 0x25cd878>
     
         def test_instance(self):
             self.x = 6*7
     >       assert self.x != 42
     E       assert 42 != 42
-    E        +  where 42 = <failure_demo.TestMoreErrors instance at 0x113f710>.x
+    E        +  where 42 = <failure_demo.TestMoreErrors instance at 0x25cd878>.x
     
     failure_demo.py:202: AssertionError
     _______________________ TestMoreErrors.test_compare ________________________
     
-    self = <failure_demo.TestMoreErrors instance at 0x10bae18>
+    self = <failure_demo.TestMoreErrors instance at 0x263ab00>
     
         def test_compare(self):
     >       assert globf(10) < 5
@@ -531,7 +531,7 @@
     failure_demo.py:205: AssertionError
     _____________________ TestMoreErrors.test_try_finally ______________________
     
-    self = <failure_demo.TestMoreErrors instance at 0x1160248>
+    self = <failure_demo.TestMoreErrors instance at 0x2646050>
     
         def test_try_finally(self):
             x = 1
@@ -540,4 +540,4 @@
     E           assert 1 == 0
     
     failure_demo.py:210: AssertionError
-    ======================== 39 failed in 0.25 seconds =========================
+    ======================== 39 failed in 0.23 seconds =========================


diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 doc/en/example/simple.txt
--- a/doc/en/example/simple.txt
+++ b/doc/en/example/simple.txt
@@ -155,7 +155,7 @@
     
     test_module.py .s
     ========================= short test summary info ==========================
-    SKIP [1] /tmp/doc-exec-62/conftest.py:9: need --runslow option to run
+    SKIP [1] /tmp/doc-exec-140/conftest.py:9: need --runslow option to run
     
     =================== 1 passed, 1 skipped in 0.01 seconds ====================
 
@@ -388,7 +388,7 @@
     ================================= FAILURES =================================
     ____________________ TestUserHandling.test_modification ____________________
     
-    self = <test_step.TestUserHandling instance at 0x2677b90>
+    self = <test_step.TestUserHandling instance at 0x19e8b48>
     
         def test_modification(self):
     >       assert 0
@@ -403,3 +403,95 @@
 We'll see that ``test_deletion`` was not executed because ``test_modification``
 failed.  It is reported as an "expected failure".
 
+
+Package/Directory-level fixtures (setups)
+-------------------------------------------------------
+
+If you have nested test directories, you can have per-directory fixture scopes
+by placing fixture functions in a ``conftest.py`` file in that directory
+You can use all types of fixtures including :ref:`autouse fixtures
+<autouse fixtures>` which are the equivalent of xUnit's setup/teardown
+concept.  It's however recommended to have explicit fixture references in your
+tests or test classes rather than relying on implicitely executing
+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::
+
+    # content of a/conftest.py
+    import pytest
+
+    class DB:
+        pass
+
+    @pytest.fixture(scope="session")
+    def db():
+        return DB()
+
+and then a test module in that directory::
+
+    # content of a/test_db.py
+    def test_a1(db):
+        assert 0, db  # to show value
+
+another test module::
+
+    # content of a/test_db2.py
+    def test_a2(db):
+        assert 0, db  # to show value
+
+and then a module in a sister directory which will not see
+the ``db`` fixture::
+
+    # content of b/test_error.py
+    def test_root(db):  # no db here, will error out
+        pass
+    
+We can run this::
+
+    $ py.test
+    =========================== test session starts ============================
+    platform linux2 -- Python 2.7.3 -- pytest-2.3.3
+    collected 3 items
+    
+    a/test_db.py F
+    a/test_db2.py F
+    b/test_error.py E
+    
+    ================================== ERRORS ==================================
+    _______________________ ERROR at setup of test_root ________________________
+    file /tmp/doc-exec-133/b/test_error.py, line 1
+      def test_root(db):  # no db here, will error out
+            fixture 'db' not found
+            available fixtures: pytestconfig, recwarn, monkeypatch, capfd, capsys, tmpdir
+            use 'py.test --fixtures [testpath]' for help on them.
+    
+    /tmp/doc-exec-133/b/test_error.py:1
+    ================================= FAILURES =================================
+    _________________________________ test_a1 __________________________________
+    
+    db = <conftest.DB instance at 0x13d22d8>
+    
+        def test_a1(db):
+    >       assert 0, db  # to show value
+    E       AssertionError: <conftest.DB instance at 0x13d22d8>
+    
+    a/test_db.py:2: AssertionError
+    _________________________________ test_a2 __________________________________
+    
+    db = <conftest.DB instance at 0x13d22d8>
+    
+        def test_a2(db):
+    >       assert 0, db  # to show value
+    E       AssertionError: <conftest.DB instance at 0x13d22d8>
+    
+    a/test_db2.py:2: AssertionError
+    ==================== 2 failed, 1 error in 0.02 seconds =====================
+
+The two test modules in the ``a`` directory see the same ``db`` fixture instance
+while the one test in the sister-directory ``b`` doesn't see it.  We could of course
+also define a ``db`` fixture in that sister directory's ``conftest.py`` file.
+Note that each fixture is only instantiated if there is a test actually needing
+it (unless you use "autouse" fixture which are always executed ahead of the first test
+executing).
+
+


diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 doc/en/fixture.txt
--- a/doc/en/fixture.txt
+++ b/doc/en/fixture.txt
@@ -79,7 +79,7 @@
     ================================= FAILURES =================================
     ________________________________ test_ehlo _________________________________
     
-    smtp = <smtplib.SMTP instance at 0x1992a70>
+    smtp = <smtplib.SMTP instance at 0x2934a28>
     
         def test_ehlo(smtp):
             response, msg = smtp.ehlo()
@@ -89,7 +89,7 @@
     E       assert 0
     
     test_smtpsimple.py:12: AssertionError
-    ========================= 1 failed in 0.30 seconds =========================
+    ========================= 1 failed in 0.26 seconds =========================
 
 In the failure traceback we see that the test function was called with a
 ``smtp`` argument, the ``smtplib.SMTP()`` instance created by the fixture
@@ -197,7 +197,7 @@
     ================================= FAILURES =================================
     ________________________________ test_ehlo _________________________________
     
-    smtp = <smtplib.SMTP instance at 0x2b8a248>
+    smtp = <smtplib.SMTP instance at 0x13b9cf8>
     
         def test_ehlo(smtp):
             response = smtp.ehlo()
@@ -209,7 +209,7 @@
     test_module.py:6: AssertionError
     ________________________________ test_noop _________________________________
     
-    smtp = <smtplib.SMTP instance at 0x2b8a248>
+    smtp = <smtplib.SMTP instance at 0x13b9cf8>
     
         def test_noop(smtp):
             response = smtp.noop()
@@ -218,7 +218,7 @@
     E       assert 0
     
     test_module.py:11: AssertionError
-    ========================= 2 failed in 0.48 seconds =========================
+    ========================= 2 failed in 0.22 seconds =========================
 
 You see the two ``assert 0`` failing and more importantly you can also see 
 that the same (module-scoped) ``smtp`` object was passed into the two 
@@ -271,7 +271,7 @@
 
     $ py.test -s -q --tb=no
     FF
-    finalizing <smtplib.SMTP instance at 0x1584908>
+    finalizing <smtplib.SMTP instance at 0x28a4830>
 
 We see that the ``smtp`` instance is finalized after the two
 tests using it tests executed.  If we had specified ``scope='function'`` 
@@ -342,7 +342,7 @@
     ================================= FAILURES =================================
     __________________________ test_ehlo[merlinux.eu] __________________________
     
-    smtp = <smtplib.SMTP instance at 0x2368248>
+    smtp = <smtplib.SMTP instance at 0x26c7200>
     
         def test_ehlo(smtp):
             response = smtp.ehlo()
@@ -354,7 +354,7 @@
     test_module.py:6: AssertionError
     __________________________ test_noop[merlinux.eu] __________________________
     
-    smtp = <smtplib.SMTP instance at 0x2368248>
+    smtp = <smtplib.SMTP instance at 0x26c7200>
     
         def test_noop(smtp):
             response = smtp.noop()
@@ -365,7 +365,7 @@
     test_module.py:11: AssertionError
     ________________________ test_ehlo[mail.python.org] ________________________
     
-    smtp = <smtplib.SMTP instance at 0x2377680>
+    smtp = <smtplib.SMTP instance at 0x26d6638>
     
         def test_ehlo(smtp):
             response = smtp.ehlo()
@@ -376,7 +376,7 @@
     test_module.py:5: AssertionError
     ________________________ test_noop[mail.python.org] ________________________
     
-    smtp = <smtplib.SMTP instance at 0x2377680>
+    smtp = <smtplib.SMTP instance at 0x26d6638>
     
         def test_noop(smtp):
             response = smtp.noop()
@@ -430,7 +430,7 @@
     test_appsetup.py:12: test_smtp_exists[merlinux.eu] PASSED
     test_appsetup.py:12: test_smtp_exists[mail.python.org] PASSED
     
-    ========================= 2 passed in 6.79 seconds =========================
+    ========================= 2 passed in 6.43 seconds =========================
 
 Due to the parametrization of ``smtp`` the test will run twice with two
 different ``App`` instances and respective smtp servers.  There is no


diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 doc/en/getting-started.txt
--- a/doc/en/getting-started.txt
+++ b/doc/en/getting-started.txt
@@ -122,7 +122,7 @@
     ================================= FAILURES =================================
     ____________________________ TestClass.test_two ____________________________
     
-    self = <test_class.TestClass instance at 0x22a4d40>
+    self = <test_class.TestClass instance at 0x13becf8>
     
         def test_two(self):
             x = "hello"
@@ -157,7 +157,7 @@
     ================================= FAILURES =================================
     _____________________________ test_needsfiles ______________________________
     
-    tmpdir = local('/tmp/pytest-594/test_needsfiles0')
+    tmpdir = local('/tmp/pytest-780/test_needsfiles0')
     
         def test_needsfiles(tmpdir):
             print tmpdir
@@ -166,7 +166,7 @@
     
     test_tmpdir.py:3: AssertionError
     ----------------------------- Captured stdout ------------------------------
-    /tmp/pytest-594/test_needsfiles0
+    /tmp/pytest-780/test_needsfiles0
 
 Before the test runs, a unique-per-test-invocation temporary directory
 was created.  More info at :ref:`tmpdir handling`.


diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 doc/en/parametrize.txt
--- a/doc/en/parametrize.txt
+++ b/doc/en/parametrize.txt
@@ -135,8 +135,8 @@
     
         def test_valid_string(stringinput):
     >       assert stringinput.isalpha()
-    E       assert <built-in method isalpha of str object at 0x2b1792721fa8>()
-    E        +  where <built-in method isalpha of str object at 0x2b1792721fa8> = '!'.isalpha
+    E       assert <built-in method isalpha of str object at 0x2ad17dea1fa8>()
+    E        +  where <built-in method isalpha of str object at 0x2ad17dea1fa8> = '!'.isalpha
     
     test_strings.py:3: AssertionError
 
@@ -149,7 +149,7 @@
     $ py.test -q -rs test_strings.py 
     s
     ========================= short test summary info ==========================
-    SKIP [1] /home/hpk/p/pytest/.tox/regen/lib/python2.7/site-packages/_pytest/python.py:960: got empty parameter set, function test_valid_string at /tmp/doc-exec-26/test_strings.py:1
+    SKIP [1] /home/hpk/p/pytest/.tox/regen/lib/python2.7/site-packages/_pytest/python.py:960: got empty parameter set, function test_valid_string at /tmp/doc-exec-103/test_strings.py:1
 
 For further examples, you might want to look at :ref:`more
 parametrization examples <paramexamples>`.


diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 doc/en/tmpdir.txt
--- a/doc/en/tmpdir.txt
+++ b/doc/en/tmpdir.txt
@@ -37,7 +37,7 @@
     ================================= FAILURES =================================
     _____________________________ test_create_file _____________________________
     
-    tmpdir = local('/tmp/pytest-595/test_create_file0')
+    tmpdir = local('/tmp/pytest-781/test_create_file0')
     
         def test_create_file(tmpdir):
             p = tmpdir.mkdir("sub").join("hello.txt")
@@ -48,7 +48,7 @@
     E       assert 0
     
     test_tmpdir.py:7: AssertionError
-    ========================= 1 failed in 0.03 seconds =========================
+    ========================= 1 failed in 0.04 seconds =========================
 
 .. _`base temporary directory`:
 


diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 doc/en/unittest.txt
--- a/doc/en/unittest.txt
+++ b/doc/en/unittest.txt
@@ -101,7 +101,7 @@
         def test_method1(self):
             assert hasattr(self, "db")
     >       assert 0, self.db   # fail for demo purposes
-    E       AssertionError: <conftest.DummyDB instance at 0x269e5a8>
+    E       AssertionError: <conftest.DummyDB instance at 0x1766560>
     
     test_unittest_db.py:9: AssertionError
     ___________________________ MyTest.test_method2 ____________________________
@@ -110,7 +110,7 @@
     
         def test_method2(self):
     >       assert 0, self.db   # fail for demo purposes
-    E       AssertionError: <conftest.DummyDB instance at 0x269e5a8>
+    E       AssertionError: <conftest.DummyDB instance at 0x1766560>
     
     test_unittest_db.py:12: AssertionError
     ========================= 2 failed in 0.02 seconds =========================


diff -r 2737384b71498a53f1dde1e01de09921a58cfc5e -r 81580e70517e2af175a3848c8a5a2b4ed2dc7770 tox.ini
--- a/tox.ini
+++ b/tox.ini
@@ -68,6 +68,7 @@
      :pypi:PyYAML
 commands=
     rm -rf /tmp/doc-exec*
+    pip install pytest==2.3.3
     make regen
 
 [testenv:py31]

Repository URL: https://bitbucket.org/hpk42/pytest/

--

This is a commit notification from bitbucket.org. You are receiving
this because you have the service enabled, addressing the recipient of
this email.



More information about the pytest-commit mailing list