a bit better example in pathlib docs - maybe include example path that involves file in a folder(s)?

[matkoniecz]

Documentation

See https://docs.python.org/3/library/pathlib.html#concrete-paths

Path('setup.py') and PosixPath('/etc') and WindowsPath('c:/Program Files/') both have single level only.

Would it be OK to have example with file in a folder? say PosixPath('/etc/hosts') (if that is correct way to pass more complex paths to constructor...)

Would PR changing this would be welcome and have chances to be reviewed?

Linked PRs

• GH-120794: Use example paths with multiple parts in pathlib docs #122887
• [3.13] GH-120794: Use example paths with multiple parts in pathlib docs (GH-122887) #122895
• [3.12] GH-120794: Use example paths with multiple parts in pathlib docs (GH-122887) #122896

[nineteendo]

Sure, also applies to pure paths: https://docs.python.org/3/library/pathlib.html#pure-paths, which is only seen in normalisation edge cases and unc paths.

[barneygale]

A few more examples wouldn't hurt, e.g. for PosixPath we could show:

>>> PosixPath('/etc/hosts')
PosixPath('/etc/hosts')
>>> PosixPath('/home', 'mat', '.profile')
PosixPath('/home/mat/.profile')

Happy to review a PR

[barneygale]

Sorted. Thanks again for reporting, @matkoniecz!

[matkoniecz]

And thanks for processing suggestion! In many projects such issues are completely ignored, so it was kind of pleasant surprise to see this one actually implemented. It definitely makes me like Python even more.