Dev 3.x i18n & improvements (#696)

* Added base code and make code improvements
* Auto-exclude coverage for `if TYPE_CHECKING:`
* Fixed current coverage
* Cover I18n module
* Update pipeline
* Fixed annotations
* Added docs
* Move exceptions
* Added tests for KeyboardBuilder and initial docs
* Remove help generator (removed from sources tree, requires rewrite)
* Added patch-notes #698, #699, #700, #701, #702, #703

tests/test_dispatcher/test_filters/test_state.py

@@ -0,0 +1,49 @@
+from inspect import isclass
+
+import pytest
+
+from aiogram.dispatcher.filters import StateFilter
+from aiogram.dispatcher.fsm.state import State, StatesGroup
+from aiogram.types import Update
+
+pytestmark = pytest.mark.asyncio
+
+
+class MyGroup(StatesGroup):
+    state = State()
+
+
+class TestStateFilter:
+    @pytest.mark.parametrize(
+        "state", [None, State("test"), MyGroup, MyGroup(), "state", ["state"]]
+    )
+    def test_validator(self, state):
+        f = StateFilter(state=state)
+        assert isinstance(f.state, list)
+        value = f.state[0]
+        assert (
+            isinstance(value, (State, str, MyGroup))
+            or (isclass(value) and issubclass(value, StatesGroup))
+            or value is None
+        )
+
+    @pytest.mark.parametrize(
+        "state,current_state,result",
+        [
+            [State("state"), "@:state", True],
+            [[State("state")], "@:state", True],
+            [MyGroup, "MyGroup:state", True],
+            [[MyGroup], "MyGroup:state", True],
+            [MyGroup(), "MyGroup:state", True],
+            [[MyGroup()], "MyGroup:state", True],
+            ["*", "state", True],
+            [None, None, True],
+            [[None], None, True],
+            [None, "state", False],
+            [[], "state", False],
+        ],
+    )
+    @pytestmark
+    async def test_filter(self, state, current_state, result):
+        f = StateFilter(state=state)
+        assert bool(await f(obj=Update(update_id=42), raw_state=current_state)) is result

tests/test_dispatcher/test_middlewares/test_user_context.py

@@ -0,0 +1,14 @@
+import pytest
+
+from aiogram.dispatcher.middlewares.user_context import UserContextMiddleware
+
+
+async def next_handler(*args, **kwargs):
+    pass
+
+
+class TestUserContextMiddleware:
+    @pytest.mark.asyncio
+    async def test_unexpected_event_type(self):
+        with pytest.raises(RuntimeError):
+            await UserContextMiddleware()(next_handler, object(), {})