Hide keyboard shortcuts

Hot-keys on this page

r m x p   toggle line displays

j k   next/prev highlighted chunk

0   (zero) top of page

1   (one) first highlighted chunk

1

2

3

4

5

6

7

8

9

10

11

12

13

14

15

16

17

18

19

20

21

22

23

24

25

26

27

28

29

30

31

32

33

34

35

36

37

38

39

40

41

42

43

44

45

46

47

48

49

50

51

52

53

54

55

56

57

58

59

60

61

62

63

64

65

66

67

68

69

70

71

72

73

74

75

76

77

78

79

80

81

82

83

84

85

86

87

88

89

90

91

92

93

94

95

96

97

98

99

100

101

102

103

104

105

106

107

108

109

110

111

112

# (c) 2014 Michael DeHaan, <michael@ansible.com> 

# 

# This file is part of Ansible 

# 

# Ansible is free software: you can redistribute it and/or modify 

# it under the terms of the GNU General Public License as published by 

# the Free Software Foundation, either version 3 of the License, or 

# (at your option) any later version. 

# 

# Ansible is distributed in the hope that it will be useful, 

# but WITHOUT ANY WARRANTY; without even the implied warranty of 

# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 

# GNU General Public License for more details. 

# 

# You should have received a copy of the GNU General Public License 

# along with Ansible. If not, see <http://www.gnu.org/licenses/>. 

 

# Make coding more python3-ish 

from __future__ import (absolute_import, division, print_function) 

__metaclass__ = type 

 

import os 

 

from ansible.errors import AnsibleParserError, AnsibleError 

from ansible.module_utils.six import iteritems, string_types 

from ansible.playbook.attribute import Attribute, FieldAttribute 

from ansible.playbook.base import Base 

from ansible.playbook.helpers import load_list_of_roles 

from ansible.playbook.role.include import RoleInclude 

from ansible.playbook.role.requirement import RoleRequirement 

 

__all__ = ['RoleMetadata'] 

 

 

class RoleMetadata(Base): 

''' 

This class wraps the parsing and validation of the optional metadata 

within each Role (meta/main.yml). 

''' 

 

_allow_duplicates = FieldAttribute(isa='bool', default=False) 

_dependencies = FieldAttribute(isa='list', default=[]) 

_galaxy_info = FieldAttribute(isa='GalaxyInfo') 

 

def __init__(self, owner=None): 

self._owner = owner 

super(RoleMetadata, self).__init__() 

 

@staticmethod 

def load(data, owner, variable_manager=None, loader=None): 

''' 

Returns a new RoleMetadata object based on the datastructure passed in. 

''' 

 

55 ↛ 56line 55 didn't jump to line 56, because the condition on line 55 was never true if not isinstance(data, dict): 

raise AnsibleParserError("the 'meta/main.yml' for role %s is not a dictionary" % owner.get_name()) 

 

m = RoleMetadata(owner=owner).load_data(data, variable_manager=variable_manager, loader=loader) 

return m 

 

def _load_dependencies(self, attr, ds): 

''' 

This is a helper loading function for the dependencies list, 

which returns a list of RoleInclude objects 

''' 

 

roles = [] 

68 ↛ 85line 68 didn't jump to line 85, because the condition on line 68 was never false if ds: 

69 ↛ 70line 69 didn't jump to line 70, because the condition on line 69 was never true if not isinstance(ds, list): 

raise AnsibleParserError("Expected role dependencies to be a list.", obj=self._ds) 

 

for role_def in ds: 

73 ↛ 76line 73 didn't jump to line 76, because the condition on line 73 was never false if isinstance(role_def, string_types) or 'role' in role_def or 'name' in role_def: 

roles.append(role_def) 

continue 

try: 

# role_def is new style: { src: 'galaxy.role,version,name', other_vars: "here" } 

def_parsed = RoleRequirement.role_yaml_parse(role_def) 

if def_parsed.get('name'): 

role_def['name'] = def_parsed['name'] 

roles.append(role_def) 

except AnsibleError as exc: 

raise AnsibleParserError(str(exc), obj=role_def, orig_exc=exc) 

 

current_role_path = None 

86 ↛ 89line 86 didn't jump to line 89, because the condition on line 86 was never false if self._owner: 

current_role_path = os.path.dirname(self._owner._role_path) 

 

try: 

return load_list_of_roles(roles, play=self._owner._play, current_role_path=current_role_path, variable_manager=self._variable_manager, 

loader=self._loader) 

except AssertionError as e: 

raise AnsibleParserError("A malformed list of role dependencies was encountered.", obj=self._ds, orig_exc=e) 

 

def _load_galaxy_info(self, attr, ds): 

''' 

This is a helper loading function for the galaxy info entry 

in the metadata, which returns a GalaxyInfo object rather than 

a simple dictionary. 

''' 

 

return ds 

 

def serialize(self): 

return dict( 

allow_duplicates=self._allow_duplicates, 

dependencies=self._dependencies, 

) 

 

def deserialize(self, data): 

setattr(self, 'allow_duplicates', data.get('allow_duplicates', False)) 

setattr(self, 'dependencies', data.get('dependencies', []))