Merge remote-tracking branch 'origin/dev-1.x' into dev-1.x

aiogram/bot/api.py

@@ -1,13 +1,12 @@
-import asyncio
-import logging
 import os
+import logging
 from http import HTTPStatus
 
 import aiohttp
 
 from .. import types
-from ..utils import exceptions
 from ..utils import json
+from ..utils import exceptions
 from ..utils.helper import Helper, HelperMode, Item
 
 # Main aiogram logger

aiogram/types/audio.py

@@ -18,8 +18,8 @@ class Audio(base.TelegramObject, mixins.Downloadable):
 
     def __hash__(self):
         return hash(self.file_id) + \
-               self.duration + \
+            self.duration + \
-               hash(self.performer) + \
+            hash(self.performer) + \
-               hash(self.title) + \
+            hash(self.title) + \
-               hash(self.mime_type) + \
+            hash(self.mime_type) + \
-               self.file_size
+            self.file_size

aiogram/types/chat.py

@@ -40,7 +40,7 @@ class Chat(base.TelegramObject):
     @property
     def mention(self):
         """
-        Get mention if dialog have username or full name if this is Private dialog otherwise None
+        Get mention if a Chat has a username, or get full name if this is a Private Chat, otherwise None is returned
         """
         if self.username:
             return '@' + self.username
@@ -51,7 +51,7 @@ class Chat(base.TelegramObject):
     @property
     def user_url(self):
         if self.type != ChatType.PRIVATE:
-            raise TypeError('This property available only in private chats.')
+            raise TypeError('`user_url` property is only available in private chats!')
 
         return f"tg://user?id={self.id}"
 

aiogram/types/fields.py

@@ -15,8 +15,8 @@ class BaseField(metaclass=abc.ABCMeta):
 
         :param base: class for child element
         :param default: default value
-        :param alias: alias name (for e.g. field named 'from'  must be has name 'from_user'
+        :param alias: alias name (for e.g. field 'from' has to be named 'from_user'
-                      ('from' is builtin Python keyword)
+                      as 'from' is a builtin Python keyword
         """
         self.base_object = base
         self.default = default
@@ -34,7 +34,7 @@ class BaseField(metaclass=abc.ABCMeta):
 
     def get_value(self, instance):
         """
-        Get value for current object instance
+        Get value for the current object instance
 
         :param instance:
         :return:

aiogram/types/message_entity.py

@@ -18,8 +18,8 @@ class MessageEntity(base.TelegramObject):
 
     def _apply(self, text, func):
         return text[:self.offset] + \
-               func(text[self.offset:self.offset + self.length]) + \
+            func(text[self.offset:self.offset + self.length]) + \
-               text[self.offset + self.length:]
+            text[self.offset + self.length:]
 
     def apply_md(self, text):
         """

aiogram/types/reply_keyboard.py

@@ -67,7 +67,7 @@ class ReplyKeyboardMarkup(base.TelegramObject):
 
         :param button:
         """
-        if self.keyboard and len(self.keyboard[-1] < self.row_width):
+        if self.keyboard and len(self.keyboard[-1]) < self.row_width:
             self.keyboard[-1].append(button)
         else:
             self.add(button)

examples/media_group.py

@@ -14,13 +14,13 @@ dp = Dispatcher(bot)
 
 @dp.message_handler(commands=['start'])
 async def send_welcome(message: types.Message):
-    # So... By first i want to send something like that:
+    # So... At first I want to send something like this:
     await message.reply("Do you want to see many pussies? Are you ready?")
 
     # And wait few seconds...
     await asyncio.sleep(1)
 
-    # Good bots always must be send chat actions. Or not.
+    # Good bots should send chat actions. Or not.
     await ChatActions.upload_photo()
 
     # Create media group