Reuse existing connections to Telegram when possible

botogram communicates with the Bot API a lot, and creating new HTTPS
connections is all but cheap in terms of speed. By reusing existing
connections (thanks to Keep-Alive), it's possible to make botogram
faster than before.

Author: Pietro Albini

botogram/api.py

@@ -6,6 +6,8 @@
     Released under the MIT license
 """
 
+import os
+
 import requests
 
 
@@ -76,10 +78,23 @@ def __init__(self, api_key, endpoint=None):
         self._api_key = api_key
         self._endpoint = endpoint
 
+        self._session_cache = None
+        self._session_pid = -1
+
+    def _session(self):
+        """Get the current requests session"""
+        # Ensure a new session is created if the PID changes. This is because
+        # sessions behaves badly if you use them after fork()
+        if self._session_pid != os.getpid() or self._session_cache is None:
+            self._session_cache = requests.Session()
+            self._session_pid = os.getpid()
+
+        return self._session_cache
+
     def call(self, method, params=None, files=None, expect=None):
         """Call a method of the API"""
         url = self._endpoint + "bot%s/%s" % (self._api_key, method)
-        response = requests.get(url, params=params, files=files)
+        response = self._session().get(url, params=params, files=files)
         content = response.json()
 
         if not content["ok"]:

docs/changelog/0.4.rst

@@ -0,0 +1,22 @@
+.. Copyright (c) 2016 Pietro Albini <[email protected]>
+   Released under the MIT license
+
+===========================
+Changelog of botogram 0.4.x
+===========================
+
+Here you can find all the changes in the botogram 0.4.x releases.
+
+.. _changelog-0.4:
+
+botogram 0.4
+============
+
+*Alpha release, not yet released.*
+
+Release description not yet written.
+
+Performance improvements
+------------------------
+
+* botogram now tries to reuse existing connections to Telegram when possible

docs/changelog/index.rst

@@ -12,6 +12,7 @@ Here you can see what changed in every botogram release.
 .. toctree::
    :maxdepth: 2
 
+   0.4
    0.3
    0.2
    0.1