Coverage for britney2/policies/__init__.py: 100%
47 statements
« prev ^ index » next coverage.py v6.5.0, created at 2025-03-23 07:34 +0000
1from enum import Enum, unique
2from functools import total_ordering
5@total_ordering
6@unique
7class PolicyVerdict(Enum):
8 """"""
10 """
11 The policy doesn't apply to this item. No test was done.
12 """
13 NOT_APPLICABLE = 0
14 """
15 The migration item passed the policy.
16 """
17 PASS = 1
18 """
19 The policy was completely overruled by a hint.
20 """
21 PASS_HINTED = 2
22 """
23 The migration item did not pass the policy, but the failure is believed
24 to be temporary
25 """
26 REJECTED_TEMPORARILY = 3
27 """
28 The migration item is temporarily unable to migrate due to another item. The other item is temporarily blocked.
29 """
30 REJECTED_WAITING_FOR_ANOTHER_ITEM = 4
31 """
32 The migration item is permanently unable to migrate due to another item. The other item is permanently blocked.
33 """
34 REJECTED_BLOCKED_BY_ANOTHER_ITEM = 5
35 """
36 The migration item needs approval to migrate
37 """
38 REJECTED_NEEDS_APPROVAL = 6
39 """
40 The migration item is blocked, but there is not enough information to determine
41 if this issue is permanent or temporary
42 """
43 REJECTED_CANNOT_DETERMINE_IF_PERMANENT = 7
44 """
45 The migration item did not pass the policy and the failure is believed
46 to be uncorrectable (i.e. a hint or a new version is needed)
47 """
48 REJECTED_PERMANENTLY = 8
50 @property
51 def is_rejected(self) -> bool:
52 return True if self.name.startswith("REJECTED") else False
54 @property
55 def is_blocked(self) -> bool:
56 """Whether the item (probably) needs a fix or manual assistance to migrate"""
57 return self in {
58 PolicyVerdict.REJECTED_BLOCKED_BY_ANOTHER_ITEM,
59 PolicyVerdict.REJECTED_NEEDS_APPROVAL,
60 PolicyVerdict.REJECTED_CANNOT_DETERMINE_IF_PERMANENT, # Assuming the worst
61 PolicyVerdict.REJECTED_PERMANENTLY,
62 }
64 @staticmethod
65 def worst_of(*args: "PolicyVerdict") -> "PolicyVerdict":
66 """Pick the "worst" of two verdicts - useful for aggregating two verdicts"""
67 # We could have used max everywhere, but "worst_of" seemed more clear (as then you do not have to remember
68 # the value of the verdicts)
69 return max(args)
71 def __lt__(self, other: "PolicyVerdict") -> bool:
72 return True if self.value < other.value else False
75@unique
76class ApplySrcPolicy(Enum):
77 """
78 For a source item, run the source policy (this is the default)
79 """
81 RUN_SRC = 1
82 """
83 For a source item, run the arch policy on every arch
84 """
85 RUN_ON_EVERY_ARCH_ONLY = 2
86 """
87 For a source item, run the source policy and run the arch policy on every arch
88 """
89 RUN_SRC_AND_EVERY_ARCH = 3
91 @property
92 def run_src(self) -> bool:
93 return self in {
94 ApplySrcPolicy.RUN_SRC,
95 ApplySrcPolicy.RUN_SRC_AND_EVERY_ARCH,
96 }
98 @property
99 def run_arch(self) -> bool:
100 return self in {
101 ApplySrcPolicy.RUN_ON_EVERY_ARCH_ONLY,
102 ApplySrcPolicy.RUN_SRC_AND_EVERY_ARCH,
103 }