Q ?hS SrSrSSKJr SSKJrJrJrJrJ r J r J r SSK J r Jr SSKJr SSKJr SSKJr SS KJrJr SS KJr SS KJr SS KJr SS KrSSK J!r! Sr"\# S"Sjr%S\-r&S\-r'\ "S\SSS\'S9/r(\"/SQ5r)"SS\5r*Sr+"SS\5r,\,r-Sr."S S!\5r/g ! "SS\$5r#N^=f)#z4.2.1.1aExperimental class to generate Tables of Contents easily This module defines a single TableOfContents() class that can be used to create automatically a table of tontents for Platypus documents like this: story = [] toc = TableOfContents() story.append(toc) # some heading paragraphs here... doc = MyTemplate(path) doc.multiBuild(story) The data needed to create the table is a list of (level, text, pageNum) triplets, plus some paragraph styles for each level of the table itself. The triplets will usually be created in a document template's method like afterFlowable(), making notification calls using the notify() method with appropriate data like this: (level, text, pageNum) = ... self.notify('TOCEntry', (level, text, pageNum)) Optionally the list can contain four items in which case the last item is a destination key which the entry should point to. A bookmark with this key needs to be created first like this: key = 'ch%s' % self.seq.nextf('chapter') self.canv.bookmarkPage(key) self.notify('TOCEntry', (level, text, pageNum, key)) As the table of contents need at least two passes over the Platypus story which is why the multiBuild() method must be called. The levelParaStyle variables are the paragraph styles used to format the entries in the table of contents. Their indentation is calculated like this: each entry starts at a multiple of some constant named delta. If one entry spans more than one line, all lines after the first are indented by the same constant named epsilon. )cm) commasplit escapeOnce encode_label decode_labelstrTypes asUnicodeasNative)ParagraphStyle _baseFontName) sequencer) Paragraph)IndexingFlowable) TableStyleTable)Spacer) stringWidthcanvasN) literal_evalc&SSKJn U"USSS.5$)Nr)unescape'")z'z")xml.sax.saxutilsr)txtrs T/var/www/html/env/lib/python3.13/site-packages/reportlab/platypus/tableofcontents.pyunquoter<s) CC37 88c\rSrSrSrSrg)setCc:X;a[RX5 ggN)listappend)selfxs raddset.addDs} D#rN)__name__ __module__ __qualname____firstlineno__r)__static_attributes__r+rrr!r!Cs $rr!c "SRUVVs/sHupx[U5PM snn5n URSURSpURn [ XR U 5n X:- nX:a.U S:a(SU -n [ XR U 5n X:aU S:aM([ U[5(aPU(a*[ XQR U 5n[X:- U - U- 5nOS=nnUU-<U <3nUUU-- U - nX=- nOUc SU -nU nUnO [S 5eUR"UU 5nURUR U 5 URUR5 URU5 UR"U5 [ SUR U 5nUH]unnU(dM[ [U5UR U 5nUR "S UUU UU-XR"-4S S 9 UUU-- nM_ gs snnf) z Draws pagestr on the canvas using the given style. If dot is None, pagestr is drawn at the current position in the canvas. If dot is a string, pagestr is drawn right-aligned. If the string is not empty, the gap is filled with it. , cur_xcur_yg?g?rNz, z@Argument dot should either be None or an instance of basestring.)relative)joinstr _curr_tx_infofontSizerfontName isinstancerint TypeError beginTextsetFont setFillColor textColortextLinedrawTextlinkRectleading)rstylepages availWidth availHeightdot formatterp_pagestrr(yr;pagestrw freeWidthdotwdotsntextnewxpagextxcommawkeyws rdrawPageNumbersr]HsiiE2EDAQE23G    (&*>*>w*Gq~~H7NNH=H I  8s?>wA  8s? #x  sNNH=Dh.45E EDg.E$J&1% wZ[[   $ "BJJu~~x(OOEOO$KK OOB u~~x 8F3  A 9C%E!GQ}}_!EPQR V Q3sH r6g?zLevel 0 )namer<r;rGfirstLineIndent leftIndent))VALIGNrrrfTOP) RIGHTPADDINGrdrer) LEFTPADDINGrdrerch\rSrSrSrSrSrSrSrSr Sr S r SS jr S r S rSrSSjrSrg )TableOfContentsaThis creates a formatted table of contents. It presumes a correct block of data is passed in. The data block contains a list of (level, text, pageNumber) triplets. You can supply a paragraph style for each level (starting at zero). Set dotsMinLevel to determine from which level on a line of dots should be drawn between the text and the page number. If dotsMinLevel is set to a negative value, no dotted lines are drawn. c URSS5UlURS[5UlURS[5UlURSS5UlURSS5UlURSS 5UlU(a+[S S RUR55-5eSUl /Ul /Ulg) NrightColumnWidthH levelStyles tableStyle dotsMinLevelr6rM notifyKindTOCEntryzunexpected keyword arguments %sr2)poprndefaultLevelStylesrpdefaultTableStylerqrrrM _notifyKind ValueErrorr8keys_table_entries _lastEntries)r'kwdss r__init__TableOfContents.__init__s $);B ?88M2DE((<0AB HH^A6+d388L< z"CdiiPTPYPYP[F\"\]]  rcLURSSUlUR5 gr$)r|r} clearEntriesr's r beforeBuildTableOfContents.beforeBuilds MM!, rcgNr6r+rs r isIndexingTableOfContents.isIndexingrc4URUR:H$r$r|r}rs r isSatisfiedTableOfContents.isSatisfied !2!223rcBXR:XaUR"U6 gg)zThe notification hook called to register all kinds of events. Here we are interested in self._notifyKind (default TOCEntry) events only. N)rxaddEntry)r'kindstuffs rnotifyTableOfContents.notifys! ## # MM5 ! $rc/Ulgr$r|rs rrTableOfContents.clearEntries  rc 4URU$![a| URUS- 5nURR[ SUR U4-UUR [-UR[-S95 URUs$f=f)VReturns the style for level n, generating and caching styles on demand if not present.r6%s-%d-indentedr`parentrarb) rp IndexError getLevelStyler&r r`radeltarbr'n prevstyles rrTableOfContents.getLevelStyles '##A& & '**1Q3/I    # #N)Y^^Q,??$&/&?&?&E!*!5!5e!; %= > ##A& & 'sBBBNc|[U5[S5:XdS5eURRXX445 g)zAdds one entry to the table of contents. This allows incremental buildup by a doctemplate. Requires that enough styles are defined.r6zLevel must be an integerN)typer|r&)r'levelrVpageNumr[s rrTableOfContents.addEntrys7 E{d1g%A'AA% e789rc4UHnUR"U6 M g)zBulk creation of entries in the table of contents. If you knew the titles but not the page numbers, you could supply them to get sensible output on the first run.N)r)r' listOfEntries entryargss r addEntriesTableOfContents.addEntriess 'I MM9 %'rc^^^[TR5S:XaS/nO TRnUUU4SjnUTRl/nUHupgpTR U5n U (a7SU <SU<S3n[ U 5R SS5R S S5n OS n [S XxXk4-U 5n U R(a&UR[S U R5/5 URU /5 M [UT4TRS 9Tl TRRTRTT5uTlTlTRTR 4$),All table properties should be known by now.r)rz!Placeholder for table of contentsrNcL>URS5n[US5[US5[US5pTnT RU5nT RS:aUT R:aSnOSnT R (aT R U5n[ XX54/T TU5 g)8Callback to draw dots and page numbers after each entry.,rr6 . r5N)splitr>rrrrrMr]) rrlabelpagerr[rHrLrKrJr's rdrawTOCEntryEnd-TableOfContents.wrap..drawTOCEntryEndsKK$E"58}c%(m\%PQ(=SD&&u-E  A%%43D3D*D~~dnnT&:t FTK=*kSV Wrz zrz\x2crNz3%sr6 colWidthsrH)lenr}canvrrreprreplacer spaceBeforer&rrrqr{wrapOnwidthheight) r'rJrK _tempEntriesr tableDatarrVrr[rHkeyValparas ``` rwrapTableOfContents.wraps9 t  !Q &JKL,,L X%4 ! +7 'U'&&u-E14d;c**3w7??GLRVZejUssuz{D    &E,=,=">!@A   dW %,8I*dooV "&++"4"4TYYz;"W DK DKK((rcNURRURX5$zAt this stage we do not care about splitting the entries, we will just return a list of platypus tables. Presumably the calling app has a pointer to the original TableOfContents object; Platypus just sees tables. )r{splitOnrr'rJrKs rrTableOfContents.splits {{""499ZEErc<URRXX45 gzDon't do this at home! The standard calls for implementing draw(); we are hooking this in order to delegate ALL the drawing work to the embedded table object. N)r{drawOnr'rr(rQ_sWs rrTableOfContents.drawOns 6a-r) r|r}rxr{rrrMrrprnrqrr$r)r,r-r.r/__doc__rrrrrrrrrrrrr0r+rrrkrksE   4" ':&))XF.rrkcT[U[[45(a [U5$U4$r$)r=r%tuple)r(s r makeTupler!s#!T%L!!Qx 4Krc\rSrSrSrSrSrSSjrSr\ R4Sjr S r S r S rS rS rSSjrSrS/\"S54/4SjrSrSrSSjrSrSrSrg) SimpleIndexi&zdCreates multi level indexes. The styling can be cutomized and alphabetic headers turned on and off. c 0Ul0UlSUlURSS5UlUR "S0UD6 g)zM Constructor of SimpleIndex. Accepts the same arguments as the setup method. Nrs IndexEntryr+)r|r} _flowablerurxsetup)r'kwargss rrSimpleIndex.__init__+s<  !::l<@ Vrcb[[SU-5$![a [SU-5ef=f)Nz _format_%szUnknown sequencer format %r)getattr rl_sequencer ImportErrorry)r' formatNames r getFormatFuncSimpleIndex.getFormatFunc7s< I< z(AB B I:ZGH H Is.NcUc[S[SS9nXlU=(d [UlX lX@lUcSSKJn XPl URU5Ul Xpl g)a! This method makes it possible to change styling and other parameters on an existing object. style is the paragraph style to use for index entries. dot can either be None or a string. If it's None, entries are immediatly followed by their corresponding page numbers. If it's a string, page numbers are aligned on the right side of the document and the gap filled with a repeating sequence of the string. tableStyle is the style used by the table which the index uses to draw itself. Use this to change properties like spacing between elements. headers is a boolean. If it is True, alphabetic headers are displayed in the Index when the first letter changes. If False, we just output some extra space before the next item name makes it possible to use several indexes in one document. If you want this use this parameter to give each index a unique name. You can then index a term by refering to the name of the index which it should appear in: format can be 'I', 'i', '123', 'ABC', 'abc' Nindexr_)r`r<r;r)DEFAULT_INDEX_NAME) r r textStylerwrqrLheadersreportlab.platypus.paraparserrr`r formatFuncoffset)r'rHrLrqrr`formatrs rrSimpleIndex.setup=s]* ="1>135E$9(9 < P ,,V4 rc[US5n[U5upEnUc URnOURU5nUc URn[ U5nUR 5nU"X- 5n SUR<SU<SU <3n URn URXSU SU S-5 URXHU 4U 5 g! UnS=pVN=f)Nlatin1ix_rO_p_r3r4rG) r rrrrr getPageNumberr`r:bookmarkHorizontalr) r'rrrtermsrrrcPNpnsr[infos r__call__SimpleIndex.__call__`sx( #$0$7 !E6 >J++F3J >[[F5!  "$!%E37!! ']DMDO4ST e#Y,# #E" "FVs CCc^^UU4SjnU$)NcR>SSKJn T"U0UD6n[UTRT5 U$)Nrr)reportlab.pdfgenrsetattrr`)argsrrc canvasmakerr's rnewcanvasmaker2SimpleIndex.getCanvasMaker..newcanvasmakerys* /T,V,A Adii %Hrr+)r'rrs`` rgetCanvasMakerSimpleIndex.getCanvasMakerws  rcgrr+rs rrSimpleIndex.isIndexingrrc4URUR:H$r$rrs rrSimpleIndex.isSatisfiedrrcbURR5UlUR5 gr$)r|copyr}rrs rrSimpleIndex.beforeBuilds# MM..0 rc0Ulgr$rrs rrSimpleIndex.clearEntriesrrcXR:Xa0Uup4URX0RR5U45 gg)zThe notification hook called to register all kinds of events. Here we are interested in self._notifyKind (default IndexEntry) events only. N)rxr_canvr)r'rrrVrs rrSimpleIndex.notifys: ## #!MD MM$!9!9!;G D E $rcURR[U5[/55R X#45 g)zAllows incremental buildupN)r| setdefaultrr!r))r'rVrr[s rrSimpleIndex.addEntrys+   4R9==wnMrcNURRURX5$r)rrrrs rrSimpleIndex.splits ~~%%dii HHrzPlaceholder for index)NNNcUR=(d URnU(dU$[[UR 555$)zAReturn the last run's entries! If there are none, returns dummy.)r}r|r%sorteditems)r'dummylEs r_getlastEntriesSimpleIndex._getlastEntriess4    /$--LF288:&''rc ^^^^TR5VVs/sHup4[SU55U4PM nnnSnURUS9 TR=(a S=(d SmUUUU4SjnUTRlSn/n /n TR S5n UGHup4[U5nSRS[R"S USSR5555n X:waU nTR(aUn OS n U R[SU R5/5 U R[X5/5 U R[SU R 5/5 [#X5upU(aUn X>Sn[%[U55nUS <S U<S 3US 'UH|n['U5nTR UT-5n[UU5nUR(a&U R[SUR5/5 U RU/5 US- nM~ GM [)U T/TR*S9Tlgs snnf)Nc38# UHn[U5v M g7fr$)r ).0ts r %SimpleIndex._build..s;Uy||Usc USVs/sH>nSRS[R"SUR5555PM@ sn$s snf)Nrr5c3^# UH#n[R"U5S:wdMUv M% g7fMnN unicodedatacategoryr&rs rr(5SimpleIndex._build..getkey..s)s(O1S^SgSghiSjnrSrQQ(O- -NFD)r8r/ normalizeupper)seqr(s rgetkey"SimpleIndex._build..getkeyseBCDEFEyzBGGs (=(=eQWWY(OstEF FFsAA)r[r6rc>T RT 5n[[U55VVs/sH upEUSU4PM nnn[XUTTT R5 gs snnf)rr6N)rrrr]rL) rrrrHrNkrIrKrJ leveloffsetr's rdrawIndexEntryEnd-SimpleIndex._build..drawIndexEntryEndsW&&{3E)/ U0C)DE)D#!ad1X)DEE F5*k488 TFsAr5c3^# UH#n[R"U5S:wdMUv M% g7fr,r.r1s rr(r)s)~)ZA^i^r^rst^uy}^}aa)Zr3r4 rfz(r)r"rsortrrr=rr%r8r/r5r6r&rrr spaceAfterlistdiffrrrrqr)r'rJrKtexts pageNumbersrr8r=alphar lastTexts alphaStylenalphaheaderidiffrrVrHrr<s``` @r_buildSimpleIndex._builds36:6J6J6LN6L 2;U;;KH6L N Ff%ll(q-A  U U '8 #  ''* ". EKEWW~)>)>ueAhqkFWFWFY)Z~F<<"F F  &J,B,B"C!EF  )F"?!AB  &J,A,A"B!DEy0GA! b  k!23EMRSUYX]^E"I"$'**1[=9 u-$$$$fQ0A0A&B%DE  $)Q/#/HyZLXmNs IcURX5 URRURX5uUlUlURUR 4$)r)rMrrrrrrs rrSimpleIndex.wrapsD J+"&.."7"7 *"Z DKzz4;;&&rc<URRXX45 gr)rrrs rrSimpleIndex.drawOns f0rcURn[USS5nU(dURUlUR5 U(dU?gg!U(dU?ff=f)Nr)rrrdraw)r'r'ocanvs rrTSimpleIndex.drawsP NN&&YYAF  FFHF5Fs A Ac [URS5(dUR/UlURU$![a [UR5UlUR US- 5nURR [ SURU4-UURS[--URS[--S95 URUs$f=f)r__iter__r6rg?r) hasattrrrr%rr&r r`rarrbrs rrSimpleIndex.getLevelStylest~~z22"nn-DN %>>!$ $ %!$..1DN**1Q3/I NN ! !.)Y^^Q,??$&/&?&?2&E!*!5!5be!; #= > >>!$ $ %s>B#C$#C$) r|rr}rxrLrrrr`rrqrr)NNNTN123rr$r)r,r-r.r/rrrrrrCanvasr rrrrrrr enumerater"rMrrrTrr0r+rrrr&s I !F-.*04 FNI(?&? )@T%U$V(7Yr' 1 %rrc[[U5[U55n[U5HnXX:wdMX1US4s $ X!US4$r$)minrrange)l1l2mrKs rrCrCsM CGSWA 1X 5BE>f9  f9rc:\rSrSrSrSrSrSrSrS Sjr Sr g ) ReferenceTextizRFakery to illustrate how a reference would work if we could put it in a paragraph.cfXlX l[S5UlSUlSUlSUlg)Ntmpi) textPatterntargetr paraStyle _lastPageNum_pageNum_para)r'rh targetKeys rrReferenceText.__init__s/& '.   rc&URUlgr$)rlrkrs rrReferenceText.beforeBuild s MMrcFUS:XaUup4X0R:XaX@lggg)NTarget)rirl)r'rrr[rs rrReferenceText.notify#s* 8 "NSkk! ' " rcURUR-n[X0R5UlURR X5$r$)rhrkrrjrmr)r'rJrKrVs rrReferenceText.wrap)s;$"3"33t^^4 zzz77rc<URRXX45 gr$)rmrrs rrReferenceText.drawOn.s &Q,r)rkrlrmrjrirhNr) r,r-r.r/rrrrrrr0r+rrreres *( 8 -rre)rN)0 __version__rreportlab.lib.unitsrreportlab.lib.utilsrrrrrr r reportlab.lib.stylesr r reportlab.libr rreportlab.platypus.paragraphrreportlab.platypus.doctemplaterreportlab.platypus.tablesrrreportlab.platypus.flowablesrreportlab.pdfbase.pdfmetricsrrrr/astrrr!r%r]repsilonrvrwrkrrAlphabeticIndexrCrer+rrrs  ' R#qqq>32;7/4#9$4v " b&  I.&I.V d%"d%L-$-g$$d$s B00 B?