Support custom executors in AsyncAPI, add AsyncAPI to docs.

devourer/async.py

@@ -13,10 +13,13 @@
 from devourer import GenericAPICreator
 
 
-# Default time (seconds) to wait for thread before timing out
+# Default time (seconds) to wait for thread before timing out.
 DEFAULT_ASYNC_TIMEOUT = 5.0
 
-# Default number of executors for an API instance
+# Default executor class.
+DEFAULT_EXECUTOR = ThreadPoolExecutor
+
+# Default number of executors for an API instance.
 DEFAULT_EXECUTORS = 2
 
 
@@ -30,8 +33,21 @@ class AsyncAPIBase(GenericAPIBase):
     _methods = None
 
     def __init__(self, *args, **kwargs):
+        """
+        Add async settings and invoke base initializer.
+        :param args:
+        :param executors: number of concurrent executor workers.
+        :param executor_class: executor class.
+        :param executor: executor instance. Takes priority over executor_class.
+        :param kwargs:
+        """
+        executor = kwargs.pop('executor', None)
         executors = kwargs.pop('executors', DEFAULT_EXECUTORS)
-        self._executor = ThreadPoolExecutor(max_workers=executors)
+        executor_class = kwargs.pop('executor_class', DEFAULT_EXECUTOR)
+        if executor:
+            self._executor = executor
+        else:
+            self._executor = executor_class(max_workers=executors)
         super(AsyncAPIBase, self).__init__(*args, **kwargs)
 
     def call(self, name, *args, **kwargs):

docs/index.rst

@@ -19,6 +19,9 @@ Contents:
 .. autoclass:: GenericAPI
     :members:
 
+.. autoclass:: AsyncAPI
+    :members:
+
 .. autoclass:: APIMethod
     :members:
 

setup.py

@@ -3,7 +3,7 @@
 setup(
     name='devourer',
     packages=['devourer'],
-    version='0.4.1',
+    version='0.4.2',
     install_requires=[
         'requests',
         'futures',
@@ -14,7 +14,7 @@
     author='Bonnier Business Polska / Krzysztof Bujniewicz',
     author_email='racech@gmail.com',
     url='https://github.com/bonnierpolska/devourer',
-    download_url='https://github.com/bonnierpolska/devourer/tarball/0.4.1',
+    download_url='https://github.com/bonnierpolska/devourer/tarball/0.4.2',
     keywords=['api', 'generic api', 'api client'],
     classifiers=[]
 )