witten_borgmatic/tests/unit/hooks/test_dispatch.py

249 lines
11 KiB
Python

import sys
import pytest
from flexmock import flexmock
from borgmatic.hooks import dispatch as module
def hook_function(hook_config, config, log_prefix, thing, value):
'''
This test function gets mocked out below.
'''
pass
def test_call_hook_invokes_module_function_with_arguments_and_returns_value():
config = {'super_hook': flexmock(), 'other_hook': flexmock()}
expected_return_value = flexmock()
test_module = sys.modules[__name__]
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.data_source
).and_return(['other_hook'])
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.monitoring
).and_return(['super_hook', 'third_hook'])
flexmock(module.importlib).should_receive('import_module').with_args(
'borgmatic.hooks.monitoring.super_hook'
).and_return(test_module)
flexmock(test_module).should_receive('hook_function').with_args(
config['super_hook'], config, 'prefix', 55, value=66
).and_return(expected_return_value).once()
return_value = module.call_hook('hook_function', config, 'prefix', 'super_hook', 55, value=66)
assert return_value == expected_return_value
def test_call_hook_probes_config_with_databases_suffix():
config = {'super_hook_databases': flexmock(), 'other_hook': flexmock()}
expected_return_value = flexmock()
test_module = sys.modules[__name__]
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.data_source
).and_return(['other_hook'])
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.monitoring
).and_return(['super_hook', 'third_hook'])
flexmock(module.importlib).should_receive('import_module').with_args(
'borgmatic.hooks.monitoring.super_hook'
).and_return(test_module)
flexmock(test_module).should_receive('hook_function').with_args(
config['super_hook_databases'], config, 'prefix', 55, value=66
).and_return(expected_return_value).once()
return_value = module.call_hook('hook_function', config, 'prefix', 'super_hook', 55, value=66)
assert return_value == expected_return_value
def test_call_hook_strips_databases_suffix_from_hook_name():
config = {'super_hook_databases': flexmock(), 'other_hook_databases': flexmock()}
expected_return_value = flexmock()
test_module = sys.modules[__name__]
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.data_source
).and_return(['other_hook'])
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.monitoring
).and_return(['super_hook', 'third_hook'])
flexmock(module.importlib).should_receive('import_module').with_args(
'borgmatic.hooks.monitoring.super_hook'
).and_return(test_module)
flexmock(test_module).should_receive('hook_function').with_args(
config['super_hook_databases'], config, 'prefix', 55, value=66
).and_return(expected_return_value).once()
return_value = module.call_hook(
'hook_function', config, 'prefix', 'super_hook_databases', 55, value=66
)
assert return_value == expected_return_value
def test_call_hook_without_hook_config_invokes_module_function_with_arguments_and_returns_value():
config = {'other_hook': flexmock()}
expected_return_value = flexmock()
test_module = sys.modules[__name__]
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.data_source
).and_return(['other_hook'])
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.monitoring
).and_return(['super_hook', 'third_hook'])
flexmock(module.importlib).should_receive('import_module').with_args(
'borgmatic.hooks.monitoring.super_hook'
).and_return(test_module)
flexmock(test_module).should_receive('hook_function').with_args(
None, config, 'prefix', 55, value=66
).and_return(expected_return_value).once()
return_value = module.call_hook('hook_function', config, 'prefix', 'super_hook', 55, value=66)
assert return_value == expected_return_value
def test_call_hook_without_corresponding_module_raises():
config = {'super_hook': flexmock(), 'other_hook': flexmock()}
test_module = sys.modules[__name__]
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.data_source
).and_return(['other_hook'])
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.monitoring
).and_return(['some_hook'])
flexmock(module.importlib).should_receive('import_module').with_args(
'borgmatic.hooks.monitoring.super_hook'
).and_return(test_module)
flexmock(test_module).should_receive('hook_function').never()
with pytest.raises(ValueError):
module.call_hook('hook_function', config, 'prefix', 'super_hook', 55, value=66)
def test_call_hook_skips_non_hook_modules():
config = {'not_a_hook': flexmock(), 'other_hook': flexmock()}
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.data_source
).and_return(['other_hook'])
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.monitoring
).and_return(['not_a_hook', 'third_hook'])
not_a_hook_module = flexmock(IS_A_HOOK=False)
flexmock(module.importlib).should_receive('import_module').with_args(
'borgmatic.hooks.monitoring.not_a_hook'
).and_return(not_a_hook_module)
return_value = module.call_hook('hook_function', config, 'prefix', 'not_a_hook', 55, value=66)
assert return_value is None
def test_call_hooks_calls_each_hook_and_collects_return_values():
config = {'super_hook': flexmock(), 'other_hook': flexmock()}
expected_return_values = {'super_hook': flexmock(), 'other_hook': flexmock()}
flexmock(module.importlib).should_receive('import_module').with_args(
'borgmatic.hooks.monitoring'
).and_return(module.borgmatic.hooks.monitoring)
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.monitoring
).and_return(['super_hook', 'other_hook'])
flexmock(module).should_receive('call_hook').and_return(
expected_return_values['super_hook']
).and_return(expected_return_values['other_hook'])
return_values = module.call_hooks('do_stuff', config, 'prefix', module.Hook_type.MONITORING, 55)
assert return_values == expected_return_values
def test_call_hooks_calls_skips_return_values_for_unconfigured_hooks():
config = {'super_hook': flexmock()}
expected_return_values = {'super_hook': flexmock()}
flexmock(module.importlib).should_receive('import_module').with_args(
'borgmatic.hooks.monitoring'
).and_return(module.borgmatic.hooks.monitoring)
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.monitoring
).and_return(['super_hook', 'other_hook'])
flexmock(module).should_receive('call_hook').and_return(expected_return_values['super_hook'])
return_values = module.call_hooks('do_stuff', config, 'prefix', module.Hook_type.MONITORING, 55)
assert return_values == expected_return_values
def test_call_hooks_calls_treats_null_hook_as_optionless():
config = {'super_hook': flexmock(), 'other_hook': None}
expected_return_values = {'super_hook': flexmock(), 'other_hook': flexmock()}
flexmock(module.importlib).should_receive('import_module').with_args(
'borgmatic.hooks.monitoring'
).and_return(module.borgmatic.hooks.monitoring)
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.monitoring
).and_return(['super_hook', 'other_hook'])
flexmock(module).should_receive('call_hook').and_return(
expected_return_values['super_hook']
).and_return(expected_return_values['other_hook'])
return_values = module.call_hooks('do_stuff', config, 'prefix', module.Hook_type.MONITORING, 55)
assert return_values == expected_return_values
def test_call_hooks_calls_looks_up_databases_suffix_in_config():
config = {'super_hook_databases': flexmock(), 'other_hook': flexmock()}
expected_return_values = {'super_hook': flexmock(), 'other_hook': flexmock()}
flexmock(module.importlib).should_receive('import_module').with_args(
'borgmatic.hooks.monitoring'
).and_return(module.borgmatic.hooks.monitoring)
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.monitoring
).and_return(['super_hook', 'other_hook'])
flexmock(module).should_receive('call_hook').and_return(
expected_return_values['super_hook']
).and_return(expected_return_values['other_hook'])
return_values = module.call_hooks('do_stuff', config, 'prefix', module.Hook_type.MONITORING, 55)
assert return_values == expected_return_values
def test_call_hooks_even_if_unconfigured_calls_each_hook_and_collects_return_values():
config = {'super_hook': flexmock(), 'other_hook': flexmock()}
expected_return_values = {'super_hook': flexmock(), 'other_hook': flexmock()}
flexmock(module.importlib).should_receive('import_module').with_args(
'borgmatic.hooks.monitoring'
).and_return(module.borgmatic.hooks.monitoring)
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.monitoring
).and_return(['super_hook', 'other_hook'])
flexmock(module).should_receive('call_hook').and_return(
expected_return_values['super_hook']
).and_return(expected_return_values['other_hook'])
return_values = module.call_hooks_even_if_unconfigured(
'do_stuff', config, 'prefix', module.Hook_type.MONITORING, 55
)
assert return_values == expected_return_values
def test_call_hooks_even_if_unconfigured_calls_each_hook_configured_or_not_and_collects_return_values():
config = {'other_hook': flexmock()}
expected_return_values = {'super_hook': flexmock(), 'other_hook': flexmock()}
flexmock(module.importlib).should_receive('import_module').with_args(
'borgmatic.hooks.monitoring'
).and_return(module.borgmatic.hooks.monitoring)
flexmock(module).should_receive('get_submodule_names').with_args(
module.borgmatic.hooks.monitoring
).and_return(['super_hook', 'other_hook'])
flexmock(module).should_receive('call_hook').and_return(
expected_return_values['super_hook']
).and_return(expected_return_values['other_hook'])
return_values = module.call_hooks_even_if_unconfigured(
'do_stuff', config, 'prefix', module.Hook_type.MONITORING, 55
)
assert return_values == expected_return_values