Merge pull request #3153 from brianmaissy/document_not_to_call_main_multiple_times
Added note that calling pytest.main multiple times from the same process is not recommended because of import caching
This commit is contained in:
		
						commit
						3bc7ced97a
					
				| 
						 | 
					@ -0,0 +1 @@
 | 
				
			||||||
 | 
					Added note that calling pytest.main multiple times from the same process is not recommended because of import caching.
 | 
				
			||||||
| 
						 | 
					@ -388,5 +388,14 @@ hook was invoked::
 | 
				
			||||||
    $ python myinvoke.py
 | 
					    $ python myinvoke.py
 | 
				
			||||||
    *** test run reporting finishing
 | 
					    *** test run reporting finishing
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					.. note::
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					    Calling ``pytest.main()`` will result in importing your tests and any modules
 | 
				
			||||||
 | 
					    that they import. Due to the caching mechanism of python's import system,
 | 
				
			||||||
 | 
					    making subsequent calls to ``pytest.main()`` from the same process will not
 | 
				
			||||||
 | 
					    reflect changes to those files between the calls. For this reason, making
 | 
				
			||||||
 | 
					    multiple calls to ``pytest.main()`` from the same process (in order to re-run
 | 
				
			||||||
 | 
					    tests, for example) is not recommended.
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
.. include:: links.inc
 | 
					.. include:: links.inc
 | 
				
			||||||
| 
						 | 
					
 | 
				
			||||||
		Loading…
	
		Reference in New Issue