Update example for VkRequestsPool

Author: python273

examples/requests_pool.py

@@ -21,7 +21,8 @@ def main():
         return
 
     """
-        TODO: write description
+        Позволяет выполнять до 25 запросов к API за один запрос.
+        Работает через метод execute.
     """
 
     friends = {}
@@ -32,10 +33,20 @@ def main():
 
     print(friends)
 
+    # Same result
+    with vk_api.VkRequestsPool(vk_session) as pool:
+        friends = pool.method_one_param(
+            'friends.get', key='user_id', values=[1, 183433824])
+
+    print(friends)
+
     with vk_api.VkRequestsPool(vk_session) as pool:
         friends = pool.method('friends.get')
         status = pool.method('status.get')
 
+    # Обратите внимание, что запрос выполняется после выхода из with
+    # и к результатам обратиться можно только после выхода из него
+
     print(friends)
     print(status)
 

vk_api/vk_tools.py

@@ -142,10 +142,20 @@ def method(self, method, values=None):
 
     def method_one_param(self, method, default_values=None, key=None,
                          values=None):
+        """  Использовать, если изменяется значение только одного параметра
+
+        :param method: метод
+        :param default_values: одинаковые значения для запросов
+        :param key: ключ изменяющегося параметра
+        :param values: список значений изменяющегося параметра (max: 25)
+        """
 
         if self.one_param is False and self.pool:
             raise Exception('One param mode dont work with self.method')
 
+        if default_values is None:
+            default_values = {}
+
         self.one_param = {
             'method': method,
             'default': default_values,