[VVP] Track Requirements to Test Cases
[vvp/validation-scripts.git] / ice_validator / tests / helpers.py
1 # -*- coding: utf8 -*-
2 # ============LICENSE_START=======================================================
3 # org.onap.vvp/validation-scripts
4 # ===================================================================
5 # Copyright © 2017 AT&T Intellectual Property. All rights reserved.
6 # ===================================================================
7 #
8 # Unless otherwise specified, all software contained herein is licensed
9 # under the Apache License, Version 2.0 (the “License”);
10 # you may not use this software except in compliance with the License.
11 # You may obtain a copy of the License at
12 #
13 #             http://www.apache.org/licenses/LICENSE-2.0
14 #
15 # Unless required by applicable law or agreed to in writing, software
16 # distributed under the License is distributed on an "AS IS" BASIS,
17 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18 # See the License for the specific language governing permissions and
19 # limitations under the License.
20 #
21 #
22 #
23 # Unless otherwise specified, all documentation contained herein is licensed
24 # under the Creative Commons License, Attribution 4.0 Intl. (the “License”);
25 # you may not use this documentation except in compliance with the License.
26 # You may obtain a copy of the License at
27 #
28 #             https://creativecommons.org/licenses/by/4.0/
29 #
30 # Unless required by applicable law or agreed to in writing, documentation
31 # distributed under the License is distributed on an "AS IS" BASIS,
32 # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
33 # See the License for the specific language governing permissions and
34 # limitations under the License.
35 #
36 # ============LICENSE_END============================================
37 #
38 # ECOMP is a trademark and service mark of AT&T Intellectual Property.
39 #
40
41 import yaml
42 from boltons import funcutils
43
44
45 def check_basename_ending(template_type, basename):
46     '''
47     return True/False if the template type is matching
48     the filename
49     '''
50     if not template_type:
51         return True
52     elif template_type == 'volume':
53         return basename.endswith('_volume')
54     else:
55         return not basename.endswith('_volume')
56
57
58 def get_parsed_yml_for_yaml_files(yaml_files, sections=[]):
59     '''
60     get the parsed yaml for a list of yaml files
61     '''
62     parsed_yml_list = []
63     for yaml_file in yaml_files:
64         yml = ''
65
66         try:
67             with open(yaml_file) as fh:
68                 yml = yaml.load(fh)
69         except Exception as e:
70             print(e)
71
72         if yml:
73             if sections:
74                 for k in yml.keys():
75                     if k not in sections:
76                         del yml[k]
77             parsed_yml_list.append(yml)
78
79     return parsed_yml_list
80
81
82 def validates(*requirement_ids):
83     """Decorator that tags the test function with one or more requirement IDs.
84
85     Example:
86         >>> @validates('R-12345', 'R-12346')
87         ... def test_something():
88         ...     pass
89         >>> assert test_something.requirement_ids == ['R-12345', 'R-12346']
90     """
91     def decorator(func):
92         # NOTE: We use a utility here to ensure that function signatures are
93         # maintained because pytest inspects function signatures to inject
94         # fixtures.  I experimented with a few options, but this is the only
95         # library that worked. Other libraries dynamically generated a
96         # function at run-time, and then lost the requirement_ids attribute
97         @funcutils.wraps(func)
98         def wrapper(*args, **kw):
99             return func(*args, **kw)
100         wrapper.requirement_ids = requirement_ids
101         return wrapper
102     decorator.requirement_ids = requirement_ids
103     return decorator