aiogram/tests/test_fsm/test_scene.py

1548 lines
49 KiB
Python
Raw Normal View History

PoC Scenes (#1280) * Base implementation * Small refactoring + added possibility to specify post-action on handlers * Move scene properties to config object * Revise aiogram/scenes with wizard-based design pattern Modified files in aiogram/scenes to incorporate the Wizard design pattern. Files affected are _marker.py, _registry.py, _wizard.py and __init__.py. The changes introduced a SceneWizard Class and ScenesManager, both of which aid in controlling navigation between different scenes or states. This helps clarifying the codebase, streamline scene transitions and offer more control over the app flow. * Added example * Small optimizations * Replace ValueError with SceneException in scenes. Added error safety in scene resolver. * str * Added possibility to reset context on scene entered and to handle callback query in any state * Remove inline markup in example * Small changes * Docs + example * Small refactoring * Remove scene inclusion methods from router The methods for including scenes as sub-routers have been removed from the router.py file. Instead, the SceneRegistry class is now set to register scenes by default upon initializing. This streamlines the scene management process by removing redundant routers and making registration automatic. * Init tests * Small fix in tests * Add support for State instance in the scene The aiogram FSM scene now allows the use of State instance as an argument, enabling more customization. Modified the 'as_handler' method to receive **kwargs arguments, allowing passing of attributes to the handler. An additional type check has been also added to ensure the 'scene' is either a subclass of Scene or a string. * Fixed test * Expand test coverage for test_fsm module The commit enhances tests for the test_fsm module to improve code reliability. It includes additional unit tests for the ObserverDecorator and ActionContainer classes and introduces new tests for the SceneHandlerWrapper class. This ensures the correct functionality of the decorator methods, the action container execution, and the handler wrapper. * Reformat code * Fixed long line in the example * Skip some tests on PyPy * Change mock return_value * Compatibility... * Compatibility... * Compatibility... * Added base changes description * Scenes Tests (#1369) * ADD tests for `SceneRegistry` * ADD tests for `ScenesManager` * ADD Changelog * Revert "ADD Changelog" This reverts commit 6dd93012524f92d187443e3af8e90264a4499b5b. * Remove `@pytest.mark.asyncio`, Reformat code * Scenes Tests. Part 2 (#1371) * ADD tests for `SceneWizard` * ADD tests for `Scene` * Refactor ObserverDecorator to use on.message syntax in test_scene.py Cover `Scene::__init_subclass__::if isinstance(value, ObserverDecorator):` * Refactor `HistoryManager` in `aiogram/fsm/scene.py` Removed condition that checked if 'history' is empty before calling 'update_data' in 'Scene'. * ADD tests for `HistoryManager` * Small changes in the documentation * Small changes in the documentation * Small changes in the documentation --------- Co-authored-by: Andrew <11490628+andrew000@users.noreply.github.com>
2023-11-23 00:41:21 +02:00
import inspect
import platform
from datetime import datetime
from unittest.mock import ANY, AsyncMock, patch
import pytest
from aiogram import Dispatcher, F, Router
from aiogram.dispatcher.event.bases import NextMiddlewareType
from aiogram.exceptions import SceneException
from aiogram.filters import StateFilter
from aiogram.fsm.context import FSMContext
from aiogram.fsm.scene import (
ActionContainer,
After,
HandlerContainer,
HistoryManager,
ObserverDecorator,
ObserverMarker,
Scene,
SceneAction,
SceneConfig,
SceneHandlerWrapper,
SceneRegistry,
ScenesManager,
SceneWizard,
_empty_handler,
on,
)
from aiogram.fsm.state import State, StatesGroup
from aiogram.fsm.storage.base import StorageKey
from aiogram.fsm.storage.memory import MemoryStorage, MemoryStorageRecord
from aiogram.types import Chat, Message, Update
from tests.mocked_bot import MockedBot
class TestOnMarker:
@pytest.mark.parametrize(
"marker_name",
[
"message",
"edited_message",
"channel_post",
"edited_channel_post",
"inline_query",
"chosen_inline_result",
"callback_query",
"shipping_query",
"pre_checkout_query",
"poll",
"poll_answer",
"my_chat_member",
"chat_member",
"chat_join_request",
],
)
def test_marker_name(self, marker_name: str):
attr = getattr(on, marker_name)
assert isinstance(attr, ObserverMarker)
assert attr.name == marker_name
async def test_empty_handler():
result = await _empty_handler()
assert result is None
class TestAfter:
def test_exit(self):
after = After.exit()
assert after is not None
assert after.action == SceneAction.exit
assert after.scene is None
def test_back(self):
after = After.back()
assert after is not None
assert after.action == SceneAction.back
assert after.scene is None
def test_goto(self):
after = After.goto("test")
assert after is not None
assert after.action == SceneAction.enter
assert after.scene == "test"
class TestObserverMarker:
def test_decorator(self):
marker = ObserverMarker("test")
decorator = marker(F.test, after=After.back())
assert isinstance(decorator, ObserverDecorator)
assert decorator.name == "test"
assert len(decorator.filters) == 1
assert decorator.action is None
assert decorator.after is not None
def test_enter(self):
marker = ObserverMarker("test")
decorator = marker.enter(F.test)
assert isinstance(decorator, ObserverDecorator)
assert decorator.name == "test"
assert len(decorator.filters) == 1
assert decorator.action == SceneAction.enter
assert decorator.after is None
def test_leave(self):
marker = ObserverMarker("test")
decorator = marker.leave()
assert isinstance(decorator, ObserverDecorator)
assert decorator.name == "test"
assert len(decorator.filters) == 0
assert decorator.action == SceneAction.leave
assert decorator.after is None
def test_exit(self):
marker = ObserverMarker("test")
decorator = marker.exit()
assert isinstance(decorator, ObserverDecorator)
assert decorator.name == "test"
assert len(decorator.filters) == 0
assert decorator.action == SceneAction.exit
assert decorator.after is None
def test_back(self):
marker = ObserverMarker("test")
decorator = marker.back()
assert isinstance(decorator, ObserverDecorator)
assert decorator.name == "test"
assert len(decorator.filters) == 0
assert decorator.action == SceneAction.back
assert decorator.after is None
class TestObserverDecorator:
def test_wrap_something(self):
decorator = ObserverDecorator("test", F.test)
with pytest.raises(TypeError):
decorator("test")
def test_wrap_handler(self):
decorator = ObserverDecorator("test", F.test)
def handler():
pass
wrapped = decorator(handler)
assert wrapped is not None
assert hasattr(wrapped, "__aiogram_handler__")
assert isinstance(wrapped.__aiogram_handler__, list)
assert len(wrapped.__aiogram_handler__) == 1
wrapped2 = decorator(handler)
assert len(wrapped2.__aiogram_handler__) == 2
def test_wrap_action(self):
decorator = ObserverDecorator("test", F.test, action=SceneAction.enter)
def handler():
pass
wrapped = decorator(handler)
assert wrapped is not None
assert not hasattr(wrapped, "__aiogram_handler__")
assert hasattr(wrapped, "__aiogram_action__")
assert isinstance(wrapped.__aiogram_action__, dict)
assert len(wrapped.__aiogram_action__) == 1
assert SceneAction.enter in wrapped.__aiogram_action__
assert "test" in wrapped.__aiogram_action__[SceneAction.enter]
def test_observer_decorator_leave(self):
observer_decorator = ObserverDecorator("Test Name", (F.text,))
action_container = observer_decorator.leave()
assert isinstance(action_container, ActionContainer)
assert action_container.name == "Test Name"
assert action_container.filters == (F.text,)
assert action_container.action == SceneAction.leave
def test_observer_decorator_enter(self):
observer_decorator = ObserverDecorator("test", (F.text,))
target = "mock_target"
action_container = observer_decorator.enter(target)
assert isinstance(action_container, ActionContainer)
assert action_container.name == "test"
assert action_container.filters == (F.text,)
assert action_container.action == SceneAction.enter
assert action_container.target == target
def test_observer_decorator_exit(self):
observer_decorator = ObserverDecorator("test", (F.text,))
action_container = observer_decorator.exit()
assert isinstance(action_container, ActionContainer)
assert action_container.name == "test"
assert action_container.filters == (F.text,)
assert action_container.action == SceneAction.exit
def test_observer_decorator_back(self):
observer_decorator = ObserverDecorator("test", (F.text,))
action_container = observer_decorator.back()
assert isinstance(action_container, ActionContainer)
assert action_container.name == "test"
assert action_container.filters == (F.text,)
assert action_container.action == SceneAction.back
class TestActionContainer:
async def test_action_container_execute_enter(self):
wizard_mock = AsyncMock(spec=SceneWizard)
action_container = ActionContainer(
"Test Name", (F.text,), SceneAction.enter, "Test Target"
)
await action_container.execute(wizard_mock)
wizard_mock.goto.assert_called_once_with("Test Target")
async def test_action_container_execute_leave(self):
wizard_mock = AsyncMock(spec=SceneWizard)
action_container = ActionContainer("Test Name", (F.text,), SceneAction.leave)
await action_container.execute(wizard_mock)
wizard_mock.leave.assert_called_once()
async def test_action_container_execute_exit(self):
wizard_mock = AsyncMock(spec=SceneWizard)
action_container = ActionContainer("Test Name", (F.text,), SceneAction.exit)
await action_container.execute(wizard_mock)
wizard_mock.exit.assert_called_once()
async def test_action_container_execute_back(self):
wizard_mock = AsyncMock(spec=SceneWizard)
action_container = ActionContainer("Test Name", (F.text,), SceneAction.back)
await action_container.execute(wizard_mock)
wizard_mock.back.assert_called_once()
class TestSceneHandlerWrapper:
async def test_scene_handler_wrapper_call(self):
class MyScene(Scene):
pass
async def handler_mock(*args, **kwargs):
return 42
state_mock = AsyncMock(spec=FSMContext)
scenes_mock = AsyncMock(spec=ScenesManager)
event_update_mock = Update(
update_id=42,
message=Message(
message_id=42,
text="test",
date=datetime.now(),
chat=Chat(
type="private",
id=42,
),
),
)
kwargs = {"state": state_mock, "scenes": scenes_mock, "event_update": event_update_mock}
scene_handler_wrapper = SceneHandlerWrapper(MyScene, handler_mock)
result = await scene_handler_wrapper(event_update_mock, **kwargs)
# Check whether result is correct
assert result == 42
async def test_scene_handler_wrapper_call_with_after(self):
class MyScene(Scene):
pass
async def handler_mock(*args, **kwargs):
return 42
state_mock = AsyncMock(spec=FSMContext)
scenes_mock = AsyncMock(spec=ScenesManager)
event_update_mock = Update(
update_id=42,
message=Message(
message_id=42,
text="test",
date=datetime.now(),
chat=Chat(
type="private",
id=42,
),
),
)
kwargs = {"state": state_mock, "scenes": scenes_mock, "event_update": event_update_mock}
scene_handler_wrapper = SceneHandlerWrapper(MyScene, handler_mock, after=After.exit())
with patch(
"aiogram.fsm.scene.ActionContainer.execute", new_callable=AsyncMock
) as after_mock:
result = await scene_handler_wrapper(event_update_mock, **kwargs)
# Check whether after_mock is called
after_mock.assert_called_once_with(ANY)
# Check whether result is correct
assert result == 42
def test_scene_handler_wrapper_str(self):
class MyScene(Scene):
pass
async def handler_mock(*args, **kwargs):
pass
after = After.back()
scene_handler_wrapper = SceneHandlerWrapper(MyScene, handler_mock, after=after)
result = str(scene_handler_wrapper)
assert result == f"SceneHandlerWrapper({MyScene}, {handler_mock}, after={after})"
def test_await(self):
class MyScene(Scene):
pass
async def handler_mock(*args, **kwargs):
pass
scene_handler_wrapper = SceneHandlerWrapper(MyScene, handler_mock)
assert inspect.isawaitable(scene_handler_wrapper)
assert hasattr(scene_handler_wrapper, "__await__")
assert scene_handler_wrapper.__await__() is scene_handler_wrapper
class TestHistoryManager:
async def test_history_manager_push(self):
state = FSMContext(
storage=MemoryStorage(), key=StorageKey(bot_id=42, chat_id=-42, user_id=42)
)
history_manager = HistoryManager(state=state)
data = {"test_data": "test_data"}
await history_manager.push("test_state", data)
history_data = await history_manager._history_state.get_data()
assert history_data.get("history") == [{"state": "test_state", "data": data}]
async def test_history_manager_push_if_history_overflow(self):
state = FSMContext(
storage=MemoryStorage(), key=StorageKey(bot_id=42, chat_id=-42, user_id=42)
)
history_manager = HistoryManager(state=state, size=2)
states = ["test_state", "test_state2", "test_state3", "test_state4"]
data = {"test_data": "test_data"}
for state in states:
await history_manager.push(state, data)
history_data = await history_manager._history_state.get_data()
assert history_data.get("history") == [
{"state": "test_state3", "data": data},
{"state": "test_state4", "data": data},
]
async def test_history_manager_pop(self):
state = FSMContext(
storage=MemoryStorage(), key=StorageKey(bot_id=42, chat_id=-42, user_id=42)
)
history_manager = HistoryManager(state=state)
data = {"test_data": "test_data"}
await history_manager.push("test_state", data)
await history_manager.push("test_state2", data)
record = await history_manager.pop()
history_data = await history_manager._history_state.get_data()
assert isinstance(record, MemoryStorageRecord)
assert record == MemoryStorageRecord(state="test_state2", data=data)
assert history_data.get("history") == [{"state": "test_state", "data": data}]
async def test_history_manager_pop_if_history_empty(self):
state = FSMContext(
storage=MemoryStorage(), key=StorageKey(bot_id=42, chat_id=-42, user_id=42)
)
history_manager = HistoryManager(state=state)
record = await history_manager.pop()
assert record is None
async def test_history_manager_pop_if_history_become_empty_after_pop(self):
state = FSMContext(
storage=MemoryStorage(), key=StorageKey(bot_id=42, chat_id=-42, user_id=42)
)
history_manager = HistoryManager(state=state)
data = {"test_data": "test_data"}
await history_manager.push("test_state", data)
await history_manager.pop()
assert await history_manager._history_state.get_data() == {}
async def test_history_manager_get(self):
state = FSMContext(
storage=MemoryStorage(), key=StorageKey(bot_id=42, chat_id=-42, user_id=42)
)
history_manager = HistoryManager(state=state)
data = {"test_data": "test_data"}
await history_manager.push("test_state", data)
record = await history_manager.get()
assert isinstance(record, MemoryStorageRecord)
assert record == MemoryStorageRecord(state="test_state", data=data)
async def test_history_manager_get_if_history_empty(self):
state = FSMContext(
storage=MemoryStorage(), key=StorageKey(bot_id=42, chat_id=-42, user_id=42)
)
history_manager = HistoryManager(state=state)
record = await history_manager.get()
assert record is None
async def test_history_manager_all(self):
state = FSMContext(
storage=MemoryStorage(), key=StorageKey(bot_id=42, chat_id=-42, user_id=42)
)
history_manager_size = 10
history_manager = HistoryManager(state=state, size=history_manager_size)
data = {"test_data": "test_data"}
for i in range(history_manager_size):
await history_manager.push(f"test_state{i}", data)
records = await history_manager.all()
assert isinstance(records, list)
assert len(records) == history_manager_size
assert all(isinstance(record, MemoryStorageRecord) for record in records)
async def test_history_manager_all_if_history_empty(self):
state = FSMContext(
storage=MemoryStorage(), key=StorageKey(bot_id=42, chat_id=-42, user_id=42)
)
history_manager = HistoryManager(state=state)
records = await history_manager.all()
assert records == []
async def test_history_manager_clear(self):
state = FSMContext(
storage=MemoryStorage(), key=StorageKey(bot_id=42, chat_id=-42, user_id=42)
)
history_manager = HistoryManager(state=state)
data = {"test_data": "test_data"}
await history_manager.push("test_state", data)
await history_manager.clear()
assert await history_manager._history_state.get_data() == {}
async def test_history_manager_snapshot(self):
state = FSMContext(
storage=MemoryStorage(), key=StorageKey(bot_id=42, chat_id=-42, user_id=42)
)
history_manager = HistoryManager(state=state)
data = {"test_data": "test_data"}
await history_manager.push("test_state", data)
await history_manager.snapshot()
assert await history_manager._history_state.get_data() == {
"history": [
{"state": "test_state", "data": data},
{
"state": await history_manager._state.get_state(),
"data": await history_manager._state.get_data(),
},
]
}
async def test_history_manager_set_state(self):
state_mock = AsyncMock(spec=FSMContext)
state_mock.storage = MemoryStorage()
state_mock.key = StorageKey(bot_id=42, chat_id=-42, user_id=42)
state_mock.set_state = AsyncMock()
state_mock.set_data = AsyncMock()
history_manager = HistoryManager(state=state_mock)
history_manager._state = state_mock
state = "test_state"
data = {"test_data": "test_data"}
await history_manager._set_state(state, data)
state_mock.set_state.assert_called_once_with(state)
state_mock.set_data.assert_called_once_with(data)
async def test_history_manager_rollback(self):
history_manager = HistoryManager(
state=FSMContext(
storage=MemoryStorage(), key=StorageKey(bot_id=42, chat_id=-42, user_id=42)
)
)
data = {"test_data": "test_data"}
await history_manager.push("test_state", data)
await history_manager.push("test_state2", data)
record = await history_manager.get()
assert record == MemoryStorageRecord(state="test_state2", data=data)
await history_manager.rollback()
record = await history_manager.get()
assert record == MemoryStorageRecord(state="test_state", data=data)
async def test_history_manager_rollback_if_not_previous_state(self):
history_manager = HistoryManager(
state=FSMContext(
storage=MemoryStorage(), key=StorageKey(bot_id=42, chat_id=-42, user_id=42)
)
)
data = {"test_data": "test_data"}
await history_manager.push("test_state", data)
state = await history_manager.rollback()
assert state == "test_state"
state = await history_manager.rollback()
assert state is None
class TestScene:
def test_scene_subclass_initialisation(self):
class ParentScene(Scene):
@on.message(F.text)
def parent_handler(self, *args, **kwargs):
pass
@on.message.enter(F.text)
def parent_action(self, *args, **kwargs):
pass
class SubScene(
ParentScene,
state="sub_state",
reset_data_on_enter=True,
reset_history_on_enter=True,
callback_query_without_state=True,
):
general_handler = on.message(
F.text.casefold() == "test", after=After.goto("sub_state")
)
@on.message(F.text)
def sub_handler(self, *args, **kwargs):
pass
@on.message.exit()
def sub_action(self, *args, **kwargs):
pass
# Assert __scene_config__ attributes are correctly set for SubScene
assert isinstance(SubScene.__scene_config__, SceneConfig)
assert SubScene.__scene_config__.state == "sub_state"
assert SubScene.__scene_config__.reset_data_on_enter is True
assert SubScene.__scene_config__.reset_history_on_enter is True
assert SubScene.__scene_config__.callback_query_without_state is True
# Assert handlers are correctly set
assert len(SubScene.__scene_config__.handlers) == 3
for handler in SubScene.__scene_config__.handlers:
assert isinstance(handler, HandlerContainer)
assert handler.name == "message"
assert handler.handler in (
ParentScene.parent_handler,
SubScene.sub_handler,
_empty_handler,
)
assert handler.filters == (F.text,)
# Assert actions are correctly set
assert len(SubScene.__scene_config__.actions) == 2
enter_action = SubScene.__scene_config__.actions[SceneAction.enter]
assert isinstance(enter_action, dict)
assert "message" in enter_action
assert enter_action["message"].callback == ParentScene.parent_action
exit_action = SubScene.__scene_config__.actions[SceneAction.exit]
assert isinstance(exit_action, dict)
assert "message" in exit_action
assert exit_action["message"].callback == SubScene.sub_action
def test_scene_subclass_initialisation_bases_is_scene_subclass(self):
class NotAScene:
pass
class MyScene(Scene, NotAScene):
pass
class TestClass(MyScene, NotAScene):
pass
assert MyScene in TestClass.__bases__
assert NotAScene in TestClass.__bases__
bases = [base for base in TestClass.__bases__ if not issubclass(base, Scene)]
assert Scene not in bases
assert NotAScene in bases
def test_scene_add_to_router(self):
class MyScene(Scene):
@on.message(F.text)
def test_handler(self, *args, **kwargs):
pass
router = Router()
MyScene.add_to_router(router)
assert len(router.observers["message"].handlers) == 1
def test_scene_add_to_router_scene_with_callback_query_without_state(self):
class MyScene(Scene, callback_query_without_state=True):
@on.callback_query(F.data)
def test_handler(self, *args, **kwargs):
pass
router = Router()
MyScene.add_to_router(router)
assert len(router.observers["callback_query"].handlers) == 1
assert (
StateFilter(MyScene.__scene_config__.state)
not in router.observers["callback_query"].handlers[0].filters
)
def test_scene_as_handler(self):
class MyScene(Scene):
@on.message(F.text)
def test_handler(self, *args, **kwargs):
pass
handler = MyScene.as_handler()
router = Router()
router.message.register(handler)
assert router.observers["message"].handlers[0].callback == handler
async def test_scene_as_handler_enter(self):
class MyScene(Scene):
@on.message.enter(F.text)
def test_handler(self, *args, **kwargs):
pass
event = AsyncMock()
scenes = ScenesManager(
registry=SceneRegistry(Router()),
update_type="message",
event=event,
state=FSMContext(
storage=MemoryStorage(), key=StorageKey(bot_id=42, chat_id=-42, user_id=42)
),
data={},
)
scenes.enter = AsyncMock()
kwargs = {"test_kwargs": "test_kwargs"}
handler = MyScene.as_handler(**kwargs)
await handler(event, scenes)
scenes.enter.assert_called_once_with(MyScene, **kwargs)
class TestSceneWizard:
async def test_scene_wizard_enter_with_reset_data_on_enter(self):
class MyScene(Scene, reset_data_on_enter=True):
pass
scene_config_mock = AsyncMock()
scene_config_mock.state = "test_state"
state_mock = AsyncMock(spec=FSMContext)
state_mock.set_state = AsyncMock()
wizard = SceneWizard(
scene_config=MyScene.__scene_config__,
manager=AsyncMock(spec=ScenesManager),
state=state_mock,
update_type="message",
event=AsyncMock(),
data={},
)
kwargs = {"test_kwargs": "test_kwargs"}
wizard._on_action = AsyncMock()
await wizard.enter(**kwargs)
state_mock.set_data.assert_called_once_with({})
state_mock.set_state.assert_called_once_with(MyScene.__scene_config__.state)
wizard._on_action.assert_called_once_with(SceneAction.enter, **kwargs)
async def test_scene_wizard_enter_with_reset_history_on_enter(self):
class MyScene(Scene, reset_history_on_enter=True):
pass
state_mock = AsyncMock(spec=FSMContext)
state_mock.set_state = AsyncMock()
manager = AsyncMock(spec=ScenesManager)
manager.history = AsyncMock(spec=HistoryManager)
manager.history.clear = AsyncMock()
wizard = SceneWizard(
scene_config=MyScene.__scene_config__,
manager=manager,
state=state_mock,
update_type="message",
event=AsyncMock(),
data={},
)
kwargs = {"test_kwargs": "test_kwargs"}
wizard._on_action = AsyncMock()
await wizard.enter(**kwargs)
manager.history.clear.assert_called_once()
state_mock.set_state.assert_called_once_with(MyScene.__scene_config__.state)
wizard._on_action.assert_called_once_with(SceneAction.enter, **kwargs)
async def test_scene_wizard_leave_with_history(self):
scene_config_mock = AsyncMock()
scene_config_mock.state = "test_state"
manager = AsyncMock(spec=ScenesManager)
manager.history = AsyncMock(spec=HistoryManager)
manager.history.snapshot = AsyncMock()
wizard = SceneWizard(
scene_config=scene_config_mock,
manager=manager,
state=AsyncMock(spec=FSMContext),
update_type="message",
event=AsyncMock(),
data={},
)
wizard._on_action = AsyncMock()
kwargs = {"test_kwargs": "test_kwargs"}
await wizard.leave(_with_history=False, **kwargs)
manager.history.snapshot.assert_not_called()
wizard._on_action.assert_called_once_with(SceneAction.leave, **kwargs)
async def test_scene_wizard_leave_without_history(self):
scene_config_mock = AsyncMock()
scene_config_mock.state = "test_state"
manager = AsyncMock(spec=ScenesManager)
manager.history = AsyncMock(spec=HistoryManager)
manager.history.snapshot = AsyncMock()
wizard = SceneWizard(
scene_config=scene_config_mock,
manager=manager,
state=AsyncMock(spec=FSMContext),
update_type="message",
event=AsyncMock(),
data={},
)
wizard._on_action = AsyncMock()
kwargs = {"test_kwargs": "test_kwargs"}
await wizard.leave(**kwargs)
manager.history.snapshot.assert_called_once()
wizard._on_action.assert_called_once_with(SceneAction.leave, **kwargs)
async def test_scene_wizard_back(self):
current_scene_config_mock = AsyncMock()
current_scene_config_mock.state = "test_state"
previous_scene_config_mock = AsyncMock()
previous_scene_config_mock.state = "previous_test_state"
previous_scene_mock = AsyncMock()
previous_scene_mock.__scene_config__ = previous_scene_config_mock
manager = AsyncMock(spec=ScenesManager)
manager.history = AsyncMock(spec=HistoryManager)
manager.history.rollback = AsyncMock(return_value=previous_scene_mock)
manager.enter = AsyncMock()
wizard = SceneWizard(
scene_config=current_scene_config_mock,
manager=manager,
state=AsyncMock(spec=FSMContext),
update_type="message",
event=AsyncMock(),
data={},
)
wizard.leave = AsyncMock()
kwargs = {"test_kwargs": "test_kwargs"}
await wizard.back(**kwargs)
wizard.leave.assert_called_once_with(_with_history=False, **kwargs)
manager.history.rollback.assert_called_once()
manager.enter.assert_called_once_with(previous_scene_mock, _check_active=False, **kwargs)
async def test_scene_wizard_retake(self):
scene_config_mock = AsyncMock()
scene_config_mock.state = "test_state"
wizard = SceneWizard(
scene_config=scene_config_mock,
manager=AsyncMock(spec=ScenesManager),
state=AsyncMock(spec=FSMContext),
update_type="message",
event=AsyncMock(),
data={},
)
wizard.goto = AsyncMock()
kwargs = {"test_kwargs": "test_kwargs"}
await wizard.retake(**kwargs)
wizard.goto.assert_called_once_with(scene_config_mock.state, **kwargs)
async def test_scene_wizard_retake_exception(self):
scene_config_mock = AsyncMock()
scene_config_mock.state = None
wizard = SceneWizard(
scene_config=scene_config_mock,
manager=AsyncMock(spec=ScenesManager),
state=AsyncMock(spec=FSMContext),
update_type="message",
event=AsyncMock(),
data={},
)
kwargs = {"test_kwargs": "test_kwargs"}
with pytest.raises(AssertionError, match="Scene state is not specified"):
await wizard.retake(**kwargs)
async def test_scene_wizard_goto(self):
scene_config_mock = AsyncMock()
scene_config_mock.state = "test_state"
scene_mock = AsyncMock()
scene_mock.__scene_config__ = scene_config_mock
wizard = SceneWizard(
scene_config=scene_config_mock,
manager=AsyncMock(spec=ScenesManager),
state=AsyncMock(spec=FSMContext),
update_type="message",
event=AsyncMock(),
data={},
)
wizard.leave = AsyncMock()
wizard.manager.enter = AsyncMock()
kwargs = {"test_kwargs": "test_kwargs"}
await wizard.goto(scene_mock, **kwargs)
wizard.leave.assert_called_once_with(**kwargs)
wizard.manager.enter.assert_called_once_with(scene_mock, _check_active=False, **kwargs)
async def test_scene_wizard_on_action(self):
scene_config_mock = AsyncMock()
scene_config_mock.actions = {SceneAction.enter: {"message": AsyncMock()}}
scene_config_mock.state = "test_state"
scene_mock = AsyncMock()
event_mock = AsyncMock()
event_mock.type = "message"
data = {"test_data": "test_data"}
wizard = SceneWizard(
scene_config=scene_config_mock,
manager=AsyncMock(),
state=AsyncMock(),
update_type="message",
event=event_mock,
data=data,
)
wizard.scene = scene_mock
kwargs = {"test_kwargs": "test_kwargs"}
result = await wizard._on_action(SceneAction.enter, **kwargs)
scene_config_mock.actions[SceneAction.enter]["message"].call.assert_called_once_with(
scene_mock, event_mock, **{**data, **kwargs}
)
assert result is True
async def test_scene_wizard_on_action_no_scene(self):
wizard = SceneWizard(
scene_config=AsyncMock(),
manager=AsyncMock(),
state=AsyncMock(),
update_type="message",
event=AsyncMock(),
data={},
)
with pytest.raises(SceneException, match="Scene is not initialized"):
await wizard._on_action(SceneAction.enter)
async def test_scene_wizard_on_action_no_action_config(self):
scene_config_mock = AsyncMock()
scene_config_mock.actions = {}
scene_config_mock.state = "test_state"
scene_mock = AsyncMock()
event_mock = AsyncMock()
event_mock.type = "message"
wizard = SceneWizard(
scene_config=scene_config_mock,
manager=AsyncMock(),
state=AsyncMock(),
update_type="message",
event=event_mock,
data={},
)
wizard.scene = scene_mock
kwargs = {"test_kwargs": "test_kwargs"}
result = await wizard._on_action(SceneAction.enter, **kwargs)
assert result is False
async def test_scene_wizard_on_action_event_type_not_in_action_config(self):
scene_config_mock = AsyncMock()
scene_config_mock.actions = {SceneAction.enter: {"test_update_type": AsyncMock()}}
scene_config_mock.state = "test_state"
event_mock = AsyncMock()
event_mock.type = "message"
wizard = SceneWizard(
scene_config=scene_config_mock,
manager=AsyncMock(),
state=AsyncMock(),
update_type="message",
event=event_mock,
data={},
)
wizard.scene = AsyncMock()
kwargs = {"test_kwargs": "test_kwargs"}
result = await wizard._on_action(SceneAction.enter, **kwargs)
assert result is False
async def test_scene_wizard_set_data(self):
wizard = SceneWizard(
scene_config=AsyncMock(),
manager=AsyncMock(),
state=AsyncMock(),
update_type="message",
event=AsyncMock(),
data={},
)
wizard.state.set_data = AsyncMock()
data = {"test_key": "test_value"}
await wizard.set_data(data)
wizard.state.set_data.assert_called_once_with(data=data)
async def test_scene_wizard_get_data(self):
wizard = SceneWizard(
scene_config=AsyncMock(),
manager=AsyncMock(),
state=AsyncMock(),
update_type="message",
event=AsyncMock(),
data={},
)
wizard.state.get_data = AsyncMock()
await wizard.get_data()
wizard.state.get_data.assert_called_once_with()
async def test_scene_wizard_update_data_if_data(self):
wizard = SceneWizard(
scene_config=AsyncMock(),
manager=AsyncMock(),
state=AsyncMock(),
update_type="message",
event=AsyncMock(),
data={},
)
data = {"test_key": "test_value"}
kwargs = {"test_kwargs": "test_kwargs"}
wizard.state.update_data = AsyncMock(return_value={**data, **kwargs})
result = await wizard.update_data(data=data, **kwargs)
wizard.state.update_data.assert_called_once_with(data={**data, **kwargs})
assert result == {**data, **kwargs}
async def test_scene_wizard_update_data_if_no_data(self):
wizard = SceneWizard(
scene_config=AsyncMock(),
manager=AsyncMock(),
state=AsyncMock(),
update_type="message",
event=AsyncMock(),
data={},
)
data = None
kwargs = {"test_kwargs": "test_kwargs"}
wizard.state.update_data = AsyncMock(return_value={**kwargs})
result = await wizard.update_data(data=data, **kwargs)
wizard.state.update_data.assert_called_once_with(data=kwargs)
assert result == {**kwargs}
async def test_scene_wizard_clear_data(self):
wizard = SceneWizard(
scene_config=AsyncMock(),
manager=AsyncMock(),
state=AsyncMock(),
update_type="message",
event=AsyncMock(),
data={},
)
wizard.set_data = AsyncMock()
await wizard.clear_data()
wizard.set_data.assert_called_once_with({})
class TestScenesManager:
async def test_scenes_manager_get_scene(self, bot: MockedBot):
class MyScene(Scene):
pass
router = Router()
registry = SceneRegistry(router)
registry.add(MyScene)
scenes_manager = ScenesManager(
registry=registry,
update_type="message",
event=Update(
update_id=42,
message=Message(
message_id=42,
text="test",
date=datetime.now(),
chat=Chat(
type="private",
id=42,
),
),
),
state=FSMContext(
storage=MemoryStorage(), key=StorageKey(chat_id=-42, user_id=42, bot_id=bot.id)
),
data={},
)
scene = await scenes_manager._get_scene(MyScene)
assert isinstance(scene, MyScene)
assert isinstance(scene.wizard, SceneWizard)
assert scene.wizard.scene_config == MyScene.__scene_config__
assert scene.wizard.manager == scenes_manager
assert scene.wizard.update_type == "message"
assert scene.wizard.data == {}
async def test_scenes_manager_get_active_scene(self, bot: MockedBot):
class TestScene(Scene):
pass
class TestScene2(Scene, state="test_state2"):
pass
registry = SceneRegistry(Router())
registry.add(TestScene, TestScene2)
manager = ScenesManager(
registry,
update_type="message",
event=Update(
update_id=42,
message=Message(
message_id=42,
text="test",
date=datetime.now(),
chat=Chat(
type="private",
id=42,
),
),
),
state=FSMContext(
storage=MemoryStorage(), key=StorageKey(chat_id=-42, user_id=42, bot_id=bot.id)
),
data={},
)
scene = await manager._get_active_scene()
assert isinstance(scene, TestScene)
await manager.enter(TestScene2)
scene = await manager._get_active_scene()
assert isinstance(scene, TestScene2)
async def test_scenes_manager_get_active_scene_with_scene_exception(self, bot: MockedBot):
registry = SceneRegistry(Router())
manager = ScenesManager(
registry,
update_type="message",
event=Update(
update_id=42,
message=Message(
message_id=42,
text="test",
date=datetime.now(),
chat=Chat(
type="private",
id=42,
),
),
),
state=FSMContext(
storage=MemoryStorage(), key=StorageKey(chat_id=-42, user_id=42, bot_id=bot.id)
),
data={},
)
scene = await manager._get_active_scene()
assert scene is None
async def test_scenes_manager_enter_with_scene_type_none(self, bot: MockedBot):
registry = SceneRegistry(Router())
manager = ScenesManager(
registry,
update_type="message",
event=Update(
update_id=42,
message=Message(
message_id=42,
text="test",
date=datetime.now(),
chat=Chat(
type="private",
id=42,
),
),
),
state=FSMContext(
storage=MemoryStorage(), key=StorageKey(chat_id=-42, user_id=42, bot_id=bot.id)
),
data={},
)
assert await manager.enter(None) is None
async def test_scenes_manager_enter_with_scene_exception(self, bot: MockedBot):
registry = SceneRegistry(Router())
manager = ScenesManager(
registry,
update_type="message",
event=Update(
update_id=42,
message=Message(
message_id=42,
text="test",
date=datetime.now(),
chat=Chat(
type="private",
id=42,
),
),
),
state=FSMContext(
storage=MemoryStorage(), key=StorageKey(chat_id=-42, user_id=42, bot_id=bot.id)
),
data={},
)
scene = "invalid_scene"
with pytest.raises(SceneException, match=f"Scene {scene!r} is not registered"):
await manager.enter(scene)
async def test_scenes_manager_close_if_active_scene(self, bot: MockedBot):
class TestScene(Scene):
pass
registry = SceneRegistry(Router())
registry.add(TestScene)
manager = ScenesManager(
registry,
update_type="message",
event=Update(
update_id=42,
message=Message(
message_id=42,
text="test",
date=datetime.now(),
chat=Chat(
type="private",
id=42,
),
),
),
state=FSMContext(
storage=MemoryStorage(), key=StorageKey(chat_id=-42, user_id=42, bot_id=bot.id)
),
data={},
)
manager._get_active_scene = AsyncMock(
return_value=TestScene(
SceneWizard(
scene_config=TestScene.__scene_config__,
manager=manager,
state=manager.state,
update_type="message",
event=manager.event,
data={},
)
)
)
manager._get_active_scene.return_value.wizard.exit = AsyncMock()
await manager.close()
manager._get_active_scene.assert_called_once()
manager._get_active_scene.return_value.wizard.exit.assert_called_once()
async def test_scenes_manager_close_if_no_active_scene(self, bot: MockedBot):
registry = SceneRegistry(Router())
manager = ScenesManager(
registry,
update_type="message",
event=Update(
update_id=42,
message=Message(
message_id=42,
text="test",
date=datetime.now(),
chat=Chat(
type="private",
id=42,
),
),
),
state=FSMContext(
storage=MemoryStorage(), key=StorageKey(chat_id=-42, user_id=42, bot_id=bot.id)
),
data={},
)
manager._get_active_scene = AsyncMock(return_value=None)
result = await manager.close()
manager._get_active_scene.assert_called_once()
assert result is None
class TestSceneRegistry:
def test_scene_registry_initialization(self):
router = Router()
register_on_add = True
registry = SceneRegistry(router, register_on_add)
assert registry.router == router
assert registry.register_on_add == register_on_add
assert registry._scenes == {}
def test_scene_registry_add_scene(self):
class MyScene(Scene):
pass
router = Router()
register_on_add = True
MyScene.__scene_config__.state = "test_scene"
registry = SceneRegistry(router, register_on_add)
registry.add(MyScene)
assert len(registry._scenes) == 1
assert registry._scenes["test_scene"] == MyScene
def test_scene_registry_add_scene_pass_router(self):
class MyScene(Scene):
pass
router = Router()
MyScene.__scene_config__.state = "test_scene"
registry = SceneRegistry(router)
registry.add(MyScene, router=router)
assert len(registry._scenes) == 1
assert registry._scenes["test_scene"] == MyScene
def test_scene_registry_add_scene_already_exists(self):
class MyScene(Scene):
pass
router = Router()
register_on_add = True
MyScene.__scene_config__.state = "test_scene"
registry = SceneRegistry(router, register_on_add)
registry.add(MyScene)
with pytest.raises(SceneException):
registry.add(MyScene)
def test_scene_registry_add_scene_no_scenes(self):
class MyScene(Scene):
pass
router = Router()
register_on_add = True
MyScene.__scene_config__.state = "test_scene"
registry = SceneRegistry(router, register_on_add)
registry._scenes = {}
with pytest.raises(ValueError, match="At least one scene must be specified"):
registry.add()
def test_scene_registry_register(self):
class MyScene(Scene):
pass
router = Router()
register_on_add = True
MyScene.__scene_config__.state = "test_scene"
registry = SceneRegistry(router, register_on_add)
registry.register(MyScene)
assert len(registry._scenes) == 1
assert registry._scenes["test_scene"] == MyScene
def test_scene_registry_get_scene_if_scene_type_is_str(self):
class MyScene(Scene):
pass
router = Router()
register_on_add = True
MyScene.__scene_config__.state = "test_scene"
registry = SceneRegistry(router, register_on_add)
registry.add(MyScene)
retrieved_scene = registry.get("test_scene")
assert retrieved_scene == MyScene
def test_scene_registry_get_scene_if_scene_type_is_scene(self):
class MyScene(Scene):
pass
router = Router()
register_on_add = True
MyScene.__scene_config__.state = "test_scene"
registry = SceneRegistry(router, register_on_add)
registry.add(MyScene)
retrieved_scene = registry.get(MyScene)
assert retrieved_scene == MyScene
def test_scene_registry_get_scene_if_scene_state_is_state(self):
class MyStates(StatesGroup):
test_state = State()
class MyScene(Scene):
pass
router = Router()
register_on_add = True
MyScene.__scene_config__.state = MyStates.test_state
registry = SceneRegistry(router, register_on_add)
registry.add(MyScene)
retrieved_scene = registry.get(MyScene)
assert retrieved_scene == MyScene
def test_scene_registry_get_scene_if_scene_state_is_not_str(self):
class MyScene(Scene):
pass
router = Router()
register_on_add = True
MyScene.__scene_config__.state = 42
registry = SceneRegistry(router, register_on_add)
registry.add(MyScene)
with pytest.raises(SceneException, match="Scene must be a subclass of Scene or a string"):
registry.get(MyScene)
def test_scene_registry_get_scene_not_registered(self):
router = Router()
register_on_add = True
registry = SceneRegistry(router, register_on_add)
with pytest.raises(SceneException):
registry.get("test_scene")
def test_scene_registry_setup_middleware_with_dispatcher(self):
router = Router()
registry = SceneRegistry(router)
dispatcher = Dispatcher()
registry._setup_middleware(dispatcher)
assert registry._update_middleware in dispatcher.update.outer_middleware
for name, observer in dispatcher.observers.items():
if name == "update":
continue
assert registry._update_middleware not in observer.outer_middleware
def test_scene_registry_setup_middleware_with_router(self):
inner_router = Router()
registry = SceneRegistry(inner_router)
outer_router = Router()
registry._setup_middleware(outer_router)
for name, observer in outer_router.observers.items():
if name in ("update", "error"):
continue
assert registry._middleware in observer.outer_middleware
async def test_scene_registry_update_middleware(self, bot: MockedBot):
router = Router()
registry = SceneRegistry(router)
handler = AsyncMock(spec=NextMiddlewareType)
event = Update(
update_id=42,
message=Message(
message_id=42,
text="test",
date=datetime.now(),
chat=Chat(id=42, type="private"),
),
)
data = {
"state": FSMContext(
storage=MemoryStorage(), key=StorageKey(chat_id=-42, user_id=42, bot_id=bot.id)
)
}
result = await registry._update_middleware(handler, event, data)
assert "scenes" in data
assert isinstance(data["scenes"], ScenesManager)
handler.assert_called_once_with(event, data)
assert result == handler.return_value
async def test_scene_registry_update_middleware_not_update(self, bot: MockedBot):
router = Router()
registry = SceneRegistry(router)
handler = AsyncMock(spec=NextMiddlewareType)
event = Message(
message_id=42,
text="test",
date=datetime.now(),
chat=Chat(id=42, type="private"),
)
data = {
"state": FSMContext(
storage=MemoryStorage(), key=StorageKey(chat_id=-42, user_id=42, bot_id=bot.id)
)
}
with pytest.raises(AssertionError, match="Event must be an Update instance"):
await registry._update_middleware(handler, event, data)
async def test_scene_registry_middleware(self, bot: MockedBot):
router = Router()
registry = SceneRegistry(router)
handler = AsyncMock(spec=NextMiddlewareType)
event = Update(
update_id=42,
message=Message(
message_id=42,
text="test",
date=datetime.now(),
chat=Chat(id=42, type="private"),
),
)
data = {
"state": FSMContext(
storage=MemoryStorage(), key=StorageKey(chat_id=-42, user_id=42, bot_id=bot.id)
),
"event_update": event,
}
result = await registry._middleware(handler, event, data)
assert "scenes" in data
assert isinstance(data["scenes"], ScenesManager)
handler.assert_called_once_with(event, data)
assert result == handler.return_value