bpo-39285: Clarify example for PurePath.match

[timlo]

Fixes Issue39285

The example incorrectly returned True for match.

Furthermore the example is ambiguous in its usage of PureWindowsPath.
Windows is case-insensitve, however the underlying match functionality
utilizes fnmatch.fnmatchcase.

https://bugs.python.org/issue39285

https://bugs.python.org/issue39285

Automerge-Triggered-By: @pitrou

[pitrou]

I don't understand this PR. The point of this snippet in the documentation is to show that case-sensitivity follows platform defaults.
Perhaps the example should be enhanced to show how Posix and Windows paths differ, e.g.:

>>> PurePosixPath('b.py').match('*.PY')
False
>>> PureWindowsPath('b.py').match('*.PY')
True

[pitrou]

cc @barneygale

[barneygale]

Sounds like a wording problem. This sentence:

As with other methods, case-sensitivity is observed:

Can be taken to mean that path.match() is always case-sensitive, regardless of platform. It could be tweaked to say:

As with other methods, the flavour's case-folding semantics are respected:

I agree that an additional example involving PurePosixPath would help.

[timlo]

Thanks! I've updated the example and wording to incorporate the feedback.

[pitrou]

+1, thank you

[miss-islington]

Thanks @timlo for the PR 🌮🎉.. I'm working now to backport this PR to: 3.7, 3.8.
🐍🍒⛏🤖

[bedevere-bot]

GH-19597 is a backport of this pull request to the 3.8 branch.

[bedevere-bot]

GH-19598 is a backport of this pull request to the 3.7 branch.