Clarify usage of usefixtures mark in hooks

Fix #7512 Co-authored-by: Bruno Oliveira <[email protected]>
pytest-dev · Jul 22, 2020 · dbc50a7 · dbc50a7
1 parent 6ecb8f5
commit dbc50a7
Show file tree

Hide file tree

Showing 2 changed files with 9 additions and 5 deletions.
diff --git a/changelog/7422.doc.rst b/changelog/7422.doc.rst
@@ -0,0 +1 @@
+Clarified when the ``usefixtures`` mark can apply fixtures to test.
diff --git a/doc/en/reference.rst b/doc/en/reference.rst
@@ -180,15 +180,18 @@ pytest.mark.usefixtures
 
 Mark a test function as using the given fixture names.
 
-.. warning::
-
-    This mark has no effect when applied
-    to a **fixture** function.
-
 .. py:function:: pytest.mark.usefixtures(*names)
 
     :param args: the names of the fixture to use, as strings
 
+.. note::
+
+    When using `usefixtures` in hooks, it can only load fixtures when applied to a test function before test setup
+    (for example in the `pytest_collection_modifyitems` hook).
+
+    Also not that his mark has no effect when applied to **fixtures**.
+
+
 
 .. _`pytest.mark.xfail ref`:
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1 @@
		Clarified when the ``usefixtures`` mark can apply fixtures to test.