estimated_time_left/__init__.py

import time
import math

class ProgressInfo:
    def __init__(self, elapsed_time, progress, index, count):
        self.elapsed_time = elapsed_time
        self.progress = progress
        self.index = index
        self.count = count

    def time_remaining(self):
        if (self.progress > 0):
            return self.elapsed_time * (1/self.progress) - self.elapsed_time
        return 0

def format_time(seconds):
    hours   = int(seconds // 3600)
    minutes = int((seconds % 3600) // 60)
    seconds = int(seconds % 60)
    return "%02d:%02d:%02d" % ( hours, minutes, seconds )

def progress_info(progress_info, set_progress=None):
    if set_progress:
        set_progress(progress_info)

    return "{:>05.2f}%, {:s} of {:s}".format(
            progress_info.progress * 100, format_time( progress_info.elapsed_time ), format_time( progress_info.time_remaining() ) )

class CurrentUpdateProgress():

    def __init__(self, prefix_text):
        self.progress    = "00.00%, 00:05:11"
        self.prefix_text = prefix_text

    def __call__(self, progress_info):
        self.set_progress( progress_info )

    def set_progress(self, progress_info):
        self.progress = "{:>05.2f}%, {:s}".format( progress_info.progress * 100, format_time( progress_info.time_remaining() ) )

    def __str__(self):
        return "%s (%s)" % ( self.prefix_text, self.progress )

def range(n, info_frequency=0):
    i = 0
    start = time.time()
    if_counter = start
    while i < n:
        now = time.time()
        if now - if_counter > info_frequency:
            pi = ProgressInfo(now - start, float(i)/n, i, n)
            if_counter += info_frequency
        else:
            pi = None
        yield i, pi
        i += 1

def sequence_timer(sequence, info_frequency=0, length=None):
    """
        Yields tuples (item, progress_info) objects

        @param `length` if the `sequence` parameter is a generator, it does not have __len__
                defined, then, if you know its length, you can pass it as this parameter.
    """
    i = 0
    start = time.time()
    if_counter = start
    length = length if length else len(sequence)
    for elem in sequence:
        now = time.time()
        if now - if_counter < info_frequency:
            yield elem, None
        else:
            pi = ProgressInfo(now - start, float(i)/length, i, length)
            if_counter += info_frequency
            yield elem, pi
        i += 1

def file_timer(in_file, info_frequency=0):
    i = 0
    start = time.time()
    if_counter = start
    in_file.seek(0, 2)
    length = in_file.tell()
    in_file.seek(0)

    while True:
        line = in_file.readline()
        if line == "":
            break

        now = time.time()
        if now - if_counter < info_frequency:
            yield line, None
        else:
            pi = ProgressInfo(now - start, float(in_file.tell())/length, i, length)
            if_counter += info_frequency
            yield line, pi
        i += 1

def format_seconds(seconds):
    out_string = ''
    comma = False
    if seconds > 60*60:
        hours = math.floor(seconds / (60*60))
        seconds -= hours*60*60
        out_string += '%g hours'%hours
    if seconds > 60:
        minutes = math.floor(seconds / 60)
        seconds -= minutes*60
        if out_string:
            out_string += ', '
        out_string += '%g minutes'%minutes
    if round(seconds) > 1:
        if out_string:
            out_string += ', '
        out_string += '%g seconds'%round(seconds)
    return out_string