lisa.trace.DynamicTraceEventChecker#

class lisa.trace.DynamicTraceEventChecker(event_checkers=None, **kwargs)[source]#

Bases: AssociativeTraceEventChecker

Do not check anything, but exposes the information that one of the group of events will be used.

This allows an API to manually decide which group is chosen based on its parameters, but will still convey the information that they are not really optional.

Parameters:

event_checkers (list(TraceEventCheckerBase)) – Event checkers that may be used

Properties

logger inherited

Convenience short-hand for self.get_logger().

Methods

__and__() inherited

Combine two event checkers into one that checks the presence of both.

__bool__() inherited

__call__() inherited

Decorator for methods that require some given trace events.

__class_getitem__() inherited

See collections.abc.Iterable.__class_getitem__()

__contains__() inherited

__getitem__() inherited

__iter__() inherited

__len__() inherited

__matmul__() inherited

Combine two event checkers into an optional one.

__or__() inherited

Combine two event checkers into one that checks the presence of either of them.

__reversed__() inherited

See collections.abc.Sequence.__reversed__()

check_events() inherited

Check that certain trace events are available in the given set of events.

count() inherited

See collections.abc.Sequence.count()

doc_str() inherited

Top-level function called by Sphinx’s autodoc extension to augment docstrings of the functions.

expand_namespaces() inherited

Build a TraceEventCheckerBase that will fixup the event names to take into account the given namespaces.

from_events() inherited

Build an instance of the class, converting str to TraceEventChecker.

get_all_events() inherited

Return a set of all events that are checked by this checker.

get_logger() inherited

Provides a logging.Logger named after cls.

index() inherited

See collections.abc.Sequence.index()

log_locals() inherited

Debugging aid: log the local variables of the calling function.

map() inherited

Apply the given function to all the children and rebuild a new object with the result.

Properties#

property DynamicTraceEventChecker.logger#

Inherited property, see lisa.utils.Loggable.logger

Convenience short-hand for self.get_logger().

Methods#

DynamicTraceEventChecker.__and__(other)#

Inherited method, see lisa.trace.TraceEventCheckerBase.__and__()

Combine two event checkers into one that checks the presence of both.

DynamicTraceEventChecker.__bool__()#

Inherited method, see lisa.trace.AssociativeTraceEventChecker.__bool__()

DynamicTraceEventChecker.__call__(f)#

Inherited method, see lisa.trace.TraceEventCheckerBase.__call__()

Decorator for methods that require some given trace events.

classmethod DynamicTraceEventChecker.__class_getitem__()#

Inherited method, see collections.abc.Iterable.__class_getitem__()

DynamicTraceEventChecker.__contains__(event)#

Inherited method, see lisa.trace.TraceEventCheckerBase.__contains__()

DynamicTraceEventChecker.__getitem__(i)#

Inherited method, see lisa.trace.TraceEventCheckerBase.__getitem__()

DynamicTraceEventChecker.__iter__()#

Inherited method, see lisa.trace.TraceEventCheckerBase.__iter__()

DynamicTraceEventChecker.__len__(event)#

Inherited method, see lisa.trace.TraceEventCheckerBase.__len__()

DynamicTraceEventChecker.__matmul__(other)#

Inherited method, see lisa.trace.TraceEventCheckerBase.__matmul__()

Combine two event checkers into an optional one.

DynamicTraceEventChecker.__or__(other)#

Inherited method, see lisa.trace.TraceEventCheckerBase.__or__()

Combine two event checkers into one that checks the presence of either of them.

DynamicTraceEventChecker.__reversed__()#

Inherited method, see collections.abc.Sequence.__reversed__()

DynamicTraceEventChecker.check_events(event_set, check_optional=False, namespaces=None)#

Inherited method, see lisa.trace.TraceEventCheckerBase.check_events()

Check that certain trace events are available in the given set of events.

DynamicTraceEventChecker.count()#

Inherited method, see collections.abc.Sequence.count()

DynamicTraceEventChecker.doc_str()#

Inherited method, see lisa.trace.TraceEventCheckerBase.doc_str()

Top-level function called by Sphinx’s autodoc extension to augment docstrings of the functions.

DynamicTraceEventChecker.expand_namespaces(namespaces=None)#

Inherited method, see lisa.trace.TraceEventCheckerBase.expand_namespaces()

Build a TraceEventCheckerBase that will fixup the event names to take into account the given namespaces.

classmethod DynamicTraceEventChecker.from_events(events, **kwargs)#

Inherited method, see lisa.trace.AssociativeTraceEventChecker.from_events()

Build an instance of the class, converting str to TraceEventChecker.

DynamicTraceEventChecker.get_all_events()#

Inherited method, see lisa.trace.AssociativeTraceEventChecker.get_all_events()

Return a set of all events that are checked by this checker.

classmethod DynamicTraceEventChecker.get_logger(suffix=None)#

Inherited method, see lisa.utils.Loggable.get_logger()

Provides a logging.Logger named after cls.

DynamicTraceEventChecker.index()#

Inherited method, see collections.abc.Sequence.index()

classmethod DynamicTraceEventChecker.log_locals(var_names=None, level='debug')#

Inherited method, see lisa.utils.Loggable.log_locals()

Debugging aid: log the local variables of the calling function.

DynamicTraceEventChecker.map(f)#

Inherited method, see lisa.trace.AssociativeTraceEventChecker.map()

Apply the given function to all the children and rebuild a new object with the result.