Add note about not monkey-patching builtins (pytest-dev#1986)

* Add note about not monkey-patching builtins Related to pytest-dev#1985 * Mention -s as well
nicoddemus · Oct 5, 2016 · 50b960c · 50b960c
1 parent d47ae79
commit 50b960c
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/doc/en/monkeypatch.rst b/doc/en/monkeypatch.rst
@@ -55,6 +55,14 @@ will delete the method ``request.session.Session.request``
 so that any attempts within tests to create http requests will fail.
 
 
+.. note::
+
+    Be advised that it is not recommended to patch builtin functions such as ``open``,
+    ``compile``, etc., because it might break pytest's internals. If that's
+    unavoidable, passing ``--tb=native``, ``--assert=plain`` and ``--capture=no`` might 
+    help althought there's no guarantee.
+
+
 Method reference of the monkeypatch fixture
 -------------------------------------------