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

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

# (c) 2012, Jeroen Hoekx <jeroen@hoekx.be> 

# 

# 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 re 

import operator as py_operator 

from collections import MutableMapping, MutableSequence 

from distutils.version import LooseVersion, StrictVersion 

 

from ansible import errors 

 

 

def failed(result): 

''' Test if task result yields failed ''' 

if not isinstance(result, MutableMapping): 

raise errors.AnsibleFilterError("The failed test expects a dictionary") 

return result.get('failed', False) 

 

 

def success(result): 

''' Test if task result yields success ''' 

return not failed(result) 

 

 

def changed(result): 

''' Test if task result yields changed ''' 

if not isinstance(result, MutableMapping): 

raise errors.AnsibleFilterError("The changed test expects a dictionary") 

if 'changed' not in result: 

changed = False 

if ( 

'results' in result and # some modules return a 'results' key 

isinstance(result['results'], MutableSequence) and 

isinstance(result['results'][0], MutableMapping) 

): 

for res in result['results']: 

if res.get('changed', False): 

changed = True 

break 

else: 

changed = result.get('changed', False) 

return changed 

 

 

def skipped(result): 

''' Test if task result yields skipped ''' 

if not isinstance(result, MutableMapping): 

raise errors.AnsibleFilterError("The skipped test expects a dictionary") 

return result.get('skipped', False) 

 

 

def regex(value='', pattern='', ignorecase=False, multiline=False, match_type='search'): 

''' Expose `re` as a boolean filter using the `search` method by default. 

This is likely only useful for `search` and `match` which already 

have their own filters. 

''' 

flags = 0 

75 ↛ 76line 75 didn't jump to line 76, because the condition on line 75 was never true if ignorecase: 

flags |= re.I 

77 ↛ 78line 77 didn't jump to line 78, because the condition on line 77 was never true if multiline: 

flags |= re.M 

_re = re.compile(pattern, flags=flags) 

_bool = __builtins__.get('bool') 

return _bool(getattr(_re, match_type, 'search')(value)) 

 

 

def match(value, pattern='', ignorecase=False, multiline=False): 

''' Perform a `re.match` returning a boolean ''' 

return regex(value, pattern, ignorecase, multiline, 'match') 

 

 

def search(value, pattern='', ignorecase=False, multiline=False): 

''' Perform a `re.search` returning a boolean ''' 

return regex(value, pattern, ignorecase, multiline, 'search') 

 

 

def version_compare(value, version, operator='eq', strict=False): 

''' Perform a version comparison on a value ''' 

op_map = { 

'==': 'eq', '=': 'eq', 'eq': 'eq', 

'<': 'lt', 'lt': 'lt', 

'<=': 'le', 'le': 'le', 

'>': 'gt', 'gt': 'gt', 

'>=': 'ge', 'ge': 'ge', 

'!=': 'ne', '<>': 'ne', 'ne': 'ne' 

} 

 

if strict: 

Version = StrictVersion 

else: 

Version = LooseVersion 

 

if operator in op_map: 

operator = op_map[operator] 

else: 

raise errors.AnsibleFilterError('Invalid operator type') 

 

try: 

method = getattr(py_operator, operator) 

return method(Version(str(value)), Version(str(version))) 

except Exception as e: 

raise errors.AnsibleFilterError('Version comparison: %s' % e) 

 

 

class TestModule(object): 

''' Ansible core jinja2 tests ''' 

 

def tests(self): 

return { 

# failure testing 

'failed': failed, 

'failure': failed, 

'succeeded': success, 

'success': success, 

'successful': success, 

 

# changed testing 

'changed': changed, 

'change': changed, 

 

# skip testing 

'skipped': skipped, 

'skip': skipped, 

 

# regex 

'match': match, 

'search': search, 

'regex': regex, 

 

# version comparison 

'version_compare': version_compare, 

'version': version_compare, 

 

# lists 

'any': any, 

'all': all, 

}