From 264e7ac32733572fad3892ba0e830dba7cc87cf0 Mon Sep 17 00:00:00 2001
From: Ran Benita <ran@unusedvar.com>
Date: Wed, 14 Jun 2023 09:22:34 +0300
Subject: [PATCH] reference: add doc for `Package`

We document the other py collectors, we should document `Package` as
well.
---
 doc/en/reference/reference.rst | 6 ++++++
 src/_pytest/python.py          | 3 +++
 2 files changed, 9 insertions(+)

diff --git a/doc/en/reference/reference.rst b/doc/en/reference/reference.rst
index 7107218b3..f591eb21e 100644
--- a/doc/en/reference/reference.rst
+++ b/doc/en/reference/reference.rst
@@ -926,6 +926,12 @@ Parser
 .. autoclass:: pytest.Parser()
     :members:
 
+Package
+~~~~~~~
+
+.. autoclass:: pytest.Package()
+    :members:
+
 OptionGroup
 ~~~~~~~~~~~
 
diff --git a/src/_pytest/python.py b/src/_pytest/python.py
index ad847c8af..2036819cf 100644
--- a/src/_pytest/python.py
+++ b/src/_pytest/python.py
@@ -659,6 +659,9 @@ class Module(nodes.File, PyCollector):
 
 
 class Package(Module):
+    """Collector for files and directories in a Python packages -- directories
+    with an `__init__.py` file."""
+
     def __init__(
         self,
         fspath: Optional[LEGACY_PATH],