pathlib's relative_to should behave like os.path.relpath

[domragusa]

BPO	40358
Nosy	@pitrou, @eryksun, @ammaraskar, @CuriousLearner, @CAM-Gerlach, @barneygale, @domragusa, @bowiechen
PRs	bpo-40358: add strict parameter to pathlib.PurePath.relative_to #19807 gh-84538: add strict argument to pathlib.PurePath.relative_to #19813
Files	relative_to.patch

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = None
created_at = <Date 2020-04-22.00:03:03.148>
labels = ['type-feature', 'library', '3.11']
title = "pathlib's relative_to should behave like os.path.relpath"
updated_at = <Date 2022-02-22.23:57:02.772>
user = 'https://github.com/domragusa'

bugs.python.org fields:

activity = <Date 2022-02-22.23:57:02.772>
actor = 'terry.reedy'
assignee = 'none'
closed = False
closed_date = None
closer = None
components = ['Library (Lib)']
creation = <Date 2020-04-22.00:03:03.148>
creator = 'd.ragusa'
dependencies = []
files = ['49095']
hgrepos = []
issue_num = 40358
keywords = ['patch']
message_count = 11.0
messages = ['366958', '367037', '367041', '367047', '367490', '367697', '367723', '370254', '393696', '393777', '408249']
nosy_count = 10.0
nosy_names = ['pitrou', 'python-dev', 'eryksun', 'ammar2', 'Socob', 'CuriousLearner', 'CAM-Gerlach', 'barneygale', 'd.ragusa', 'bowiechen']
pr_nums = ['19807', '19813']
priority = 'normal'
resolution = None
stage = 'patch review'
status = 'open'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue40358'
versions = ['Python 3.11']

[domragusa]

Can we improve pathlib.relative_to(other) so that it handles the case of a path not being a direct child of other, like os.path.relpath?

For example:
Path('/some/thing').relative_to('/foo') -> Path('../some/thing')

At the moment it just raises an exception.

[pitrou]

The current behaviour is by design. I would not mind adding an option to control it, though.

If you are new to Python development and want to submit a patch or PR, I recommend reading the Developer's Guide:
https://devguide.python.org/

[domragusa]

Thanks for your answer. Yeah, I'm new, I'm reading the guide, sorry for any
faux pas :)

Ok, an option would be great as well, a simple True/False switch? Any
suggestion for the name?
I'll get back with a proper patch this time.

On Wed, Apr 22, 2020 at 8:18 PM Antoine Pitrou <report@bugs.python.org>
wrote:

Antoine Pitrou <solipsis@pitrou.net> added the comment:

The current behaviour is by design. I would not mind adding an option to
control it, though.

If you are new to Python development and want to submit a patch or PR, I
recommend reading the Developer's Guide:
https://devguide.python.org/

----------

---

Python tracker <report@bugs.python.org>
<https://bugs.python.org/issue40358\>

---

[eryksun]

Note that the implementation of relpath is pure and thus assumes it's working with existing, resolved paths (i.e. "the filesystem is not accessed to confirm the existence or nature of path or start"). For example:

 >>> os.path.relpath('/some/thing', '/symlink')
 '../some/thing'

If "symlink" targets "/spam/eggs/foo", then the resolved path would be "/spam/eggs/some/thing" instead of "/some/thing". Maybe the relative_to method should default to a strict mode that raises ValueError on ambiguous cases that depend on the "existence or nature" of the paths. I think the current implementation is strict.

[domragusa]

Yeah, you're right, there's no access to the filesystem and the result
is generated assuming the paths are already resolved.
strict seems to be an appropriate name for the option, thanks.

I've looked into the test suite, it helped a lot especially with
Windows paths, they were more complicated than I though.
I've duplicated the tests to verify that it still function as before
and I've added some tests for values that would raise an exception. It
works.
I'm not overly fond of the way I check for unrelated paths, but I
couldn't think of something more elegant.

Any input is appreciated.

[ammaraskar]

Thank you for your work on this Domenico. For reviewing the code, would you mind creating a Github pull request for it as described here https://devguide.python.org/pullrequest/

[domragusa]

I may have forgotten to use the proper format for the title of each
commit, should I delete the pull request and make a new one or can it
be fixed when (or if) it's pulled?

On Thu, Apr 30, 2020 at 2:03 AM Roundup Robot <report@bugs.python.org> wrote:

Change by Roundup Robot <devnull@psf.upfronthosting.co.za>:

----------
nosy: +python-dev
nosy_count: 5.0 -> 6.0
pull_requests: +19128
stage: -> patch review
pull_request: #19807

---

Python tracker <report@bugs.python.org>
<https://bugs.python.org/issue40358\>

---

[domragusa]

I've solved the conflicts with #63810 (bpo-23082: Better error message for PurePath.relative_to() from pathlib) that was merged in the mean time and improved the documentation.

Everything appears to be in order, can you take a look at it?

[terryjreedy]

On bpo-44078 (closed as duplicate), Mark Hammond made a similar request.