This file is indexed.

/usr/share/pyshared/freshen/stepregistry.py is in python-freshen 0.2-2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
#-*- coding: utf8 -*-
import imp
import logging
import re
import os
import sys
import traceback

__all__ = ['Given', 'When', 'Then', 'Before', 'After', 'AfterStep', 'Transform']
__unittest = 1

log = logging.getLogger('freshen')

class AmbiguousStepImpl(Exception):
    
    def __init__(self, step, impl1, impl2):
        self.step = step
        self.impl1 = impl1
        self.impl2 = impl2
        super(AmbiguousStepImpl, self).__init__('Ambiguous: "%s"\n %s\n %s' % (step.match,
                                                                              impl1.get_location(),
                                                                              impl2.get_location()))

class UndefinedStepImpl(Exception):
    
    def __init__(self, step):
        self.step = step
        super(UndefinedStepImpl, self).__init__('"%s" # %s' % (step.match, step.source_location()))

class StepImpl(object):
    
    def __init__(self, step_type, spec, func):
        self.step_type = step_type
        self.spec = spec
        self.func = func
        self.re_spec = re.compile(spec)
    
    def run(self, *args, **kwargs):
        self.func(*args, **kwargs)

    def __call__(self, *args, **kwargs):
        self.func(*args, **kwargs)
    
    def match(self, match):
        return self.re_spec.match(match)
        
    def get_location(self):
        code = self.func.func_code
        return "%s:%d" % (code.co_filename, code.co_firstlineno)

class HookImpl(object):
    
    def __init__(self, cb_type, func, tags=[]):
        self.cb_type = cb_type
        self.tags = tags
        self.func = func
        self.tags = tags
        self.order = 0
    
    def __repr__(self):
        return "<Hook: @%s %s(...)>" % (self.cb_type, self.func.func_name)
    
    def run(self, scenario):
        self.func(scenario)
    
    def __call__(self, *args, **kwargs):
        self.func(*args, **kwargs)

class TransformImpl(object):
    
    def __init__(self, spec_fragment, func):
        self.spec_fragment = spec_fragment
        self.re_spec = re.compile(spec_fragment)
        self.func = func
    
    def is_match(self, arg):
        return self.re_spec.match(arg) != None
    
    def transform_arg(self, arg):
        match = self.re_spec.match(arg)
        if match:
            return self.func(*match.groups())
    
    def __call__(self, *args, **kwargs):
        self.func(*args, **kwargs)

class StepImplLoader(object):

    def __init__(self):
        self.modules = {}
        self.module_counter = 0
    
    def load_steps_impl(self, registry, path, module_names=None):
        """
        Load the step implementations at the given path, with the given module names. If
        module_names is None then the module 'steps' is searched by default.
        """
        
        if not module_names:
            module_names = ['steps']
        
        path = os.path.abspath(path)
        
        for module_name in module_names:
            mod = self.modules.get((path, module_name))
            
            if mod is None:
                #log.debug("Looking for step def module '%s' in %s" % (module_name, path))
                cwd = os.getcwd()
                if cwd not in sys.path:
                    sys.path.append(cwd)
                
                try:
                    actual_module_name = os.path.basename(module_name)
                    complete_path = os.path.join(path, os.path.dirname(module_name))
                    info = imp.find_module(actual_module_name, [complete_path])
                except ImportError:
                    #log.debug("Did not find step defs module '%s' in %s" % (module_name, path))
                    return
                
                # Modules have to be loaded with unique names or else problems arise
                mod = imp.load_module("stepdefs_" + str(self.module_counter), *info)
                self.module_counter += 1
                self.modules[(path, module_name)] = mod
            
            for item_name in dir(mod):
                item = getattr(mod, item_name)
                if isinstance(item, StepImpl):
                    registry.add_step(item.step_type, item)
                elif isinstance(item, HookImpl):
                    registry.add_hook(item.cb_type, item)
                elif isinstance(item, TransformImpl):
                    registry.add_transform(item)


class StepImplRegistry(object):
    
    def __init__(self, tag_matcher_class):
        self.steps = {
            'given': [],
            'when': [],
            'then': []
        }
        
        self.hooks = {
            'before': [],
            'after': [],
            'after_step': []
        }
        
        self.transforms = []
        self.tag_matcher_class = tag_matcher_class
    
    def add_step(self, step_type, step):
        self.steps[step_type].append(step)
    
    def add_hook(self, hook_type, hook):
        self.hooks[hook_type].append(hook)
    
    def add_transform(self, transform):
        self.transforms.append(transform)
    
    def _apply_transforms(self, arg):
        for transform in self.transforms:
            if transform.is_match(arg):
                return transform.transform_arg(arg)
        return arg
    
    def find_step_impl(self, step):
        """
        Find the implementation of the step for the given match string. Returns the StepImpl object
        corresponding to the implementation, and the arguments to the step implementation. If no
        implementation is found, raises UndefinedStepImpl. If more than one implementation is
        found, raises AmbiguousStepImpl.
        
        Each of the arguments returned will have been transformed by the first matching transform
        implementation.
        """
        result = None
        for si in self.steps[step.step_type]:
            matches = si.match(step.match)
            if matches:
                if result:
                    raise AmbiguousStepImpl(step, result[0], si)
                
                args = [self._apply_transforms(arg) for arg in matches.groups()]
                result = si, args
        
        if not result:
            raise UndefinedStepImpl(step)
        return result
    
    def get_hooks(self, cb_type, tags=[]):
        hooks = [h for h in self.hooks[cb_type] if self.tag_matcher_class(h.tags).check_match(tags)]
        hooks.sort(cmp=lambda x,y: cmp(x.order, y.order))
        return hooks


def step_decorator(step_type):
    def decorator_wrapper(spec):
        """ Decorator to wrap step definitions in. Registers definition. """
        def wrapper(func):
            return StepImpl(step_type, spec, func)
        return wrapper
    return decorator_wrapper

def hook_decorator(cb_type):
    """ Decorator to wrap hook definitions in. Registers hook. """
    def decorator_wrapper(*tags_or_func):
        if len(tags_or_func) == 1 and callable(tags_or_func[0]):
            # No tags were passed to this decorator
            func = tags_or_func[0]
            return HookImpl(cb_type, func)
        else:
            # We got some tags, so we need to produce the real decorator
            tags = tags_or_func
            def d(func):
                return HookImpl(cb_type, func, tags)
            return d
    return decorator_wrapper

def transform_decorator(spec_fragment):
    def wrapper(func):
        return TransformImpl(spec_fragment, func)
    return wrapper


Given = step_decorator('given')
When = step_decorator('when')
Then = step_decorator('then')
Before = hook_decorator('before')
After = hook_decorator('after')
AfterStep = hook_decorator('after_step')
Transform = transform_decorator