U :vhy_@sdZdZdZdZddlZddlZddlZddlZddlZddl m Z ddl m Z dd l mZd d Zd d ZGdddZGdddeZdS)z PDF Template Helpers for fpdf.pyz%Mariano Reingart z#Copyright (C) 2010 Mariano ReingartzLGPL 3.0N)get_stack_level) FPDFException)FPDFcCs|d|dd|dfS)Ni)colrr1/tmp/pip-unpacked-wheel-dvf6lv8i/fpdf/template.py_rgbsr cCsft|\}}}|dkr&|dkr&|dks.|dkr>|dddS|ddd|ddd|dddS)Nrz.3fz g z rg)r )rrgbrrr _rgb_as_strs rc@seZdZdZd@ddZddZeddZed d ZdAe j e d d dZ dBe j e e e dddZ ddZeZddZddZddZdddddddd d!d!d!ddddd"d#d$d%Zdddddd dd&d'd(Zdddddd ddd)d*d+Zdddddd ddd)d,d-Zdddddd.d/d0Zdddddd1d2d dd3 d4d5Zddddd6d dddddd7 d8d9Zdddddddd d!d!d!ddd: d;d<ZdCd>d?ZdS)D FlexTemplatez A flexible templating class. Allows to apply one or several template definitions to any page of a document in any combination. Nc Cs^t|tstd||_d|_|r,|||j|j|j|j |j |j |j |j d|_i|_dS)a= Arguments: pdf (fpdf.FPDF() instance): All content will be added to this object. elements (list of dicts): A template definition in a list of dicts. If you omit this, then you need to call either load_elements() or parse_csv() before doing anything else. z('pdf' must be an instance of fpdf.FPDF()N)TLIBEBCC39W) isinstancer TypeErrorpdf splitting_pdf load_elements_text_line_image_rect_ellipse_barcode_code39_writehandlerstexts)selfrelementsrrr __init__!s    zFlexTemplate.__init__cCs$ttdfttdfttfttfttfttfttdfttftttttttdfttdftttdfttfttdfd}||_g|_|D]}d|krd|d<dD]}||kr|ddkr&|dkrd |kr|d |d<q|d krd |kr|d |d <q|d kr&d |kr&|d |d |d <qtd|dqd|krb|ddkrZd|d<ntdd|kr|ddkrd|kr|d|d<| D]p\}}||krt |||st |tr|j nd dd|D}t d|d|dt||j dq|j|dqdS)z Load a template definition. Arguments: elements (list of dicts): A template definition in a list of dicts N)nametypex1y1x2y2fontsizebolditalic underline foreground backgroundaligntextpriority multilinerotatewrapmoder<r)r-r.r/r0r2r.rr/xr0yr2hzMandatory key 'z' missing in input datar1rrz(Mandatory key 'x2' missing in input datar4wz or cSsg|]}d|jdqS)')__name__.0r@rrr ~sz.FlexTemplate.load_elements..zValue of element item 'z ' must be z, not ''.r-)strr.intfloatobjectboolr+keysKeyErroritemsrrFjoinrappendlower)r*r+ key_configektttyperrr r;sn                zFlexTemplate.load_elementscCs8|dddkrt|dS|ddkr0t|dSt|S)z#Allow hex and oct values for colorsN)0x0Xr0rL)srrr _parse_colorcodes    zFlexTemplate._parse_colorcodecCs$t|}|dkrdS|dkr dSdS)NrTFra)rbirrr _parse_multilines zFlexTemplate._parse_multilineutf-8)infileencodingc Cst||d}t|}|D]}|d}|rft|trf|dr^t|ddd|d<nt d|d}|rt|tr|drt|ddd|d<qt d q| |W5QRXdS) a Load the template definition from a JSON file. The data must be structured as an array of objects, with names and values exactly equivalent to what would get supplied to load_elements(), Arguments: infile (string or path-like object): The filepath of the JSON file. encoding (string): The character encoding of the file. Default is UTF-8. rhr8#rNr^z;If foreground is a string, it must have the form '#rrggbb'.r9z;If background is a string, it must have the form '#rrggbb'.) openjsonloadgetrrKrU startswithrL ValueErrorr)r*rgrhfdatadZfgvalZbgvalrrr parse_jsons$    zFlexTemplate.parse_json,.)rg delimiter decimal_seprhc sd%fdd }dtdfdtdfd|dfd|dfd |dfd |dfd td fd |d fdtd fdtd fdtd fd|jd fd|jd fdtd fdtd fdtd fd|jd fd|d fdtd ff}g|_|dkrt}t||d}tj ||dD]}| dgt |t |i} t ||D]\} } | } | s|| drd| dd krN|dd krNntd!| dd"n| ddkrd| d<n| d| | | d<q|j| qW5QRXd#d$|jD|_dS)&a? Load the template definition from a CSV file. Arguments: infile (string or path-like object): The filepath of the CSV file. delimiter (single character): The character that separates the fields in the CSV file: Usually a comma, semicolon, or tab. decimal_sep (single character): The decimal separator used in the file. Usually either a point or a comma. encoding (string): The character encoding of the file. Default is the system default encoding. r_cst|p |dS)z-Convert to float with given decimal separatorrv)rMstripreplace)rbdefaultrxrr _varsep_floatsz-FlexTemplate.parse_csv.._varsep_floatr-Tr.r/r0r1r2r3Fr4r5r6r7r8r9r:r;r<r=r>r?Nri)rwr[rrrCzMandatory value 'z' missing in csv datacSsg|]}|dqS)r-rU)rHvalrrr rIsz*FlexTemplate.parse_csv..)r_)rKrLrcrer+localegetpreferredencodingrkcsvreaderextendlenzipryrrTrP) r*rgrwrxrhr}rVrqrowZkargsrcfgvsrr|r parse_csvsT     zFlexTemplate.parse_csvcCsNt|ts tdt|jd||jkr%sz+FlexTemplate.__getitem__..) rrKrr.rFrPrQrUr)nextr+rrrr __getitem__s   zFlexTemplate.__getitem__c stfdd|jD}|js0t|_|jd}|drF|d7}|drX|d7}|drj|d 7}|j|d ||d |jj|d |d |d|dt||dddd|dddS)a Split a string between words, for the parts to fit into a given element width. Additional splits will be made replacing any '\n' characters. Arguments: text (string): The input text string. element_name (string): The name of the template element to fit the text inside. Returns: A list of substrings, each of which will fit into the element width when rendered in the element font style and size. c3s&|]}|dkr|VqdS)r-Nr)rHelement element_namerr r7sz/FlexTemplate.split_multicell..r~r5rr6rr7Ur3r4r1r/r2r0r:TLINESr?WORD)rDrBr;r:dry_runoutputr?) rr+rradd_pagernset_font multi_cellrK)r*r;rrstylerrr split_multicell(s.       zFlexTemplate.split_multicellrr~ helvetica ?Fr)r/r0r1r2r;r3r4scaler5r6r7r:r8r9r=r?c Osv|sdS|j}|jt| kr*|jt| |dkr8d}n d}|jt|krX|jt||}d}dD]<}| d|drl| d|drl|dd }||7}ql| r|d 7}| r|d 7}| r|d 7}| ||||| ||||||}}|dkr |j |||d | |dnR|r@|j|||d | ||dn2|j|||| |dddd }|j |||d | |ddS)NFTr~rrr<>|d|dr>|dd}||7}q>| r|d7}| r|d 7}| r|d 7}| ||||| ||| d || dS) Nr~rrrrrrrrrr) rrrrr ryrUrorrrwrite)r*r/r0r1r2r;r3r4rr5r6r7rr8rrrrrrrr r's( $   zFlexTemplate._writec Cst|jddd}|j|D]}|}|j|d|dd|d<|dkr|d||d<|d ||d <|d|d |d||d <|d |d |d ||d <|r|d||d<|d ||d <|r|d ||d <|d ||d <||d <|d }|r|j |||dd|kr|dr|j |d|d|d |j |f|W5QRXn|j |f|W5QRXq$d|kr|dr|j |d|d|d |j |f|W5QRXq$|j |f|q$W5QRXi|_dS)a` Add the contents of the template to the PDF document. Arguments: offsetx, offsety (float): Place the template to move its origin to the given coordinates. rotate (float): Rotate the inserted template around its (offset) origin. scale (float): Scale the inserted template by this factor. cSs|dS)Nr<r)r@rrr Mz%FlexTemplate.render..rr-r;r~rr/r0r1r2rr.r>N) sortedr+rZ local_contextcopyr)rnrUupperZrotationr() r*ZoffsetxZoffsetyr>rZsorted_elementsrZeleZ handler_namerrr renderAs:  "   zFlexTemplate.render)N)rf)rurvN)rrrr)rF __module__ __qualname____doc__r,r staticmethodrcreosPathLikerKrtrrsetrrrr r!r#r$r"r%r&r'rrrrr rs J  $ O , K     & (rc s8eZdZdZd fdd Zd d Zdfd d ZZS)Templatezr A simple templating class. Allows to apply a single template definition to all pages of a document. NA4portraitmmr~c s|rtjdttddD]$} tt| tstd| dqt|||d} | || || | | || | tj| |ddS) a Arguments: infile (str): [**DEPRECATED since 2.2.0**] unused, will be removed in a later version elements (list of dicts): A template definition in a list of dicts. If you omit this, then you need to call either load_elements() or parse_csv() before doing anything else. format (str): The page format of the document (eg. "A4" or "letter"). orientation (str): The orientation of the document. Possible values are "portrait"/"P" or "landscape"/"L" unit (str): The units used in the template definition. One of "mm", "cm", "in", "pt", or a number for points per unit. title (str): The title of the document. author (str): The author of the document. subject (str): The subject matter of the document. creator (str): The creator of the document. zD"infile" is deprecated since v2.2.0, unused and will soon be removedr)format orientationunittitleauthorsubjectcreatorkeywordsz Argument "z" must be of type str.)rrr)rr+N)rrrrrlocalsrKrr set_titleZ set_authorZ set_creator set_subject set_keywordssuperr,) r*rgr+rrrrrrrrargr __class__rr r,xs &      zTemplate.__init__cCs|jjr||jdS)z5Finish the current page, and proceed to the next one.N)rpagerr)r*rrr rszTemplate.add_pagecsV|rtjdttd|jjdddd|jjddd t|rR|j |d S) aa Finish the document and process all pending data. Arguments: outfile (str): If given, the PDF file will be written to this file name. Alternatively, the `.pdf.output()` method can be manually called. dest (str): [**DEPRECATED since 2.2.0**] unused, will be removed in a later version. zB"dest" is deprecated since v2.2.0, unused and will soon be removedrrrr^)rr4Fr)marginN) rrrrrrZset_auto_page_breakrrr)r*outfiledestrrr rs  zTemplate.render) NNrrrr~r~r~r~r~)NN)rFrrrr,rr __classcell__rrrr ros Ar)r __author__ __copyright__ __license__rrrlrr deprecationrerrorsrZfpdfrr rrrrrrr s(   Z