coverage
Toggle main menu visibility
読み取り中…
検索中…
一致する文字列を見つけられません
retry_policy.py
[詳解]
1
"""Nav2ゴール再送の連続失敗計数と待機時刻をROS非依存で管理する。
2
3
``CoverageBridge`` の再試行判断(拒否・実行失敗の計数、 backoff待機、
4
上限到達の判定)を純粋ロジックとして切り出す。時刻は単調時計の秒
5
(``time.monotonic`` と同じ基準)を引数で受け取る。
6
"""
7
8
from
__future__
import
annotations
9
10
from
dataclasses
import
dataclass
11
12
13
@dataclass
14
class
RetryPolicy
:
15
"""連続失敗を数え、再送可否と待機期限を判定する。
16
17
拒否(ゴール不受理)と実行失敗(abort等の非成功終了)を区別せず
18
連続失敗として数える。成功または新しいゾーンの受信でリセットする。
19
受理時にはリセットしない。受理後に失敗が続けば上限で諦める。
20
"""
21
22
limit: int = 3
23
"""諦めるまでの連続失敗回数。"""
24
25
backoff_sec: float = 5.0
26
"""失敗後に次回再送まで待つ秒数 [s]。"""
27
28
failures: int = 0
29
"""現在の連続失敗回数。"""
30
31
next_retry_monotonic: float = 0.0
32
"""次回再送が可能になる単調時刻 [s]。"""
33
34
def
record_failure
(self, now_monotonic: float) -> bool:
35
"""失敗を1件計数し、上限到達でTrue(諦め)を返す。
36
37
上限未満なら次回再送時刻を ``backoff_sec`` 秒後に進める。
38
"""
39
self.
failures
+= 1
40
if
self.
failures
>= self.
limit
:
41
return
True
42
self.
next_retry_monotonic
= now_monotonic + self.
backoff_sec
43
return
False
44
45
def
reset
(self) -> None:
46
"""成功時または新しいゾーンの受信時に計数と待機を破棄する。"""
47
self.
failures
= 0
48
self.
next_retry_monotonic
= 0.0
49
50
def
ready
(self, now_monotonic: float) -> bool:
51
"""待機期限を過ぎて再送可能ならTrueを返す。"""
52
return
now_monotonic >= self.
next_retry_monotonic
53
54
def
state_text
(self) -> str:
55
"""``/coverage/state`` 通知用の再試行中テキストを返す。"""
56
return
f
'WAITING_NAV_RETRY {self.failures}/{self.limit}'
coverage.retry_policy.RetryPolicy
連続失敗を数え、再送可否と待機期限を判定する。
定義
retry_policy.py:14
coverage.retry_policy.RetryPolicy.failures
int failures
定義
retry_policy.py:28
coverage.retry_policy.RetryPolicy.reset
None reset(self)
成功時または新しいゾーンの受信時に計数と待機を破棄する。
定義
retry_policy.py:45
coverage.retry_policy.RetryPolicy.ready
bool ready(self, float now_monotonic)
待機期限を過ぎて再送可能ならTrueを返す。
定義
retry_policy.py:50
coverage.retry_policy.RetryPolicy.backoff_sec
float backoff_sec
定義
retry_policy.py:25
coverage.retry_policy.RetryPolicy.limit
int limit
定義
retry_policy.py:22
coverage.retry_policy.RetryPolicy.record_failure
bool record_failure(self, float now_monotonic)
失敗を1件計数し、上限到達でTrue(諦め)を返す。
定義
retry_policy.py:34
coverage.retry_policy.RetryPolicy.next_retry_monotonic
float next_retry_monotonic
定義
retry_policy.py:31
coverage.retry_policy.RetryPolicy.state_text
str state_text(self)
/coverage/state 通知用の再試行中テキストを返す。
定義
retry_policy.py:54
coverage
retry_policy.py
構築:
1.18.0