annotate lib/background_loop.py @ 2215:d8853f173568

fork background_loop
author drewp@bigasterisk.com
date Tue, 23 May 2023 14:41:04 -0700
parents
children acf1b68d031a
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
2215
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
1 # dev copy
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
2 import asyncio
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
3 import logging
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
4 import time
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
5 import traceback
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
6 from typing import Any, Awaitable, Callable, Union
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
7
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
8 from prometheus_client import Gauge, Summary
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
9
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
10 log = logging.getLogger()
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
11
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
12
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
13 # throw this away (when net_routes is rewritten)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
14 def loop_forever_sync(func, sleep_period, up_metric):
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
15 first_run = True
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
16 while True:
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
17 try:
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
18 func(first_run)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
19 up_metric.set(1)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
20 first_run = False
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
21 except Exception as ex:
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
22 log.error(ex)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
23 traceback.print_exc()
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
24 up_metric.set(0)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
25 time.sleep(sleep_period)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
26
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
27
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
28 _created = []
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
29
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
30 # todo: some tricky typing
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
31 F_RET = Any
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
32 F_KWARGS = Any
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
33
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
34 UserAsyncFunc = Callable[..., # always called with at least kwarg first_run=bool
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
35 Awaitable[F_RET]]
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
36 UserSyncFunc = Callable[..., # see above
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
37 F_RET]
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
38 UserFunc = Union[UserAsyncFunc, UserSyncFunc]
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
39
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
40
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
41 class Loop:
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
42
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
43 def __init__(
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
44 self,
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
45 func: UserFunc,
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
46 sleep_period: float,
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
47 metric_prefix: str,
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
48 ):
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
49 self.func = func
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
50 self.sleep_period = sleep_period
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
51
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
52 self.up_metric = Gauge(f'{metric_prefix}_up', 'not erroring')
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
53 self.call_metric = Summary(f'{metric_prefix}_calls', 'calls')
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
54 self.lastSuccessRun = 0
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
55 self.everSucceeded = False
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
56
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
57 async def call_func(self, first_run: bool, call_kwargs={}) -> F_RET:
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
58 with self.call_metric.time():
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
59 if asyncio.iscoroutinefunction(self.func):
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
60 ret = await self.func(first_run=first_run, **call_kwargs)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
61 else:
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
62 ret = self.func(first_run=first_run, **call_kwargs)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
63 return ret
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
64
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
65 async def _run(self):
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
66 self.first_run = True
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
67 while True:
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
68 await self._runOne()
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
69 await asyncio.sleep(self.sleep_period)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
70
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
71 async def runNow(self, **kwargs: F_KWARGS) -> F_RET:
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
72 """unlike background runs, you get to pass more args and get your func's
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
73 return value.
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
74 """
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
75 return await self._runOne(call_kwargs=kwargs)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
76
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
77 async def _runOne(self, call_kwargs={}):
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
78 try:
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
79 result = await self.call_func(self.first_run, call_kwargs)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
80 self.lastSuccessRun = time.time()
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
81 self.up_metric.set(1)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
82 self.everSucceeded = True
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
83 self.first_run = False
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
84 except Exception as ex:
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
85 log.error(ex)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
86 traceback.print_exc()
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
87 self.up_metric.set(0)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
88 result = None
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
89 # todo: something that reveals error ratio
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
90 return result
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
91
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
92
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
93 def loop_forever(
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
94 func: UserFunc,
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
95 sleep_period: float,
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
96 metric_prefix='background_loop',
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
97 up_metric=None,
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
98 call_metric=None,
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
99 ):
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
100 """
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
101 sleep_period is the sleep time after however long func takes to run
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
102 """
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
103 if up_metric is not None or call_metric is not None:
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
104 raise NotImplementedError('remove old-style metrics')
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
105
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
106 loop = Loop(func, sleep_period, metric_prefix)
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
107 _created.append(asyncio.create_task(loop._run()))
d8853f173568 fork background_loop
drewp@bigasterisk.com
parents:
diff changeset
108 return loop