Jun 26, 2023 · Jun 14, 2023 · Jun 15, 2023 · Jun 15, 2023 · Jun 18, 2023 · Jun 18, 2023
diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst
   Return ``True`` if the path points to a directory, ``False`` if it points
   to another kind of file.

   This method normally follows symlinks; to exclude symlinks to directories,
   add the argument ``follow_symlinks=False``.

   ``False`` is also returned if the path doesn't exist or is a broken symlink;
   other errors (such as permission errors) are propagated.

   This method normally follows symlinks; to exclude symlinks to directories,
   add the argument ``follow_symlinks=False``.

   .. versionchanged:: 3.13
      The *follow_symlinks* parameter was added.


 .. method:: Path.is_file()
 .. method:: Path.is_file(*, follow_symlinks=True)

   Return ``True`` if the path points to a regular file (or a symbolic link
 pointing to a regular file), ``False`` if itpoints to another kind of file.
   Return ``True`` if the path points to a regular file, ``False`` if it
   points to another kind of file.

   ``False`` is also returned if the path doesn't exist or is a broken symlink;
   other errors (such as permission errors) are propagated.

   This method normally follows symlinks; to exclude symlinks, add the
   argument ``follow_symlinks=False``.

   .. versionchanged:: 3.13
      The *follow_symlinks* parameter was added.


 .. method:: Path.is_junction()

diff --git a/Lib/pathlib.py b/Lib/pathlib.py
            # Non-encodable path
            return False

    def is_file(self):
    def is_file(self, *, follow_symlinks=True):
        """
        Whether this path is a regular file (also True for symlinks pointing
        to regular files).
        """
        try:
            return S_ISREG(self.stat().st_mode)
            return S_ISREG(self.stat(follow_symlinks=follow_symlinks).st_mode)
        except OSError as e:
            if not _ignore_error(e):
                raise
diff --git a/Lib/test/test_pathlib.py b/Lib/test/test_pathlib.py
            self.assertTrue((P / 'linkA').is_file())
            self.assertFalse((P / 'linkB').is_file())
            self.assertFalse((P/ 'brokenLink').is_file())
        self.assertIs((P / 'fileA\udfff').is_file(), False)
        self.assertIs((P / 'fileA\x00').is_file(), False)
        self.assertFalse((P / 'fileA\udfff').is_file())
        self.assertFalse((P / 'fileA\x00').is_file())

    def test_is_file_no_follow_symlinks(self):
        P = self.cls(BASE)
        self.assertTrue((P / 'fileA').is_file(follow_symlinks=False))
        self.assertFalse((P / 'dirA').is_file(follow_symlinks=False))
        self.assertFalse((P / 'non-existing').is_file(follow_symlinks=False))
        self.assertFalse((P / 'fileA' / 'bah').is_file(follow_symlinks=False))
        if os_helper.can_symlink():
            self.assertFalse((P / 'linkA').is_file(follow_symlinks=False))
            self.assertFalse((P / 'linkB').is_file(follow_symlinks=False))
            self.assertFalse((P/ 'brokenLink').is_file(follow_symlinks=False))
        self.assertFalse((P / 'fileA\udfff').is_file(follow_symlinks=False))
        self.assertFalse((P / 'fileA\x00').is_file(follow_symlinks=False))

    def test_is_mount(self):
        P = self.cls(BASE)
diff --git a/Misc/NEWS.d/next/Library/2023-06-14-18-41-18.gh-issue-105793.YSoykM.rst b/Misc/NEWS.d/next/Library/2023-06-14-18-41-18.gh-issue-105793.YSoykM.rst
 Add *follow_symlinks* keyword-only argument to :meth:`pathlib.Path.is_dir`,
 defaulting to ``True``.
 Add *follow_symlinks* keyword-only argument to :meth:`pathlib.Path.is_dir` and
 :meth:`~pathlib.Path.is_file`,defaulting to ``True``.
Original file line number	Diff line number	Diff line change
Expand Up		@@ -958,24 +958,30 @@ call fails (for example because the path doesn't exist).
		Return ``True`` if the path points to a directory, ``False`` if it points
		to another kind of file.

		This method normally follows symlinks; to exclude symlinks to directories,
		add the argument ``follow_symlinks=False``.

		``False`` is also returned if the path doesn't exist or is a broken symlink;
		other errors (such as permission errors) are propagated.

		This method normally follows symlinks; to exclude symlinks to directories,
		add the argument ``follow_symlinks=False``.

		.. versionchanged:: 3.13
		The follow_symlinks parameter was added.


		.. method:: Path.is_file()
		.. method:: Path.is_file(*, follow_symlinks=True)

		Return ``True`` if the path points to a regular file (or a symbolic link
		pointing to a regular file), ``False`` if itpoints to another kind of file.
		Return ``True`` if the path points to a regular file, ``False`` if it
		points to another kind of file.

		``False`` is also returned if the path doesn't exist or is a broken symlink;
		other errors (such as permission errors) are propagated.

		This method normally follows symlinks; to exclude symlinks, add the
		argument ``follow_symlinks=False``.

		.. versionchanged:: 3.13
		The follow_symlinks parameter was added.


		.. method:: Path.is_junction()

Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -825,13 +825,13 @@ def is_dir(self, *, follow_symlinks=True):
		# Non-encodable path
		return False

		def is_file(self):
		def is_file(self, *, follow_symlinks=True):
		"""
		Whether this path is a regular file (also True for symlinks pointing
		to regular files).
		"""
		try:
		return S_ISREG(self.stat().st_mode)
		return S_ISREG(self.stat(follow_symlinks=follow_symlinks).st_mode)
		except OSError as e:
		if not _ignore_error(e):
		raise
Expand Down
Original file line number	Diff line number	Diff line change
Expand Up		@@ -2205,8 +2205,21 @@ def test_is_file(self):
		self.assertTrue((P / 'linkA').is_file())
		self.assertFalse((P / 'linkB').is_file())
		self.assertFalse((P/ 'brokenLink').is_file())
		self.assertIs((P / 'fileA\udfff').is_file(), False)
		self.assertIs((P / 'fileA\x00').is_file(), False)
		self.assertFalse((P / 'fileA\udfff').is_file())
		self.assertFalse((P / 'fileA\x00').is_file())

		def test_is_file_no_follow_symlinks(self):
		P = self.cls(BASE)
		self.assertTrue((P / 'fileA').is_file(follow_symlinks=False))
		self.assertFalse((P / 'dirA').is_file(follow_symlinks=False))
		self.assertFalse((P / 'non-existing').is_file(follow_symlinks=False))
		self.assertFalse((P / 'fileA' / 'bah').is_file(follow_symlinks=False))
		if os_helper.can_symlink():
		self.assertFalse((P / 'linkA').is_file(follow_symlinks=False))
		self.assertFalse((P / 'linkB').is_file(follow_symlinks=False))
		self.assertFalse((P/ 'brokenLink').is_file(follow_symlinks=False))
		self.assertFalse((P / 'fileA\udfff').is_file(follow_symlinks=False))
		self.assertFalse((P / 'fileA\x00').is_file(follow_symlinks=False))

		def test_is_mount(self):
		P = self.cls(BASE)
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -1,2 +1,2 @@
		Add follow_symlinks keyword-only argument to :meth:`pathlib.Path.is_dir`,
		defaulting to ``True``.
		Add follow_symlinks keyword-only argument to :meth:`pathlib.Path.is_dir` and
		:meth:`~pathlib.Path.is_file`,defaulting to ``True``.