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