Add doc

Small fixes

Author: python273

vk_api/vk_api.py

@@ -300,10 +300,10 @@ def method(self, method, values=None, captcha_sid=None, captcha_key=None):
 
 
 def doc(method=None):
-    ''' Открывает документацию на метод или список всех методов
+    """ Открывает документацию на метод или список всех методов
 
     :param method: метод
-    '''
+    """
 
     if not method:
         method = 'methods'
@@ -326,7 +326,7 @@ def code_from_number(phone_prefix, phone_postfix, number):
     prefix_len = len(phone_prefix)
     postfix_len = len(phone_postfix)
 
-    if (prefix_len + postfix_len) > len(number):
+    if (prefix_len + postfix_len) >= len(number):
         return
 
     # Сравниваем начало номера
@@ -368,6 +368,10 @@ def __init__(self, vk, method, values, error):
         self.error = error
 
     def try_method(self):
+        ''' Пробует отправить запрос заново
+
+        '''
+
         return self.vk.method(self.method, self.values)
 
     def __str__(self):
@@ -388,12 +392,21 @@ def __init__(self, vk, captcha_sid,
         self.url = url
 
     def get_url(self):
+        """ Возвращает ссылку на изображение капчи
+
+        """
+
         if not self.url:
             self.url = 'http://api.vk.com/captcha.php?sid={}'.format(self.sid)
 
         return self.url
 
     def try_again(self, key):
+        """ Отправляет запрос заново с ответом капчи
+
+        :param key: текст капчи
+        """
+
         self.key = key
 
         self.kwargs.update({

vk_api/vk_tools.py

@@ -11,12 +11,17 @@
 import json
 import sys
 
-if sys.version_info[0] == 3:
-    xrange = range
+if sys.version_info[0] != 3:
+    range = xrange
 
 
 class VkTools(object):
     def __init__(self, vk):
+        """
+
+        :param vk: объект vk_api
+        """
+
         self.vk = vk
 
     def get_all(self, method, values=None, max_count=200, key='items'):
@@ -78,7 +83,7 @@ def get_all_slow(self, method, values=None, max_count=200, key='items'):
         count = response['count']
         items = response[key]
 
-        for i in xrange(max_count, count + 1, max_count):
+        for i in range(max_count, count + 1, max_count):
             values.update({
                 'offset': i
             })
@@ -89,8 +94,8 @@ def get_all_slow(self, method, values=None, max_count=200, key='items'):
         return {'count': len(items), key: items}
 
 # Полный код в файле vk_procedures
-code_get_all_items = '''
+code_get_all_items = """
 var z=%s,x=%s,y=%s,k="%s",p={"count":z}+y,r=API.%s(p),c=r["count"],j=r[k],o=0,
 i=1;while(i<25&&o<c){o=i*z+x;p={"count":z,"offset":o}+y;r=API.%s(p);j=j+r[k];i
 =i+1;};return{"count":c,"items":j,"offset":o,"end":o+z>=c};
-'''.replace('\n', '')
+""".replace('\n', '')

vk_api/vk_upload.py

@@ -11,6 +11,11 @@
 
 class VkUpload(object):
     def __init__(self, vk):
+        """
+
+        :param vk: объект vk_api
+        """
+
         self.vk = vk
         # https://vk.com/dev/upload_files