VimPlug/typeshed
1
0
Fork 0
mirror of https://github.com/davidhalter/typeshed.git synced 2025-12-23 12:21:27 +08:00
Code Issues Actions Packages Projects Releases Wiki Activity

Make os.path.join() first parameter pos-only (#6812)

Browse Source
This commit is contained in:
Alex Waygood
2022-01-04 14:38:46 +00:00
committed by GitHub
parent 73302d3bb8
commit 582f1e9c5f
3 changed files with 15 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
stdlib/ntpath.pyi
View File

@@ -48,11 +48,13 @@ altsep: str
if sys.version_info < (3, 7) and sys.platform == "win32":
def splitunc(p: AnyStr) -> tuple[AnyStr, AnyStr]: ... # deprecated
# Similar to posixpath, but have slightly different argument names
# First parameter is not actually pos-only,
# but must be defined as pos-only in the stub or cross-platform code doesn't type-check,
# as the parameter name is different in posixpath.join()
@overload
def join(path: StrPath, *paths: StrPath) -> str: ...
def join(__path: StrPath, *paths: StrPath) -> str: ...
@overload
def join(path: BytesPath, *paths: BytesPath) -> bytes: ...
def join(__path: BytesPath, *paths: BytesPath) -> bytes: ...
if sys.platform == "win32":
if sys.version_info >= (3, 10):

8
stdlib/posixpath.pyi
View File

@@ -60,10 +60,14 @@ def normpath(path: AnyStr) -> AnyStr: ...
def commonpath(paths: Sequence[StrPath]) -> str: ...
@overload
def commonpath(paths: Sequence[BytesPath]) -> bytes: ...
# First parameter is not actually pos-only,
# but must be defined as pos-only in the stub or cross-platform code doesn't type-check,
# as the parameter name is different in ntpath.join()
@overload
def join(a: StrPath, *paths: StrPath) -> str: ...
def join(__a: StrPath, *paths: StrPath) -> str: ...
@overload
def join(a: BytesPath, *paths: BytesPath) -> bytes: ...
def join(__a: BytesPath, *paths: BytesPath) -> bytes: ...
if sys.version_info >= (3, 10):
@overload

4
tests/stubtest_allowlists/py310.txt
View File

@@ -115,6 +115,10 @@ contextlib.AbstractContextManager.__exit__
io.IncrementalNewlineDecoder.setstate
typing.SupportsRound.__round__
types.DynamicClassAttribute..* # In the stub we pretend it's an alias for property, but it has positional-only differences
# These three have a pos-or-keyword first parameter at runtime, but deliberately have a pos-only first parameter in the stub. #6812
posixpath.join
ntpath.join
os.path.join
# These enums derive from (str, Enum). See comment in py3_common.txt
pstats.SortKey.__new__