Merge pull request #6 from python273/dev

Docstrings fix

Author: python273

example.py

@@ -1,21 +1,20 @@
 # -*- coding: utf-8 -*-
 
-'''
+"""
 @author: Kirill Python
 @contact: http://vk.com/python273
 @license Apache License, Version 2.0, see LICENSE file
 
 Copyright (C) 2014
-'''
+"""
 
 import vk_api
 
 
 def main():
-    u''' Пример получения последнего сообщения со стены '''
+    """ Пример получения последнего сообщения со стены """
 
-    login = u'python@vk.com'
-    password = u'mypassword'
+    login, password = 'python@vk.com', 'mypassword'
 
     try:
         vk = vk_api.VkApi(login, password)  # Авторизируемся

jconfig/__init__.py

@@ -1,12 +1,12 @@
 # -*- coding: utf-8 -*-
 
-'''
+"""
 @author: Kirill Python
 @contact: http://vk.com/python273
 @license Apache License, Version 2.0, see LICENSE file
 
 Copyright (C) 2014
-'''
+"""
 
 __author__ = 'Kirill Python'
 __version__ = '1.2'

jconfig/jconfig.py

@@ -1,12 +1,12 @@
 # -*- coding: utf-8 -*-
 
-'''
+"""
 @author: Kirill Python
 @contact: http://vk.com/python273
 @license Apache License, Version 2.0, see LICENSE file
 
 Copyright (C) 2014
-'''
+"""
 
 import os
 import json

vk_api/__init__.py

@@ -1,12 +1,12 @@
 # -*- coding: utf-8 -*-
 
-'''
+"""
 @author: Kirill Python
 @contact: http://vk.com/python273
 @license Apache License, Version 2.0, see LICENSE file
 
 Copyright (C) 2014
-'''
+"""
 
 __author__ = 'Kirill Python'
 __version__ = '4.7.1'

vk_api/vk_api.py

@@ -1,12 +1,12 @@
 # -*- coding: utf-8 -*-
 
-'''
+"""
 @author: Kirill Python
 @contact: http://vk.com/python273
 @license Apache License, Version 2.0, see LICENSE file
 
 Copyright (C) 2014
-'''
+"""
 
 import jconfig
 import re
@@ -22,7 +22,7 @@ class VkApi(object):
     def __init__(self, login=None, password=None, number=None, token=None,
                  proxies=None, captcha_handler=None, config_filename=None,
                  api_version='5.21', app_id=2895443, scope=2097151):
-        u'''
+        """
         :param login: Логин ВКонтакте
         :param password: Пароль ВКонтакте
         :param number: Номер для проверке безопасности (указывать, если
@@ -38,7 +38,7 @@ def __init__(self, login=None, password=None, number=None, token=None,
         :param api_version: Версия API (default: '5.21')
         :param app_id: Standalone-приложение (default: 2895443)
         :param scope: Запрашиваемые права (default: 2097151)
-        '''
+        """
 
         self.login = login
         self.password = password
