Files
PyRIGS/z3c/rml/document.py
2014-12-07 17:32:25 +00:00

758 lines
24 KiB
Python

##############################################################################
#
# Copyright (c) 2007 Zope Foundation and Contributors.
# All Rights Reserved.
#
# This software is subject to the provisions of the Zope Public License,
# Version 2.1 (ZPL). A copy of the ZPL should accompany this distribution.
# THIS SOFTWARE IS PROVIDED "AS IS" AND ANY AND ALL EXPRESS OR IMPLIED
# WARRANTIES ARE DISCLAIMED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
# WARRANTIES OF TITLE, MERCHANTABILITY, AGAINST INFRINGEMENT, AND FITNESS
# FOR A PARTICULAR PURPOSE.
#
##############################################################################
"""RML ``document`` element
"""
import cStringIO
import logging
import sys
import zope.interface
import reportlab.pdfgen.canvas
from reportlab.pdfbase import pdfmetrics, ttfonts, cidfonts
from reportlab.lib import colors, fonts
from reportlab.platypus import tableofcontents
from reportlab.platypus.doctemplate import IndexingFlowable
from z3c.rml import attr, canvas, directive, doclogic, interfaces, list
from z3c.rml import occurence, pdfinclude, special, storyplace, stylesheet
from z3c.rml import template
LOGGER_NAME = 'z3c.rml.render'
class IRegisterType1Face(interfaces.IRMLDirectiveSignature):
"""Register a new Type 1 font face."""
afmFile = attr.File(
title=u'AFM File',
description=u'Path to AFM file used to register the Type 1 face.',
doNotOpen=True,
required=True)
pfbFile = attr.File(
title=u'PFB File',
description=u'Path to PFB file used to register the Type 1 face.',
doNotOpen=True,
required=True)
class RegisterType1Face(directive.RMLDirective):
signature = IRegisterType1Face
def process(self):
args = self.getAttributeValues(valuesOnly=True)
face = pdfmetrics.EmbeddedType1Face(*args)
pdfmetrics.registerTypeFace(face)
class IRegisterFont(interfaces.IRMLDirectiveSignature):
"""Register a new font based on a face and encoding."""
name = attr.String(
title=u'Name',
description=(u'The name under which the font can be used in style '
u'declarations or other parameters that lookup a font.'),
required=True)
faceName = attr.String(
title=u'Face Name',
description=(u'The name of the face the font uses. The face has to '
u'be previously registered.'),
required=True)
encName = attr.String(
title=u'Encoding Name',
description=(u'The name of the encdoing to be used.'),
required=True)
class RegisterFont(directive.RMLDirective):
signature = IRegisterFont
def process(self):
args = self.getAttributeValues(valuesOnly=True)
font = pdfmetrics.Font(*args)
pdfmetrics.registerFont(font)
class IAddMapping(interfaces.IRMLDirectiveSignature):
"""Map various styles(bold, italic) of a font name to the actual ps fonts
used."""
faceName = attr.String(
title=u'Name',
description=(u'The name of the font to be mapped'),
required=True)
bold = attr.Integer(
title=u'Bold',
description=(u'Bold'),
required=True)
italic = attr.Integer(
title=u'Italic',
description=(u'Italic'),
required=True)
psName = attr.String(
title=u'psName',
description=(u'Actual font name mapped'),
required=True)
class AddMapping(directive.RMLDirective):
signature = IAddMapping
def process(self):
args = self.getAttributeValues(valuesOnly=True)
fonts.addMapping(*args)
class IRegisterTTFont(interfaces.IRMLDirectiveSignature):
"""Register a new TrueType font given the TT file and face name."""
faceName = attr.String(
title=u'Face Name',
description=(u'The name of the face the font uses. The face has to '
u'be previously registered.'),
required=True)
fileName = attr.File(
title=u'File Name',
description=u'File path of the of the TrueType font.',
doNotOpen=True,
required=True)
class RegisterTTFont(directive.RMLDirective):
signature = IRegisterTTFont
def process(self):
args = self.getAttributeValues(valuesOnly=True)
font = ttfonts.TTFont(*args)
pdfmetrics.registerFont(font)
class IRegisterCidFont(interfaces.IRMLDirectiveSignature):
"""Register a new CID font given the face name."""
faceName = attr.String(
title=u'Face Name',
description=(u'The name of the face the font uses. The face has to '
u'be previously registered.'),
required=True)
encName = attr.String(
title=u'Encoding Name',
description=(u'The name of the encoding to use for the font.'),
required=False)
class RegisterCidFont(directive.RMLDirective):
signature = IRegisterCidFont
attrMapping = {'faceName': 'face', 'encName': 'encoding'}
def process(self):
args = dict(self.getAttributeValues(attrMapping=self.attrMapping))
if 'encoding' in args:
font = cidfonts.CIDFont(**args)
else:
font = cidfonts.UnicodeCIDFont(**args)
pdfmetrics.registerFont(font)
class IRegisterFontFamily(interfaces.IRMLDirectiveSignature):
"""Register a new font family."""
name = attr.String(
title=u'Name',
description=(u'The name of the font family.'),
required=True)
normal = attr.String(
title=u'Normal Font Name',
description=(u'The name of the normal font variant.'),
required=False)
bold = attr.String(
title=u'Bold Font Name',
description=(u'The name of the bold font variant.'),
required=False)
italic = attr.String(
title=u'Italic Font Name',
description=(u'The name of the italic font variant.'),
required=False)
boldItalic = attr.String(
title=u'Bold/Italic Font Name',
description=(u'The name of the bold/italic font variant.'),
required=True)
class RegisterFontFamily(directive.RMLDirective):
signature = IRegisterFontFamily
attrMapping = {'name': 'family'}
def process(self):
args = dict(self.getAttributeValues(attrMapping=self.attrMapping))
pdfmetrics.registerFontFamily(**args)
class IColorDefinition(interfaces.IRMLDirectiveSignature):
"""Define a new color and give it a name to be known under."""
id = attr.String(
title=u'Id',
description=(u'The id/name the color will be available under.'),
required=True)
RGB = attr.Color(
title=u'RGB Color',
description=(u'The color value that is represented.'),
required=False)
CMYK = attr.Color(
title=u'CMYK Color',
description=(u'The color value that is represented.'),
required=False)
value = attr.Color(
title=u'Color',
description=(u'The color value that is represented.'),
required=False)
spotName = attr.String(
title=u'Spot Name',
description=(u'The Spot Name of the CMYK color.'),
required=False)
density = attr.Float(
title=u'Density',
description=(u'The color density of the CMYK color.'),
min=0.0,
max=1.0,
required=False)
knockout = attr.String(
title=u'Knockout',
description=(u'The knockout of the CMYK color.'),
required=False)
alpha = attr.Float(
title=u'Alpha',
description=(u'The alpha channel of the color.'),
min=0.0,
max=1.0,
required=False)
class ColorDefinition(directive.RMLDirective):
signature = IColorDefinition
def process(self):
kwargs = dict(self.getAttributeValues())
id = kwargs.pop('id')
for attrName in ('RGB', 'CMYK', 'value'):
color = kwargs.pop(attrName, None)
if color is not None:
# CMYK has additional attributes.
for name, value in kwargs.items():
setattr(color, name, value)
manager = attr.getManager(self)
manager.colors[id] = color
return
raise ValueError('At least one color definition must be specified.')
# Initialize also supports the <color> tag.
stylesheet.Initialize.factories['color'] = ColorDefinition
stylesheet.IInitialize.setTaggedValue(
'directives',
stylesheet.IInitialize.getTaggedValue('directives') +
(occurence.ZeroOrMore('color', IColorDefinition),)
)
class IStartIndex(interfaces.IRMLDirectiveSignature):
"""Start a new index."""
name = attr.String(
title=u'Name',
description=u'The name of the index.',
default='index',
required=True)
offset = attr.Integer(
title=u'Offset',
description=u'The counting offset.',
min=0,
required=False)
format = attr.Choice(
title=u'Format',
description=(u'The format the index is going to use.'),
choices=interfaces.LIST_FORMATS,
required=False)
class StartIndex(directive.RMLDirective):
signature = IStartIndex
def process(self):
kwargs = dict(self.getAttributeValues())
name = kwargs['name']
manager = attr.getManager(self)
manager.indexes[name] = tableofcontents.SimpleIndex(**kwargs)
class ICropMarks(interfaces.IRMLDirectiveSignature):
"""Crop Marks specification"""
name = attr.String(
title=u'Name',
description=u'The name of the index.',
default='index',
required=True)
borderWidth = attr.Measurement(
title=u'Border Width',
description=u'The width of the crop mark border.',
required=False)
markColor = attr.Color(
title=u'Mark Color',
description=u'The color of the crop marks.',
required=False)
markWidth = attr.Measurement(
title=u'Mark Width',
description=u'The line width of the actual crop marks.',
required=False)
markLength = attr.Measurement(
title=u'Mark Length',
description=u'The length of the actual crop marks.',
required=False)
markLast = attr.Boolean(
title=u'Mark Last',
description=u'If set, marks are drawn after the content is rendered.',
required=False)
bleedWidth = attr.Measurement(
title=u'Bleed Width',
description=(u'The width of the page bleed.'),
required=False)
class CropMarksProperties(object):
borderWidth = 36
markWidth = 0.5
markColor = colors.toColor('green')
markLength = 18
markLast = True
bleedWidth = 0
class CropMarks(directive.RMLDirective):
signature = ICropMarks
def process(self):
cmp = CropMarksProperties()
for name, value in self.getAttributeValues():
setattr(cmp, name, value)
self.parent.parent.cropMarks = cmp
class ILogConfig(interfaces.IRMLDirectiveSignature):
"""Configure the render logger."""
level = attr.Choice(
title=u'Level',
description=u'The default log level.',
choices=interfaces.LOG_LEVELS,
doLower=False,
required=False)
format = attr.String(
title=u'Format',
description=u'The format of the log messages.',
required=False)
filename = attr.File(
title=u'File Name',
description=u'The path to the file that is being logged.',
doNotOpen=True,
required=True)
filemode = attr.Choice(
title=u'File Mode',
description=u'The mode to open the file in.',
choices={'WRITE': 'w', 'APPEND': 'a'},
default='a',
required=False)
datefmt = attr.String(
title=u'Date Format',
description=u'The format of the log message date.',
required=False)
class LogConfig(directive.RMLDirective):
signature = ILogConfig
def process(self):
args = dict(self.getAttributeValues())
# cleanup win paths like:
# ....\\input\\file:///D:\\trunk\\...
if sys.platform[:3].lower() == "win":
if args['filename'].startswith('file:///'):
args['filename'] = args['filename'][len('file:///'):]
logger = logging.getLogger(LOGGER_NAME)
handler = logging.FileHandler(args['filename'], args['filemode'])
formatter = logging.Formatter(
args.get('format'), args.get('datefmt'))
handler.setFormatter(formatter)
logger.addHandler(handler)
if 'level' in args:
logger.setLevel(args['level'])
self.parent.parent.logger = logger
class IDocInit(interfaces.IRMLDirectiveSignature):
occurence.containing(
occurence.ZeroOrMore('color', IColorDefinition),
occurence.ZeroOrMore('name', special.IName),
occurence.ZeroOrMore('registerType1Face', IRegisterType1Face),
occurence.ZeroOrMore('registerFont', IRegisterFont),
occurence.ZeroOrMore('registerCidFont', IRegisterCidFont),
occurence.ZeroOrMore('registerTTFont', IRegisterTTFont),
occurence.ZeroOrMore('registerFontFamily', IRegisterFontFamily),
occurence.ZeroOrMore('addMapping', IAddMapping),
occurence.ZeroOrMore('logConfig', ILogConfig),
occurence.ZeroOrMore('cropMarks', ICropMarks),
occurence.ZeroOrMore('startIndex', IStartIndex),
)
pageMode = attr.Choice(
title=u'Page Mode',
description=(u'The page mode in which the document is opened in '
u'the viewer.'),
choices=('UseNone', 'UseOutlines', 'UseThumbs', 'FullScreen'),
required=False)
pageLayout = attr.Choice(
title=u'Page Layout',
description=(u'The layout in which the pages are displayed in '
u'the viewer.'),
choices=('SinglePage', 'OneColumn', 'TwoColumnLeft', 'TwoColumnRight'),
required=False)
useCropMarks = attr.Boolean(
title=u'Use Crop Marks',
description=u'A flag when set shows crop marks on the page.',
required=False)
hideToolbar = attr.TextBoolean(
title=u'Hide Toolbar',
description=(u'A flag indicating that the toolbar is hidden in '
u'the viewer.'),
required=False)
hideMenubar = attr.TextBoolean(
title=u'Hide Menubar',
description=(u'A flag indicating that the menubar is hidden in '
u'the viewer.'),
required=False)
hideWindowUI = attr.TextBoolean(
title=u'Hide Window UI',
description=(u'A flag indicating that the window UI is hidden in '
u'the viewer.'),
required=False)
fitWindow = attr.TextBoolean(
title=u'Fit Window',
description=u'A flag indicating that the page fits in the viewer.',
required=False)
centerWindow = attr.TextBoolean(
title=u'Center Window',
description=(u'A flag indicating that the page fits is centered '
u'in the viewer.'),
required=False)
displayDocTitle = attr.TextBoolean(
title=u'Display Doc Title',
description=(u'A flag indicating that the document title is displayed '
u'in the viewer.'),
required=False)
nonFullScreenPageMode = attr.Choice(
title=u'Non-Full-Screen Page Mode',
description=(u'Non-Full-Screen page mode in the viewer.'),
choices=('UseNone', 'UseOutlines', 'UseThumbs', 'UseOC'),
required=False)
direction = attr.Choice(
title=u'Text Direction',
description=(u'The text direction of the PDF.'),
choices=('L2R', 'R2L'),
required=False)
viewArea = attr.Choice(
title=u'View Area',
description=(u'View Area setting used in the viewer.'),
choices=('MediaBox', 'CropBox', 'BleedBox', 'TrimBox', 'ArtBox'),
required=False)
viewClip = attr.Choice(
title=u'View Clip',
description=(u'View Clip setting used in the viewer.'),
choices=('MediaBox', 'CropBox', 'BleedBox', 'TrimBox', 'ArtBox'),
required=False)
printArea = attr.Choice(
title=u'Print Area',
description=(u'Print Area setting used in the viewer.'),
choices=('MediaBox', 'CropBox', 'BleedBox', 'TrimBox', 'ArtBox'),
required=False)
printClip = attr.Choice(
title=u'Print Clip',
description=(u'Print Clip setting used in the viewer.'),
choices=('MediaBox', 'CropBox', 'BleedBox', 'TrimBox', 'ArtBox'),
required=False)
printScaling = attr.Choice(
title=u'Print Scaling',
description=(u'The print scaling mode in which the document is opened '
u'in the viewer.'),
choices=('None', 'AppDefault'),
required=False)
class DocInit(directive.RMLDirective):
signature = IDocInit
factories = {
'name': special.Name,
'color': ColorDefinition,
'registerType1Face': RegisterType1Face,
'registerFont': RegisterFont,
'registerTTFont': RegisterTTFont,
'registerCidFont': RegisterCidFont,
'registerFontFamily': RegisterFontFamily,
'addMapping': AddMapping,
'logConfig': LogConfig,
'cropMarks': CropMarks,
'startIndex': StartIndex,
}
viewerOptions = dict(
(option[0].lower()+option[1:], option)
for option in ['HideToolbar', 'HideMenubar', 'HideWindowUI', 'FitWindow',
'CenterWindow', 'DisplayDocTitle',
'NonFullScreenPageMode', 'Direction', 'ViewArea',
'ViewClip', 'PrintArea', 'PrintClip', 'PrintScaling'])
def process(self):
kwargs = dict(self.getAttributeValues())
self.parent.cropMarks = kwargs.get('useCropMarks', False)
self.parent.pageMode = kwargs.get('pageMode')
self.parent.pageLayout = kwargs.get('pageLayout')
for name in self.viewerOptions:
setattr(self.parent, name, kwargs.get(name))
super(DocInit, self).process()
class IDocument(interfaces.IRMLDirectiveSignature):
occurence.containing(
occurence.ZeroOrOne('docinit', IDocInit),
occurence.ZeroOrOne('stylesheet', stylesheet.IStylesheet),
occurence.ZeroOrOne('template', template.ITemplate),
occurence.ZeroOrOne('story', template.IStory),
occurence.ZeroOrOne('pageInfo', canvas.IPageInfo),
occurence.ZeroOrMore('pageDrawing', canvas.IPageDrawing),
)
filename = attr.String(
title=u'File Name',
description=(u'The default name of the output file, if no output '
u'file was provided.'),
required=True)
title = attr.String(
title=u'Title',
description=(u'The "Title" annotation for the PDF document.'),
required=False)
subject = attr.String(
title=u'Subject',
description=(u'The "Subject" annotation for the PDF document.'),
required=False)
author = attr.String(
title=u'Author',
description=(u'The "Author" annotation for the PDF document.'),
required=False)
creator = attr.String(
title=u'Creator',
description=(u'The "Creator" annotation for the PDF document.'),
required=False)
debug = attr.Boolean(
title=u'Debug',
description=u'A flag to activate the debug output.',
default=False,
required=False)
compression = attr.BooleanWithDefault(
title=u'Compression',
description=(u'A flag determining whether page compression should '
u'be used.'),
required=False)
invariant = attr.BooleanWithDefault(
title=u'Invariant',
description=(u'A flag that determines whether the produced PDF '
u'should be invariant with respect to the date and '
u'the exact contents.'),
required=False)
class Document(directive.RMLDirective):
signature = IDocument
zope.interface.implements(interfaces.IManager,
interfaces.IPostProcessorManager,
interfaces.ICanvasManager)
factories = {
'docinit': DocInit,
'stylesheet': stylesheet.Stylesheet,
'template': template.Template,
'story': template.Story,
'pageInfo': canvas.PageInfo,
'pageDrawing': canvas.PageDrawing,
}
def __init__(self, element):
super(Document, self).__init__(element, None)
self.names = {}
self.styles = {}
self.colors = {}
self.indexes = {}
self.postProcessors = []
self.filename = '<unknown>'
self.cropMarks = False
self.pageLayout = None
self.pageMode = None
self.logger = None
self.svgs = {}
self.attributesCache = {}
for name in DocInit.viewerOptions:
setattr(self, name, None)
def _indexAdd(self, canvas, name, label):
self.indexes[name](canvas, name, label)
def _beforeDocument(self):
self._initCanvas(self.doc.canv)
self.canvas = self.doc.canv
def _initCanvas(self, canvas):
canvas._indexAdd = self._indexAdd
canvas.manager = self
if self.pageLayout:
canvas._doc._catalog.setPageLayout(self.pageLayout)
if self.pageMode:
canvas._doc._catalog.setPageMode(self.pageMode)
for name, option in DocInit.viewerOptions.items():
if getattr(self, name) is not None:
canvas.setViewerPreference(option, getattr(self, name))
# Setting annotations.
data = dict(self.getAttributeValues(
select=('title', 'subject', 'author', 'creator')))
canvas.setTitle(data.get('title'))
canvas.setSubject(data.get('subject'))
canvas.setAuthor(data.get('author'))
canvas.setCreator(data.get('creator'))
def process(self, outputFile=None, maxPasses=2):
"""Process document"""
# Reset all reportlab global variables. This is very important for
# ReportLab not to fail.
reportlab.rl_config._reset()
debug = self.getAttributeValues(select=('debug',), valuesOnly=True)[0]
if not debug:
reportlab.rl_config.shapeChecking = 0
# Add our colors mapping to the default ones.
colors.toColor.setExtraColorsNameSpace(self.colors)
if outputFile is None:
# TODO: This is relative to the input file *not* the CWD!!!
outputFile = open(self.element.get('filename'), 'wb')
# Create a temporary output file, so that post-processors can
# massage the output
self.outputFile = tempOutput = cStringIO.StringIO()
# Process common sub-directives
self.processSubDirectives(select=('docinit', 'stylesheet'))
# Handle Page Drawing Documents
if self.element.find('pageDrawing') is not None:
kwargs = dict(self.getAttributeValues(
select=('compression', 'debug'),
attrMapping={'compression': 'pageCompression',
'debug': 'verbosity'}
))
kwargs['cropMarks'] = self.cropMarks
self.canvas = reportlab.pdfgen.canvas.Canvas(tempOutput, **kwargs)
self._initCanvas(self.canvas)
self.processSubDirectives(select=('pageInfo', 'pageDrawing'))
self.canvas.save()
# Handle Flowable-based documents.
elif self.element.find('template') is not None:
self.processSubDirectives(select=('template', 'story'))
self.doc.beforeDocument = self._beforeDocument
self.doc.multiBuild(self.flowables, maxPasses=maxPasses)
# Process all post processors
for name, processor in self.postProcessors:
tempOutput.seek(0)
tempOutput = processor.process(tempOutput)
# Save the result into our real output file
tempOutput.seek(0)
outputFile.write(tempOutput.getvalue())
# Cleanup.
colors.toColor.setExtraColorsNameSpace({})
reportlab.rl_config.shapeChecking = 1
def get_name(self, name, default=None):
if default is None:
default = u''
if name not in self.names:
if self.doc._indexingFlowables and isinstance(
self.doc._indexingFlowables[-1],
DummyIndexingFlowable
):
return default
self.doc._indexingFlowables.append(DummyIndexingFlowable())
return self.names.get(name, default)
class DummyIndexingFlowable(IndexingFlowable):
"""A dummy flowable to trick multiBuild into performing +1 pass."""
def __init__(self):
self.i = -1
def isSatisfied(self):
self.i += 1
return self.i