Tracking issue for Path::relative_from stabilization

[brson]

Path::relative_from removes the common prefix from a path, e.g. /foo/bar relative_from /foo yields bar.

The old path_relative_from would calculate the relative path from two points on the file system, e.g. the relative path from /foo/bar to /foo/baz/qux is ../baz/qux. This is a useful operation.

Nominating because I think either relative_from is named wrong or is not useful.

[brson]

cc #23283

[aturon]

cc me

[aturon]

Note that the reason the new semantics was adopted has to do with symlinks (the same reason we do not normalize ..). We'll need to discuss this further, but for now it's plausible to leave this function unstable.

[pnkfelix]

Function is not yet stable, so this need not be milestoned. P-high, not 1.0.

[lilyball]

Path::relative_from made more sense back when we auto-normalized paths. The idea was if you joined the result to the first path, you'd get the second path. Since we don't normalize like that anymore, that behavior doesn't work.

It's still a potentially useful operation, but because of symlinks, there are two different behaviors that might be desired:

1. The current behavior where joining the result onto the first path unambiguously refers to the same thing the second path does, even if there's symlinks (which basically means base needs to be a prefix of self)
2. The old behavior where the result can start with ../ components. Symlinks mean traversing the base path and then traversing the returned relative path may not put you in the same directory that traversing theself` path does. But this operation is useful when either you're working with a path-based system that doesn't care about symlinks, or you've already resolved symlinks in the paths you're working with.

Based on that I think it's reasonable to provide both implementations. The former might want to be called something like strip_prefix() instead. the latter could continue to be called relative_from.

[withoutboats]

Nominating because I think either relative_from is named wrong or is not useful.

Just noting that I have found this function useful. I think it would probably make more sense to name it something like strip_prefix though.

[rgardner]

I too have found this function useful. What has to happen to stabilize this?

[JanLikar]

This should be stabilized or a similar function should be proposed.