gramps/src/BasicUtils/_UpdateCallback.py
Raphael Ackermann bbe2cc6d4e 2008-01-22 Raphael Ackermann <raphael.ackermann@gmail.com>
* src/* Everything but src/images/* and src/data/* add correct svn 
	properties with the commands:
	svn propset -R svn:mime-type text/plain src/
	svn propset -R svn:eol-style native src/
	svn propset -R svn:keywords Id src/
	See below why the Id keyword is enough. From svn help propset
	svn:keywords   - Keywords to be expanded.  Valid keywords are:
      URL, HeadURL             - The URL for the head version of the object.
      Author, LastChangedBy    - The last person to modify the file.
      Date, LastChangedDate    - The date/time the object was last modified.
      Rev, Revision,           - The last revision the object changed.
      LastChangedRevision
      Id                       - A compressed summary of the previous
                                   4 keywords.

svn: r9912
2008-01-22 09:17:46 +00:00

92 lines
2.8 KiB
Python

#
# Gramps - a GTK+/GNOME based genealogy program
#
# Copyright (C) 2004-2007 Donald N. Allingham
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
#
# $Id$
"""
A set of basic utilities that everything in GRAMPS can depend upon.
The goal is to have this module not depend on any other gramps module.
That way, e.g. database classes can safely depend on that without
other GRAMPS baggage.
"""
#-------------------------------------------------------------------------
#
# Python modules
#
#-------------------------------------------------------------------------
import time
#-------------------------------------------------------------------------
#
# Callback updater
#
#-------------------------------------------------------------------------
class UpdateCallback:
"""
Basic class providing way of calling the callback to update
things during lenghty operations.
"""
def __init__(self, callback, interval=1):
"""
@param callback: a function with one arg to execute every so often
@type callback: function
@param interval: number of seconds at most between the updates
@type interval: int
"""
if '__call__' in dir(callback): # callback is really callable
self.update = self.update_real
self.callback = callback
self.interval = interval
self.reset()
else:
self.update = self.update_empty
self.text = ""
def reset(self, text=""):
self.count = 0
self.oldval = 0
self.oldtime = 0
self.text = text
def set_total(self, total):
self.total = total
def update_empty(self, count=None):
pass
def update_real(self, count=None):
self.count += 1
if not count:
count = self.count
newval = int(100*count/self.total)
newtime = time.time()
time_has_come = self.interval and (newtime-self.oldtime>self.interval)
value_changed = newval!=self.oldval
if value_changed or time_has_come:
if self.text:
self.callback(newval, text=self.text)
else:
self.callback(newval)
self.oldval = newval
self.oldtime = newtime