;]e 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 }dd||DS)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 4/usr/lib/python3/dist-packages/pypdf/_page_labels.py roman_numz1number2uppercase_roman_numeral..roman_numTsk#(   GZ#w''DAqq. 7Q; Caxx   cg|]}|Sr0).0as r+ z2number2uppercase_roman_numeral..\s...!A...r-)intrstrjoin)r r,r*s @r+number2uppercase_roman_numeralr7Cso   E sx} 77..yy~~... / //r-numbercDt|SN)r7lowerr8s r+number2lowercase_roman_numeralr=_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|Sr0)chr)r1is r+r3z+number2uppercase_letter..fs>>>1A>>>r-AZrr.) ValueErrorrangeord)r8alphabetrep remainders r+number2uppercase_letterrKcs {{6777>>c#hhC1 = =>>>H C 1**RK >>Iy1}%+)2 1** Jr-cDt|Sr:)rKr;r<s r+number2lowercase_letterrMss "6 * * 0 0 2 22r-readerindexc8|jd}d|vrt|dzS|d}d|vr<|d}d}d}d}|t|krR||}||dz}|dzt|krn(||dz|krn|dz }|t|kRdd ttt t d }t|ts| |}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.r0ns r+zindex2label..sBr-c t|Sr:)r5rSs r+rUzindex2label..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) trailerr5lenr7r=rKrM isinstancedict get_objectgetr__name__) rNrOroot number_treenumsrAvalue start_indexmstartprefixs r+ index2labelrfws >' "DD  519~~}%K+7#  #d))mmq'KQKE1uD !!AE{U"" FA#d))mm,""00))   %&& -%%e,,E%&& "uqy>> ! %##4$$*%))D//*5;+>+FGGGG+k!9!9<      uqy>>r-keyrar`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 rQr6a nums like array must have an even number of elementsrN)rXrEinsert)rgrar`rAs r+ nums_insertrks 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 rQrriz/page_index_to must be greater or equal than keyN)rXrErOpop)rgrlr`rAs r+nums_clear_rangeros 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 rQrrir)NN)rXrErO)rgr`rAs r+ nums_nextrqsg 4yy1}QRRR 3!A3t99}}Qa!e%%|r-)__doc__typingrrr _protocolsr_utilsrgenericr r r r4r5r7r=rKrMrfrkrorqr0r-r+rws99v-,,,,,,,,,))))))""""""@@@@@@@@@@0000008:3:3:::: C C     3C3C3333<)<#<#<<<<~" " " " """":   4   8L !8,<#= =>r-