Files
meson/mesonbuild/_pathlib.py
Dylan Baker 2c63b423f2 pathlib: Use WindowsPath directly instead of messing with Path for subclassing
The code I came up with works with mypy for versions of Python >= 3.12,
but for 3.11 and 3.10 it still complains that _BASE_CLASS isn't a static
type. The problem is that in those versions `pathlib.Path` is a factory
instead of a type. But we can side step that because this hack exists
for Windows and only, and just directly inherit the WindowsPath
2026-06-04 08:12:10 +02:00

71 lines
2.1 KiB
Python

# SPDX-License-Identifier: Apache-2.0
# Copyright 2021 The Meson development team
'''
This module soly exists to work around a pathlib.resolve bug on
certain Windows systems:
https://github.com/mesonbuild/meson/issues/7295
https://bugs.python.org/issue31842
It should **never** be used directly. Instead, it is automatically
used when `import pathlib` is used. This is achieved by messing with
`sys.modules['pathlib']` in mesonmain.
Additionally, the sole purpose of this module is to work around a
python bug. This only bugfixes to pathlib functions and classes are
allowed here. Finally, this file should be removed once all upstream
python bugs are fixed and it is OK to tell our users to "just upgrade
python".
'''
from __future__ import annotations
import pathlib
import os
import platform
__all__ = [
'PurePath',
'PurePosixPath',
'PureWindowsPath',
'Path',
]
PurePath = pathlib.PurePath
PurePosixPath = pathlib.PurePosixPath
PureWindowsPath = pathlib.PureWindowsPath
# Only patch on platforms where the bug occurs
if platform.system().lower() == 'windows':
# Can not directly inherit from pathlib.Path because the __new__
# operator of pathlib.Path() returns a {Posix,Windows}Path object
# until Python 3.12, when this was changed so that Path can be directly
# inherited.
#
# Since this particular code path is only relevant to Windows, just inherit
# WindowsPath directly.
class _Path(pathlib.WindowsPath):
def resolve(self, strict: bool = False) -> _Path:
'''
Work around a resolve bug on certain Windows systems:
https://github.com/mesonbuild/meson/issues/7295
https://bugs.python.org/issue31842
'''
try:
return super().resolve(strict=strict)
except OSError:
return _Path(os.path.normpath(self))
Path: type[pathlib.Path] = _Path
else:
Path = pathlib.Path
PosixPath = pathlib.PosixPath
WindowsPath = pathlib.WindowsPath
__all__ += [
'PosixPath',
'WindowsPath',
]