1"""
2    test_events
3    ~~~~~~~~~~~
4
5    Test the EventManager class.
6
7    :copyright: Copyright 2007-2021 by the Sphinx team, see AUTHORS.
8    :license: BSD, see LICENSE for details.
9"""
10
11import pytest
12
13from sphinx.errors import ExtensionError
14from sphinx.events import EventManager
15
16
17def test_event_priority():
18    result = []
19    events = EventManager(object())  # pass an dummy object as an app
20    events.connect('builder-inited', lambda app: result.append(1), priority = 500)
21    events.connect('builder-inited', lambda app: result.append(2), priority = 500)
22    events.connect('builder-inited', lambda app: result.append(3), priority = 200)  # eariler
23    events.connect('builder-inited', lambda app: result.append(4), priority = 700)  # later
24    events.connect('builder-inited', lambda app: result.append(5), priority = 500)
25
26    events.emit('builder-inited')
27    assert result == [3, 1, 2, 5, 4]
28
29
30def test_event_allowed_exceptions():
31    def raise_error(app):
32        raise RuntimeError
33
34    events = EventManager(object())  # pass an dummy object as an app
35    events.connect('builder-inited', raise_error, priority=500)
36
37    # all errors are conveted to ExtensionError
38    with pytest.raises(ExtensionError):
39        events.emit('builder-inited')
40
41    # Allow RuntimeError (pass-through)
42    with pytest.raises(RuntimeError):
43        events.emit('builder-inited', allowed_exceptions=(RuntimeError,))
44