Support `exist_ok` for `pathlib`'s `Path.copy_into()`

Bug report

Bug description:

Background

The Path.copy_into() method (introduced in Python 3.14) is used to copy files or directories into another directory.
The behaviour of files being copied and directories being copied is inconsistent when the destination directory contains a file or directory with the same name.

Examples

When a file is copied into a directory that already has a file with that name, the copied file overwrites the file at the destination directory:

"""
# Copying a file into a directory that already has a file with the same name #

Directory Structure:
dir_a
    |__my_file.txt

dir_b
    |__my_file.txt
"""
from pathlib import Path

dir_a_my_file = Path("dir_a") / "my_file.txt"
dir_b = Path("dir_b")

# Act
dir_a_my_file.copy_into(dir_b)  # Success - dir_a/my_file.txt overwrites dir_b/my_file.txt

However, when a directory is copied into another directory (one which contains a sub-directory with the same name),
the copy operation fails and FileExistsError is raised:

"""
# Copying a directory into a directory, that contains a sub-directory with the same name #

Directory Structure:
dir_a
    |__my_dir

dir_b
    |__my_dir
"""
from pathlib import Path

dir_a_my_dir = Path("dir_a") / "my_dir"
dir_b = Path("dir_b")

# Act
dir_a_my_dir.copy_into(dir_b)  # Failure - FileExistsError is raised.

Problem

The behaviour of the copy_into() method in the file case (success) and in the directory case (failure) is inconsistent.
It is also inconsistent with how Linux (when using cp -r) handles this exact same case.

Expected Result

Instead of raising an exception, the copied directory should be merged with the existing one.

Fix Suggestion

1. Add a default exist_ok=True parameter to copy_into().
   This parameter is already used in the Path.touch() and Path.mkdir() methods, and should be familiar to users.

2. When a file is copied into a destination directory that already has a file with the same name:

   • If exist_ok=True, the copied file should overwrite the file at the destination directory.
     This is the already the current behaviour, so no additional changes are required.

   • If exist_ok=False, a FileExistsError exception will be raised. This is consistent with the behaviour of Path.touch().

3. When a directory is copied into a destination directory that contains a sub-directory with the same name:

   • If exist_ok=True, the copied directory will be merged with the destination's sub-directory.
     This is consistent with the behaviour of copying in Linux.
   • If exist_ok=False, a FileExistsError exception will be raised. This is consistent with the behaviour of Path.mkdir().

Thank you.

CPython versions tested on:

3.14

Operating systems tested on:

Linux

Linked PRs

• gh-143058

Bắt đầu bằng cách tìm phần triển khai pathlib và các bài kiểm thử cho Path.copy_into(), sau đó so sánh hành vi hiện tại khi xảy ra xung đột tệp và thư mục với Path.touch() và Path.mkdir(). Được xem là hoàn tất khi exist_ok được hỗ trợ, các bản sao thư mục đệ quy được hợp nhất hoặc phát sinh ngoại lệ như đã chỉ định, và cả hai trường hợp đều được bao phủ bởi các bài kiểm thử; lưu ý rằng PR được liên kết gh-143058 đã cho thấy công việc đang được tiến hành.