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!