Wrap os.DirEntry in _DirEntryStatus

Author: barneygale

Doc/library/pathlib.rst

@@ -1195,11 +1195,8 @@ Querying file type and status
       directory
 
    If the path was generated from :meth:`Path.iterdir` then this attribute is
-   an :class:`os.DirEntry` instance. These objects are initialized with some
-   information about the file type; see the :func:`os.scandir` docs for
-   details. In other cases, this attribute is an instance of an internal
-   pathlib class which initially knows nothing about the file status. In
-   either case, merely accessing :attr:`Path.status` does not perform any
+   initialized with information about the file type gleaned from scanning the
+   parent. Merely accessing :attr:`Path.status` does not perform any
    filesystem queries.
 
    To fetch up-to-date information, it's best to call :meth:`Path.is_dir`,

Doc/whatsnew/3.14.rst

@@ -543,9 +543,8 @@ pathlib
   implementing the :class:`pathlib.types.Status` protocol (also new). The
   object supports querying the file type and internally caching
   :func:`~os.stat` results. Path objects generated by
-  :meth:`~pathlib.Path.iterdir` store :class:`os.DirEntry` objects, which are
-  initialized with file type information gleaned from scanning the parent
-  directory.
+  :meth:`~pathlib.Path.iterdir` are initialized with file type information
+  gleaned from scanning the parent directory.
 
   (Contributed by Barney Gale in :gh:`125413`.)
 

Lib/pathlib/_local.py

@@ -108,6 +108,35 @@ def is_symlink(self):
         return S_ISLNK(self._get_mode(follow_symlinks=False))
 
 
+class _DirEntryStatus:
+    __slots__ = ('_entry', '_repr')
+
+    def __init__(self, path, entry):
+        self._entry = entry
+        self._repr = f"<{type(path).__name__}.status>"
+
+    def __repr__(self):
+        return self._repr
+
+    def is_dir(self, *, follow_symlinks=True):
+        """
+        Whether this path is a directory.
+        """
+        return self._entry.is_dir(follow_symlinks=follow_symlinks)
+
+    def is_file(self, *, follow_symlinks=True):
+        """
+        Whether this path is a regular file.
+        """
+        return self._entry.is_file(follow_symlinks=follow_symlinks)
+
+    def is_symlink(self):
+        """
+        Whether this path is a symbolic link.
+        """
+        return self._entry.is_symlink()
+
+
 class PurePath(PurePathBase):
     """Base class for manipulating paths without I/O.
 
@@ -762,7 +791,7 @@ def _filter_trailing_slash(self, paths):
     def _from_dir_entry(self, dir_entry, path_str):
         path = self.with_segments(path_str)
         path._str = path_str
-        path._status = dir_entry
+        path._status = _DirEntryStatus(path, dir_entry)
         return path
 
     def iterdir(self):

Misc/NEWS.d/next/Library/2024-12-10-19-39-35.gh-issue-125413.wOb4yr.rst

@@ -2,6 +2,5 @@ Add :attr:`pathlib.Path.status` attribute, which stores an object
 implementing the :class:`pathlib.types.Status` protocol (also new). The
 object supports querying the file type and internally caching
 :func:`~os.stat` results. Path objects generated by
-:meth:`~pathlib.Path.iterdir` store :class:`os.DirEntry` objects, which are
-initialized with file type information gleaned from scanning the parent
-directory.
+:meth:`~pathlib.Path.iterdir` are initialized with file type information
+gleaned from scanning the parent directory.