LSST Applications g00274db5b6+edbf708997,g00d0e8bbd7+edbf708997,g199a45376c+5137f08352,g1fd858c14a+1d4b6db739,g262e1987ae+f4d9505c4f,g29ae962dfc+7156fb1a53,g2cef7863aa+73c82f25e4,g35bb328faa+edbf708997,g3e17d7035e+5b3adc59f5,g3fd5ace14f+852fa6fbcb,g47891489e3+6dc8069a4c,g53246c7159+edbf708997,g64539dfbff+9f17e571f4,g67b6fd64d1+6dc8069a4c,g74acd417e5+ae494d68d9,g786e29fd12+af89c03590,g7ae74a0b1c+a25e60b391,g7aefaa3e3d+536efcc10a,g7cc15d900a+d121454f8d,g87389fa792+a4172ec7da,g89139ef638+6dc8069a4c,g8d7436a09f+28c28d8d6d,g8ea07a8fe4+db21c37724,g92c671f44c+9f17e571f4,g98df359435+b2e6376b13,g99af87f6a8+b0f4ad7b8d,gac66b60396+966efe6077,gb88ae4c679+7dec8f19df,gbaa8f7a6c5+38b34f4976,gbf99507273+edbf708997,gc24b5d6ed1+9f17e571f4,gca7fc764a6+6dc8069a4c,gcc769fe2a4+97d0256649,gd7ef33dd92+6dc8069a4c,gdab6d2f7ff+ae494d68d9,gdbb4c4dda9+9f17e571f4,ge410e46f29+6dc8069a4c,geaed405ab2+e194be0d2b,w.2025.47
LSST Data Management Base Package
Loading...
Searching...
No Matches
lsst.dax.apdb.monitor.MonFilter Class Reference

Public Member Functions

 __init__ (self, str rule)
 
bool is_match_all (self)
 
bool|None accept (self, str agent_name)
 

Public Attributes

str agent_name = "any" else rule
 

Protected Attributes

bool _accept = True
 

Detailed Description

Filter for the names associated with client agents.

Parameters
----------
rule : `str`
    String specifying filtering rule for a single name, or catch-all rule.
    The rule consist of the agent name prefixed by minus or optional plus
    sign. Catch-all rule uses name "any". If the rule starts with minus
    sign then matching agent will be rejected. Otherwise matching agent
    is accepted.

Definition at line 141 of file monitor.py.

Constructor & Destructor Documentation

◆ __init__()

lsst.dax.apdb.monitor.MonFilter.__init__ ( self,
str rule )

Definition at line 154 of file monitor.py.

154 def __init__(self, rule: str):
155 self._accept = True
156 if rule.startswith("-"):
157 self._accept = False
158 rule = rule[1:]
159 elif rule.startswith("+"):
160 rule = rule[1:]
161 self.agent_name = "" if rule == "any" else rule
162

Member Function Documentation

◆ accept()

bool | None lsst.dax.apdb.monitor.MonFilter.accept ( self,
str agent_name )
Return filtering decision for specified agent name.

Parameters
----------
agent_name : `str`
    Name of the client agent that produces monitoring record.

Returns
-------
decision : `bool` or `None`
    `True` if the agent is accepted, `False` if agent is rejected.
    `None` is returned if this rule does not match agent name and
    decision should be made by the next rule.

Definition at line 173 of file monitor.py.

173 def accept(self, agent_name: str) -> bool | None:
174 """Return filtering decision for specified agent name.
175
176 Parameters
177 ----------
178 agent_name : `str`
179 Name of the client agent that produces monitoring record.
180
181 Returns
182 -------
183 decision : `bool` or `None`
184 `True` if the agent is accepted, `False` if agent is rejected.
185 `None` is returned if this rule does not match agent name and
186 decision should be made by the next rule.
187 """
188 if not self.agent_name or agent_name == self.agent_name:
189 return self._accept
190 return None
191
192

◆ is_match_all()

bool lsst.dax.apdb.monitor.MonFilter.is_match_all ( self)
Return `True` if this rule is a catch-all rule.

Returns
-------
is_match_all : `bool`
    `True` if rule name is `-any`, `+any`, or `any`.

Definition at line 163 of file monitor.py.

163 def is_match_all(self) -> bool:
164 """Return `True` if this rule is a catch-all rule.
165
166 Returns
167 -------
168 is_match_all : `bool`
169 `True` if rule name is `-any`, `+any`, or `any`.
170 """
171 return not self.agent_name
172

Member Data Documentation

◆ _accept

bool lsst.dax.apdb.monitor.MonFilter._accept = True
protected

Definition at line 155 of file monitor.py.

◆ agent_name

str lsst.dax.apdb.monitor.MonFilter.agent_name = "any" else rule

Definition at line 161 of file monitor.py.


The documentation for this class was generated from the following file: