Inheritance diagram for lsst.dax.ppdb.timer.Timer:

Public Member Functions
def	__init__ (self, name="", doPrint=True)

def	start (self)

def	stop (self)

def	dump (self)

def	__str__ (self)

def	__enter__ (self)

def	__exit__ (self, exc_type, exc_val, exc_tb)

Detailed Description

Instance of this class can be used to track consumed time.

This class is also a context manager and can be used in
a `with` statement. By default it prints consumed CPU time
and real time spent in a context.

Example:

    with Timer('SelectTimer'):
        engine.execute('SELECT ...')

Definition at line 37 of file timer.py.

Constructor & Destructor Documentation

◆ init()

def lsst.dax.ppdb.timer.Timer.__init__	(	self,
		name = `""`,
		doPrint = `True`
	)

@param name:  Time name, will be printed together with statistics
@param doPrint: if True then print statistics on exist from context

Definition at line 51 of file timer.py.

     def __init__(self, name="", doPrint=True):
         """
         @param name:  Time name, will be printed together with statistics
         @param doPrint: if True then print statistics on exist from context
         """
         self._name = name
         self._print = doPrint
 
         self._startReal = None
         self._startUser = None
         self._startSys = None
         self._sumReal = 0.
         self._sumUser = 0.
         self._sumSys = 0.
 

Member Function Documentation

◆ enter()

def lsst.dax.ppdb.timer.Timer.__enter__ ( self )

Enter context, start timer

Definition at line 111 of file timer.py.

     def __enter__(self):
         """
         Enter context, start timer
         """
         self.start()
         return self
 

◆ exit()

def lsst.dax.ppdb.timer.Timer.__exit__	(	self,
		exc_type,
		exc_val,
		exc_tb
	)

Exit context, stop and dump timer

Definition at line 118 of file timer.py.

     def __exit__(self, exc_type, exc_val, exc_tb):
         """
         Exit context, stop and dump timer
         """
         if exc_type is None:
             self.stop()
             if self._print:
                 self.dump()
         return False
 

◆ str()

def lsst.dax.ppdb.timer.Timer.__str__ ( self )

Definition at line 97 of file timer.py.

     def __str__(self):
         real = self._sumReal
         user = self._sumUser
         sys = self._sumSys
         if self._startReal is not None:
             real += time.time() - self._startReal
             ru = resource.getrusage(resource.RUSAGE_SELF)
             user += ru.ru_utime - self._startUser
             sys += ru.ru_stime - self._startSys
         info = "real=%.3f user=%.3f sys=%.3f" % (real, user, sys)
         if self._name:
             info = self._name + ": " + info
         return info
 

◆ dump()

def lsst.dax.ppdb.timer.Timer.dump ( self )

Dump timer statistics

Definition at line 90 of file timer.py.

     def dump(self):
         """
         Dump timer statistics
         """
         _LOG.info("%s", self)
         return self
 

◆ start()

def lsst.dax.ppdb.timer.Timer.start ( self )

Start timer.

Definition at line 66 of file timer.py.

     def start(self):
         """
         Start timer.
         """
         self._startReal = time.time()
         ru = resource.getrusage(resource.RUSAGE_SELF)
         self._startUser = ru.ru_utime
         self._startSys = ru.ru_stime
         return self
 

◆ stop()

def lsst.dax.ppdb.timer.Timer.stop ( self )

Stop timer.

Definition at line 76 of file timer.py.

     def stop(self):
         """
         Stop timer.
         """
         if self._startReal is not None:
             self._sumReal += time.time() - self._startReal
             ru = resource.getrusage(resource.RUSAGE_SELF)
             self._sumUser += ru.ru_utime - self._startUser
             self._sumSys += ru.ru_stime - self._startSys
             self._startReal = None
             self._startUser = None
             self._startSys = None
         return self
 

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

/j/snowflake/release/lsstsw/stack/Linux64/dax_ppdb/19.0.0+1/python/lsst/dax/ppdb/timer.py

Public Member Functions