Skip to content

Commit b7cba71

Browse files
committed
Explain differences between urllib3 and requests backends
Fixes elastic#402
1 parent 40db4b6 commit b7cba71

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

docs/transports.rst

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,11 @@ For example to use the ``requests``-based connection just import it and use it::
1414
from elasticsearch import Elasticsearch, RequestsHttpConnection
1515
es = Elasticsearch(connection_class=RequestsHttpConnection)
1616

17+
The default connection class is based on ``urllib3`` which is more performant
18+
and lightweight than the optional ``requests``-based class. Only use
19+
``RequestsHttpConnection`` if you have need of any of ``requests`` advanced
20+
features like custom auth plugins etc.
21+
1722

1823
.. py:module:: elasticsearch.connection
1924

0 commit comments

Comments
 (0)