i92i/fSrSrSrSrSSKrSSKrSSKrSSKrSSKrSSK J r SSK J r SS K Jr S rS r"S S 5r"SS\5rg)zj PDF template helpers for fpdf2. Usage documentation at: z%Mariano Reingart z#Copyright (C) 2010 Mariano ReingartzLGPL 3.0N)get_stack_level) FPDFException)FPDFc$US-US-S-US-4$)Ni)cols G/home/james-whalen/.local/lib/python3.13/site-packages/fpdf/template.py_rgbr s 5LC3J,c ::c[U5upnUS:Xa US:XaUS:XdUS:Xa US- SS3$US- SSUS- SSUS- SS3$)Nrz.3fz g z rg)r )r rgbs r _rgb_as_strrsf3iGA! Q16a1fbc'#b!!#gc]!AGC=!c'#c ::r c\rSrSrSrS-SjrSr\S5r\S5r S.S\ RS \ 4S jjr S/S\ RS \ S \ S \ 4S jjrSr\rSrSrSrSSSSSSSSSSSSSSSSS.SjrSSSSSSSSS.SjrSSSSSSSSSS. SjrSSSSSSSSSS. SjrSSSSSS .S!jrSSSSSS"S#SSS$. S%jrSSSSS&SSSSSSS'. S(jrSSSSSSSSSSSSSS). S*jrS0S+jrS,rg)1 FlexTemplatez A flexible templating class. Allows to apply one or several template definitions to any page of a document in any combination. Usage documentation at: Nc \[U[5(d [S5eXlSUlU(aUR U5 UR URURURURURURURS.Ul0Ulg)a Args: pdf (fpdf.fpdf.FPDF): All content will be added to this `FPDF` instance. elements (list[dict]): 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)selfr$elementss r __init__FlexTemplate.__init__'s#t$$FG G!    x (--<<    r c H0S[[S54_S[[S54_S[[4_S[[4_S[[4_S[[4_S[[S54_S [[4_S [_S [_S [_S [_S[_S[[S54_S[[S54_S[_S[ [S54_[[4[[S54[ [S54S.EnXl/UlUGHnSU;aSUS'SHhnXC;dM USS:XaHUS:XaSU;a USUS'M)US:XaSU;a USUS'M?US:XaSU;aUSUS-US'M[[SUS35e SU;aUSS;aSUS'O [S5eS U;aUSS:XaSU;aUSUS 'SU;ahUSR5HnUS ;dM [S!US"35e S#US;aSUSS#'S$US;aUSS#USS$'S%US;aSUSS%'UR5HupEXC;dM [X4U5(aM![U[5(a URO/S&RUVs/sHnS'URS'3PM sn5n[S(US)US*[X45RS+35e URRUSR!55 GM gs snf),zk Load a template definition. Args: elements (list of dicts): A template definition in a list of dicts nameNtypex1y1x2y2fontsizebolditalic underline foreground backgroundaligntextpriority multiline)rotatewrapmode dash_patternr)r6r7r8r9r;r xyhzMandatory key 'z' missing in input datarr z(Mandatory key 'x2' missing in input datawrI)dashgapphasez Invalid key 'z' in dash_patternrOrPrQz or 'zValue of element item 'z ' must be z, not ''.)strr7intfloatobjectbooldictr2keysKeyErroritemsr"__name__joinr#appendlower)r1r2 key_configektrJttypes r r&FlexTemplate.load_elementsAs S$t*%  S$t*%  3,  3,  3,   3,  S$t*%  S%L  F  f    #  #  c4:& S$t*%! " # $ $T +% &Eld4j)!4:.+ 0!  A? !* 7:yE)9&'fAdG$9&'fAdG$9&'g#&6AdG$"_QC7N#OPP8"1}V9 -AdG"#MNNQ;1V9#5!8 !#AfI">*//1A 88&qc9J'KLL2>!2201An%f-. 11/0/@/HAn%e,!N"3312An%g."((*6*QT1"5"5&a.. #[[Q)GQAajj\*;Q)GH $1!JugWTRSRVZM`M`Laacd+ II  QvY__. /eZ*Hs L clUSSS;a [US5$USS:Xa [US5$[U5$)z#Allow hex and oct values for colorsN)0x0Xr0rU)ss r _parse_colorcodeFlexTemplate._parse_colorcodes> Ra5L q":  Q43;q!9 1v r c6[U5nUS:agUS:agg)NrTFrn)rois r _parse_multilineFlexTemplate._parse_multilines" F q5 q5r infileencodingcl[XS9n[R"U5nUHnURS5nU(aW[ U[ 5(aBUR 5RS5(a[USSS5US'O [S5eURS5nU(dM[ U[ 5(dMUR 5RS5(a[USSS5US'M[S 5e URU5 SSS5 g!,(df  g=f) aP 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(), Args: infile (str, path-like object): The filepath of the JSON file. encoding (str): The character encoding of the file. Default is UTF-8. rwrA#rNrkz;If foreground is a string, it must have the form '#rrggbb'.rBz;If background is a string, it must have the form '#rrggbb'.) openjsonloadgetr"rTr` startswithrU ValueErrorr&)r1rvrwfdatadfgvalbgvals r parse_jsonFlexTemplate.parse_jsons& ,99Q[UR5=(d URTS55$)z-Convert to float with given decimal separator.)rVstripreplace)rodefaultrs r _varsep_float-FlexTemplate.parse_csv.._varsep_floats(!'').w77 SIJ Jr r6Tr7r8r9r:r;r<Fr=r>r?r@rArBrCrDrErFrGrHNry)rrhrrrMzMandatory value 'z' missing in csv data)rl)rTrUrprtr2localegetpreferredencodingr{csvreaderextendlenziprrr_r`rZ) r1rvrrrwrrarrowkargsvalcfgvss ` r parse_csvFlexTemplate.parse_csvs( KS$  S$  =$ ' =$ ' =$ ' =$ ' S% ]E * S% sE " #u % 400% 8 400% 8 c5 ! S% e $ $// 7 }e , e $) ,  224H & ,zz!9 B43z?SX#=>? #C 4HCBq6"1v~#a&M2I $&3&7Ax?T$U'"!"!Vz101E*-2 ),Ar !f !!5" $$U++:-.59MMBMS[&&(MB /- ,.CsC G!<G2! G/c[U[5(dS[U5RS35eUR 5UR ;a[ SU35eX RUR 5'g)N!name must be of type 'str', not 'rSz%Element not loaded, cannot set item: )r"rTr7r]r`rZrr0)r1r6values r __setitem__FlexTemplate.__setitem__su #   G .tDz/B/B.C2 F G  ::# UH"oSR5T:XdMUSv M$ g7f)r6rDNr`).0rJkeys r +FlexTemplate.__getitem__..0s' J 161Bc1IYQvY s- -) r"rTr7r]rZr[r`r0nextr2)r1r6rs @r __getitem__FlexTemplate.__getitem__$s #   G .tDz/B/B.C2 F G  yy 4. jjl $** ::c? " J JD  r c T^[U4SjUR55nUR(d)[5UlURR 5 SnUR S5(aUS- nUR S5(aUS- nUR S5(aUS- nURR US XCS 5 URRUS US - US US- [U5UR SS5SSUR SS5S9$)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. Args: text (str): The input text string. element_name (str): 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. c3v># UH.nUSR5TR5:XdM*Uv M0 g7f)r6Nr)relement element_names r r/FlexTemplate.split_multicell..@s8 (v$$&,*<*<*>> G(s)9 9rr>rr?rr@Ur<r=r:r8r;r9rCTLINESrHWORD)rNrLrDrCdry_runoutputrH) rr2r%radd_pager~set_font multi_cellrT)r1rDrrstyles ` r split_multicellFlexTemplate.split_multicell3s ==   !!!%D     ' ' ) ;;v   SLE ;;x SLE ;;{ # # SLE ##GFOUFOL!!,,dmgdm+dmgdm+T++gr*[[V4-  r rr helvetica ?Fr)r8r9r:r;rDr<r=scaler>r?r@rCrArBrFrHc <U(dgURnUR[U 5:waUR"[ U 56 UcSnO3SnUR [U5:waUR "[ U56 UR5R5nSnSHEnURSUS35(dMURSUS35(dM;USS nUU- nMG U (aUS - nU (aUS - nU (aUS - nURUUXx-5 URX5 X1- XB- nnUcURUUUS U US9 gU(aURUUUS U UUS9 gURUUUU USSS9S nURUUUS U US9 g)NFTrrrr<>r?r@rCrArBrFrH___r$rrtagwidthheights r r'FlexTemplate._textZs* hh >>[4 4   Z 0 1  DD~~Z!88""D$45zz|!!# C3%qz**t}}r#a[/I/IAbz !  SLE  SLE  SLE T5$,/ 2v   HHuT!5tH T  NN!  >>!"D HHuT!5tH Tr )r8r9r:r;r=rrArIcURRR5R5[ U5:wa"URR "[ U56 URRXV-5 Ub2URRn URR"S0UD6 URRXX45 UbURR"S0W D6 gg)Nr ) r$ draw_color serializer`rset_draw_colorr set_line_widthrIset_dash_patternline) r1r8r9r:r;r=rrArIrrrestore_dash_patterns r r(FlexTemplate._lines 88   ( ( * 0 0 2k*6M M HH # #T*%5 6  -  ##'88#8#8 HH % % 5 5  bb%  # HH % % =(< = $r ) r8r9r:r;r=rrArBrIc URn U RR5R5[ U5:waU R "[ U56 UcSn O3Sn U R[ U5:waU R"[ U56 U RXV-5 U b(URRnU R"S0U D6 U RXX1- XB- U S9 U bURR"S0WD6 ggNDFD)rr ) r$rrr`rrr rrrrIrrectr1r8r9r:r;r=rrArBrIrrr$rrs r r*FlexTemplate._rectshh >> # # % + + -Z1H H   Z 0 1  EE~~Z!88""D$45 4<(  ##'88#8#8  0< 0 "'7  # HH % % =(< = $r c URn U RR5R5[ U5:waU R "[ U56 UcSn O3Sn U R[ U5:waU R"[ U56 U RXV-5 U b(URRnU R"S0U D6 U RXX1- XB- U S9 U bURR"S0WD6 ggr) r$rrr`rrr rrrrIrellipsers r r+FlexTemplate._ellipseshh >> # # % + + -Z1H H   Z 0 1  EE~~Z!88""D$45 4<(  ##'88#8#8  0< 0 BBGRWE :  # HH % % =(< = $r )r8r9r:r;rDc VU(a"URRXQX#U- XB- SS9 gg)Nr)rNrLlink)r$image)r1r8r9r:r;rDrrs r r)FlexTemplate._images(  HHNN4R7bgBN G r interleaved 2of5 ntr) r8r9r:r;rDr<r=rrAc ,URn U RR5R5[ U 5:waU R "[ U 56 UR5R5nUS:XaU RXQX'U-XB- S9 gg)Nr)rNrL) r$rrr`rrr rinterleaved2of5) r1r8r9r:r;rDr<r=rrArrr$s r r,FlexTemplate._barcodeshh >> # # % + + -Z1H H   Z 0 1zz|!!# ( (   "u   H )r g?) r8r9r;rDr=rrArJrKrNrLc VUc U cU cU b"[R"S[[5S9 URnUR R 5R5[U5:waUR"[U56 X2- n U S::aSn URXAX%U-U 5 g)NzVcode39 arguments x/y/w/h are deprecated since v2.4.4, please use x1/y1/y2/size instead stacklevelr) warningswarnDeprecationWarningrr$rrr`rrr code39)r1r8r9r;rDr=rrArJrKrNrLrrr$s r r-FlexTemplate._code39s =AMQ]am MM8#*,  hh >> # # % + + -Z1H H   Z 0 1 G 6A 4Rq1r ) r8r9r:r;rDr<r=rr>r?r@rrAc U(dgURnUR[U 5:waUR"[ U 56 UR 5R 5nSnSHEnURSUS35(dMURSUS35(dM;USSnUU- nMG U (aUS- nU (aUS - nU (aUS - nURUUXx-5 URX5 URS X\5 g) Nrrrrrrrrrrr) r$rrrr rr`rrrrwrite)r1r8r9r:r;rDr<r=rr>r?r@rrArrr$rrs r r.FlexTemplate._write7s& hh >>[4 4   Z 0 1zz|!!# C3%qz**t}}r#a[/I/IAbz !  SLE  SLE  SLE T5$,/ 2 !T r c [URSS9nURR5 UGHnUR 5nUR R USR5UR SS55US'US:waDUSU-US'USU-US'USUS US- U--US 'USUS US- U--US 'U(aUSU-US'US U-US 'U(aUSU-US'US U-US 'XGS 'US R5nU(aURRX1U5 S U;aOUS (aEURRUS USUS5 URU"S0UD6 SSS5 OURU"S0UD6 SSS5 GMS U;aQUS (aGURRUS USUS5 URU"S0UD6 SSS5 GMURU"S0UD6 GM SSS5 0Ulg!,(df  N=f!,(df  GM*=f!,(df  GM==f!,(df  NM=f)a( Add the contents of the template to the PDF document. Args: 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. c US$)NrEr )rJs r %FlexTemplate.render..hsa mr )rr6rDrrr8r9r:r;rr7rGNr ) sortedr2r$ local_contextcopyr0r~r`upperrotationr/) r1offsetxoffsetyrGrsorted_elementsrele handler_names r renderFlexTemplate.render_sa!4KL XX # # %*lln"jjnnS[->->-@#''&RTBUVF C< #D E 1CI #D E 1CI #D c$i'$-.G5-P QCI #D c$i'$-.G5-P QCI #D G 3CI #D G 3CI #D G 3CI #D G 3CI$G "6{002 **6GD#s?s8}!%!2!23x=#d)SQUY!W $ l ; Bc B"X!W!MM,7>#> ED 33x=!XX..s8}c$iTS MM,7>#>TS l3:c:9+&< "X!WEDTS5& %sUDI37I <H< I 0AI31I %I3< I I  I  I3 I0 * I33 J)r2r/rZr$r%r0)N)zutf-8),rN)rrr)r] __module__ __qualname____firstlineno____doc__r3r& staticmethodrprtosPathLikerTrrrsetrrrr'r(r*r+r)r,r-r.r__static_attributes__r r r rrs4S0j%%%D IC ICIC IC  ICV) C)  % T    %FUV >6 >F >@!abH  " I2      2L     &!P(r rcZ^\rSrSrSrSU4SjjrSrSU4SjjrSrU=r $) Templateiz A simple templating class. Allows to apply a single template definition to all pages of a document. Usage documentation at: c >U(a"[R"S[[5S9 SH2n [ [ 5U [ 5(aM%[SU S35e [X4US9n U RU5 U RU5 U RU 5 U RU5 U RU 5 [T U]=XS9 g) a$ Args: infile (str): [**DEPRECATED since 2.2.0**] unused, will be removed in a later version elements (list[dict]): 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.)r"r#r$)r$r2N)rrrrr"localsrTr#r set_title set_author set_creator set_subject set_keywordssuperr3)r1rvr2r"r#r$r%r&r'r(r)argr$ __class__s r r3Template.__init__s:  MMV"*,   CfhsmS11*SE1G HII  &E e v     " S4r cURR(aUR5 URR5 g)z5Finish the current page, and proceed to the next one.N)r$pagerr)r1s r rTemplate.add_pages& 88== KKM r c$>U(a"[R"S[[5S9 URR SSSS9 URR SSS 9 [TU]!5 U(aURRU5 g g ) a* Finish the document and process all pending data. Args: 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 removedrrrrk)rr=Fr)marginN) rrrrr$rset_auto_page_breakr0rr)r1outfiledestr2s r rTemplate.renderst  MMT"*,  +Sr: $$U1$5   HHOOG $ r r ) NNA4portraitmmrrrrr)NN) r]rrrrr3rrr __classcell__)r2s@r r r s= 65p%%r r )r __author__ __copyright__ __license__rrr|rr deprecationrerrorsrfpdfrr rrr r r r rGsR 5 5  &&&(!;;j j Z]%|]%r