LSST Applications g0603fd7c41+501e3db9f9,g0aad566f14+23d8574c86,g0dd44d6229+a1a4c8b791,g2079a07aa2+86d27d4dc4,g2305ad1205+a62672bbc1,g2bbee38e9b+047b288a59,g337abbeb29+047b288a59,g33d1c0ed96+047b288a59,g3a166c0a6a+047b288a59,g3d1719c13e+23d8574c86,g487adcacf7+cb7fd919b2,g4be5004598+23d8574c86,g50ff169b8f+96c6868917,g52b1c1532d+585e252eca,g591dd9f2cf+4a9e435310,g63cd9335cc+585e252eca,g858d7b2824+23d8574c86,g88963caddf+0cb8e002cc,g99cad8db69+43388bcaec,g9ddcbc5298+9a081db1e4,ga1e77700b3+a912195c07,gae0086650b+585e252eca,gb0e22166c9+60f28cb32d,gb2522980b2+793639e996,gb3a676b8dc+b4feba26a1,gb4b16eec92+63f8520565,gba4ed39666+c2a2e4ac27,gbb8dafda3b+a5d255a82e,gc120e1dc64+d820f8acdb,gc28159a63d+047b288a59,gc3e9b769f7+f4f1cc6b50,gcf0d15dbbd+a1a4c8b791,gdaeeff99f8+f9a426f77a,gdb0af172c8+b6d5496702,ge79ae78c31+047b288a59,w.2024.19
LSST Data Management Base Package
Loading...
Searching...
No Matches
Public Member Functions | Public Attributes | Protected Attributes | List of all members
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

 agent_name
 

Protected Attributes

 _accept
 

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 135 of file monitor.py.

Constructor & Destructor Documentation

◆ __init__()

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

Definition at line 148 of file monitor.py.

148 def __init__(self, rule: str):
149 self._accept = True
150 if rule.startswith("-"):
151 self._accept = False
152 rule = rule[1:]
153 elif rule.startswith("+"):
154 rule = rule[1:]
155 self.agent_name = "" if rule == "any" else rule
156

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 clent 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 167 of file monitor.py.

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

◆ 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 157 of file monitor.py.

157 def is_match_all(self) -> bool:
158 """Return `True` if this rule is a catch-all rule.
159
160 Returns
161 -------
162 is_match_all : `bool`
163 `True` if rule name is `-any`, `+any`, or `any`.
164 """
165 return not self.agent_name
166

Member Data Documentation

◆ _accept

lsst.dax.apdb.monitor.MonFilter._accept
protected

Definition at line 149 of file monitor.py.

◆ agent_name

lsst.dax.apdb.monitor.MonFilter.agent_name

Definition at line 155 of file monitor.py.


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