GH-73991: Add pathlib.Path.rmtree()

[barneygale]

Add a Path.rmtree() method that removes an entire directory tree, like shutil.rmtree(). The signature of the optional on_error argument matches the Path.walk() argument of the same name, but differs from the onexc and onerror arguments to shutil.rmtree(). Consistency within pathlib is probably more important.

In the private pathlib ABCs, we add an implementation based on walk().

• Issue: Support moving across filesystems in pathlib.Path, as shutil.move() does #73991

---

📚 Documentation preview 📚: https://cpython-previews--119060.org.readthedocs.build/

[picnixz]

Thank you for that addition by the way. Here are some nitpicking comments.

[AA-Turner]

Docs failure is #122068