Feature or enhancement

Add a function that splits a path into a(drive, root, tail) triad:

1. Thedrive part has the same meaning as insplitdrive()
2. Theroot part is one of: the empty string, a forward slash, a backward slash (Windows only), or two forward slashes (POSIX only)
3. Thetail part is everything following the root.

Similarly tosplitdrive(), asplitroot() function would ensure thatdrive + root + tail is the same as the input path.

Pitch

The extra level of detail reflects an extra step in the Windows 'current path' hierarchy -- Windows has both a 'current drive', and a 'current directory' for one or more drives, which results in several kinds of non-absolute paths, e.g. 'foo/bar', '/foo/bar', 'X:foo/bar'

This three-part model is used successfully by pathlib, which exposesroot as an attribute, and combinesdrive + root as an attribute calledanchor. The anchor has useful properties, e.g. comparing two paths anchors can tell us whether arelative_to() operation is possible.

Pathlib hasits own implementation ofsplitroot(), but its performance is hamstrung by its need for OS-agnosticism. By moving the implementation intontpath andposixpath we can take advantage of OS-specific rules to improve pathlib performance.

Previous discussion

• https://discuss.python.org/t/add-os-path-splitroot/22243
• https://github.com/python/cpython/pull/31691/files#r944987609
• https://github.com/python/cpython/pull/100351/files/5b67a7489e5518975d0c11033cd35bf60fad0ddf#r1065219273

Linked PRs

• gh-101000: Add os.path.splitroot() #101002