Возможность загружать граффити с токена группы и в сообщение (#136)

Author: Igor

examples/execute_functions.py

@@ -18,7 +18,7 @@
 
 vk_get_filtered = VkFunction(
     args=('method', 'values', 'key'),
-    clean_args=('method', 'key'),  # аргументы будут сконвертрованы через str
+    clean_args=('method', 'key'),  # аргументы будут сконвертированы через str
                                    # остальные через json.dumps
     code='''
     return API.%(method)s(%(values)s)["items"]@.%(key)s;

examples/two_factor_auth.py

@@ -3,7 +3,7 @@
 
 
 def auth_handler():
-    """ При двухфакторной аутентификации вызывается эта функция. 
+    """ При двухфакторной аутентификации вызывается эта функция.
     """
 
     # Код двухфакторной аутентификации

vk_api/audio.py

@@ -187,7 +187,7 @@ def search(self, q='', offset=0):
 
 
 def scrap_data(html, user_id):
-    """ Парсинг списка аудиозаписей из html странцы """
+    """ Парсинг списка аудиозаписей из html страницы """
 
     soup = BeautifulSoup(html, 'html.parser')
     tracks = []
@@ -221,7 +221,7 @@ def scrap_data(html, user_id):
 
 
 def scrap_albums(html):
-    """ Парсинг списка альбомов из html странцы """
+    """ Парсинг списка альбомов из html страницы """
 
     soup = BeautifulSoup(html, 'html.parser')
     albums = []

vk_api/tools.py

@@ -18,7 +18,7 @@
 
 class VkTools(object):
     """
-    Содержит некоторые воспомогательные функции, которые могут понадобиться
+    Содержит некоторые вспомогательные функции, которые могут понадобиться
     при использовании API
 
     :param vk: Объект :class:`VkApi`

vk_api/upload.py

@@ -193,7 +193,7 @@ def video(self, video_file=None, link=None, name=None, description=None,
               no_comments=None, repeat=None):
         """ Загрузка видео
 
-        :param video_file: путь до файла или file-like объект.
+        :param video_file: путь к видеофайлу или file-like объект.
         :type video_file: object, str
 
         :param link: url для встраивания видео с внешнего сайта,
@@ -222,7 +222,7 @@ def video(self, video_file=None, link=None, name=None, description=None,
         :type group_id: int
 
         :param album_id: идентификатор альбома, в который будет загружен
-            видео файл.
+            видеофайл.
         :type album_id: int
 
         :param privacy_view: настройки приватности просмотра видеозаписи в
@@ -345,13 +345,22 @@ def audio_message(self, audio, peer_id=None, group_id=None):
             to_wall=group_id is not None
         )
 
-    def graffiti(self, image):
+    def graffiti(self, image, peer_id=None, group_id=None):
         """ Загрузка граффити
 
         :param image: путь к png изображению или file-like объект.
+        :param peer_id: идентификатор диалога (только для авторизации пользователя)
+        :param group_id: для токена группы, нужно передавать ID группы,
+        вместо peer_id
         """
 
-        return self.document(image, doc_type='graffiti')
+        return self.document(
+            image,
+            doc_type='graffiti',
+            message_peer_id=peer_id,
+            group_id=group_id,
+            to_wall=group_id is not None
+        )
 
     def photo_cover(self, photo, group_id,
                     crop_x=None, crop_y=None,

vk_api/vk_api.py

@@ -51,7 +51,7 @@ class VkApi(object):
 
     :param password: Пароль ВКонтакте (если пароль не передан, то будет
         попытка использовать сохраненные данные)
-    :param password: str
+    :type password: str
 
     :param token: access_token
     :type token: str
@@ -135,7 +135,7 @@ def _sid(self):
     def auth(self, reauth=False, token_only=False):
         """ Аутентификация
 
-        :param reauth: Позволяет переавторизиваться, игнорируя сохраненные
+        :param reauth: Позволяет переавторизоваться, игнорируя сохраненные
             куки и токен
 
         :param token_only: Включает оптимальную стратегию аутентификации, если
@@ -516,7 +516,7 @@ def http_handler(self, error):
 
     def too_many_rps_handler(self, error):
         """ Обработчик ошибки "Слишком много запросов в секунду".
-            Ждет пол секунды и пробудет отправить запрос заново
+            Ждет пол секунды и пробует отправить запрос заново
 
         :param error: исключение
         """