|
1
|
1 |
|
import logging |
|
2
|
1 |
|
from contextlib import ExitStack |
|
3
|
1 |
|
from copy import copy |
|
4
|
1 |
|
from functools import wraps |
|
5
|
1 |
|
from typing import ( |
|
6
|
|
|
Collection, |
|
7
|
|
|
Union, |
|
8
|
|
|
Type, |
|
9
|
|
|
TypeVar, |
|
10
|
|
|
Optional, |
|
11
|
|
|
cast, |
|
12
|
|
|
ContextManager, |
|
13
|
|
|
Iterator, |
|
14
|
|
|
Generator, |
|
15
|
|
|
Callable, |
|
16
|
|
|
List, |
|
17
|
|
|
) |
|
18
|
|
|
|
|
19
|
1 |
|
from lagom import Container |
|
20
|
1 |
|
from lagom.compilaton import mypyc_attr |
|
21
|
1 |
|
from lagom.definitions import ConstructionWithContainer, SingletonWrapper, Alias |
|
22
|
1 |
|
from lagom.exceptions import InvalidDependencyDefinition |
|
23
|
1 |
|
from lagom.interfaces import ( |
|
24
|
|
|
ReadableContainer, |
|
25
|
|
|
SpecialDepDefinition, |
|
26
|
|
|
CallTimeContainerUpdate, |
|
27
|
|
|
ContainerBoundFunction, |
|
28
|
|
|
) |
|
29
|
|
|
|
|
30
|
1 |
|
X = TypeVar("X") |
|
31
|
|
|
|
|
32
|
|
|
|
|
33
|
1 |
|
class _ContextBoundFunction(ContainerBoundFunction[X]): |
|
34
|
|
|
""" |
|
35
|
|
|
Represents an instance of a function bound to a context container |
|
36
|
|
|
""" |
|
37
|
|
|
|
|
38
|
1 |
|
__slots__ = ("context_container", "partially_bound_function") |
|
39
|
|
|
|
|
40
|
1 |
|
context_container: "ContextContainer" |
|
41
|
1 |
|
partially_bound_function: ContainerBoundFunction |
|
42
|
|
|
|
|
43
|
1 |
|
def __init__( |
|
44
|
|
|
self, |
|
45
|
|
|
context_container: "ContextContainer", |
|
46
|
|
|
partially_bound_function: ContainerBoundFunction, |
|
47
|
|
|
): |
|
48
|
1 |
|
self.context_container = context_container |
|
49
|
1 |
|
self.partially_bound_function = partially_bound_function |
|
50
|
|
|
|
|
51
|
1 |
|
def __call__(self, *args, **kwargs) -> X: |
|
52
|
1 |
|
with self.context_container as c: |
|
53
|
1 |
|
return self.partially_bound_function.rebind(c)(*args, **kwargs) |
|
54
|
|
|
|
|
55
|
1 |
|
def rebind(self, container: ReadableContainer) -> "ContainerBoundFunction[X]": |
|
56
|
|
|
return wraps(self.partially_bound_function)( |
|
57
|
|
|
_ContextBoundFunction( |
|
58
|
|
|
self.context_container, self.partially_bound_function.rebind(container) |
|
59
|
|
|
) |
|
60
|
|
|
) |
|
61
|
|
|
|
|
62
|
|
|
|
|
63
|
1 |
|
@mypyc_attr(allow_interpreted_subclasses=True) |
|
64
|
1 |
|
class ContextContainer(Container): |
|
65
|
|
|
""" |
|
66
|
|
|
Wraps a regular container but is a ContextManager for use within a `with`. |
|
67
|
|
|
|
|
68
|
|
|
>>> from tests.examples import SomeClass, SomeClassManager |
|
69
|
|
|
>>> from lagom import Container |
|
70
|
|
|
>>> from typing import ContextManager |
|
71
|
|
|
>>> |
|
72
|
|
|
>>> # The regular container |
|
73
|
|
|
>>> c = Container() |
|
74
|
|
|
>>> |
|
75
|
|
|
>>> # register a context manager for SomeClass |
|
76
|
|
|
>>> c[ContextManager[SomeClass]] = SomeClassManager |
|
77
|
|
|
>>> |
|
78
|
|
|
>>> context_c = ContextContainer(c, context_types=[SomeClass]) |
|
79
|
|
|
>>> with context_c as c: |
|
80
|
|
|
... c[SomeClass] |
|
81
|
|
|
<tests.examples.SomeClass object at ...> |
|
82
|
|
|
""" |
|
83
|
|
|
|
|
84
|
1 |
|
exit_stack: Optional[ExitStack] = None |
|
85
|
1 |
|
_context_types: Collection[Type] |
|
86
|
1 |
|
_context_singletons: Collection[Type] |
|
87
|
|
|
|
|
88
|
1 |
|
def __init__( |
|
89
|
|
|
self, |
|
90
|
|
|
container: Container, |
|
91
|
|
|
context_types: Collection[Type], |
|
92
|
|
|
context_singletons: Collection[Type] = tuple(), |
|
93
|
|
|
log_undefined_deps: Union[bool, logging.Logger] = False, |
|
94
|
|
|
): |
|
95
|
1 |
|
self._context_types = context_types |
|
96
|
1 |
|
self._context_singletons = context_singletons |
|
97
|
1 |
|
super().__init__(container, log_undefined_deps) |
|
98
|
|
|
|
|
99
|
1 |
|
def clone(self) -> "ContextContainer": |
|
100
|
|
|
"""returns a copy of the container |
|
101
|
|
|
:return: |
|
102
|
|
|
""" |
|
103
|
1 |
|
return ContextContainer( |
|
104
|
|
|
self, |
|
105
|
|
|
context_types=self._context_types, |
|
106
|
|
|
context_singletons=self._context_singletons, |
|
107
|
|
|
log_undefined_deps=self._undefined_logger, |
|
108
|
|
|
) |
|
109
|
|
|
|
|
110
|
1 |
|
def __enter__(self): |
|
111
|
1 |
|
if not self.exit_stack: |
|
112
|
|
|
# All actual context definitions happen on a clone so that there's isolation between invocations |
|
113
|
1 |
|
in_context = self.clone() |
|
114
|
1 |
|
for dep_type in set(self._context_types): |
|
115
|
1 |
|
in_context[dep_type] = self._context_type_def(dep_type) |
|
116
|
1 |
|
for dep_type in set(self._context_singletons): |
|
117
|
1 |
|
in_context[dep_type] = self._singleton_type_def(dep_type) |
|
118
|
1 |
|
in_context.exit_stack = ExitStack() |
|
119
|
|
|
|
|
120
|
|
|
# The parent context manager keeps track of the inner clone |
|
121
|
1 |
|
self.exit_stack = ExitStack() |
|
122
|
1 |
|
self.exit_stack.enter_context(in_context) |
|
123
|
1 |
|
return in_context |
|
124
|
1 |
|
return self |
|
125
|
|
|
|
|
126
|
1 |
|
def __exit__(self, exc_type, exc_val, exc_tb): |
|
127
|
1 |
|
if self.exit_stack: |
|
128
|
1 |
|
self.exit_stack.close() |
|
129
|
1 |
|
self.exit_stack = None |
|
130
|
|
|
|
|
131
|
1 |
|
def partial( |
|
132
|
|
|
self, |
|
133
|
|
|
func: Callable[..., X], |
|
134
|
|
|
shared: Optional[List[Type]] = None, |
|
135
|
|
|
container_updater: Optional[CallTimeContainerUpdate] = None, |
|
136
|
|
|
) -> ContainerBoundFunction[X]: |
|
137
|
1 |
|
base_partial = super(ContextContainer, self).partial( |
|
138
|
|
|
func, shared, container_updater |
|
139
|
|
|
) |
|
140
|
|
|
|
|
141
|
1 |
|
return wraps(base_partial)(_ContextBoundFunction(self, base_partial)) |
|
142
|
|
|
|
|
143
|
1 |
|
def magic_partial( |
|
144
|
|
|
self, |
|
145
|
|
|
func: Callable[..., X], |
|
146
|
|
|
shared: Optional[List[Type]] = None, |
|
147
|
|
|
keys_to_skip: Optional[List[str]] = None, |
|
148
|
|
|
skip_pos_up_to: int = 0, |
|
149
|
|
|
container_updater: Optional[CallTimeContainerUpdate] = None, |
|
150
|
|
|
) -> ContainerBoundFunction[X]: |
|
151
|
1 |
|
base_partial = super(ContextContainer, self).magic_partial( |
|
152
|
|
|
func, shared, keys_to_skip, skip_pos_up_to, container_updater |
|
153
|
|
|
) |
|
154
|
|
|
|
|
155
|
1 |
|
return wraps(base_partial)(_ContextBoundFunction(self, base_partial)) |
|
156
|
|
|
|
|
157
|
1 |
|
def _context_type_def(self, dep_type: Type): |
|
158
|
1 |
|
type_def = self.get_definition(ContextManager[dep_type]) or self.get_definition(Iterator[dep_type]) or self.get_definition(Generator[dep_type, None, None]) # type: ignore |
|
159
|
1 |
|
if type_def is None: |
|
160
|
1 |
|
raise InvalidDependencyDefinition( |
|
161
|
|
|
f"A ContextManager[{dep_type}] should be defined. " |
|
162
|
|
|
f"This could be an Iterator[{dep_type}] or Generator[{dep_type}, None, None] " |
|
163
|
|
|
f"with the @contextmanager decorator" |
|
164
|
|
|
) |
|
165
|
1 |
|
if isinstance(type_def, Alias): |
|
166
|
|
|
# Without this we create a definition that points to |
|
167
|
|
|
# itself. |
|
168
|
1 |
|
type_def = copy(type_def) |
|
169
|
1 |
|
type_def.skip_definitions = True |
|
170
|
1 |
|
return ConstructionWithContainer(lambda c: self._context_resolver(c, type_def)) # type: ignore |
|
171
|
|
|
|
|
172
|
1 |
|
def _singleton_type_def(self, dep_type: Type): |
|
173
|
|
|
""" |
|
174
|
|
|
The same as context_type_def but acts as a singleton within this container |
|
175
|
|
|
""" |
|
176
|
1 |
|
return SingletonWrapper(self._context_type_def(dep_type)) |
|
177
|
|
|
|
|
178
|
1 |
|
def _context_resolver(self, c: ReadableContainer, type_def: SpecialDepDefinition): |
|
179
|
|
|
""" |
|
180
|
|
|
Takes an existing definition which must be a context manager. Returns |
|
181
|
|
|
the value of the context manager from __enter__ and then places the |
|
182
|
|
|
__exit__ in this container's exit stack |
|
183
|
|
|
""" |
|
184
|
1 |
|
assert self.exit_stack, "Types can only be resolved within a with" |
|
185
|
1 |
|
context_manager = cast(ContextManager, type_def.get_instance(c)) |
|
186
|
|
|
return self.exit_stack.enter_context(context_manager) |
|
187
|
|
|
|
meadsteve /
lagom
