Skip to content

[stdlib] Use "; removed ..." in deprecation messages #16293

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
srittau merged 1 commit into from
Aug 24, 2026
Merged

[stdlib] Use "; removed ..." in deprecation messages #16293

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions stdlib/argparse.pyi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -458,7 +458,7 @@ if sys.version_info >= (3, 12):
deprecated: bool = False,
) -> None: ...
@overload
@deprecated("The `type`, `choices`, and `metavar` parameters are ignored and will be removed in Python 3.14.")
@deprecated("The `type`, `choices`, and `metavar` parameters are ignored; removed in Python 3.14.")
def __init__(
self,
option_strings: Sequence[str],
Expand All @@ -483,7 +483,7 @@ if sys.version_info >= (3, 12):
help: str | None = None,
) -> None: ...
@overload
@deprecated("The `type`, `choices`, and `metavar` parameters are ignored and will be removed in Python 3.14.")
@deprecated("The `type`, `choices`, and `metavar` parameters are ignored; removed in Python 3.14.")
def __init__(
self,
option_strings: Sequence[str],
Expand All @@ -509,7 +509,7 @@ else:
help: str | None = None,
) -> None: ...
@overload
@deprecated("The `type`, `choices`, and `metavar` parameters are ignored and will be removed in Python 3.14.")
@deprecated("The `type`, `choices`, and `metavar` parameters are ignored; removed in Python 3.14.")
def __init__(
self,
option_strings: Sequence[str],
Expand Down
2 changes: 1 addition & 1 deletion stdlib/ctypes/__init__.pyi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -168,7 +168,7 @@ c_buffer = create_string_buffer
def create_unicode_buffer(init: int | str, size: int | None = None) -> Array[c_wchar]: ...

if sys.version_info < (3, 15):
@deprecated("Deprecated; will be removed in Python 3.15.")
@deprecated("Deprecated; removed in Python 3.15.")
def SetPointerType(pointer: type[_Pointer[Any]], cls: _CTypeBaseType) -> None: ...

@deprecated("Soft deprecated. Use multiplication instead.")
Expand Down
2 changes: 1 addition & 1 deletion stdlib/email/utils.pyi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ elif sys.version_info >= (3, 12):
@overload
def localtime(dt: datetime.datetime | None = None) -> datetime.datetime: ...
@overload
@deprecated("The `isdst` parameter does nothing and will be removed in Python 3.14.")
@deprecated("The `isdst` parameter is ignored; removed in Python 3.14.")
def localtime(dt: datetime.datetime | None = None, isdst: Unused = None) -> datetime.datetime: ...

else:
Expand Down
8 changes: 2 additions & 6 deletions stdlib/glob.pyi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,13 +10,9 @@ if sys.version_info >= (3, 13):
__all__ += ["translate"]

if sys.version_info < (3, 15):
@deprecated(
"Deprecated since Python 3.10; will be removed in Python 3.15. Use `glob.glob()` with the *root_dir* argument instead."
)
@deprecated("Deprecated since Python 3.10; removed in Python 3.15. Use `glob.glob()` with the *root_dir* argument instead.")
def glob0(dirname: AnyStr, pattern: AnyStr) -> list[AnyStr]: ...
@deprecated(
"Deprecated since Python 3.10; will be removed in Python 3.15. Use `glob.glob()` with the *root_dir* argument instead."
)
@deprecated("Deprecated since Python 3.10; removed in Python 3.15. Use `glob.glob()` with the *root_dir* argument instead.")
def glob1(dirname: AnyStr, pattern: AnyStr) -> list[AnyStr]: ...

if sys.version_info >= (3, 11):
Expand Down
2 changes: 1 addition & 1 deletion stdlib/http/server.pyi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -128,7 +128,7 @@ class SimpleHTTPRequestHandler(BaseHTTPRequestHandler):
def executable(path: StrPath) -> bool: ... # undocumented

if sys.version_info < (3, 15):
@deprecated("Deprecated and unsafe; will be removed in Python 3.15.")
@deprecated("Deprecated and unsafe; removed in Python 3.15.")
class CGIHTTPRequestHandler(SimpleHTTPRequestHandler):
cgi_directories: list[str]
have_fork: bool # undocumented
Expand Down
2 changes: 1 addition & 1 deletion stdlib/pathlib/__init__.pyi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -100,7 +100,7 @@ class PurePath(PathLike[str]):
if sys.version_info < (3, 15):
if sys.version_info >= (3, 13):
@deprecated(
"Deprecated since Python 3.13; will be removed in Python 3.15. "
"Deprecated since Python 3.13; removed in Python 3.15. "
"Use `os.path.isreserved()` to detect reserved paths on Windows."
)
def is_reserved(self) -> bool: ...
Expand Down
2 changes: 1 addition & 1 deletion stdlib/platform.pyi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,7 @@ def mac_ver(
) -> tuple[str, tuple[str, str, str], str]: ...

if sys.version_info < (3, 15):
@deprecated("Deprecated; will be removed in Python 3.15.")
@deprecated("Deprecated; removed in Python 3.15.")
def java_ver(
release: str = "",
vendor: str = "",
Expand Down
2 changes: 1 addition & 1 deletion stdlib/types.pyi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -156,7 +156,7 @@ class CodeType:
def co_firstlineno(self) -> int: ...
if sys.version_info < (3, 15):
@property
@deprecated("Deprecated since Python 3.10; will be removed in Python 3.15. Use `CodeType.co_lines()` instead.")
@deprecated("Deprecated since Python 3.10; removed in Python 3.15. Use `CodeType.co_lines()` instead.")
def co_lnotab(self) -> bytes: ...

@property
Expand Down
10 changes: 5 additions & 5 deletions stdlib/wave.pyi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -47,9 +47,9 @@ class Wave_read:
def getcompname(self) -> str: ...
def getparams(self) -> _wave_params: ...
if sys.version_info < (3, 15):
@deprecated("Deprecated; will be removed in Python 3.15.")
@deprecated("Deprecated; removed in Python 3.15.")
def getmarkers(self) -> None: ...
@deprecated("Deprecated; will be removed in Python 3.15.")
@deprecated("Deprecated; removed in Python 3.15.")
def getmark(self, id: Any) -> Never: ...

def setpos(self, pos: int) -> None: ...
Expand Down Expand Up @@ -85,11 +85,11 @@ class Wave_write:
def getparams(self) -> _wave_params: ...

if sys.version_info < (3, 15):
@deprecated("Deprecated; will be removed in Python 3.15.")
@deprecated("Deprecated; removed in Python 3.15.")
def setmark(self, id: Any, pos: Any, name: Any) -> Never: ...
@deprecated("Deprecated; will be removed in Python 3.15.")
@deprecated("Deprecated; removed in Python 3.15.")
def getmark(self, id: Any) -> Never: ...
@deprecated("Deprecated; will be removed in Python 3.15.")
@deprecated("Deprecated; removed in Python 3.15.")
def getmarkers(self) -> None: ...

def tell(self) -> int: ...
Expand Down