def test_from_parameter_list_raises_error_when_parameter_list_is_empty():
# when:
try:
Parameter.from_parameter_list('', 'abc')
except MockGeneratorError:
return
assert False
def test_enrich_with_documentation_sets_is_null_terminated():
# given:
parameter = Parameter('abc', 'def', PointerType('int', False, 1, False))
documentation = create_parameter_documentation('abc', null_terminated=True)
# when:
parameter.enrich_with_documentation(documentation)
# then:
assert parameter.is_null_terminated
def test_enrich_with_documentation_sets_fixed_length():
# given:
parameter = Parameter('abc', 'def', PointerType('int', False, 1, False))
parameter_documentation = create_parameter_documentation('abc',
fixed_length=4)
# when:
parameter.enrich_with_documentation(parameter_documentation)
# then:
assert parameter.kind == ParameterKind.kind_in_out()
assert parameter.fixed_length == 4
def test_enrich_with_documentation_fails_on_impossible_combination():
# given:
parameter = Parameter('abc', 'def', SimpleType('int'))
parameter_documentation = create_parameter_documentation(
'abc', parameter_kind='out')
# when:
try:
parameter.enrich_with_documentation(parameter_documentation)
except MockGeneratorError:
return
assert False
def test_enrich_with_documentation_sets_length_descriptor():
# given:
parameter = Parameter('abc', 'def', PointerType('int', False, 1, False))
documentation = create_parameter_documentation('abc',
length_descriptor='size')
# when:
parameter.enrich_with_documentation(documentation)
# then:
assert parameter.has_length_descriptor
assert parameter.length_descriptor == 'size'
def test_enrich_with_documentation_sets_is_input():
# given:
parameter = Parameter('abc', 'def', PointerType('int', False, 1, False))
parameter_documentation = create_parameter_documentation(
'abc', parameter_kind='out')
# when:
parameter.enrich_with_documentation(parameter_documentation)
# then:
assert parameter.kind == ParameterKind.kind_out()
assert not parameter.is_input
assert parameter.is_not_input
def test_initial_kind_is_guessed():
# when:
parameter = Parameter('abc', 'def', PointerType('int', False, 1, False))
# then:
assert parameter.is_input
assert not parameter.is_not_input
assert parameter.is_output
def test_types_not_reported_as_c_string(c_type):
# when:
parameter = Parameter('abc', 'def', c_type)
# then:
assert not parameter.has_c_string_type
assert not parameter.has_utf8_string_type
assert parameter.has_no_string_type
def test_char_pointer_type_is_reported_as_c_string():
# when:
parameter = Parameter('abc', 'def', PointerType('char', False, 1, False))
# then:
assert parameter.has_c_string_type
assert not parameter.has_utf8_string_type
assert not parameter.has_no_string_type
def test_enrich_with_documentation_defaults_for_pointers():
# given:
parameter = Parameter('abc', 'def', PointerType('int', False, 1, False))
documentation = create_parameter_documentation('abc')
# when:
parameter.enrich_with_documentation(documentation)
# then:
assert not parameter.has_simple_type
assert parameter.has_pointer_type
assert parameter.is_single_element
assert not parameter.has_fixed_length
assert parameter.fixed_length is None
assert not parameter.is_null_terminated
assert not parameter.has_length_descriptor
assert parameter.length_descriptor is None
def test_struct_type(c_type, expected_type):
# given:
parameter = Parameter('abc', 'def', c_type)
# when:
struct_type = parameter.struct_type
# then:
assert struct_type == expected_type
def test_enrich_with_documentation_sets_ignored_on_length_descriptors():
# given:
pointer_param = Parameter('x', 'abc', PointerType('int', False, 1, False))
length_descriptor_param = Parameter('size', 'abc', SimpleType('size_t'))
method = Method('abc', SimpleType('void'),
[pointer_param, length_descriptor_param])
attributions = ActiveAttributions()
attributions.add_attribution('length-descriptor=size')
documentation = ParameterDocumentation('x', attributions)
# when:
method.enrich_with_documentation({'x': documentation})
# then:
assert not pointer_param.is_ignored
assert pointer_param.is_included
assert length_descriptor_param.is_ignored
assert not length_descriptor_param.is_included
def test_enrich_with_documentation_ensures_parameter_kind_is_set():
# given:
method = Method('abc', SimpleType('void'),
[Parameter('x', 'abc', SimpleType('int'))])
# when:
method.enrich_with_documentation(dict())
# then:
assert method.parameters[0].is_input
assert not method.parameters[0].is_output
def test_enrich_with_documentation_defaults():
# given:
parameter = Parameter('abc', 'def', SimpleType('int'))
parameter_documentation = create_parameter_documentation('abc')
# when:
parameter.enrich_with_documentation(parameter_documentation)
# then:
assert parameter.kind == ParameterKind.kind_in()
assert parameter.is_input
assert not parameter.is_not_input
assert not parameter.is_output
assert parameter.has_simple_type
assert not parameter.has_pointer_type
assert not parameter.is_single_element
assert not parameter.has_fixed_length
assert parameter.fixed_length is None
assert not parameter.is_null_terminated
assert not parameter.has_length_descriptor
assert parameter.length_descriptor is None
def test_error_is_raised_when_length_descriptor_does_not_exist():
# given:
pointer_param = Parameter('x', 'abc', PointerType('int', False, 1, False))
method = Method('abc', SimpleType('void'), [pointer_param])
attributions = ActiveAttributions()
attributions.add_attribution('length-descriptor=size')
documentation = ParameterDocumentation('x', attributions)
# when:
try:
method.enrich_with_documentation({'x': documentation})
except MockGeneratorError:
return
assert False