@wgb! dZddlmZmZmZmZmZddlmZddl m Z ddl m Z m Z mZmZmZdedefd Zd edefd Zd edefd Zd edefd Zde dedefdZdededefdZdede de ddfdZdedede ddfdZdede deeeee ffdZy)u Page labels are shown by PDF viewers as "the page number". A page has a numeric index, starting at 0. Additionally, the page has a label. In the most simple case: label = index + 1 However, the title page and the table of contents might have Roman numerals as page labels. This makes things more complicated. Example 1 --------- >>> reader.root_object["/PageLabels"]["/Nums"] [0, IndirectObject(18, 0, 139929798197504), 8, IndirectObject(19, 0, 139929798197504)] >>> reader.get_object(reader.root_object["/PageLabels"]["/Nums"][1]) {'/S': '/r'} >>> reader.get_object(reader.root_object["/PageLabels"]["/Nums"][3]) {'/S': '/D'} Example 2 --------- The following is a document with pages labeled i, ii, iii, iv, 1, 2, 3, A-8, A-9, ... 1 0 obj << /Type /Catalog /PageLabels << /Nums [ 0 << /S /r >> 4 << /S /D >> 7 << /S /D /P ( A- ) /St 8 >> % A number tree containing % three page label dictionaries ] >> ... >> endobj §12.4.2 PDF Specification 1.7 and 2.0 ===================================== Entries in a page label dictionary ---------------------------------- The /S key: D Decimal Arabic numerals R Uppercase Roman numerals r Lowercase Roman numerals A Uppercase letters (A to Z for the first 26 pages, AA to ZZ for the next 26, and so on) a Lowercase letters (a to z for the first 26 pages, aa to zz for the next 26, and so on) )IteratorListOptionalTuplecast)PdfCommonDocProtocol)logger_warning) ArrayObjectDictionaryObject NullObject NumberObjectis_null_or_nonenumreturnc~gddtdttffd }djt ||S)N) )iM)iCM)iD)iCD)dC)ZXC)2L)(XL) X) IX)V)IV)rIrrc3lKD]*\}}t||\}}||z|||zz}|dks*yyw)Nr)divmod)rdecimal roman_reprx_romans I/var/www/horilla/myenv/lib/python3.12/site-packages/pypdf/_page_labels.py roman_numz1number2uppercase_roman_numeral..roman_num[sM#(  GZ#w'DAqq. 7Q; Cax  s,44)intrstrjoinlist)rr0r.s @r/number2uppercase_roman_numeralr6Js; E sx} 774 #' ((numberc4t|jSN)r6lowerr8s r/number2lowercase_roman_numeralr=fs )& 1 7 7 99r7c|dkr tdttdtddzDcgc] }t|}}d}|dkDr'|dz}|dk(rd}||dz |z}||z}|dz}|dkDr'|Scc}w)NrzExpecting a positive numberAZrr1) ValueErrorrangeordchr)r8ialphabetrep remainders r/number2uppercase_letterrJjs {677 %c#hC1 =>1A>H> C 1*RK >Iy1}%+)2 1* J?sA8c4t|jSr:)rJr;r<s r/number2lowercase_letterrLzs "6 * 0 0 22r7dictionary_objectindexctt|d}d}d}d}|t|krM||}||dzj}|dzt|k(rn ||dz|kDrn|dz }|t|krMddtt t td}t|tst|dzS|jdd}|jd d }|||jd ||z |zzS) N/Numsrrcy)Nr1ns r/z%get_label_from_nums..sr7ct|Sr:)r3rTs r/rVz%get_label_from_nums..s Ar7)Nz/Dz/Rz/rz/Az/az/Stz/Pr1z/S) rr len get_objectr6r=rJrL isinstancedictr3get) rMrNnumsrFvalue start_indexmstartprefixs r/get_label_from_numsrc~s   .w7 8D A EK c$i-1g QU &&( q5CI   A;   Q c$i-,,%%  A eT "519~ IIeQ E YYtR F &Aeiio&u{':U'BC CCr7readercltt|j}d|vrt|dzStt|dj }d|vr t ||Sd|vrt |dtsd}|dkrttt|d}|D]r}ttt|d}|d|cxkr |dks/n2t|jdds|dz }|dk(r td |}nt ||cSn|dkrtd |d tt|dzS) z See 7.9.7 "Number Trees". Args: reader: The PdfReader index: The index of the page Returns: The label of the page, e.g. "iv" or "4". z /PageLabelsrrPz/Kidsrrz/LimitsNz"Too deep nesting is not supported.z,Could not reliably determine page label for .)rr root_objectr3rYrcrZr rr2rr\NotImplementedErrorr __name__)rdrNroot number_treelevelkidskidlimitss r/ index2labelrpsN  &"4"4 5DD 519~'m)<)G)G)IJK+";66+jW1Ez&Rck-. G0DED d3iY8!922*3777D+AB  C<"5 D#'* .sE:: &+ck.A%JHU uqy>r7keyr^r]Nc*t|dzdk7r tdt|}|dk7r!|||dz kr|dz }|dk7r |||dz kr|t|kr|||k(r |||dz<y|j|||j|dz|y)z Insert a key, value pair in a Nums array. See 7.9.7 "Number Trees". Args: key: number key of the entry value: value of the entry nums: Nums array to modify rQr6A nums like array must have an even number of elementsrN)rXrBinsert)rqr^r]rFs r/ nums_insertrus  4y1}QRR D A q&SDQK' E q&SDQK' 3t9}QQU  As AE5!r7 page_index_toc(t|dzdk7r td||kr td|j|dz}|t|krD|||kr;|j||j||t|kr |||kr9yyyy)a Remove all entries in a number tree in a range after an entry. See 7.9.7 "Number Trees". Args: key: number key of the entry before the range page_index_to: The page index of the upper limit of the range nums: Nums array to modify rQrrsz/page_index_to must be greater or equal than keyN)rXrBrNpop)rqrvr]rFs r/nums_clear_rangerys  4y1}QRRsJKK 3!A c$i-DG}4     c$i-DG}4-4-r7ct|dzdk7r td|j|dz}|t|kr ||||dzfSy)z Return the (key, value) pair of the entry after the given one. See 7.9.7 "Number Trees". Args: key: number key of the entry nums: Nums array rQrrsr)NN)rXrBrN)rqr]rFs r/ nums_nextr{ sW 4y1}QRR 3!A3t9}Qa!e%%r7)__doc__typingrrrrr _protocolsr _utilsr genericr r r rrr2r3r6r=rJrLrcrpruryr{rSr7r/rs1:x98,")))8:3:3: C C  3C3C3!D+;!DC!DC!DH.,.S.S.b" " " " "<   6   8L !8,<#= =>r7