Skip to content

[urllib] Deprecate cafile, capath, cadefault parameters #15260

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 3 commits into from
Jan 11, 2026
Merged

[urllib] Deprecate cafile, capath, cadefault parameters #15260

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
19740f6
[urllib] Deprecate cafile, capath, cadefault parameters
donbarbos Jan 11, 2026
57c2b2c
reflect the impossibility of passing `context` and `cafile` at once
donbarbos Jan 11, 2026
361db11
last fix
donbarbos Jan 11, 2026
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
24 changes: 20 additions & 4 deletions stdlib/urllib/request.pyi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ from email.message import Message
from http.client import HTTPConnection, HTTPMessage, HTTPResponse
from http.cookiejar import CookieJar
from re import Pattern
from typing import IO, Any, ClassVar, NoReturn, Protocol, TypeVar, overload, type_check_only
from typing import IO, Any, ClassVar, Literal, NoReturn, Protocol, TypeVar, overload, type_check_only
from typing_extensions import TypeAlias, deprecated
from urllib.error import HTTPError as HTTPError
from urllib.response import addclosehook, addinfourl
Expand Down Expand Up @@ -65,16 +65,32 @@ if sys.version_info >= (3, 13):
) -> _UrlopenRet: ...

else:
@overload
def urlopen(
url: str | Request,
data: _DataType | None = None,
timeout: float | None = ...,
*,
cafile: str | None = None,
capath: str | None = None,
cadefault: bool = False,
cafile: None = None,
capath: None = None,
cadefault: Literal[False] = False,
context: ssl.SSLContext | None = None,
) -> _UrlopenRet: ...
@overload
@deprecated(
"The `cafile`, `capath`, `cadefault` parameters are deprecated since Python 3.6; "
"removed in Python 3.13. Use `context` parameter instead."
)
def urlopen(
url: str | Request,
data: _DataType | None = None,
timeout: float | None = ...,
*,
cafile: StrOrBytesPath | None = None,
capath: StrOrBytesPath | None = None,
cadefault: bool = False,
context: None = None,
) -> _UrlopenRet: ...

def install_opener(opener: OpenerDirector) -> None: ...
def build_opener(*handlers: BaseHandler | Callable[[], BaseHandler]) -> OpenerDirector: ...
Expand Down