From 1b7896f83d5c7ed822f5efc1d62fb33325ce2471 Mon Sep 17 00:00:00 2001
From: Ran Benita <ran@unusedvar.com>
Date: Fri, 23 Jun 2023 15:25:52 +0300
Subject: [PATCH] Add PytestRemovedIn9Warning

It's good to have it available already in all 8.* versions, even if it's
not used yet.
---
 doc/en/reference/reference.rst | 3 +++
 src/_pytest/warning_types.py   | 6 ++++++
 src/pytest/__init__.py         | 2 ++
 3 files changed, 11 insertions(+)

diff --git a/doc/en/reference/reference.rst b/doc/en/reference/reference.rst
index 83bbccbcb..d5ab94bc3 100644
--- a/doc/en/reference/reference.rst
+++ b/doc/en/reference/reference.rst
@@ -1153,6 +1153,9 @@ Custom warnings generated in some situations such as improper usage or deprecate
 .. autoclass:: pytest.PytestRemovedIn8Warning
   :show-inheritance:
 
+.. autoclass:: pytest.PytestRemovedIn9Warning
+  :show-inheritance:
+
 .. autoclass:: pytest.PytestUnhandledCoroutineWarning
    :show-inheritance:
 
diff --git a/src/_pytest/warning_types.py b/src/_pytest/warning_types.py
index bd5f41873..f6b0a3a69 100644
--- a/src/_pytest/warning_types.py
+++ b/src/_pytest/warning_types.py
@@ -56,6 +56,12 @@ class PytestRemovedIn8Warning(PytestDeprecationWarning):
     __module__ = "pytest"
 
 
+class PytestRemovedIn9Warning(PytestDeprecationWarning):
+    """Warning class for features that will be removed in pytest 9."""
+
+    __module__ = "pytest"
+
+
 class PytestReturnNotNoneWarning(PytestRemovedIn8Warning):
     """Warning emitted when a test function is returning value other than None."""
 
diff --git a/src/pytest/__init__.py b/src/pytest/__init__.py
index 9c1d5d204..58ddb3288 100644
--- a/src/pytest/__init__.py
+++ b/src/pytest/__init__.py
@@ -71,6 +71,7 @@ from _pytest.warning_types import PytestConfigWarning
 from _pytest.warning_types import PytestDeprecationWarning
 from _pytest.warning_types import PytestExperimentalApiWarning
 from _pytest.warning_types import PytestRemovedIn8Warning
+from _pytest.warning_types import PytestRemovedIn9Warning
 from _pytest.warning_types import PytestReturnNotNoneWarning
 from _pytest.warning_types import PytestUnhandledCoroutineWarning
 from _pytest.warning_types import PytestUnhandledThreadExceptionWarning
@@ -131,6 +132,7 @@ __all__ = [
     "PytestDeprecationWarning",
     "PytestExperimentalApiWarning",
     "PytestRemovedIn8Warning",
+    "PytestRemovedIn9Warning",
     "PytestReturnNotNoneWarning",
     "Pytester",
     "PytestPluginManager",