python/aiogram
1
0
Fork 0
mirror of https://github.com/aiogram/aiogram.git synced 2025-12-11 18:01:04 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Combining filters (again) (#1018)

Browse source 
* Added explicit logic filters, added slots to all other filters

* Update translation files

* Update docs
This commit is contained in:
Alex Root Junior 2022-10-03 01:23:22 +03:00 • committed by GitHub
parent 1a3e2a8991
commit b0f251a8b8
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
26 changed files with 823 additions and 361 deletions
Download patch file Download diff file Expand all files Collapse all files

1
CHANGES/1017.doc
View file

@ -1 +0,0 @@
Fix UA translations in index.po

1
CHANGES/1017.doc.rst Normal file
View file

@ -0,0 +1 @@
Fix UA translations in index.po

3
CHANGES/1018.feature.rst Normal file
View file

@ -0,0 +1,3 @@
(again) Added possibility to combine filters with an *and*/*or* operations.
Read more in ":ref:`Combining filters <combining-filters>`" documentation section

9
aiogram/filters/__init__.py
View file

@ -1,5 +1,3 @@
from typing import Dict, Tuple, Type
from .base import Filter
from .chat_member_updated import (
ADMINISTRATOR,
@ -18,6 +16,7 @@ from .chat_member_updated import (
)
from .command import Command, CommandObject, CommandStart
from .exception import ExceptionMessageFilter, ExceptionTypeFilter
from .logic import and_f, invert_f, or_f
from .magic_data import MagicData
from .state import StateFilter
from .text import Text
@ -25,7 +24,6 @@ from .text import Text
BaseFilter = Filter
__all__ = (
"BUILTIN_FILTERS",
"Filter",
"BaseFilter",
"Text",
@ -49,6 +47,7 @@ __all__ = (
"IS_NOT_MEMBER",
"JOIN_TRANSITION",
"LEAVE_TRANSITION",
"and_f",
"or_f",
"invert_f",
)
BUILTIN_FILTERS: Dict[str, Tuple[Type[Filter], ...]] = {}

23
aiogram/filters/base.py
View file

@ -2,7 +2,7 @@ from abc import ABC, abstractmethod
from typing import TYPE_CHECKING, Any, Awaitable, Callable, Dict, Union
if TYPE_CHECKING:
from aiogram.dispatcher.event.handler import CallbackType, FilterObject
from aiogram.filters.logic import _InvertFilter
class Filter(ABC):
@ -31,6 +31,8 @@ class Filter(ABC):
pass
def __invert__(self) -> "_InvertFilter":
from aiogram.filters.logic import invert_f
return invert_f(self)
def update_handler_flags(self, flags: Dict[str, Any]) -> None:
@ -50,22 +52,3 @@ class Filter(ABC):
def __await__(self): # type: ignore # pragma: no cover
# Is needed only for inspection and this method is never be called
return self.__call__
class _InvertFilter(Filter):
__slots__ = ("target",)
def __init__(self, target: "FilterObject") -> None:
self.target = target
async def __call__(self, *args: Any, **kwargs: Any) -> Union[bool, Dict[str, Any]]:
return not bool(await self.target.call(*args, **kwargs))
def __str__(self) -> str:
return f"~{self.target.callback}"
def invert_f(target: "CallbackType") -> _InvertFilter:
from aiogram.dispatcher.event.handler import FilterObject
return _InvertFilter(target=FilterObject(target))

5
aiogram/filters/callback_data.py
View file

@ -131,6 +131,11 @@ class CallbackQueryFilter(Filter):
via callback data instance
"""
__slots__ = (
"callback_data",
"rule",
)
def __init__(
self,
*,

14
aiogram/filters/chat_member_updated.py
View file

@ -9,6 +9,11 @@ TransitionT = TypeVar("TransitionT", bound="_MemberStatusTransition")
class _MemberStatusMarker:
__slots__ = (
"name",
"is_member",
)
def __init__(self, name: str, *, is_member: Optional[bool] = None) -> None:
self.name = name
self.is_member = is_member
@ -72,6 +77,8 @@ class _MemberStatusMarker:
class _MemberStatusGroupMarker:
__slots__ = ("statuses",)
def __init__(self, *statuses: _MemberStatusMarker) -> None:
if not statuses:
raise ValueError("Member status group should have at least one status included")
@ -124,6 +131,11 @@ class _MemberStatusGroupMarker:
class _MemberStatusTransition:
__slots__ = (
"old",
"new",
)
def __init__(self, *, old: _MemberStatusGroupMarker, new: _MemberStatusGroupMarker) -> None:
self.old = old
self.new = new
@ -155,6 +167,8 @@ PROMOTED_TRANSITION = (MEMBER | RESTRICTED | LEFT | KICKED) >> ADMINISTRATOR
class ChatMemberUpdatedFilter(Filter):
__slots__ = ("member_status_changed",)
def __init__(
self,
member_status_changed: Union[

8
aiogram/filters/command.py
View file

@ -38,6 +38,14 @@ class Command(Filter):
Works only with :class:`aiogram.types.message.Message` events which have the :code:`text`.
"""
__slots__ = (
"commands",
"prefix",
"ignore_case",
"ignore_mention",
"magic",
)
def __init__(
self,
*values: CommandPatternType,

4
aiogram/filters/exception.py
View file

@ -11,6 +11,8 @@ class ExceptionTypeFilter(Filter):
Allows to match exception by type
"""
__slots__ = ("exceptions",)
def __init__(self, *exceptions: Type[Exception]):
"""
:param exceptions: Exception type(s)
@ -28,6 +30,8 @@ class ExceptionMessageFilter(Filter):
Allow to match exception by message
"""
__slots__ = ("pattern",)
def __init__(self, pattern: Union[str, Pattern[str]]):
"""
:param pattern: Regexp pattern

77
aiogram/filters/logic.py Normal file
View file

@ -0,0 +1,77 @@
from abc import ABC
from typing import TYPE_CHECKING, Any, Dict, Union
from aiogram.filters import Filter
if TYPE_CHECKING:
from aiogram.dispatcher.event.handler import CallbackType, FilterObject
class _LogicFilter(Filter, ABC):
pass
class _InvertFilter(_LogicFilter):
__slots__ = ("target",)
def __init__(self, target: "FilterObject") -> None:
self.target = target
async def __call__(self, *args: Any, **kwargs: Any) -> Union[bool, Dict[str, Any]]:
return not bool(await self.target.call(*args, **kwargs))
class _AndFilter(_LogicFilter):
__slots__ = ("targets",)
def __init__(self, *targets: "FilterObject") -> None:
self.targets = targets
async def __call__(self, *args: Any, **kwargs: Any) -> Union[bool, Dict[str, Any]]:
final_result = {}
for target in self.targets:
result = await target.call(*args, **kwargs)
if not result:
return False
if isinstance(result, dict):
final_result.update(result)
if final_result:
return final_result
return True
class _OrFilter(_LogicFilter):
__slots__ = ("targets",)
def __init__(self, *targets: "FilterObject") -> None:
self.targets = targets
async def __call__(self, *args: Any, **kwargs: Any) -> Union[bool, Dict[str, Any]]:
for target in self.targets:
result = await target.call(*args, **kwargs)
if not result:
continue
if isinstance(result, dict):
return result
return bool(result)
return False
def and_f(target1: "CallbackType", target2: "CallbackType") -> _AndFilter:
from aiogram.dispatcher.event.handler import FilterObject
return _AndFilter(FilterObject(target1), FilterObject(target2))
def or_f(target1: "CallbackType", target2: "CallbackType") -> _OrFilter:
from aiogram.dispatcher.event.handler import FilterObject
return _OrFilter(FilterObject(target1), FilterObject(target2))
def invert_f(target: "CallbackType") -> _InvertFilter:
from aiogram.dispatcher.event.handler import FilterObject
return _InvertFilter(FilterObject(target))

6
aiogram/filters/magic_data.py
View file

@ -7,6 +7,12 @@ from aiogram.types import TelegramObject
class MagicData(Filter):
"""
This filter helps to filter event with contextual data
"""
__slots__ = "magic_data"
def __init__(self, magic_data: MagicFilter) -> None:
self.magic_data = magic_data

2
aiogram/filters/state.py
View file

@ -13,6 +13,8 @@ class StateFilter(Filter):
State filter
"""
__slots__ = ("states",)
def __init__(self, *states: StateType) -> None:
if not states:
raise ValueError("At least one state is required")

8
aiogram/filters/text.py
View file

@ -25,6 +25,14 @@ class Text(Filter):
use :ref:`magic-filter <magic-filters>`. For example do :pycode:`F.text == "text"` instead
"""
__slots__ = (
"text",
"contains",
"startswith",
"endswith",
"ignore_case",
)
def __init__(
self,
text: Optional[Union[Sequence[TextType], TextType]] = None,

47
docs/dispatcher/filters/index.rst
View file

@ -53,3 +53,50 @@ Own filter example
For example if you need to make simple text filter:
.. literalinclude:: ../../../examples/own_filter.py
.. _combining-filters:
Combining Filters
=================
In general, all filters can be combined in two ways
Recommended way
---------------
If you specify multiple filters in a row, it will be checked with an "and" condition:
.. code-block:: python
@<router>.message(Text(startswith="show"), Text(endswith="example"))
Also, if you want to use two alternative ways to run the sage handler ("or" condition)
you can register the handler twice or more times as you like
.. code-block:: python
@<router>.message(Text(text="hi"))
@<router>.message(CommandStart())
Also sometimes you will need to invert the filter result, for example you have an *IsAdmin* filter
and you want to check if the user is not an admin
.. code-block:: python
@<router>.message(~IsAdmin())
Another possible way
--------------------
An alternative way is to combine using special functions (:func:`and_f`, :func:`or_f`, :func:`invert_f` from :code:`aiogram.filters` module):
.. code-block:: python
and_f(Text(startswith="show"), Text(endswith="example"))
or_f(Text(text="hi"), CommandStart())
invert_f(IsAdmin())
and_f(<A>, or_f(<B>, <C>))

66
docs/locale/en/LC_MESSAGES/api/upload_file.po
View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: aiogram \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-10-01 22:51+0300\n"
"POT-Creation-Date: 2022-10-03 01:03+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@ -86,6 +86,31 @@ msgstr ""
msgid "Then you can use it:"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.__init__:1
#: aiogram.types.input_file.FSInputFile.__init__:1 of
msgid "Represents object for uploading files from filesystem"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.__init__
#: aiogram.types.input_file.FSInputFile.__init__ of
msgid "Parameters"
msgstr ""
#: aiogram.types.input_file.FSInputFile.__init__:3 of
msgid "Path to file"
msgstr ""
#: aiogram.types.input_file.FSInputFile.__init__:4 of
msgid ""
"Filename to be propagated to telegram. By default, will be parsed from "
"path"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.__init__:5
#: aiogram.types.input_file.FSInputFile.__init__:6 of
msgid "Uploading chunk size"
msgstr ""
#: ../../api/upload_file.rst:52
msgid "Upload from buffer"
msgstr ""
@ -105,34 +130,12 @@ msgstr ""
msgid "And then you can use it:"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.from_file:1 of
msgid "Create buffer from file"
#: aiogram.types.input_file.BufferedInputFile.__init__:3 of
msgid "Bytes"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.from_file of
msgid "Parameters"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.from_file:3 of
msgid "Path to file"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.from_file:4 of
msgid ""
"Filename to be propagated to telegram. By default, will be parsed from "
"path"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.from_file:6 of
msgid "Uploading chunk size"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.from_file of
msgid "Returns"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.from_file:7 of
msgid "instance of :obj:`BufferedInputFile`"
#: aiogram.types.input_file.BufferedInputFile.__init__:4 of
msgid "Filename to be propagated to telegram."
msgstr ""
#: ../../api/upload_file.rst:74
@ -146,3 +149,12 @@ msgid ""
"<https://core.telegram.org/bots/api#sending-files>`_ by URL, you can use "
":obj:`aiogram.types.input_file.URLInputFile`."
msgstr ""
#~ msgid "Create buffer from file"
#~ msgstr ""
#~ msgid "Returns"
#~ msgstr ""
#~ msgid "instance of :obj:`BufferedInputFile`"
#~ msgstr ""

333
docs/locale/en/LC_MESSAGES/changelog.po
View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: aiogram \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-10-01 22:51+0300\n"
"POT-Creation-Date: 2022-10-03 01:03+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@ -22,227 +22,310 @@ msgid "Changelog"
msgstr ""
#: ../../../CHANGES.rst:18
msgid "3.0.0b4 (2022-08-14)"
msgid "3.0.0b5 (2022-10-02)"
msgstr ""
#: ../../../CHANGES.rst:21 ../../../CHANGES.rst:94 ../../../CHANGES.rst:135
#: ../../../CHANGES.rst:173 ../../../CHANGES.rst:221 ../../../CHANGES.rst:297
#: ../../../CHANGES.rst:330 ../../../CHANGES.rst:361
#: ../../../CHANGES.rst:21 ../../../CHANGES.rst:72 ../../../CHANGES.rst:145
#: ../../../CHANGES.rst:186 ../../../CHANGES.rst:224 ../../../CHANGES.rst:272
#: ../../../CHANGES.rst:348 ../../../CHANGES.rst:381 ../../../CHANGES.rst:412
msgid "Features"
msgstr ""
#: ../../../CHANGES.rst:23
msgid ""
"Add PyPy support and run tests under PyPy `#985 "
"<https://github.com/aiogram/aiogram/issues/985>`_"
msgstr ""
#: ../../../CHANGES.rst:25
msgid ""
"Added message text to aiogram exceptions representation `#988 "
"<https://github.com/aiogram/aiogram/issues/988>`_"
msgstr ""
#: ../../../CHANGES.rst:27
msgid ""
"Added warning about using magic filter from `magic_filter` instead of "
"`aiogram`'s ones. Is recommended to use `from aiogram import F` instead "
"of `from magic_filter import F` `#990 "
"<https://github.com/aiogram/aiogram/issues/990>`_"
msgstr ""
#: ../../../CHANGES.rst:30
msgid ""
"Added more detailed error when server response can't be deserialized. "
"This feature will help to debug unexpected responses from the Server "
"`#1014 <https://github.com/aiogram/aiogram/issues/1014>`_"
msgstr ""
#: ../../../CHANGES.rst:35 ../../../CHANGES.rst:96 ../../../CHANGES.rst:154
#: ../../../CHANGES.rst:200 ../../../CHANGES.rst:248 ../../../CHANGES.rst:304
#: ../../../CHANGES.rst:389 ../../../CHANGES.rst:421
msgid "Bugfixes"
msgstr ""
#: ../../../CHANGES.rst:37
msgid ""
"Reworked error event, introduced "
":class:`aiogram.types.error_event.ErrorEvent` object. `#898 "
"<https://github.com/aiogram/aiogram/issues/898>`_"
msgstr ""
#: ../../../CHANGES.rst:39
msgid ""
"Fixed escaping markdown in `aiogram.utils.markdown` module `#903 "
"<https://github.com/aiogram/aiogram/issues/903>`_"
msgstr ""
#: ../../../CHANGES.rst:41
msgid ""
"Fixed polling crash when Telegram Bot API raises HTTP 429 status-code. "
"`#995 <https://github.com/aiogram/aiogram/issues/995>`_"
msgstr ""
#: ../../../CHANGES.rst:43
msgid ""
"Fixed empty mention in command parsing, now it will be None instead of an"
" empty string `#1013 <https://github.com/aiogram/aiogram/issues/1013>`_"
msgstr ""
#: ../../../CHANGES.rst:48 ../../../CHANGES.rst:428
msgid "Improved Documentation"
msgstr ""
#: ../../../CHANGES.rst:50
msgid ""
"Initialized Docs translation (added Ukrainian language) `#925 "
"<https://github.com/aiogram/aiogram/issues/925>`_"
msgstr ""
#: ../../../CHANGES.rst:55
msgid "Deprecations and Removals"
msgstr ""
#: ../../../CHANGES.rst:57
msgid ""
"Removed filters factory as described in corresponding issue. `#942 "
"<https://github.com/aiogram/aiogram/issues/942>`_"
msgstr ""
#: ../../../CHANGES.rst:62 ../../../CHANGES.rst:113 ../../../CHANGES.rst:167
#: ../../../CHANGES.rst:209 ../../../CHANGES.rst:255 ../../../CHANGES.rst:315
#: ../../../CHANGES.rst:336 ../../../CHANGES.rst:359 ../../../CHANGES.rst:396
#: ../../../CHANGES.rst:435
msgid "Misc"
msgstr ""
#: ../../../CHANGES.rst:64
msgid ""
"Now Router/Dispatcher accepts only keyword arguments. `#982 "
"<https://github.com/aiogram/aiogram/issues/982>`_"
msgstr ""
#: ../../../CHANGES.rst:69
msgid "3.0.0b4 (2022-08-14)"
msgstr ""
#: ../../../CHANGES.rst:74
msgid ""
"Add class helper ChatAction for constants that Telegram BotAPI uses in "
"sendChatAction request. In my opinion, this will help users and will also"
" improve compatibility with 2.x version where similar class was called "
"\"ChatActions\". `#803 <https://github.com/aiogram/aiogram/issues/803>`_"
msgstr ""
#: ../../../CHANGES.rst:27
#: ../../../CHANGES.rst:78
msgid "Added possibility to combine filters or invert result"
msgstr ""
#: ../../../CHANGES.rst:29
#: ../../../CHANGES.rst:80
msgid "Example:"
msgstr ""
#: ../../../CHANGES.rst:37
#: ../../../CHANGES.rst:88
msgid "`#894 <https://github.com/aiogram/aiogram/issues/894>`_"
msgstr ""
#: ../../../CHANGES.rst:38
#: ../../../CHANGES.rst:89
msgid ""
"Fixed type hints for redis TTL params. `#922 "
"<https://github.com/aiogram/aiogram/issues/922>`_"
msgstr ""
#: ../../../CHANGES.rst:40
#: ../../../CHANGES.rst:91
msgid ""
"Added `full_name` shortcut for `Chat` object `#929 "
"<https://github.com/aiogram/aiogram/issues/929>`_"
msgstr ""
#: ../../../CHANGES.rst:45 ../../../CHANGES.rst:103 ../../../CHANGES.rst:149
#: ../../../CHANGES.rst:197 ../../../CHANGES.rst:253 ../../../CHANGES.rst:338
#: ../../../CHANGES.rst:370
msgid "Bugfixes"
msgstr ""
#: ../../../CHANGES.rst:47
#: ../../../CHANGES.rst:98
msgid ""
"Fixed false-positive coercing of Union types in API methods `#901 "
"<https://github.com/aiogram/aiogram/issues/901>`_"
msgstr ""
#: ../../../CHANGES.rst:49
#: ../../../CHANGES.rst:100
msgid "Added 3 missing content types:"
msgstr ""
#: ../../../CHANGES.rst:51
#: ../../../CHANGES.rst:102
msgid "proximity_alert_triggered"
msgstr ""
#: ../../../CHANGES.rst:52
#: ../../../CHANGES.rst:103
msgid "supergroup_chat_created"
msgstr ""
#: ../../../CHANGES.rst:53
#: ../../../CHANGES.rst:104
msgid "channel_chat_created"
msgstr ""
#: ../../../CHANGES.rst:54
#: ../../../CHANGES.rst:105
msgid "`#906 <https://github.com/aiogram/aiogram/issues/906>`_"
msgstr ""
#: ../../../CHANGES.rst:55
#: ../../../CHANGES.rst:106
msgid ""
"Fixed the ability to compare the state, now comparison to copy of the "
"state will return `True`. `#927 "
"<https://github.com/aiogram/aiogram/issues/927>`_"
msgstr ""
#: ../../../CHANGES.rst:57
#: ../../../CHANGES.rst:108
msgid ""
"Fixed default lock kwargs in RedisEventIsolation. `#972 "
"<https://github.com/aiogram/aiogram/issues/972>`_"
msgstr ""
#: ../../../CHANGES.rst:62 ../../../CHANGES.rst:116 ../../../CHANGES.rst:158
#: ../../../CHANGES.rst:204 ../../../CHANGES.rst:264 ../../../CHANGES.rst:285
#: ../../../CHANGES.rst:308 ../../../CHANGES.rst:345 ../../../CHANGES.rst:384
msgid "Misc"
msgstr ""
#: ../../../CHANGES.rst:64
#: ../../../CHANGES.rst:115
msgid ""
"Restrict including routers with strings `#896 "
"<https://github.com/aiogram/aiogram/issues/896>`_"
msgstr ""
#: ../../../CHANGES.rst:66
#: ../../../CHANGES.rst:117
msgid ""
"Changed CommandPatterType to CommandPatternType in "
"`aiogram/dispatcher/filters/command.py` `#907 "
"<https://github.com/aiogram/aiogram/issues/907>`_"
msgstr ""
#: ../../../CHANGES.rst:68
#: ../../../CHANGES.rst:119
msgid ""
"Added full support of `Bot API 6.1 <https://core.telegram.org/bots/api-"
"changelog#june-20-2022>`_ `#936 "
"<https://github.com/aiogram/aiogram/issues/936>`_"
msgstr ""
#: ../../../CHANGES.rst:70
#: ../../../CHANGES.rst:121
msgid "**Breaking!** More flat project structure"
msgstr ""
#: ../../../CHANGES.rst:72
#: ../../../CHANGES.rst:123
msgid "These packages was moved, imports in your code should be fixed:"
msgstr ""
#: ../../../CHANGES.rst:74
#: ../../../CHANGES.rst:125
msgid ":code:`aiogram.dispatcher.filters` -> :code:`aiogram.filters`"
msgstr ""
#: ../../../CHANGES.rst:75
#: ../../../CHANGES.rst:126
msgid ":code:`aiogram.dispatcher.fsm` -> :code:`aiogram.fsm`"
msgstr ""
#: ../../../CHANGES.rst:76
#: ../../../CHANGES.rst:127
msgid ":code:`aiogram.dispatcher.handler` -> :code:`aiogram.handler`"
msgstr ""
#: ../../../CHANGES.rst:77
#: ../../../CHANGES.rst:128
msgid ":code:`aiogram.dispatcher.webhook` -> :code:`aiogram.webhook`"
msgstr ""
#: ../../../CHANGES.rst:78
#: ../../../CHANGES.rst:129
msgid ""
":code:`aiogram.dispatcher.flags/*` -> :code:`aiogram.dispatcher.flags` "
"(single module instead of package)"
msgstr ""
#: ../../../CHANGES.rst:79
#: ../../../CHANGES.rst:130
msgid "`#938 <https://github.com/aiogram/aiogram/issues/938>`_"
msgstr ""
#: ../../../CHANGES.rst:80
#: ../../../CHANGES.rst:131
msgid ""
"Removed deprecated :code:`router.<event>_handler` and "
":code:`router.register_<event>_handler` methods. `#941 "
"<https://github.com/aiogram/aiogram/issues/941>`_"
msgstr ""
#: ../../../CHANGES.rst:82
#: ../../../CHANGES.rst:133
msgid ""
"Deprecated filters factory. It will be removed in next Beta (3.0b5) `#942"
" <https://github.com/aiogram/aiogram/issues/942>`_"
msgstr ""
#: ../../../CHANGES.rst:84
#: ../../../CHANGES.rst:135
msgid ""
"`MessageEntity` method `get_text` was removed and `extract` was renamed "
"to `extract_from` `#944 <https://github.com/aiogram/aiogram/issues/944>`_"
msgstr ""
#: ../../../CHANGES.rst:86
#: ../../../CHANGES.rst:137
msgid ""
"Added full support of `Bot API 6.2 <https://core.telegram.org/bots/api-"
"changelog#august-12-2022>`_ `#975 "
"<https://github.com/aiogram/aiogram/issues/975>`_"
msgstr ""
#: ../../../CHANGES.rst:91
#: ../../../CHANGES.rst:142
msgid "3.0.0b3 (2022-04-19)"
msgstr ""
#: ../../../CHANGES.rst:96
#: ../../../CHANGES.rst:147
msgid ""
"Added possibility to get command magic result as handler argument `#889 "
"<https://github.com/aiogram/aiogram/issues/889>`_"
msgstr ""
#: ../../../CHANGES.rst:98
#: ../../../CHANGES.rst:149
msgid ""
"Added full support of `Telegram Bot API 6.0 "
"<https://core.telegram.org/bots/api-changelog#april-16-2022>`_ `#890 "
"<https://github.com/aiogram/aiogram/issues/890>`_"
msgstr ""
#: ../../../CHANGES.rst:105
#: ../../../CHANGES.rst:156
msgid ""
"Fixed I18n lazy-proxy. Disabled caching. `#839 "
"<https://github.com/aiogram/aiogram/issues/839>`_"
msgstr ""
#: ../../../CHANGES.rst:107
#: ../../../CHANGES.rst:158
msgid ""
"Added parsing of spoiler message entity `#865 "
"<https://github.com/aiogram/aiogram/issues/865>`_"
msgstr ""
#: ../../../CHANGES.rst:109
#: ../../../CHANGES.rst:160
msgid ""
"Fixed default `parse_mode` for `Message.copy_to()` method. `#876 "
"<https://github.com/aiogram/aiogram/issues/876>`_"
msgstr ""
#: ../../../CHANGES.rst:111
#: ../../../CHANGES.rst:162
msgid ""
"Fixed CallbackData factory parsing IntEnum's `#885 "
"<https://github.com/aiogram/aiogram/issues/885>`_"
msgstr ""
#: ../../../CHANGES.rst:118
#: ../../../CHANGES.rst:169
msgid ""
"Added automated check that pull-request adds a changes description to "
"**CHANGES** directory `#873 "
"<https://github.com/aiogram/aiogram/issues/873>`_"
msgstr ""
#: ../../../CHANGES.rst:120
#: ../../../CHANGES.rst:171
msgid ""
"Changed :code:`Message.html_text` and :code:`Message.md_text` attributes "
"behaviour when message has no text. The empty string will be used instead"
@ -250,14 +333,14 @@ msgid ""
"<https://github.com/aiogram/aiogram/issues/874>`_"
msgstr ""
#: ../../../CHANGES.rst:123
#: ../../../CHANGES.rst:174
msgid ""
"Used `redis-py` instead of `aioredis` package in due to this packages was"
" merged into single one `#882 "
"<https://github.com/aiogram/aiogram/issues/882>`_"
msgstr ""
#: ../../../CHANGES.rst:125
#: ../../../CHANGES.rst:176
msgid ""
"Solved common naming problem with middlewares that confusing too much "
"developers - now you can't see the `middleware` and `middlewares` "
@ -266,113 +349,113 @@ msgid ""
"<https://github.com/aiogram/aiogram/issues/883>`_"
msgstr ""
#: ../../../CHANGES.rst:132
#: ../../../CHANGES.rst:183
msgid "3.0.0b2 (2022-02-19)"
msgstr ""
#: ../../../CHANGES.rst:137
#: ../../../CHANGES.rst:188
msgid ""
"Added possibility to pass additional arguments into the aiohttp webhook "
"handler to use this arguments inside handlers as the same as it possible "
"in polling mode. `#785 <https://github.com/aiogram/aiogram/issues/785>`_"
msgstr ""
#: ../../../CHANGES.rst:140
#: ../../../CHANGES.rst:191
msgid ""
"Added possibility to add handler flags via decorator (like `pytest.mark` "
"decorator but `aiogram.flags`) `#836 "
"<https://github.com/aiogram/aiogram/issues/836>`_"
msgstr ""
#: ../../../CHANGES.rst:142
#: ../../../CHANGES.rst:193
msgid ""
"Added :code:`ChatActionSender` utility to automatically sends chat action"
" while long process is running."
msgstr ""
#: ../../../CHANGES.rst:144
#: ../../../CHANGES.rst:195
msgid ""
"It also can be used as message middleware and can be customized via "
":code:`chat_action` flag. `#837 "
"<https://github.com/aiogram/aiogram/issues/837>`_"
msgstr ""
#: ../../../CHANGES.rst:151
#: ../../../CHANGES.rst:202
msgid ""
"Fixed unexpected behavior of sequences in the StateFilter. `#791 "
"<https://github.com/aiogram/aiogram/issues/791>`_"
msgstr ""
#: ../../../CHANGES.rst:153
#: ../../../CHANGES.rst:204
msgid ""
"Fixed exceptions filters `#827 "
"<https://github.com/aiogram/aiogram/issues/827>`_"
msgstr ""
#: ../../../CHANGES.rst:160
#: ../../../CHANGES.rst:211
msgid ""
"Logger name for processing events is changed to :code:`aiogram.events`. "
"`#830 <https://github.com/aiogram/aiogram/issues/830>`_"
msgstr ""
#: ../../../CHANGES.rst:162
#: ../../../CHANGES.rst:213
msgid ""
"Added full support of Telegram Bot API 5.6 and 5.7 `#835 "
"<https://github.com/aiogram/aiogram/issues/835>`_"
msgstr ""
#: ../../../CHANGES.rst:164
#: ../../../CHANGES.rst:215
msgid ""
"**BREAKING** Events isolation mechanism is moved from FSM storages to "
"standalone managers `#838 "
"<https://github.com/aiogram/aiogram/issues/838>`_"
msgstr ""
#: ../../../CHANGES.rst:170
#: ../../../CHANGES.rst:221
msgid "3.0.0b1 (2021-12-12)"
msgstr ""
#: ../../../CHANGES.rst:175
#: ../../../CHANGES.rst:226
msgid "Added new custom operation for MagicFilter named :code:`as_`"
msgstr ""
#: ../../../CHANGES.rst:177
#: ../../../CHANGES.rst:228
msgid "Now you can use it to get magic filter result as handler argument"
msgstr ""
#: ../../../CHANGES.rst:193
#: ../../../CHANGES.rst:244
msgid "`#759 <https://github.com/aiogram/aiogram/issues/759>`_"
msgstr ""
#: ../../../CHANGES.rst:199
#: ../../../CHANGES.rst:250
msgid ""
"Fixed: Missing :code:`ChatMemberHandler` import in "
":code:`aiogram/dispatcher/handler` `#751 "
"<https://github.com/aiogram/aiogram/issues/751>`_"
msgstr ""
#: ../../../CHANGES.rst:206
#: ../../../CHANGES.rst:257
msgid ""
"Check :code:`destiny` in case of no :code:`with_destiny` enabled in "
"RedisStorage key builder `#776 "
"<https://github.com/aiogram/aiogram/issues/776>`_"
msgstr ""
#: ../../../CHANGES.rst:208
#: ../../../CHANGES.rst:259
msgid ""
"Added full support of `Bot API 5.5 <https://core.telegram.org/bots/api-"
"changelog#december-7-2021>`_ `#777 "
"<https://github.com/aiogram/aiogram/issues/777>`_"
msgstr ""
#: ../../../CHANGES.rst:210
#: ../../../CHANGES.rst:261
msgid ""
"Stop using feature from #336. From now settings of client-session should "
"be placed as initializer arguments instead of changing instance "
"attributes. `#778 <https://github.com/aiogram/aiogram/issues/778>`_"
msgstr ""
#: ../../../CHANGES.rst:212
#: ../../../CHANGES.rst:263
msgid ""
"Make TelegramAPIServer files wrapper in local mode bi-directional "
"(server-client, client-server) Now you can convert local path to server "
@ -380,11 +463,11 @@ msgid ""
"<https://github.com/aiogram/aiogram/issues/779>`_"
msgstr ""
#: ../../../CHANGES.rst:218
#: ../../../CHANGES.rst:269
msgid "3.0.0a18 (2021-11-10)"
msgstr ""
#: ../../../CHANGES.rst:223
#: ../../../CHANGES.rst:274
msgid ""
"Breaking: Changed the signature of the session middlewares Breaking: "
"Renamed AiohttpSession.make_request method parameter from call to method "
@ -392,262 +475,258 @@ msgid ""
"outgoing requests `#716 <https://github.com/aiogram/aiogram/issues/716>`_"
msgstr ""
#: ../../../CHANGES.rst:227
#: ../../../CHANGES.rst:278
msgid ""
"Improved description of filters resolving error. For example when you try"
" to pass wrong type of argument to the filter but don't know why filter "
"is not resolved now you can get error like this:"
msgstr ""
#: ../../../CHANGES.rst:237
#: ../../../CHANGES.rst:288
msgid "`#717 <https://github.com/aiogram/aiogram/issues/717>`_"
msgstr ""
#: ../../../CHANGES.rst:238
#: ../../../CHANGES.rst:289
msgid ""
"**Breaking internal API change** Reworked FSM Storage record keys "
"propagation `#723 <https://github.com/aiogram/aiogram/issues/723>`_"
msgstr ""
#: ../../../CHANGES.rst:241
#: ../../../CHANGES.rst:292
msgid ""
"Implemented new filter named :code:`MagicData(magic_data)` that helps to "
"filter event by data from middlewares or other filters"
msgstr ""
#: ../../../CHANGES.rst:243
#: ../../../CHANGES.rst:294
msgid ""
"For example your bot is running with argument named :code:`config` that "
"contains the application config then you can filter event by value from "
"this config:"
msgstr ""
#: ../../../CHANGES.rst:249
#: ../../../CHANGES.rst:300
msgid "`#724 <https://github.com/aiogram/aiogram/issues/724>`_"
msgstr ""
#: ../../../CHANGES.rst:255
#: ../../../CHANGES.rst:306
msgid ""
"Fixed I18n context inside error handlers `#726 "
"<https://github.com/aiogram/aiogram/issues/726>`_"
msgstr ""
#: ../../../CHANGES.rst:257
#: ../../../CHANGES.rst:308
msgid ""
"Fixed bot session closing before emit shutdown `#734 "
"<https://github.com/aiogram/aiogram/issues/734>`_"
msgstr ""
#: ../../../CHANGES.rst:259
#: ../../../CHANGES.rst:310
msgid ""
"Fixed: bound filter resolving does not require children routers `#736 "
"<https://github.com/aiogram/aiogram/issues/736>`_"
msgstr ""
#: ../../../CHANGES.rst:266
#: ../../../CHANGES.rst:317
msgid ""
"Enabled testing on Python 3.10 Removed `async_lru` dependency (is "
"incompatible with Python 3.10) and replaced usage with protected property"
" `#719 <https://github.com/aiogram/aiogram/issues/719>`_"
msgstr ""
#: ../../../CHANGES.rst:269
#: ../../../CHANGES.rst:320
msgid ""
"Converted README.md to README.rst and use it as base file for docs `#725 "
"<https://github.com/aiogram/aiogram/issues/725>`_"
msgstr ""
#: ../../../CHANGES.rst:271
#: ../../../CHANGES.rst:322
msgid "Rework filters resolving:"
msgstr ""
#: ../../../CHANGES.rst:273
#: ../../../CHANGES.rst:324
msgid "Automatically apply Bound Filters with default values to handlers"
msgstr ""
#: ../../../CHANGES.rst:274
#: ../../../CHANGES.rst:325
msgid "Fix data transfer from parent to included routers filters"
msgstr ""
#: ../../../CHANGES.rst:275
#: ../../../CHANGES.rst:326
msgid "`#727 <https://github.com/aiogram/aiogram/issues/727>`_"
msgstr ""
#: ../../../CHANGES.rst:276
#: ../../../CHANGES.rst:327
msgid ""
"Added full support of Bot API 5.4 https://core.telegram.org/bots/api-"
"changelog#november-5-2021 `#744 "
"<https://github.com/aiogram/aiogram/issues/744>`_"
msgstr ""
#: ../../../CHANGES.rst:282
#: ../../../CHANGES.rst:333
msgid "3.0.0a17 (2021-09-24)"
msgstr ""
#: ../../../CHANGES.rst:287
#: ../../../CHANGES.rst:338
msgid ""
"Added :code:`html_text` and :code:`md_text` to Message object `#708 "
"<https://github.com/aiogram/aiogram/issues/708>`_"
msgstr ""
#: ../../../CHANGES.rst:289
#: ../../../CHANGES.rst:340
msgid ""
"Refactored I18n, added context managers for I18n engine and current "
"locale `#709 <https://github.com/aiogram/aiogram/issues/709>`_"
msgstr ""
#: ../../../CHANGES.rst:294
#: ../../../CHANGES.rst:345
msgid "3.0.0a16 (2021-09-22)"
msgstr ""
#: ../../../CHANGES.rst:299
#: ../../../CHANGES.rst:350
msgid "Added support of local Bot API server files downloading"
msgstr ""
#: ../../../CHANGES.rst:301
#: ../../../CHANGES.rst:352
msgid ""
"When Local API is enabled files can be downloaded via "
"`bot.download`/`bot.download_file` methods. `#698 "
"<https://github.com/aiogram/aiogram/issues/698>`_"
msgstr ""
#: ../../../CHANGES.rst:303
#: ../../../CHANGES.rst:354
msgid ""
"Implemented I18n & L10n support `#701 "
"<https://github.com/aiogram/aiogram/issues/701>`_"
msgstr ""
#: ../../../CHANGES.rst:310
#: ../../../CHANGES.rst:361
msgid ""
"Covered by tests and docs KeyboardBuilder util `#699 "
"<https://github.com/aiogram/aiogram/issues/699>`_"
msgstr ""
#: ../../../CHANGES.rst:312
#: ../../../CHANGES.rst:363
msgid "**Breaking!!!**. Refactored and renamed exceptions."
msgstr ""
#: ../../../CHANGES.rst:314
#: ../../../CHANGES.rst:365
msgid ""
"Exceptions module was moved from :code:`aiogram.utils.exceptions` to "
":code:`aiogram.exceptions`"
msgstr ""
#: ../../../CHANGES.rst:315
#: ../../../CHANGES.rst:366
msgid "Added prefix `Telegram` for all error classes"
msgstr ""
#: ../../../CHANGES.rst:316
#: ../../../CHANGES.rst:367
msgid "`#700 <https://github.com/aiogram/aiogram/issues/700>`_"
msgstr ""
#: ../../../CHANGES.rst:317
#: ../../../CHANGES.rst:368
msgid ""
"Replaced all :code:`pragma: no cover` marks via global "
":code:`.coveragerc` config `#702 "
"<https://github.com/aiogram/aiogram/issues/702>`_"
msgstr ""
#: ../../../CHANGES.rst:319
#: ../../../CHANGES.rst:370
msgid "Updated dependencies."
msgstr ""
#: ../../../CHANGES.rst:321
#: ../../../CHANGES.rst:372
msgid ""
"**Breaking for framework developers** Now all optional dependencies "
"should be installed as extra: `poetry install -E fast -E redis -E proxy "
"-E i18n -E docs` `#703 <https://github.com/aiogram/aiogram/issues/703>`_"
msgstr ""
#: ../../../CHANGES.rst:327
#: ../../../CHANGES.rst:378
msgid "3.0.0a15 (2021-09-10)"
msgstr ""
#: ../../../CHANGES.rst:332
#: ../../../CHANGES.rst:383
msgid ""
"Ability to iterate over all states in StatesGroup. Aiogram already had in"
" check for states group so this is relative feature. `#666 "
"<https://github.com/aiogram/aiogram/issues/666>`_"
msgstr ""
#: ../../../CHANGES.rst:340
#: ../../../CHANGES.rst:391
msgid ""
"Fixed incorrect type checking in the "
":class:`aiogram.utils.keyboard.KeyboardBuilder` `#674 "
"<https://github.com/aiogram/aiogram/issues/674>`_"
msgstr ""
#: ../../../CHANGES.rst:347
#: ../../../CHANGES.rst:398
msgid ""
"Disable ContentType filter by default `#668 "
"<https://github.com/aiogram/aiogram/issues/668>`_"
msgstr ""
#: ../../../CHANGES.rst:349
#: ../../../CHANGES.rst:400
msgid ""
"Moved update type detection from Dispatcher to Update object `#669 "
"<https://github.com/aiogram/aiogram/issues/669>`_"
msgstr ""
#: ../../../CHANGES.rst:351
#: ../../../CHANGES.rst:402
msgid ""
"Updated **pre-commit** config `#681 "
"<https://github.com/aiogram/aiogram/issues/681>`_"
msgstr ""
#: ../../../CHANGES.rst:353
#: ../../../CHANGES.rst:404
msgid ""
"Reworked **handlers_in_use** util. Function moved to Router as method "
"**.resolve_used_update_types()** `#682 "
"<https://github.com/aiogram/aiogram/issues/682>`_"
msgstr ""
#: ../../../CHANGES.rst:358
#: ../../../CHANGES.rst:409
msgid "3.0.0a14 (2021-08-17)"
msgstr ""
#: ../../../CHANGES.rst:363
#: ../../../CHANGES.rst:414
msgid ""
"add aliases for edit/delete reply markup to Message `#662 "
"<https://github.com/aiogram/aiogram/issues/662>`_"
msgstr ""
#: ../../../CHANGES.rst:365
#: ../../../CHANGES.rst:416
msgid ""
"Reworked outer middleware chain. Prevent to call many times the outer "
"middleware for each nested router `#664 "
"<https://github.com/aiogram/aiogram/issues/664>`_"
msgstr ""
#: ../../../CHANGES.rst:372
#: ../../../CHANGES.rst:423
msgid ""
"Prepare parse mode for InputMessageContent in AnswerInlineQuery method "
"`#660 <https://github.com/aiogram/aiogram/issues/660>`_"
msgstr ""
#: ../../../CHANGES.rst:377
msgid "Improved Documentation"
msgstr ""
#: ../../../CHANGES.rst:379
#: ../../../CHANGES.rst:430
msgid ""
"Added integration with :code:`towncrier` `#602 "
"<https://github.com/aiogram/aiogram/issues/602>`_"
msgstr ""
#: ../../../CHANGES.rst:386
#: ../../../CHANGES.rst:437
msgid ""
"Added `.editorconfig` `#650 "
"<https://github.com/aiogram/aiogram/issues/650>`_"
msgstr ""
#: ../../../CHANGES.rst:388
#: ../../../CHANGES.rst:439
msgid ""
"Redis storage speedup globals `#651 "
"<https://github.com/aiogram/aiogram/issues/651>`_"
msgstr ""
#: ../../../CHANGES.rst:390
#: ../../../CHANGES.rst:441
msgid ""
"add allow_sending_without_reply param to Message reply aliases `#663 "
"<https://github.com/aiogram/aiogram/issues/663>`_"

44
docs/locale/en/LC_MESSAGES/dispatcher/filters/index.po
View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: aiogram \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-10-01 22:51+0300\n"
"POT-Creation-Date: 2022-10-03 01:03+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@ -126,3 +126,45 @@ msgstr ""
#: ../../dispatcher/filters/index.rst:53
msgid "For example if you need to make simple text filter:"
msgstr ""
#: ../../dispatcher/filters/index.rst:58
msgid "Combining Filters"
msgstr ""
#: ../../dispatcher/filters/index.rst:60
msgid "In general, all filters can be combined in two ways"
msgstr ""
#: ../../dispatcher/filters/index.rst:64
msgid "Recommended way"
msgstr ""
#: ../../dispatcher/filters/index.rst:66
msgid ""
"If you specify multiple filters in a row, it will be checked with an "
"\"and\" condition:"
msgstr ""
#: ../../dispatcher/filters/index.rst:73
msgid ""
"Also, if you want to use two alternative ways to run the sage handler "
"(\"or\" condition) you can register the handler twice or more times as "
"you like"
msgstr ""
#: ../../dispatcher/filters/index.rst:82
msgid ""
"Also sometimes you will need to invert the filter result, for example you"
" have an *IsAdmin* filter and you want to check if the user is not an "
"admin"
msgstr ""
#: ../../dispatcher/filters/index.rst:91
msgid "Another possible way"
msgstr ""
#: ../../dispatcher/filters/index.rst:93
msgid ""
"An alternative way is to combine using special functions (:func:`and_f`, "
":func:`or_f`, :func:`invert_f` from :code:`aiogram.filters` module):"
msgstr ""

6
docs/locale/en/LC_MESSAGES/dispatcher/filters/magic_data.po
View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: aiogram \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-10-01 22:51+0300\n"
"POT-Creation-Date: 2022-10-03 01:03+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@ -21,6 +21,10 @@ msgstr ""
msgid "MagicData"
msgstr ""
#: aiogram.filters.magic_data.MagicData:1 of
msgid "This filter helps to filter event with contextual data"
msgstr ""
#: ../../dispatcher/filters/magic_data.rst:10
msgid "Can be imported:"
msgstr ""

10
docs/locale/en/LC_MESSAGES/index.po
View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: aiogram \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-10-02 00:46+0300\n"
"POT-Creation-Date: 2022-10-03 01:03+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@ -143,7 +143,10 @@ msgid "Has Finite State Machine"
msgstr ""
#: ../../../README.rst:74
msgid "Uses powerful :ref:`magic filters <magic-filters>`"
msgid ""
"Uses powerful `magic filters "
"<https://docs.aiogram.dev/en/dev-3.x/dispatcher/filters/magic_filters.html"
"#magic-filters>`"
msgstr ""
#: ../../../README.rst:75
@ -210,3 +213,6 @@ msgstr ""
#: ../../index.rst:9
msgid "Contents"
msgstr ""
#~ msgid "Uses powerful :ref:`magic filters <magic-filters>`"
#~ msgstr ""

66
docs/locale/uk_UA/LC_MESSAGES/api/upload_file.po
View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: aiogram \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-10-01 22:51+0300\n"
"POT-Creation-Date: 2022-10-03 01:03+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@ -86,6 +86,31 @@ msgstr ""
msgid "Then you can use it:"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.__init__:1
#: aiogram.types.input_file.FSInputFile.__init__:1 of
msgid "Represents object for uploading files from filesystem"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.__init__
#: aiogram.types.input_file.FSInputFile.__init__ of
msgid "Parameters"
msgstr ""
#: aiogram.types.input_file.FSInputFile.__init__:3 of
msgid "Path to file"
msgstr ""
#: aiogram.types.input_file.FSInputFile.__init__:4 of
msgid ""
"Filename to be propagated to telegram. By default, will be parsed from "
"path"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.__init__:5
#: aiogram.types.input_file.FSInputFile.__init__:6 of
msgid "Uploading chunk size"
msgstr ""
#: ../../api/upload_file.rst:52
msgid "Upload from buffer"
msgstr ""
@ -105,34 +130,12 @@ msgstr ""
msgid "And then you can use it:"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.from_file:1 of
msgid "Create buffer from file"
#: aiogram.types.input_file.BufferedInputFile.__init__:3 of
msgid "Bytes"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.from_file of
msgid "Parameters"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.from_file:3 of
msgid "Path to file"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.from_file:4 of
msgid ""
"Filename to be propagated to telegram. By default, will be parsed from "
"path"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.from_file:6 of
msgid "Uploading chunk size"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.from_file of
msgid "Returns"
msgstr ""
#: aiogram.types.input_file.BufferedInputFile.from_file:7 of
msgid "instance of :obj:`BufferedInputFile`"
#: aiogram.types.input_file.BufferedInputFile.__init__:4 of
msgid "Filename to be propagated to telegram."
msgstr ""
#: ../../api/upload_file.rst:74
@ -146,3 +149,12 @@ msgid ""
"<https://core.telegram.org/bots/api#sending-files>`_ by URL, you can use "
":obj:`aiogram.types.input_file.URLInputFile`."
msgstr ""
#~ msgid "Create buffer from file"
#~ msgstr ""
#~ msgid "Returns"
#~ msgstr ""
#~ msgid "instance of :obj:`BufferedInputFile`"
#~ msgstr ""

333
docs/locale/uk_UA/LC_MESSAGES/changelog.po
View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: aiogram \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-10-01 22:51+0300\n"
"POT-Creation-Date: 2022-10-03 01:03+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@ -22,227 +22,310 @@ msgid "Changelog"
msgstr ""
#: ../../../CHANGES.rst:18
msgid "3.0.0b4 (2022-08-14)"
msgid "3.0.0b5 (2022-10-02)"
msgstr ""
#: ../../../CHANGES.rst:21 ../../../CHANGES.rst:94 ../../../CHANGES.rst:135
#: ../../../CHANGES.rst:173 ../../../CHANGES.rst:221 ../../../CHANGES.rst:297
#: ../../../CHANGES.rst:330 ../../../CHANGES.rst:361
#: ../../../CHANGES.rst:21 ../../../CHANGES.rst:72 ../../../CHANGES.rst:145
#: ../../../CHANGES.rst:186 ../../../CHANGES.rst:224 ../../../CHANGES.rst:272
#: ../../../CHANGES.rst:348 ../../../CHANGES.rst:381 ../../../CHANGES.rst:412
msgid "Features"
msgstr ""
#: ../../../CHANGES.rst:23
msgid ""
"Add PyPy support and run tests under PyPy `#985 "
"<https://github.com/aiogram/aiogram/issues/985>`_"
msgstr ""
#: ../../../CHANGES.rst:25
msgid ""
"Added message text to aiogram exceptions representation `#988 "
"<https://github.com/aiogram/aiogram/issues/988>`_"
msgstr ""
#: ../../../CHANGES.rst:27
msgid ""
"Added warning about using magic filter from `magic_filter` instead of "
"`aiogram`'s ones. Is recommended to use `from aiogram import F` instead "
"of `from magic_filter import F` `#990 "
"<https://github.com/aiogram/aiogram/issues/990>`_"
msgstr ""
#: ../../../CHANGES.rst:30
msgid ""
"Added more detailed error when server response can't be deserialized. "
"This feature will help to debug unexpected responses from the Server "
"`#1014 <https://github.com/aiogram/aiogram/issues/1014>`_"
msgstr ""
#: ../../../CHANGES.rst:35 ../../../CHANGES.rst:96 ../../../CHANGES.rst:154
#: ../../../CHANGES.rst:200 ../../../CHANGES.rst:248 ../../../CHANGES.rst:304
#: ../../../CHANGES.rst:389 ../../../CHANGES.rst:421
msgid "Bugfixes"
msgstr ""
#: ../../../CHANGES.rst:37
msgid ""
"Reworked error event, introduced "
":class:`aiogram.types.error_event.ErrorEvent` object. `#898 "
"<https://github.com/aiogram/aiogram/issues/898>`_"
msgstr ""
#: ../../../CHANGES.rst:39
msgid ""
"Fixed escaping markdown in `aiogram.utils.markdown` module `#903 "
"<https://github.com/aiogram/aiogram/issues/903>`_"
msgstr ""
#: ../../../CHANGES.rst:41
msgid ""
"Fixed polling crash when Telegram Bot API raises HTTP 429 status-code. "
"`#995 <https://github.com/aiogram/aiogram/issues/995>`_"
msgstr ""
#: ../../../CHANGES.rst:43
msgid ""
"Fixed empty mention in command parsing, now it will be None instead of an"
" empty string `#1013 <https://github.com/aiogram/aiogram/issues/1013>`_"
msgstr ""
#: ../../../CHANGES.rst:48 ../../../CHANGES.rst:428
msgid "Improved Documentation"
msgstr ""
#: ../../../CHANGES.rst:50
msgid ""
"Initialized Docs translation (added Ukrainian language) `#925 "
"<https://github.com/aiogram/aiogram/issues/925>`_"
msgstr ""
#: ../../../CHANGES.rst:55
msgid "Deprecations and Removals"
msgstr ""
#: ../../../CHANGES.rst:57
msgid ""
"Removed filters factory as described in corresponding issue. `#942 "
"<https://github.com/aiogram/aiogram/issues/942>`_"
msgstr ""
#: ../../../CHANGES.rst:62 ../../../CHANGES.rst:113 ../../../CHANGES.rst:167
#: ../../../CHANGES.rst:209 ../../../CHANGES.rst:255 ../../../CHANGES.rst:315
#: ../../../CHANGES.rst:336 ../../../CHANGES.rst:359 ../../../CHANGES.rst:396
#: ../../../CHANGES.rst:435
msgid "Misc"
msgstr ""
#: ../../../CHANGES.rst:64
msgid ""
"Now Router/Dispatcher accepts only keyword arguments. `#982 "
"<https://github.com/aiogram/aiogram/issues/982>`_"
msgstr ""
#: ../../../CHANGES.rst:69
msgid "3.0.0b4 (2022-08-14)"
msgstr ""
#: ../../../CHANGES.rst:74
msgid ""
"Add class helper ChatAction for constants that Telegram BotAPI uses in "
"sendChatAction request. In my opinion, this will help users and will also"
" improve compatibility with 2.x version where similar class was called "
"\"ChatActions\". `#803 <https://github.com/aiogram/aiogram/issues/803>`_"
msgstr ""
#: ../../../CHANGES.rst:27
#: ../../../CHANGES.rst:78
msgid "Added possibility to combine filters or invert result"
msgstr ""
#: ../../../CHANGES.rst:29
#: ../../../CHANGES.rst:80
msgid "Example:"
msgstr ""
#: ../../../CHANGES.rst:37
#: ../../../CHANGES.rst:88
msgid "`#894 <https://github.com/aiogram/aiogram/issues/894>`_"
msgstr ""
#: ../../../CHANGES.rst:38
#: ../../../CHANGES.rst:89
msgid ""
"Fixed type hints for redis TTL params. `#922 "
"<https://github.com/aiogram/aiogram/issues/922>`_"
msgstr ""
#: ../../../CHANGES.rst:40
#: ../../../CHANGES.rst:91
msgid ""
"Added `full_name` shortcut for `Chat` object `#929 "
"<https://github.com/aiogram/aiogram/issues/929>`_"
msgstr ""
#: ../../../CHANGES.rst:45 ../../../CHANGES.rst:103 ../../../CHANGES.rst:149
#: ../../../CHANGES.rst:197 ../../../CHANGES.rst:253 ../../../CHANGES.rst:338
#: ../../../CHANGES.rst:370
msgid "Bugfixes"
msgstr ""
#: ../../../CHANGES.rst:47
#: ../../../CHANGES.rst:98
msgid ""
"Fixed false-positive coercing of Union types in API methods `#901 "
"<https://github.com/aiogram/aiogram/issues/901>`_"
msgstr ""
#: ../../../CHANGES.rst:49
#: ../../../CHANGES.rst:100
msgid "Added 3 missing content types:"
msgstr ""
#: ../../../CHANGES.rst:51
#: ../../../CHANGES.rst:102
msgid "proximity_alert_triggered"
msgstr ""
#: ../../../CHANGES.rst:52
#: ../../../CHANGES.rst:103
msgid "supergroup_chat_created"
msgstr ""
#: ../../../CHANGES.rst:53
#: ../../../CHANGES.rst:104
msgid "channel_chat_created"
msgstr ""
#: ../../../CHANGES.rst:54
#: ../../../CHANGES.rst:105
msgid "`#906 <https://github.com/aiogram/aiogram/issues/906>`_"
msgstr ""
#: ../../../CHANGES.rst:55
#: ../../../CHANGES.rst:106
msgid ""
"Fixed the ability to compare the state, now comparison to copy of the "
"state will return `True`. `#927 "
"<https://github.com/aiogram/aiogram/issues/927>`_"
msgstr ""
#: ../../../CHANGES.rst:57
#: ../../../CHANGES.rst:108
msgid ""
"Fixed default lock kwargs in RedisEventIsolation. `#972 "
"<https://github.com/aiogram/aiogram/issues/972>`_"
msgstr ""
#: ../../../CHANGES.rst:62 ../../../CHANGES.rst:116 ../../../CHANGES.rst:158
#: ../../../CHANGES.rst:204 ../../../CHANGES.rst:264 ../../../CHANGES.rst:285
#: ../../../CHANGES.rst:308 ../../../CHANGES.rst:345 ../../../CHANGES.rst:384
msgid "Misc"
msgstr ""
#: ../../../CHANGES.rst:64
#: ../../../CHANGES.rst:115
msgid ""
"Restrict including routers with strings `#896 "
"<https://github.com/aiogram/aiogram/issues/896>`_"
msgstr ""
#: ../../../CHANGES.rst:66
#: ../../../CHANGES.rst:117
msgid ""
"Changed CommandPatterType to CommandPatternType in "
"`aiogram/dispatcher/filters/command.py` `#907 "
"<https://github.com/aiogram/aiogram/issues/907>`_"
msgstr ""
#: ../../../CHANGES.rst:68
#: ../../../CHANGES.rst:119
msgid ""
"Added full support of `Bot API 6.1 <https://core.telegram.org/bots/api-"
"changelog#june-20-2022>`_ `#936 "
"<https://github.com/aiogram/aiogram/issues/936>`_"
msgstr ""
#: ../../../CHANGES.rst:70
#: ../../../CHANGES.rst:121
msgid "**Breaking!** More flat project structure"
msgstr ""
#: ../../../CHANGES.rst:72
#: ../../../CHANGES.rst:123
msgid "These packages was moved, imports in your code should be fixed:"
msgstr ""
#: ../../../CHANGES.rst:74
#: ../../../CHANGES.rst:125
msgid ":code:`aiogram.dispatcher.filters` -> :code:`aiogram.filters`"
msgstr ""
#: ../../../CHANGES.rst:75
#: ../../../CHANGES.rst:126
msgid ":code:`aiogram.dispatcher.fsm` -> :code:`aiogram.fsm`"
msgstr ""
#: ../../../CHANGES.rst:76
#: ../../../CHANGES.rst:127
msgid ":code:`aiogram.dispatcher.handler` -> :code:`aiogram.handler`"
msgstr ""
#: ../../../CHANGES.rst:77
#: ../../../CHANGES.rst:128
msgid ":code:`aiogram.dispatcher.webhook` -> :code:`aiogram.webhook`"
msgstr ""
#: ../../../CHANGES.rst:78
#: ../../../CHANGES.rst:129
msgid ""
":code:`aiogram.dispatcher.flags/*` -> :code:`aiogram.dispatcher.flags` "
"(single module instead of package)"
msgstr ""
#: ../../../CHANGES.rst:79
#: ../../../CHANGES.rst:130
msgid "`#938 <https://github.com/aiogram/aiogram/issues/938>`_"
msgstr ""
#: ../../../CHANGES.rst:80
#: ../../../CHANGES.rst:131
msgid ""
"Removed deprecated :code:`router.<event>_handler` and "
":code:`router.register_<event>_handler` methods. `#941 "
"<https://github.com/aiogram/aiogram/issues/941>`_"
msgstr ""
#: ../../../CHANGES.rst:82
#: ../../../CHANGES.rst:133
msgid ""
"Deprecated filters factory. It will be removed in next Beta (3.0b5) `#942"
" <https://github.com/aiogram/aiogram/issues/942>`_"
msgstr ""
#: ../../../CHANGES.rst:84
#: ../../../CHANGES.rst:135
msgid ""
"`MessageEntity` method `get_text` was removed and `extract` was renamed "
"to `extract_from` `#944 <https://github.com/aiogram/aiogram/issues/944>`_"
msgstr ""
#: ../../../CHANGES.rst:86
#: ../../../CHANGES.rst:137
msgid ""
"Added full support of `Bot API 6.2 <https://core.telegram.org/bots/api-"
"changelog#august-12-2022>`_ `#975 "
"<https://github.com/aiogram/aiogram/issues/975>`_"
msgstr ""
#: ../../../CHANGES.rst:91
#: ../../../CHANGES.rst:142
msgid "3.0.0b3 (2022-04-19)"
msgstr ""
#: ../../../CHANGES.rst:96
#: ../../../CHANGES.rst:147
msgid ""
"Added possibility to get command magic result as handler argument `#889 "
"<https://github.com/aiogram/aiogram/issues/889>`_"
msgstr ""
#: ../../../CHANGES.rst:98
#: ../../../CHANGES.rst:149
msgid ""
"Added full support of `Telegram Bot API 6.0 "
"<https://core.telegram.org/bots/api-changelog#april-16-2022>`_ `#890 "
"<https://github.com/aiogram/aiogram/issues/890>`_"
msgstr ""
#: ../../../CHANGES.rst:105
#: ../../../CHANGES.rst:156
msgid ""
"Fixed I18n lazy-proxy. Disabled caching. `#839 "
"<https://github.com/aiogram/aiogram/issues/839>`_"
msgstr ""
#: ../../../CHANGES.rst:107
#: ../../../CHANGES.rst:158
msgid ""
"Added parsing of spoiler message entity `#865 "
"<https://github.com/aiogram/aiogram/issues/865>`_"
msgstr ""
#: ../../../CHANGES.rst:109
#: ../../../CHANGES.rst:160
msgid ""
"Fixed default `parse_mode` for `Message.copy_to()` method. `#876 "
"<https://github.com/aiogram/aiogram/issues/876>`_"
msgstr ""
#: ../../../CHANGES.rst:111
#: ../../../CHANGES.rst:162
msgid ""
"Fixed CallbackData factory parsing IntEnum's `#885 "
"<https://github.com/aiogram/aiogram/issues/885>`_"
msgstr ""
#: ../../../CHANGES.rst:118
#: ../../../CHANGES.rst:169
msgid ""
"Added automated check that pull-request adds a changes description to "
"**CHANGES** directory `#873 "
"<https://github.com/aiogram/aiogram/issues/873>`_"
msgstr ""
#: ../../../CHANGES.rst:120
#: ../../../CHANGES.rst:171
msgid ""
"Changed :code:`Message.html_text` and :code:`Message.md_text` attributes "
"behaviour when message has no text. The empty string will be used instead"
@ -250,14 +333,14 @@ msgid ""
"<https://github.com/aiogram/aiogram/issues/874>`_"
msgstr ""
#: ../../../CHANGES.rst:123
#: ../../../CHANGES.rst:174
msgid ""
"Used `redis-py` instead of `aioredis` package in due to this packages was"
" merged into single one `#882 "
"<https://github.com/aiogram/aiogram/issues/882>`_"
msgstr ""
#: ../../../CHANGES.rst:125
#: ../../../CHANGES.rst:176
msgid ""
"Solved common naming problem with middlewares that confusing too much "
"developers - now you can't see the `middleware` and `middlewares` "
@ -266,113 +349,113 @@ msgid ""
"<https://github.com/aiogram/aiogram/issues/883>`_"
msgstr ""
#: ../../../CHANGES.rst:132
#: ../../../CHANGES.rst:183
msgid "3.0.0b2 (2022-02-19)"
msgstr ""
#: ../../../CHANGES.rst:137
#: ../../../CHANGES.rst:188
msgid ""
"Added possibility to pass additional arguments into the aiohttp webhook "
"handler to use this arguments inside handlers as the same as it possible "
"in polling mode. `#785 <https://github.com/aiogram/aiogram/issues/785>`_"
msgstr ""
#: ../../../CHANGES.rst:140
#: ../../../CHANGES.rst:191
msgid ""
"Added possibility to add handler flags via decorator (like `pytest.mark` "
"decorator but `aiogram.flags`) `#836 "
"<https://github.com/aiogram/aiogram/issues/836>`_"
msgstr ""
#: ../../../CHANGES.rst:142
#: ../../../CHANGES.rst:193
msgid ""
"Added :code:`ChatActionSender` utility to automatically sends chat action"
" while long process is running."
msgstr ""
#: ../../../CHANGES.rst:144
#: ../../../CHANGES.rst:195
msgid ""
"It also can be used as message middleware and can be customized via "
":code:`chat_action` flag. `#837 "
"<https://github.com/aiogram/aiogram/issues/837>`_"
msgstr ""
#: ../../../CHANGES.rst:151
#: ../../../CHANGES.rst:202
msgid ""
"Fixed unexpected behavior of sequences in the StateFilter. `#791 "
"<https://github.com/aiogram/aiogram/issues/791>`_"
msgstr ""
#: ../../../CHANGES.rst:153
#: ../../../CHANGES.rst:204
msgid ""
"Fixed exceptions filters `#827 "
"<https://github.com/aiogram/aiogram/issues/827>`_"
msgstr ""
#: ../../../CHANGES.rst:160
#: ../../../CHANGES.rst:211
msgid ""
"Logger name for processing events is changed to :code:`aiogram.events`. "
"`#830 <https://github.com/aiogram/aiogram/issues/830>`_"
msgstr ""
#: ../../../CHANGES.rst:162
#: ../../../CHANGES.rst:213
msgid ""
"Added full support of Telegram Bot API 5.6 and 5.7 `#835 "
"<https://github.com/aiogram/aiogram/issues/835>`_"
msgstr ""
#: ../../../CHANGES.rst:164
#: ../../../CHANGES.rst:215
msgid ""
"**BREAKING** Events isolation mechanism is moved from FSM storages to "
"standalone managers `#838 "
"<https://github.com/aiogram/aiogram/issues/838>`_"
msgstr ""
#: ../../../CHANGES.rst:170
#: ../../../CHANGES.rst:221
msgid "3.0.0b1 (2021-12-12)"
msgstr ""
#: ../../../CHANGES.rst:175
#: ../../../CHANGES.rst:226
msgid "Added new custom operation for MagicFilter named :code:`as_`"
msgstr ""
#: ../../../CHANGES.rst:177
#: ../../../CHANGES.rst:228
msgid "Now you can use it to get magic filter result as handler argument"
msgstr ""
#: ../../../CHANGES.rst:193
#: ../../../CHANGES.rst:244
msgid "`#759 <https://github.com/aiogram/aiogram/issues/759>`_"
msgstr ""
#: ../../../CHANGES.rst:199
#: ../../../CHANGES.rst:250
msgid ""
"Fixed: Missing :code:`ChatMemberHandler` import in "
":code:`aiogram/dispatcher/handler` `#751 "
"<https://github.com/aiogram/aiogram/issues/751>`_"
msgstr ""
#: ../../../CHANGES.rst:206
#: ../../../CHANGES.rst:257
msgid ""
"Check :code:`destiny` in case of no :code:`with_destiny` enabled in "
"RedisStorage key builder `#776 "
"<https://github.com/aiogram/aiogram/issues/776>`_"
msgstr ""
#: ../../../CHANGES.rst:208
#: ../../../CHANGES.rst:259
msgid ""
"Added full support of `Bot API 5.5 <https://core.telegram.org/bots/api-"
"changelog#december-7-2021>`_ `#777 "
"<https://github.com/aiogram/aiogram/issues/777>`_"
msgstr ""
#: ../../../CHANGES.rst:210
#: ../../../CHANGES.rst:261
msgid ""
"Stop using feature from #336. From now settings of client-session should "
"be placed as initializer arguments instead of changing instance "
"attributes. `#778 <https://github.com/aiogram/aiogram/issues/778>`_"
msgstr ""
#: ../../../CHANGES.rst:212
#: ../../../CHANGES.rst:263
msgid ""
"Make TelegramAPIServer files wrapper in local mode bi-directional "
"(server-client, client-server) Now you can convert local path to server "
@ -380,11 +463,11 @@ msgid ""
"<https://github.com/aiogram/aiogram/issues/779>`_"
msgstr ""
#: ../../../CHANGES.rst:218
#: ../../../CHANGES.rst:269
msgid "3.0.0a18 (2021-11-10)"
msgstr ""
#: ../../../CHANGES.rst:223
#: ../../../CHANGES.rst:274
msgid ""
"Breaking: Changed the signature of the session middlewares Breaking: "
"Renamed AiohttpSession.make_request method parameter from call to method "
@ -392,262 +475,258 @@ msgid ""
"outgoing requests `#716 <https://github.com/aiogram/aiogram/issues/716>`_"
msgstr ""
#: ../../../CHANGES.rst:227
#: ../../../CHANGES.rst:278
msgid ""
"Improved description of filters resolving error. For example when you try"
" to pass wrong type of argument to the filter but don't know why filter "
"is not resolved now you can get error like this:"
msgstr ""
#: ../../../CHANGES.rst:237
#: ../../../CHANGES.rst:288
msgid "`#717 <https://github.com/aiogram/aiogram/issues/717>`_"
msgstr ""
#: ../../../CHANGES.rst:238
#: ../../../CHANGES.rst:289
msgid ""
"**Breaking internal API change** Reworked FSM Storage record keys "
"propagation `#723 <https://github.com/aiogram/aiogram/issues/723>`_"
msgstr ""
#: ../../../CHANGES.rst:241
#: ../../../CHANGES.rst:292
msgid ""
"Implemented new filter named :code:`MagicData(magic_data)` that helps to "
"filter event by data from middlewares or other filters"
msgstr ""
#: ../../../CHANGES.rst:243
#: ../../../CHANGES.rst:294
msgid ""
"For example your bot is running with argument named :code:`config` that "
"contains the application config then you can filter event by value from "
"this config:"
msgstr ""
#: ../../../CHANGES.rst:249
#: ../../../CHANGES.rst:300
msgid "`#724 <https://github.com/aiogram/aiogram/issues/724>`_"
msgstr ""
#: ../../../CHANGES.rst:255
#: ../../../CHANGES.rst:306
msgid ""
"Fixed I18n context inside error handlers `#726 "
"<https://github.com/aiogram/aiogram/issues/726>`_"
msgstr ""
#: ../../../CHANGES.rst:257
#: ../../../CHANGES.rst:308
msgid ""
"Fixed bot session closing before emit shutdown `#734 "
"<https://github.com/aiogram/aiogram/issues/734>`_"
msgstr ""
#: ../../../CHANGES.rst:259
#: ../../../CHANGES.rst:310
msgid ""
"Fixed: bound filter resolving does not require children routers `#736 "
"<https://github.com/aiogram/aiogram/issues/736>`_"
msgstr ""
#: ../../../CHANGES.rst:266
#: ../../../CHANGES.rst:317
msgid ""
"Enabled testing on Python 3.10 Removed `async_lru` dependency (is "
"incompatible with Python 3.10) and replaced usage with protected property"
" `#719 <https://github.com/aiogram/aiogram/issues/719>`_"
msgstr ""
#: ../../../CHANGES.rst:269
#: ../../../CHANGES.rst:320
msgid ""
"Converted README.md to README.rst and use it as base file for docs `#725 "
"<https://github.com/aiogram/aiogram/issues/725>`_"
msgstr ""
#: ../../../CHANGES.rst:271
#: ../../../CHANGES.rst:322
msgid "Rework filters resolving:"
msgstr ""
#: ../../../CHANGES.rst:273
#: ../../../CHANGES.rst:324
msgid "Automatically apply Bound Filters with default values to handlers"
msgstr ""
#: ../../../CHANGES.rst:274
#: ../../../CHANGES.rst:325
msgid "Fix data transfer from parent to included routers filters"
msgstr ""
#: ../../../CHANGES.rst:275
#: ../../../CHANGES.rst:326
msgid "`#727 <https://github.com/aiogram/aiogram/issues/727>`_"
msgstr ""
#: ../../../CHANGES.rst:276
#: ../../../CHANGES.rst:327
msgid ""
"Added full support of Bot API 5.4 https://core.telegram.org/bots/api-"
"changelog#november-5-2021 `#744 "
"<https://github.com/aiogram/aiogram/issues/744>`_"
msgstr ""
#: ../../../CHANGES.rst:282
#: ../../../CHANGES.rst:333
msgid "3.0.0a17 (2021-09-24)"
msgstr ""
#: ../../../CHANGES.rst:287
#: ../../../CHANGES.rst:338
msgid ""
"Added :code:`html_text` and :code:`md_text` to Message object `#708 "
"<https://github.com/aiogram/aiogram/issues/708>`_"
msgstr ""
#: ../../../CHANGES.rst:289
#: ../../../CHANGES.rst:340
msgid ""
"Refactored I18n, added context managers for I18n engine and current "
"locale `#709 <https://github.com/aiogram/aiogram/issues/709>`_"
msgstr ""
#: ../../../CHANGES.rst:294
#: ../../../CHANGES.rst:345
msgid "3.0.0a16 (2021-09-22)"
msgstr ""
#: ../../../CHANGES.rst:299
#: ../../../CHANGES.rst:350
msgid "Added support of local Bot API server files downloading"
msgstr ""
#: ../../../CHANGES.rst:301
#: ../../../CHANGES.rst:352
msgid ""
"When Local API is enabled files can be downloaded via "
"`bot.download`/`bot.download_file` methods. `#698 "
"<https://github.com/aiogram/aiogram/issues/698>`_"
msgstr ""
#: ../../../CHANGES.rst:303
#: ../../../CHANGES.rst:354
msgid ""
"Implemented I18n & L10n support `#701 "
"<https://github.com/aiogram/aiogram/issues/701>`_"
msgstr ""
#: ../../../CHANGES.rst:310
#: ../../../CHANGES.rst:361
msgid ""
"Covered by tests and docs KeyboardBuilder util `#699 "
"<https://github.com/aiogram/aiogram/issues/699>`_"
msgstr ""
#: ../../../CHANGES.rst:312
#: ../../../CHANGES.rst:363
msgid "**Breaking!!!**. Refactored and renamed exceptions."
msgstr ""
#: ../../../CHANGES.rst:314
#: ../../../CHANGES.rst:365
msgid ""
"Exceptions module was moved from :code:`aiogram.utils.exceptions` to "
":code:`aiogram.exceptions`"
msgstr ""
#: ../../../CHANGES.rst:315
#: ../../../CHANGES.rst:366
msgid "Added prefix `Telegram` for all error classes"
msgstr ""
#: ../../../CHANGES.rst:316
#: ../../../CHANGES.rst:367
msgid "`#700 <https://github.com/aiogram/aiogram/issues/700>`_"
msgstr ""
#: ../../../CHANGES.rst:317
#: ../../../CHANGES.rst:368
msgid ""
"Replaced all :code:`pragma: no cover` marks via global "
":code:`.coveragerc` config `#702 "
"<https://github.com/aiogram/aiogram/issues/702>`_"
msgstr ""
#: ../../../CHANGES.rst:319
#: ../../../CHANGES.rst:370
msgid "Updated dependencies."
msgstr ""
#: ../../../CHANGES.rst:321
#: ../../../CHANGES.rst:372
msgid ""
"**Breaking for framework developers** Now all optional dependencies "
"should be installed as extra: `poetry install -E fast -E redis -E proxy "
"-E i18n -E docs` `#703 <https://github.com/aiogram/aiogram/issues/703>`_"
msgstr ""
#: ../../../CHANGES.rst:327
#: ../../../CHANGES.rst:378
msgid "3.0.0a15 (2021-09-10)"
msgstr ""
#: ../../../CHANGES.rst:332
#: ../../../CHANGES.rst:383
msgid ""
"Ability to iterate over all states in StatesGroup. Aiogram already had in"
" check for states group so this is relative feature. `#666 "
"<https://github.com/aiogram/aiogram/issues/666>`_"
msgstr ""
#: ../../../CHANGES.rst:340
#: ../../../CHANGES.rst:391
msgid ""
"Fixed incorrect type checking in the "
":class:`aiogram.utils.keyboard.KeyboardBuilder` `#674 "
"<https://github.com/aiogram/aiogram/issues/674>`_"
msgstr ""
#: ../../../CHANGES.rst:347
#: ../../../CHANGES.rst:398
msgid ""
"Disable ContentType filter by default `#668 "
"<https://github.com/aiogram/aiogram/issues/668>`_"
msgstr ""
#: ../../../CHANGES.rst:349
#: ../../../CHANGES.rst:400
msgid ""
"Moved update type detection from Dispatcher to Update object `#669 "
"<https://github.com/aiogram/aiogram/issues/669>`_"
msgstr ""
#: ../../../CHANGES.rst:351
#: ../../../CHANGES.rst:402
msgid ""
"Updated **pre-commit** config `#681 "
"<https://github.com/aiogram/aiogram/issues/681>`_"
msgstr ""
#: ../../../CHANGES.rst:353
#: ../../../CHANGES.rst:404
msgid ""
"Reworked **handlers_in_use** util. Function moved to Router as method "
"**.resolve_used_update_types()** `#682 "
"<https://github.com/aiogram/aiogram/issues/682>`_"
msgstr ""
#: ../../../CHANGES.rst:358
#: ../../../CHANGES.rst:409
msgid "3.0.0a14 (2021-08-17)"
msgstr ""
#: ../../../CHANGES.rst:363
#: ../../../CHANGES.rst:414
msgid ""
"add aliases for edit/delete reply markup to Message `#662 "
"<https://github.com/aiogram/aiogram/issues/662>`_"
msgstr ""
#: ../../../CHANGES.rst:365
#: ../../../CHANGES.rst:416
msgid ""
"Reworked outer middleware chain. Prevent to call many times the outer "
"middleware for each nested router `#664 "
"<https://github.com/aiogram/aiogram/issues/664>`_"
msgstr ""
#: ../../../CHANGES.rst:372
#: ../../../CHANGES.rst:423
msgid ""
"Prepare parse mode for InputMessageContent in AnswerInlineQuery method "
"`#660 <https://github.com/aiogram/aiogram/issues/660>`_"
msgstr ""
#: ../../../CHANGES.rst:377
msgid "Improved Documentation"
msgstr ""
#: ../../../CHANGES.rst:379
#: ../../../CHANGES.rst:430
msgid ""
"Added integration with :code:`towncrier` `#602 "
"<https://github.com/aiogram/aiogram/issues/602>`_"
msgstr ""
#: ../../../CHANGES.rst:386
#: ../../../CHANGES.rst:437
msgid ""
"Added `.editorconfig` `#650 "
"<https://github.com/aiogram/aiogram/issues/650>`_"
msgstr ""
#: ../../../CHANGES.rst:388
#: ../../../CHANGES.rst:439
msgid ""
"Redis storage speedup globals `#651 "
"<https://github.com/aiogram/aiogram/issues/651>`_"
msgstr ""
#: ../../../CHANGES.rst:390
#: ../../../CHANGES.rst:441
msgid ""
"add allow_sending_without_reply param to Message reply aliases `#663 "
"<https://github.com/aiogram/aiogram/issues/663>`_"

44
docs/locale/uk_UA/LC_MESSAGES/dispatcher/filters/index.po
View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: aiogram \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-10-01 22:51+0300\n"
"POT-Creation-Date: 2022-10-03 01:03+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@ -126,3 +126,45 @@ msgstr ""
#: ../../dispatcher/filters/index.rst:53
msgid "For example if you need to make simple text filter:"
msgstr ""
#: ../../dispatcher/filters/index.rst:58
msgid "Combining Filters"
msgstr ""
#: ../../dispatcher/filters/index.rst:60
msgid "In general, all filters can be combined in two ways"
msgstr ""
#: ../../dispatcher/filters/index.rst:64
msgid "Recommended way"
msgstr ""
#: ../../dispatcher/filters/index.rst:66
msgid ""
"If you specify multiple filters in a row, it will be checked with an "
"\"and\" condition:"
msgstr ""
#: ../../dispatcher/filters/index.rst:73
msgid ""
"Also, if you want to use two alternative ways to run the sage handler "
"(\"or\" condition) you can register the handler twice or more times as "
"you like"
msgstr ""
#: ../../dispatcher/filters/index.rst:82
msgid ""
"Also sometimes you will need to invert the filter result, for example you"
" have an *IsAdmin* filter and you want to check if the user is not an "
"admin"
msgstr ""
#: ../../dispatcher/filters/index.rst:91
msgid "Another possible way"
msgstr ""
#: ../../dispatcher/filters/index.rst:93
msgid ""
"An alternative way is to combine using special functions (:func:`and_f`, "
":func:`or_f`, :func:`invert_f` from :code:`aiogram.filters` module):"
msgstr ""

6
docs/locale/uk_UA/LC_MESSAGES/dispatcher/filters/magic_data.po
View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: aiogram \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-10-01 22:51+0300\n"
"POT-Creation-Date: 2022-10-03 01:03+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@ -21,6 +21,10 @@ msgstr ""
msgid "MagicData"
msgstr ""
#: aiogram.filters.magic_data.MagicData:1 of
msgid "This filter helps to filter event with contextual data"
msgstr ""
#: ../../dispatcher/filters/magic_data.rst:10
msgid "Can be imported:"
msgstr ""

12
docs/locale/uk_UA/LC_MESSAGES/index.po
View file

@ -8,7 +8,7 @@ msgid ""
msgstr ""
"Project-Id-Version: aiogram \n"
"Report-Msgid-Bugs-To: \n"
"POT-Creation-Date: 2022-10-02 00:46+0300\n"
"POT-Creation-Date: 2022-10-03 01:03+0300\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
@ -157,8 +157,11 @@ msgid "Has Finite State Machine"
msgstr "Має вбудований кінцевий автомат"
#: ../../../README.rst:74
msgid "Uses powerful :ref:`magic filters <magic-filters>`"
msgstr "Використовує потужні :ref:`магічні фільтри <magic-filters>`"
msgid ""
"Uses powerful `magic filters "
"<https://docs.aiogram.dev/en/dev-3.x/dispatcher/filters/magic_filters.html"
"#magic-filters>`"
msgstr ""
#: ../../../README.rst:75
msgid "Middlewares (incoming updates and API calls)"
@ -234,3 +237,6 @@ msgstr "Приклад використання"
#: ../../index.rst:9
msgid "Contents"
msgstr "Зміст"
#~ msgid "Uses powerful :ref:`magic filters <magic-filters>`"
#~ msgstr "Використовує потужні :ref:`магічні фільтри <magic-filters>`"

18
tests/test_filters/test_base.py
View file

@ -3,7 +3,6 @@ from typing import Awaitable
import pytest
from aiogram.filters import Filter
from aiogram.filters.base import _InvertFilter
try:
from asynctest import CoroutineMock, patch
@ -32,20 +31,3 @@ class TestBaseFilter:
call = my_filter(event="test")
await call
mocked_call.assert_awaited_with(event="test")
async def test_invert(self):
my_filter = MyFilter()
my_inverted_filter = ~my_filter
assert str(my_inverted_filter) == f"~{str(my_filter)}"
assert isinstance(my_inverted_filter, _InvertFilter)
with patch(
"tests.test_filters.test_base.MyFilter.__call__",
new_callable=CoroutineMock,
) as mocked_call:
call = my_inverted_filter(event="test")
result = await call
mocked_call.assert_awaited_with(event="test")
assert not result

38
tests/test_filters/test_logic.py Normal file
View file

@ -0,0 +1,38 @@
import pytest
from aiogram.filters import Text, and_f, invert_f, or_f
from aiogram.filters.logic import _AndFilter, _InvertFilter, _OrFilter
class TestLogic:
@pytest.mark.parametrize(
"obj,case,result",
[
[True, and_f(lambda t: t is True, lambda t: t is True), True],
[True, and_f(lambda t: t is True, lambda t: t is False), False],
[True, and_f(lambda t: t is False, lambda t: t is False), False],
[True, and_f(lambda t: {"t": t}, lambda t: t is False), False],
[True, and_f(lambda t: {"t": t}, lambda t: t is True), {"t": True}],
[True, or_f(lambda t: t is True, lambda t: t is True), True],
[True, or_f(lambda t: t is True, lambda t: t is False), True],
[True, or_f(lambda t: t is False, lambda t: t is False), False],
[True, or_f(lambda t: t is False, lambda t: t is True), True],
[True, or_f(lambda t: t is False, lambda t: {"t": t}), {"t": True}],
[True, or_f(lambda t: {"t": t}, lambda t: {"a": 42}), {"t": True}],
[True, invert_f(lambda t: t is False), True],
],
)
async def test_logic(self, obj, case, result):
assert await case(obj) == result
@pytest.mark.parametrize(
"case,type_",
[
[or_f(Text(text="test"), Text(text="test")), _OrFilter],
[and_f(Text(text="test"), Text(text="test")), _AndFilter],
[invert_f(Text(text="test")), _InvertFilter],
[~Text(text="test"), _InvertFilter],
],
)
def test_dunder_methods(self, case, type_):
assert isinstance(case, type_)