# -*- coding: utf-8 -*- # # Gramps - a GTK+/GNOME based genealogy program # # Copyright (C) 2000-2006 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$ #------------------------------------------------------------------------ # # ToolTips # # The model provides a framework for generating tooltips for different # gramps objects. The idea is to hide the task of generating these tips # from the other parts of gramps and to provide a single place were # a tooltip is generated so that it is consistent everywhere it is used. # # The tooltips generated by this module are meant to be passed to the # TreeTips module for rendering. # # To add tooltips for a new object: # # 1. copy one of the existing Tip classes and change the tooltip() # method to suit the new object. # 2. add a new entry to the CLASS_MAP at the bottom of the file. # 3. thats it. # # To use the tips, use one of the factory classes to generate the tips. # The factory classes generate methods that TreeTips will execute only # if the tip is needed. So the processing is deferred until required. #------------------------------------------------------------------------ #------------------------------------------------------------------------ # # standard python modules # #------------------------------------------------------------------------ from xml.sax.saxutils import escape from gettext import gettext as _ #------------------------------------------------------------------------- # # gtk # #------------------------------------------------------------------------- #------------------------------------------------------------------------- # # GRAMPS modules # #------------------------------------------------------------------------- import RelLib import DateHandler #------------------------------------------------------------------------- # # Utility functions # #------------------------------------------------------------------------- def short(val,size=60): if len(val) > size: return "%s..." % val[0:size] else: return val #------------------------------------------------------------------------- # # Factory classes # #------------------------------------------------------------------------- class TipFromFunction: """ TipFromFunction generates a tooltip callable. """ def __init__(self,db,fetch_function): """ fetch_function: a callable that will return a Rellib object when it is run. The function will not be run until the tooltip is required. Use a lambda function to currie any required arguments. """ self._db = db self._fetch_function = fetch_function def get_tip(self): o = self._fetch_function() # check if we have a handler for the object type returned for cls in CLASS_MAP.keys(): if isinstance(o,cls): return CLASS_MAP[cls](self._db,o)() return "no tip" __call__ = get_tip #------------------------------------------------------------------------- # # Tip generator classes. # #------------------------------------------------------------------------- class RepositoryTip: def __init__(self,db,repos): self._db = db self._obj = repos def get_tip(self): global escape s = "%s:\t%s\n\n"\ "\t%s:\n"\ "\t\t%s\n"\ "\t\t%s\n"\ "\t\t%s\n"\ "\t\t%s\n"\ "\t\t%s\n"\ "\t\t%s\n"\ "\t%s:\t%s\n"\ "\t%s:\t%s\n"\ "\t%s:\t%s\n"\ "\t%s:\t%s\n"\ "\t%s:\t%s\n"\ % ( _("Repository"),escape(self._obj.get_name()), _("Location"), escape(self._obj.address.get_parish()), escape(self._obj.address.get_city()), escape(self._obj.address.get_county()), escape(self._obj.address.get_state()), escape(self._obj.address.get_postal_code()), escape(self._obj.address.get_country()), _("Telephone"), escape(self._obj.address.get_phone()), _("Email"), escape(self._obj.get_email()), _("Search Url"), escape(self._obj.get_search_url()), _("Home Url"), escape(self._obj.get_home_url()), _("Note"), escape(self._obj.get_note())) # Get the list of sources that reference this repository repos_handle = self._obj.get_handle() source_list = [ src_handle for src_handle \ in self._db.get_source_handles() \ if self._db.get_source_from_handle(src_handle).has_repo_reference(repos_handle)] if len(source_list) > 0: s += "\n%s\n\n" % (_("Sources in repository"),) for src_handle in source_list: src = self._db.get_source_from_handle(src_handle) s += "\t%s:\t%s\n" % ( _("Name"),escape(short(src.get_title()))) return s __call__ = get_tip class PersonTip: def __init__(self,db,repos): self._db = db self._obj = repos def get_tip(self): global escape birth_str = "" birth_ref = self._obj.get_birth_ref() if birth_ref: birth = self._db.get_event_from_handle(birth_ref.ref) date_str = DateHandler.get_date(birth) if date_str != "": birth_str = escape(date_str) s = "%s\n"\ " %s: %s\n"\ " %s: %s\n" % ( _("Person"), _("Name"),escape(self._obj.get_primary_name().get_name()), _("Birth"),birth_str) if len(self._obj.get_source_references()) > 0: psrc_ref = self._obj.get_source_references()[0] psrc_id = psrc_ref.get_reference_handle() psrc = self._db.get_source_from_handle(psrc_id) s += "\n%s\n"\ " %s: %s\n" % ( _("Primary source"), _("Name"), escape(short(psrc.get_title()))) return s __call__ = get_tip class FamilyTip: def __init__(self,db,obj): self._db = db self._obj = obj def get_tip(self): global escape fhandle = self._obj.get_father_handle() mhandle = self._obj.get_mother_handle() s = "%s" % _("Family") if fhandle: father = self._db.get_person_from_handle(fhandle) s +="\n %s: %s" % ( _("Father"),escape(father.get_primary_name().get_name())) if mhandle: mother = self._db.get_person_from_handle(mhandle) s +="\n %s: %s" % ( _("Mother"),escape(mother.get_primary_name().get_name())) for cref in self._obj.get_child_ref_list(): child = self._db.get_person_from_handle(cref.ref) s +="\n %s: %s" % ( _("Child"),escape(child.get_primary_name().get_name())) return s __call__ = get_tip CLASS_MAP = { RelLib.Repository : RepositoryTip, RelLib.Person : PersonTip, RelLib.Family : FamilyTip }