@@ -81,7 +81,7 @@ def __init__(self, login=None, password=None, number=None, token=None,
                 self.api_login()
 
     def vk_login(self, captcha_sid=None, captcha_key=None):
-        u''' Авторизцаия ВКонтакте с получением cookies remixsid '''
+        """ Авторизцаия ВКонтакте с получением cookies remixsid """
 
         url = 'https://login.vk.com/'
         values = {
@@ -166,7 +166,7 @@ def security_check(self, url=None, response=None):
         raise SecurityCheck('Enter number')
 
     def check_sid(self):
-        u''' Прверка Cookies remixsid на валидность '''
+        """ Прверка Cookies remixsid на валидность """
 
         if self.sid:
             url = 'https://vk.com/feed2.php'
@@ -182,7 +182,7 @@ def check_sid(self):
                 return response
 
     def api_login(self):
-        u''' Получение токена через Desktop приложение '''
+        """ Получение токена через Desktop приложение """
 
         url = 'https://oauth.vk.com/authorize'
         values = {
@@ -214,7 +214,7 @@ def api_login(self):
             raise AuthorizationError('Authorization error (api)')
 
     def check_token(self):
-        u''' Прверка access_token на валидность '''
+        """ Прверка access_token на валидность """
 
         if self.token:
             try:
@@ -225,23 +225,22 @@ def check_token(self):
             return True
 
     def captcha_handler(self, captcha):
-        u''' http://vk.com/dev/captcha_error '''
+        """ http://vk.com/dev/captcha_error """
         pass
 
     def need_validation_handler(self, error):
-        u''' http://vk.com/dev/need_validation '''
+        """ http://vk.com/dev/need_validation """
         # TODO: write me
         pass
 
     def method(self, method, values=None, captcha_sid=None, captcha_key=None):
-        u'''
-        Использование методов API
+        """ Использование методов API
 
         :param method: метод
         :param values: параметры
         :param captcha_sid:
         :param captcha_key:
-        '''
+        """
 
         url = 'https://api.vk.com/method/%s' % method
 
@@ -298,7 +297,7 @@ def method(self, method, values=None, captcha_sid=None, captcha_key=None):
 
 
 def regexp(reg, string):
-    u''' Поиск по регулярке '''
+    """ Поиск по регулярке """
 
     reg = re.compile(reg, re.IGNORECASE | re.DOTALL)
     reg = reg.findall(string)

vk_api/vk_tools.py

@@ -1,12 +1,12 @@
 # encoding: utf-8
 
-'''
+"""
 @author: Kirill Python
 @contact: http://vk.com/python273
 @license Apache License, Version 2.0, see LICENSE file
 
 Copyright (C) 2014
-'''
+"""
 
 import json
 import sys
@@ -20,7 +20,7 @@ def __init__(self, vk):
         self.vk = vk
 
     def get_all(self, method, values=None, max_count=200, key='items'):
-        u''' Получить все элементы
+        """ Получить все элементы
             Работает в методах, где в ответе есть items или users
             За один запрос получает max_count * 25 элементов
 
@@ -29,7 +29,7 @@ def get_all(self, method, values=None, max_count=200, key='items'):
         :param max_count: максимальное количество элементов,
                             которое можно получить за один раз
         :param key: ключ элементов, которые нужно получить
-        '''
+        """
 
         if values:
             values = values.copy()
@@ -57,15 +57,15 @@ def get_all(self, method, values=None, max_count=200, key='items'):
         return {'count': len(items), key: items}
 
     def get_all_slow(self, method, values=None, max_count=200, key='items'):
-        u''' Получить все элементы
+        """ Получить все элементы
             Работает в методах, где в ответе есть count и items или users
 
         :param method: метод
         :param values: параметры
         :param max_count: максимальное количество элементов,
                             которое можно получить за один раз
         :param key: ключ элементов, которые нужно получить
-        '''
+        """
 
         if not values:
             values = {}

vk_api/vk_upload.py

@@ -1,12 +1,12 @@
 # -*- coding: utf-8 -*-
 
-'''
+"""
 @author: Kirill Python
 @contact: http://vk.com/python273
 @license Apache License, Version 2.0, see LICENSE file
 
 Copyright (C) 2014
-'''
+"""
 
 
 class VkUpload(object):
@@ -15,14 +15,14 @@ def __init__(self, vk):
         # https://vk.com/dev/upload_files
 
     def photo(self, photos, album_id=None, group_id=None):
-        u''' Загрузка изображений в альбом пользователя
+        """ Загрузка изображений в альбом пользователя
 
         photos = ['photo1.jpg', 'img.png']
                = 'screen.png'
                Максимум 5 фотографий
 
         album_id
-        '''
+        """
 
         if not (album_id and photos):
             return False
@@ -55,12 +55,12 @@ def photo(self, photos, album_id=None, group_id=None):
         return response
 
     def photoMessages(self, photos, group_id=None):
-        u''' Загрузка изображений в сообщения
+        """ Загрузка изображений в сообщения
 
         photos = ['photo1.jpg', 'img.png']
                = 'screen.png'
                Максимум 7(?) фотографий
-        '''
+        """
 
         if not photos:
             return False