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

# vim: tabstop=4 shiftwidth=4 softtabstop=4 

 

# Copyright 2012 OpenStack LLC 

# 

# Licensed under the Apache License, Version 2.0 (the "License"); you may 

# not use this file except in compliance with the License. You may obtain 

# a copy of the License at 

# 

#      http://www.apache.org/licenses/LICENSE-2.0 

# 

# Unless required by applicable law or agreed to in writing, software 

# distributed under the License is distributed on an "AS IS" BASIS, WITHOUT 

# WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the 

# License for the specific language governing permissions and limitations 

# under the License. 

 

REGISTRY = {} 

 

 

class UnresolvableDependencyException(Exception): 

    def __init__(self, name): 

        msg = 'Unregistered dependency: %s' % name 

        super(UnresolvableDependencyException, self).__init__(msg) 

 

 

def provider(name): 

    """Register the wrapped dependency provider under the specified name.""" 

    def wrapper(cls): 

        def wrapped(init): 

            def __wrapped_init__(self, *args, **kwargs): 

                """Initialize the wrapped object and add it to the registry.""" 

                init(self, *args, **kwargs) 

                REGISTRY[name] = self 

 

            return __wrapped_init__ 

 

        cls.__init__ = wrapped(cls.__init__) 

        return cls 

 

    return wrapper 

 

 

def requires(*dependencies): 

    """Inject specified dependencies from the registry into the instance.""" 

    def wrapper(self, *args, **kwargs): 

        """Inject each dependency from the registry.""" 

        self.__wrapped_init__(*args, **kwargs) 

 

        for dependency in self._dependencies: 

            if dependency not in REGISTRY: 

                raise UnresolvableDependencyException(dependency) 

            setattr(self, dependency, REGISTRY[dependency]) 

 

    def wrapped(cls): 

        """Note the required dependencies on the object for later injection. 

 

        The dependencies of the parent class are combined with that of the 

        child class to create a new set of dependencies. 

        """ 

        existing_dependencies = getattr(cls, '_dependencies', set()) 

        cls._dependencies = existing_dependencies.union(dependencies) 

        if not hasattr(cls, '__wrapped_init__'): 

            cls.__wrapped_init__ = cls.__init__ 

            cls.__init__ = wrapper 

        return cls 

 

    return wrapped