From 1c13c5e6f35cf05c4de758714bc99919e9bbbb43 Mon Sep 17 00:00:00 2001
From: "Steven M. Vascellaro" <svascellaro@gmail.com>
Date: Wed, 13 Jun 2018 12:43:05 -0400
Subject: [PATCH] Document that `requests.session()` is depreciated

Adds a docstring note that `requests.session()` is depreciated. Users should
use `requests.Session()` in versions released after Requests v1.0.
---
 requests/sessions.py | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/requests/sessions.py b/requests/sessions.py
index ba135268..f6f9c0b5 100644
--- a/requests/sessions.py
+++ b/requests/sessions.py
@@ -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()