Загрузка граффити (#133)

Author: Helow19274

vk_api/execute.py

@@ -12,7 +12,7 @@
 
 
 class VkFunction(object):
-    """ 
+    """
     Обертка над методом execute.
 
     :param code: код функции (VKScript)

vk_api/longpoll.py

@@ -381,7 +381,7 @@ def listen(self):
 
 class Event(object):
     """
-    Событие, полученное от longpoll-сервера. 
+    Событие, полученное от longpoll-сервера.
 
     Имеет поля в соответствии с `документацией <https://vk.com/dev/using_longpoll?f=3.%20Структура%20событий>`_.
 

vk_api/requests_pool.py

@@ -46,7 +46,7 @@ def error(self, value):
 
     @property
     def result(self):
-        """Результат запроса, если он прошёл успешно."""        
+        """Результат запроса, если он прошёл успешно."""
         if not self.ready:
             raise RuntimeError('Result is not available in `with` context')
 
@@ -67,11 +67,11 @@ def ok(self):
 
 
 class VkRequestsPool(object):
-    """ 
+    """
     Позволяет сделать несколько обращений к API за один запрос
     за счет метода execute.
 
-    Служит как менеджер контекста: запросы к API добавляются в 
+    Служит как менеджер контекста: запросы к API добавляются в
     открытый пул, и выполняются при его закрытии.
 
     :param vk: Объект :class:`VkApi`
@@ -98,7 +98,7 @@ def get_execute_errors(self):
         return self.execute_errors
 
     def method(self, method, values=None):
-        """ 
+        """
         Добавляет запрос в пул. Невозможно использовать вместе с :func:`method_one_param`.
         Возвращаемое значение будет содержать результат после закрытия пула.
 
@@ -123,7 +123,7 @@ def method(self, method, values=None):
         return result
 
     def method_one_param(self, method, key, values, default_values=None):
-        """ 
+        """
         Использовать, если изменяется значение только одного параметра.
         Невозможно использовать вместе с :func:`method`.
         Возвращаемое значение будет содержать результат после закрытия пула.

vk_api/tools.py

@@ -17,7 +17,7 @@
 
 
 class VkTools(object):
-    """ 
+    """
     Содержит некоторые воспомогательные функции, которые могут понадобиться
     при использовании API
 
@@ -31,7 +31,7 @@ def __init__(self, vk):
 
     def get_all_iter(self, method, max_count, values=None, key='items',
                      limit=None, stop_fn=None, negative_offset=False):
-        """ 
+        """
         Получить все элементы.
         Работает в методах, где в ответе есть count и items или users.
         За один запрос получает max_count * 25 элементов
@@ -98,7 +98,7 @@ def get_all_iter(self, method, max_count, values=None, key='items',
 
     def get_all(self, method, max_count, values=None, key='items', limit=None,
                 stop_fn=None, negative_offset=False):
-        """ 
+        """
         Использовать только если нужно загрузить все объекты в память.
 
         Eсли вы можете обрабатывать объекты по частям, то лучше
@@ -118,7 +118,7 @@ def get_all(self, method, max_count, values=None, key='items', limit=None,
 
     def get_all_slow_iter(self, method, max_count, values=None, key='items',
                           limit=None, stop_fn=None, negative_offset=False):
-        """ 
+        """
         Получить все элементы (без использования execute)
         Работает в методах, где в ответе есть count и items или users
 
@@ -190,7 +190,7 @@ def get_all_slow_iter(self, method, max_count, values=None, key='items',
 
     def get_all_slow(self, method, max_count, values=None, key='items',
                      limit=None, stop_fn=None, negative_offset=False):
-        """ 
+        """
         Использовать только если нужно загрузить все объекты в память.
 
         Eсли вы можете обрабатывать объекты по частям, то лучше
@@ -223,7 +223,7 @@ def get_all_slow(self, method, max_count, values=None, key='items',
         calls = calls + 1;
 
         params.offset = offset * %(offset_mul)s;
-        var response = API.%(method)s(params), 
+        var response = API.%(method)s(params),
             new_count = response.count,
             count_diff = (count == null ? 0 : new_count - count);
 

vk_api/upload.py

@@ -7,7 +7,6 @@
 :copyright: (c) 2018 python273
 """
 
-
 STORY_ALLOWED_LINK_TEXTS = {
     'to_store', 'vote', 'more', 'book', 'order',
     'enroll', 'fill', 'signup', 'buy', 'ticket',
@@ -285,8 +284,23 @@ def audio_message(self, audio, group_id=None):
             to_wall=group_id is not None
         )
 
+    def graffiti(self, image, group_id=None):
+        """ Загрузка граффити
+
+        :param image: путь к png изображению или file-like объект.
+        :param group_id: идентификатор сообщества
+                        (если используется токен сообщества)
+        """
+
+        return self.document(
+            image,
+            graffiti=True,
+            group_id=group_id,
+            to_wall=group_id is not None
+        )
+
     def document(self, doc, title=None, tags=None, group_id=None,
-                 to_wall=False, audio_message=False):
+                 to_wall=False, audio_message=False, graffiti=False):
         """ Загрузка документа
 
         :param doc: путь к документу или file-like объект
@@ -300,6 +314,8 @@ def document(self, doc, title=None, tags=None, group_id=None,
 
         if audio_message:
             values['type'] = 'audio_message'
+        elif graffiti:
+            values['type'] = 'graffiti'
 
         if to_wall:
             method = 'docs.getWallUploadServer'

vk_api/vk_api.py

@@ -91,7 +91,7 @@ class VkApi(object):
     def __init__(self, login=None, password=None, token=None,
                  auth_handler=None, captcha_handler=None,
                  config=jconfig.Config, config_filename='vk_config.v2.json',
-                 api_version='5.73', app_id=6222115, scope=DEFAULT_USER_SCOPE,
+                 api_version='5.74', app_id=6222115, scope=DEFAULT_USER_SCOPE,
                  client_secret=None):
 
         self.login = login