Merge pull request #17 from python273/dev

Обновление версии до 6.0

Author: python273

README.md

@@ -1,16 +1,12 @@
 vk_api
 ======
 
-**vk_api** - модуль для использования API сайта ВКонтакте (vk.com). Пример смотрите в файле [example.py](https://github.com/python273/vk_api/blob/master/example.py)
+**vk_api** - модуль для написания скриптов для сайта vk.com (Вконтакте) с использованием API. Примеры в папке [examples](./examples) (python3)
 
 Python 2 / 3
 
-С вопросами или советами можете [написать автору в ВК](https://vk.com/im?sel=183433824).
+С вопросами, пожеланиями, благодарностями [пишите сюда](https://vk.com/im?sel=183433824).
 
 Установка
 ------------
     $ pip install vk_api
-
-Для работы необходим модуль [Requests](https://github.com/kennethreitz/requests)
-
-    $ pip install requests

examples/capthca_handle.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+
+"""
+@author: Kirill Python
+@contact: https://vk.com/python273
+"""
+
+import vk_api
+
+
+def captcha_handler(captcha):
+    key = input("Enter Captcha {0}: ".format(captcha.get_url())).strip()
+
+    # Пробуем снова отправить запрос с капчей
+    return captcha.try_again(key)
+
+
+def main():
+    """ Пример: обработка капчи """
+
+    login, password = 'python@vk.com', 'mypassword'
+    vk = vk_api.VkApi(
+        login, password,
+        captcha_handler=captcha_handler  # function for handle captcha
+    )
+
+    try:
+        vk.authorization()
+    except vk_api.AuthorizationError as error_msg:
+        print(error_msg)
+        return
+
+    # some code
+    # ...
+
+if __name__ == '__main__':
+    main()

examples/get_full_wall.py

@@ -0,0 +1,35 @@
+# -*- coding: utf-8 -*-
+
+"""
+@author: Kirill Python
+@contact: https://vk.com/python273
+"""
+
+import vk_api
+
+
+def main():
+    """ Пример: получение всех постов со стены """
+
+    login, password = 'python@vk.com', 'mypassword'
+    vk = vk_api.VkApi(login, password)
+
+    try:
+        vk.authorization()
+    except vk_api.AuthorizationError as error_msg:
+        print(error_msg)
+        return
+
+    tools = vk_api.VkTools(vk)
+
+    wall = tools.get_all('wall.get', 100, {'owner_id': '183433824'})
+    print('Posts count:', wall['count'])
+
+    if wall['count']:
+        print('First post:', wall['items'][0], '\n')
+
+    if wall['count'] > 1:
+        print('Last post:', wall['items'][-1])
+
+if __name__ == '__main__':
+    main()

example.py examples/simple_example.pyexample.py renamed to examples/simple_example.py

@@ -2,10 +2,7 @@
 
 """
 @author: Kirill Python
-@contact: http://vk.com/python273
-@license Apache License, Version 2.0, see LICENSE file
-
-Copyright (C) 2014
+@contact: https://vk.com/python273
 """
 
 import vk_api
@@ -15,21 +12,21 @@ def main():
     """ Пример получения последнего сообщения со стены """
 
     login, password = 'python@vk.com', 'mypassword'
+    vk = vk_api.VkApi(login, password)
 
     try:
-        vk = vk_api.VkApi(login, password)  # Авторизируемся
+        vk.authorization()
     except vk_api.AuthorizationError as error_msg:
-        print(error_msg)  # В случае ошибки выведем сообщение
-        return  # и выйдем
+        print(error_msg)
+        return
 
     values = {
         'count': 1  # Получаем только один пост
     }
     response = vk.method('wall.get', values)  # Используем метод wall.get
 
     if response['items']:
-        # Печатаем текст последнего поста со стены
-        print(response['items'][0]['text'])
+        print(response['items'][0])
 
 if __name__ == '__main__':
     main()

examples/upload_photo.py

@@ -0,0 +1,37 @@
+# -*- coding: utf-8 -*-
+
+"""
+@author: Kirill Python
+@contact: https://vk.com/python273
+"""
+
+import vk_api
+
+
+def main():
+    """ Пример: загрузка фото """
+
+    login, password = 'python@vk.com', 'mypassword'
+    vk = vk_api.VkApi(login, password)
+
+    try:
+        vk.authorization()
+    except vk_api.AuthorizationError as error_msg:
+        print(error_msg)
+        return
+
+    upload = vk_api.VkUpload(vk)
+    photo = upload.photo(  # Подставте свои данные
+        'D:/downloads/tube.jpg',
+        album_id=200851098,
+        group_id=74030368
+    )
+
+    vk_url = 'https://vk.com/photo{}_{}'.format(
+        photo[0]['owner_id'], photo[0]['id']
+    )
+
+    print(photo, '\nLink: ', vk_url)
+
+if __name__ == '__main__':
+    main()

jconfig/__init__.py

@@ -2,15 +2,15 @@
 
 """
 @author: Kirill Python
-@contact: http://vk.com/python273
+@contact: https://vk.com/python273
 @license Apache License, Version 2.0, see LICENSE file
 
-Copyright (C) 2014
+Copyright (C) 2015
 """
 
 __author__ = 'Kirill Python'
 __version__ = '1.2'
-__email__ = 'siberianpython@gmail.com'
+__email__ = 'python273@ya.ru'
 __contact__ = 'https://vk.com/python273'
 
 

jconfig/jconfig.py

@@ -2,10 +2,10 @@
 
 """
 @author: Kirill Python
-@contact: http://vk.com/python273
+@contact: https://vk.com/python273
 @license Apache License, Version 2.0, see LICENSE file
 
-Copyright (C) 2014
+Copyright (C) 2015
 """
 
 import os

setup.py

@@ -6,19 +6,22 @@
 @contact: http://vk.com/python273
 @license Apache License, Version 2.0, see LICENSE file
 
-Copyright (C) 2014
+Copyright (C) 2015
 '''
 
 from distutils.core import setup
+
+
 setup(
     name='vk_api',
-    version='5.2',
+    version='6.0',
     author='Kirill Python',
-    author_email='siberianpython@gmail.com',
+    author_email='python273@ya.ru',
     url='https://github.com/python273/vk_api',
-    description='Module to use API vk.com',
+    description='Module for writing scripts for vk.com (vkontakte)',
     download_url='https://github.com/python273/vk_api/archive/master.zip',
     license='Apache License, Version 2.0, see LICENSE file',
 
     packages=['vk_api', 'jconfig'],
+    install_requires=['requests'],
 )

vk_api/__init__.py

@@ -2,15 +2,15 @@
 
 """
 @author: Kirill Python
-@contact: http://vk.com/python273
+@contact: https://vk.com/python273
 @license Apache License, Version 2.0, see LICENSE file
 
-Copyright (C) 2014
+Copyright (C) 2015
 """
 
 __author__ = 'Kirill Python'
-__version__ = '5.2'
-__email__ = 'siberianpython@gmail.com'
+__version__ = '6.0'
+__email__ = 'python273@ya.ru'
 __contact__ = 'https://vk.com/python273'
 
 import sys

vk_api/vk_api.py

@@ -2,10 +2,10 @@
 
 """
 @author: Kirill Python
-@contact: http://vk.com/python273
+@contact: https://vk.com/python273
 @license Apache License, Version 2.0, see LICENSE file
 
-Copyright (C) 2014
+Copyright (C) 2015
 """
 
 import jconfig
@@ -32,13 +32,16 @@ class VkApi(object):
     def __init__(self, login=None, password=None, number=None, sec_number=None,
                  token=None,
                  proxies=None, captcha_handler=None, config_filename=None,
-                 api_version='5.24', app_id=2895443, scope=2097151):
+                 api_version='5.33', app_id=2895443, scope=2097151):
         """
         :param login: Логин ВКонтакте
         :param password: Пароль ВКонтакте
-        :param number: Номер для проверке безопасности (указывать, если
-                                     в качестве логина используется не номер)
-        :param sec_number: 
+        :param number: Номер для проверки безопасности (указывать, если
+                        в качестве логина используется не номер)
+        :param sec_number: Часть номера, которая проверяется при проверке
+                            безопасности (указывать, если точно известно, что
+                            вводить и если автоматическое получение кода из
+                            номера работает не корректно)
 
         :param token: access_token
         :param proxies: proxy server
@@ -47,7 +50,7 @@ def __init__(self, login=None, password=None, number=None, sec_number=None,
         :param captcha_handler: Функция для обработки капчи
         :param config_filename: Расположение config файла
 
-        :param api_version: Версия API (default: '5.21')
+        :param api_version: Версия API (default: '5.33')
         :param app_id: Standalone-приложение (default: 2895443)
         :param scope: Запрашиваемые права (default: 2097151)
         """
@@ -72,8 +75,8 @@ def __init__(self, login=None, password=None, number=None, sec_number=None,
         self.http = requests.Session()
         self.http.proxies = proxies  # Ставим прокси
         self.http.headers = {  # Притворимся браузером
-            'User-agent': 'Mozilla/5.0 (Windows NT 6.1; rv:31.0)'
-            ' Gecko/20100101 Firefox/31.0'
+            'User-agent': 'Mozilla/5.0 (Windows NT 6.1; rv:38.0) '
+            'Gecko/20100101 Firefox/38.0'
         }
 
         self.last_request = 0.0
@@ -83,7 +86,9 @@ def __init__(self, login=None, password=None, number=None, sec_number=None,
             CAPTCHA_ERROR_CODE: captcha_handler or self.captcha_handler
         }
 
-        if login and password:
+    def authorization(self):
+        """ Полная авторизация с получением токена """
+        if self.login and self.password:
             self.sid = self.settings['remixsid']
             self.token = self.settings['access_token']
 
@@ -262,6 +267,7 @@ def need_validation_handler(self, error):
         pass
 
     def http_handler(self, error):
+        """ Handle connection errors """
         pass
 
     def method(self, method, values=None, captcha_sid=None, captcha_key=None):
@@ -298,8 +304,8 @@ def method(self, method, values=None, captcha_sid=None, captcha_key=None):
         if delay > 0:
             time.sleep(delay)
 
-        response = self.http.post(url, values)
         self.last_request = time.time()
+        response = self.http.post(url, values)
 
         if response.ok:
             response = response.json()
@@ -471,7 +477,7 @@ def get_url(self):
         """
 
         if not self.url:
-            self.url = 'http://api.vk.com/captcha.php?sid={}'.format(self.sid)
+            self.url = 'https://api.vk.com/captcha.php?sid={}'.format(self.sid)
 
         return self.url