h dZddlmZmZmZddlmZddlmZddl m Z m Z m Z de defd Zd e defd Zd e defd Zd e defd Zdede defdZde de de ddfdZde de de ddfdZde de deee ee ffdZdS)u5 Page labels are shown by PDF viewers as "the page number". A page has a numeric index, starting with 0. Additionally to that, 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 label. This makes things more complicated. Example 1 --------- >>> reader.trailer["/Root"]["/PageLabels"]["/Nums"] [0, IndirectObject(18, 0, 139929798197504), 8, IndirectObject(19, 0, 139929798197504)] >>> reader.get_object(reader.trailer["/Root"]["/PageLabels"]["/Nums"][1]) {'/S': '/r'} >>> reader.get_object(reader.trailer["/Root"]["/PageLabels"]["/Nums"][3]) {'/S': '/D'} Example 2 --------- The following example shows 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 PDF Specification 1.7 ===================== Table 159 – 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) )IteratorOptionalTuple)PdfReaderProtocol)logger_warning) ArrayObjectDictionaryObject NumberObjectnumreturncgddtdttffd }dt ||S)N) )iM)iCM)iD)iCD)dC)ZXC)2L)(XL) X) IX)V)IV)rIr r c3rKD]0\}}t||\}}||zV|||zz}|dkrdS1dS)Nr)divmod)r decimal roman_reprx_romans N/var/www/html/Sam_Eipo/venv/lib/python3.11/site-packages/pypdf/_page_labels.py roman_numz1number2uppercase_roman_numeral..roman_numTsk#(   GZ#w''DAqq. 7Q; Caxx   )intrstrjoinlist)r r,r*s @r+number2uppercase_roman_numeralr3Csh   E sx} 774 #'' ( ((r-numbercDt|SN)r3lowerr4s r+number2lowercase_roman_numeralr9_s )& 1 1 7 7 9 99r-c|dkrtddttdtddzD}d}|dkr+|dz}|dkrd}||dz |z}||z}|dz}|dk+|S) NrzExpecting a positive numberc,g|]}t|S)chr).0is r+ z+number2uppercase_letter..fs>>>1A>>>r-AZrr.) ValueErrorrangeord)r4alphabetrep remainders r+number2uppercase_letterrJcs {{6777>>c#hhC1 = =>>>H C 1**RK >>Iy1}%+)2 1** Jr-cDt|Sr6)rJr7r8s r+number2lowercase_letterrLss "6 * * 0 0 2 22r-readerindexc|jd}d|vrt|dzS|d}d|vr$|d}d}d}d}|t|krd||}||dz}|dzt|krn(||dz|krn|dz }|t|kddd tt t td }t|tst|dzS| d d} | d d } | || d||z | zzSd|vsd|vrtdtt|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/Rootz /PageLabelsrz/NumsrNcdS)Nr.r<ns r+zindex2label..sBr-c t|Sr6)r0rRs r+rTzindex2label..s CFFr-)Nz/Dz/Rz/rz/Az/az/Stz/Pr.z/Sz/Kidsz/Limitszq/Kids or /Limits found in PageLabels. Please share this PDF with pypdf: https://github.com/py-pdf/pypdf/pull/1519) trailerr0len get_objectr3r9rJrL isinstancedictgetr__name__) rMrNroot number_treenumsr?value start_indexmstartprefixs r+ index2labelrews >' "DD  519~~}%K+7#  #d))mmq'KQK**,,E1uD !!AE{U"" FA#d))mm,""00))   %&& "uqy>> ! %##4$$*%))D//*5;+>+FGGGG+k!9!9<      uqy>>r-keyr`r_Nc|t|dzdkrtdt|}|dkr)|||dz kr|dz }|dkr|||dz k|t|kr|||kr |||dz<dS|||||dz|dS)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 rPr6a nums like array must have an even number of elementsrN)rWrDinsert)rfr`r_r?s r+ nums_insertrjs 4yy1}QRRR D A q&&SDQK'' E q&&SDQK'' 3t99}}QQU  As AE5!!!!!r- page_index_toct|dzdkrtd||krtd||dz}|t|krW|||krO|||||t|kr|||kIdSdSdSdS)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 rPrrhz/page_index_to must be greater or equal than keyN)rWrDrNpop)rfrkr_r?s r+nums_clear_rangerns 4yy1}QRRRsJKKK 3!A c$ii--DG}44     c$ii--DG}4444----44r-ct|dzdkrtd||dz}|t|kr||||dzfSdS)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 rPrrhr)NN)rWrDrN)rfr_r?s r+ nums_nextrpsg 4yy1}QRRR 3!A3t99}}Qa!e%%|r-)__doc__typingrrr _protocolsr_utilsrgenericr r r r/r0r3r9rJrLrerjrnrpr<r-r+rvs99v-,,,,,,,,,))))))""""""@@@@@@@@@@))))))8:3:3:::: C C     3C3C3333;);#;#;;;;|" " " " """":   4   8L !8,<#= =>r-