chainlib/chainlib/stat.py

# standard imports
import datetime



class ChainStat:
    """Block time aggregator.
    """

    def __init__(self):
        self.block_timestamp_last = None
        self.block_avg_aggregate = None
        self.block_avg_count = -1


    def block_apply(self, block):
        """Add data from block to aggregate.

        :param block: Block to add
        :type block: chainlib.block.Block
        """
        if self.block_timestamp_last == None:
            self.block_timestamp_last = block.timestamp
        
        aggregate = block.timestamp - self.block_timestamp_last

        if self.block_avg_aggregate == None:
            self.block_avg_aggregate = float(aggregate)
        else:
            self.block_avg_aggregate *= self.block_avg_count
            self.block_avg_aggregate += block.timestamp - self.block_timestamp_last
            self.block_avg_aggregate /= (self.block_avg_count + 1)

        self.block_avg_count += 1

        self.block_timestamp_last = block.timestamp


    def block_average(self):
        """Get current aggregated average.

        :rtype: float
        :returns: Aggregate average block time, in seconds
        """
        return self.block_avg_aggregate