Merge pull request #4685 from Stevoisiak/patch-2

Note that session() should not be used
2026-06-05 22:50:18 +00:00 · 2018-06-21 12:09:06 -07:00
parent 883caaf145 1c13c5e6f3
commit cd97ce90ba
1 changed files with 6 additions and 1 deletions
@@ -735,7 +735,12 @@ def session():
    """
    Returns a :class:`Session` for context-management.

+    .. deprecated:: 1.0.0
+
+        This method has been deprecated since version 1.0.0 and is only kept for
+        backwards compatibility. New code should use :class:`~requests.sessions.Session`
+        to create a session. This may be removed at a future date.
+
    :rtype: Session
    """
-
    return Session()