GH-73991: Rework pathlib.Path.rmtree() into delete()

[barneygale]

Rename pathlib.Path.rmtree() to delete(), and add support for deleting non-directories. This simplifies the interface for users, and nicely complements the upcoming move() and copy() methods (which will also accept any type of file.)

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

---

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

[AA-Turner]

Implementation looks fine, only one question

A

[barneygale]

@nineteendo I'd welcome your review on this, if you have the time and inclination. No worries if not! Thanks in advance :)

[AA-Turner]

Merci beaucoup!

A

[barneygale]

Thank you very much for the reviews :)

[AA-Turner]

Sorry for my tardiness! Do let me know if there's anything else I can usefully review

A

[barneygale]

Not tardy at all I don't think! :]

Do let me know if there's anything else I can usefully review

Since you're offering, the next PR on the critical path here is #122369. But there's a lot going on there, so feel free to give it a miss or ask me to explain it further / break it up / whatever. Thanks again! And feel free to assign me when you next need a review of something.