Convert the book title report to use MenuReportOptions. Also, perform some general clean up for PEP8.

svn: r10506
This commit is contained in:
Brian Matherly 2008-04-06 19:52:39 +00:00
parent 534ee569c6
commit 2c88df3582

View File

@ -1,6 +1,7 @@
# Gramps - a GTK+/GNOME based genealogy program # Gramps - a GTK+/GNOME based genealogy program
# #
# Copyright (C) 2003-2006 Donald N. Allingham # Copyright (C) 2003-2006 Donald N. Allingham
# Copyright (C) 2008 Brian G. Matherly
# #
# This program is free software; you can redistribute it and/or modify # 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 # it under the terms of the GNU General Public License as published by
@ -27,26 +28,15 @@
import time import time
from TransUtils import sgettext as _ from TransUtils import sgettext as _
#------------------------------------------------------------------------
#
# gtk
#
#------------------------------------------------------------------------
import gtk
#------------------------------------------------------------------------ #------------------------------------------------------------------------
# #
# gramps modules # gramps modules
# #
#------------------------------------------------------------------------ #------------------------------------------------------------------------
from PluginUtils import register_report from PluginUtils import register_report, NumberOption, StringOption, MediaOption
from Utils import media_path_full from Utils import media_path_full
from ReportBase import Report, ReportOptions, CATEGORY_TEXT, MODE_BKI from ReportBase import Report, MenuReportOptions, CATEGORY_TEXT, MODE_BKI
import BaseDoc import BaseDoc
from Selectors import selector_factory
SelectObject = selector_factory('MediaObject')
#import AddMedia
import ThumbNails
#------------------------------------------------------------------------ #------------------------------------------------------------------------
# #
@ -54,7 +44,7 @@ import ThumbNails
# #
#------------------------------------------------------------------------ #------------------------------------------------------------------------
class SimpleBookTitle(Report): class SimpleBookTitle(Report):
""" This report class generates a title page for a book. """
def __init__(self, database, options_class): def __init__(self, database, options_class):
""" """
Create SimpleBookTitle object that produces the report. Create SimpleBookTitle object that produces the report.
@ -62,7 +52,6 @@ class SimpleBookTitle(Report):
The arguments are: The arguments are:
database - the GRAMPS database instance database - the GRAMPS database instance
person - currently selected person
options_class - instance of the Options class for this report options_class - instance of the Options class for this report
This report needs the following parameters (class variables) This report needs the following parameters (class variables)
@ -74,17 +63,17 @@ class SimpleBookTitle(Report):
imgsize - Size for the image. imgsize - Size for the image.
footer - Footer string. footer - Footer string.
""" """
Report.__init__(self, database, options_class) Report.__init__(self, database, options_class)
self.title_string = options_class.handler.options_dict['title'] menu = options_class.menu
self.image_size = options_class.handler.options_dict['imgsize'] self.title_string = menu.get_option_by_name('title').get_value()
self.subtitle_string = options_class.handler.options_dict['subtitle'] self.image_size = menu.get_option_by_name('imgsize').get_value()
self.footer_string = options_class.handler.options_dict['footer'] self.subtitle_string = menu.get_option_by_name('subtitle').get_value()
self.object_id = options_class.handler.options_dict['imgid'] self.footer_string = menu.get_option_by_name('footer').get_value()
self.object_id = menu.get_option_by_name('imgid').get_value()
def write_report(self): def write_report(self):
""" Generate the contents of the report """
self.doc.start_paragraph('SBT-Title') self.doc.start_paragraph('SBT-Title')
self.doc.write_text(self.title_string) self.doc.write_text(self.title_string)
self.doc.end_paragraph() self.doc.end_paragraph()
@ -110,155 +99,46 @@ class SimpleBookTitle(Report):
#------------------------------------------------------------------------ #------------------------------------------------------------------------
# #
# # SimpleBookTitleOptions
# #
#------------------------------------------------------------------------ #------------------------------------------------------------------------
class SimpleBookTitleOptions(ReportOptions): class SimpleBookTitleOptions(MenuReportOptions):
""" """
Defines options and provides handling interface. Defines options and provides handling interface.
""" """
def __init__(self, name, dbase): def __init__(self, name, dbase):
ReportOptions.__init__(self, name, dbase) self.__db = dbase
MenuReportOptions.__init__(self, name, dbase)
# Options specific for this report def add_menu_options(self, menu):
self.options_dict = { """ Add the options for this report """
'title' : _('Title of the Book'), category_name = _("Report Options")
'subtitle' : _('Subtitle of the Book'),
'imgid' : '',
'imgsize' : 0.0,
'footer' : '',
}
self.options_help = {
'title' : ("=str","Title string for the report",
"Whatever String You Wish"),
'subtitle' : ("=str","Subtitle string for the report",
"Whatever String You Wish"),
'footer' : ("=str","Footer string for the report",
"Whatever String You Wish"),
'imgid' : ("=ID","Gramps ID of the media object to use as an image.",
"Valid GRAMPS ID of an image."),
'imgsize' : ("=num","Size of the image.",
["Floating point value (in cm)",
"0 (to fit the page)."],
False),
}
def add_user_options(self,dialog): title = StringOption(_('book|Title'), _('Title of the Book') )
dialog.notebook = gtk.Notebook() title.set_help(_("Title string for the book."))
dialog.notebook.set_border_width(6) menu.add_option(category_name, "title", title)
dialog.window.vbox.add(dialog.notebook)
self.title_entry = gtk.Entry() subtitle = StringOption(_('Subtitle'), _('Subtitle of the Book') )
self.title_entry.set_text(self.options_dict['title']) subtitle.set_help(_("Subtitle string for the book."))
menu.add_option(category_name, "subtitle", subtitle)
self.subtitle_entry = gtk.Entry()
self.subtitle_entry.set_text(self.options_dict['subtitle'])
footer_string = self.options_dict['footer']
if not footer_string:
dateinfo = time.localtime(time.time()) dateinfo = time.localtime(time.time())
name = dialog.db.get_researcher().get_name() rname = self.__db.get_researcher().get_name()
footer_string = _('Copyright %d %s') % (dateinfo[0], name) footer_string = _('Copyright %d %s') % (dateinfo[0], rname)
self.footer_entry = gtk.Entry() footer = StringOption(_('Footer'), footer_string )
self.footer_entry.set_text(footer_string) footer.set_help(_("Footer string for the page."))
menu.add_option(category_name, "footer", footer)
dialog.add_frame_option(_('Text'),_('book|Title'),self.title_entry) imgid = MediaOption(_('Image'))
dialog.add_frame_option(_('Text'),_('Subtitle'),self.subtitle_entry) imgid.set_help( _("Gramps ID of the media object to use as an image."))
dialog.add_frame_option(_('Text'),_('Footer'),self.footer_entry) menu.add_option(category_name, "imgid", imgid)
frame = gtk.Frame() imgsize = NumberOption(_('Image Size'), 0, 0, 20, 0.1)
frame.set_size_request(96,96) imgsize.set_help(_("Size of the image in cm. A value of 0 indicates "
self.preview = gtk.Image() "that the image should be fit to the page."))
frame.add(self.preview) menu.add_option(category_name, "imgsize", imgsize)
self.obj_title = gtk.Label('')
self.remove_obj_button = gtk.Button(None,gtk.STOCK_REMOVE)
self.remove_obj_button.connect('clicked',self.remove_obj)
preview_table = gtk.Table(2,1)
preview_table.set_row_spacings(10)
preview_table.attach(frame,0,1,1,2,gtk.SHRINK|gtk.FILL,gtk.SHRINK|gtk.FILL)
preview_table.attach(self.obj_title,0,1,0,1,gtk.SHRINK|gtk.FILL,gtk.SHRINK|gtk.FILL)
select_obj_button = gtk.Button(_('From gallery...'))
select_obj_button.connect('clicked',self.select_obj,dialog)
#select_file_button = gtk.Button(_('From file...'))
#select_file_button.connect('clicked',self.select_file,dialog)
select_table = gtk.Table(1,2)
select_table.set_col_spacings(10)
select_table.attach(select_obj_button,
0,1,0,1,gtk.SHRINK|gtk.FILL,gtk.SHRINK|gtk.FILL)
#select_table.attach(select_file_button,
# 1,2,0,1,gtk.SHRINK|gtk.FILL,gtk.SHRINK|gtk.FILL)
select_table.attach(self.remove_obj_button,
1,2,0,1,gtk.SHRINK|gtk.FILL,gtk.SHRINK|gtk.FILL)
self.size = gtk.SpinButton()
self.size.set_digits(2)
self.size.set_increments(1,2)
self.size.set_range(0,20)
self.size.set_numeric(True)
self.size.set_value(self.options_dict['imgsize'])
size_frame = gtk.HBox()
size_frame.pack_start(self.size,expand=False,fill=False,padding=6)
size_frame.pack_start(gtk.Label(_('cm')),
expand=False,fill=False,padding=6)
dialog.add_frame_option(_('Image'),_('Preview'),preview_table)
dialog.add_frame_option(_('Image'),_('Select'),select_table)
dialog.add_frame_option(_('Image'),_('Size'),size_frame)
object_id = self.options_dict['imgid']
if object_id and dialog.db.get_object_from_gramps_id(object_id):
the_object = dialog.db.get_object_from_gramps_id(object_id)
self.setup_object(dialog.db,the_object)
else:
self.remove_obj_button.set_sensitive(False)
self.size.set_sensitive(False)
def parse_user_options(self,dialog):
"""
Parses the custom options that we have added.
"""
self.options_dict['title'] = unicode(self.title_entry.get_text())
self.options_dict['subtitle'] = unicode(self.subtitle_entry.get_text())
self.options_dict['footer'] = unicode(self.footer_entry.get_text())
self.options_dict['imgsize'] = self.size.get_value()
def remove_obj(self, obj):
self.options_dict['imgid'] = ""
self.obj_title.set_text('')
self.preview.set_from_pixbuf(None)
self.remove_obj_button.set_sensitive(False)
self.size.set_sensitive(False)
def select_obj(self, obj,dialog):
s_o = SelectObject(dialog.dbstate,dialog.uistate,dialog.track)
the_object = s_o.run()
self.setup_object(dialog.db,the_object)
def select_file(self, obj,dialog):
print 'Deprecated use, this must be removed'
#a_o = AddMedia.AddMediaObject(dialog.dbstate,dialog.uistate,
# dialog.track)
#a_o.run()
#self.setup_object(dialog.db,a_o.object)
def setup_object(self,database,the_object):
if not the_object:
return
self.options_dict['imgid'] = the_object.get_gramps_id()
self.obj_title.set_text(the_object.get_description())
icon_image = ThumbNails.get_thumbnail_image(
media_path_full(database, the_object.get_path()),
the_object.get_mime_type())
self.preview.set_from_pixbuf(icon_image)
self.remove_obj_button.set_sensitive(True)
self.size.set_sensitive(True)
def make_default_style(self, default_style): def make_default_style(self, default_style):
"""Make the default output style for the Simple Boot Title report.""" """Make the default output style for the Simple Boot Title report."""
@ -294,7 +174,7 @@ class SimpleBookTitleOptions(ReportOptions):
#------------------------------------------------------------------------ #------------------------------------------------------------------------
# #
# # register_report
# #
#------------------------------------------------------------------------ #------------------------------------------------------------------------
register_report( register_report(
@ -304,4 +184,8 @@ register_report(
options_class = SimpleBookTitleOptions, options_class = SimpleBookTitleOptions,
modes = MODE_BKI, modes = MODE_BKI,
translated_name = _("Title Page"), translated_name = _("Title Page"),
status = _("Stable"),
description = _("Produces a title page for book reports."),
author_name = "Brian G. Matherly",
author_email = "brian@gramps-project.org"
) )