GH-125413: Add pathlib.Path.scandir() method

[barneygale]

Add pathlib.Path.scandir() as a trivial wrapper of os.scandir().

In a future PR, I will rework pathlib._abc.PathBase.glob(), walk() and copy() methods to call scandir() and make use of cached directory entry information, and thereby improve performance. Because the Path.copy() method is provided by PathBase, this also speeds up traversal when copying local files and directories.

• Issue: Expose os.DirEntry objects from pathlib #125413

---

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

[ncoghlan]

LGTM!

[barneygale]

Woot! Thanks very much for your feedback on this, it's been most helpful in clarifying what's needed.

[Ferdi265]

I'm not sure if this is the correct place to put this feedback, but Path.scandir() returning an iterator of os.DirEntry directly, whose .path member is a str or bytes, rather than a Path is unexpected.

At least on first glance, it's unexpected that a member named "path" on an object returned from a method of Path is not actually of type Path.

withpath.scandir() asentries:
forentryinentries:
assertisinstance(entry.path, Path), "unexpected type"

[barneygale]

Would you care to open a topic on discuss.python.org? It's a good thought and worth bringing to wider attention I think.

At the moment you can get a path object with path / entry.name (edit: or pathlib.Path(entry)).

[Ferdi265]

Would you care to open a topic on discuss.python.org?

done