j ( 2dZddlmZmZddlmZmZddlmZddl m Z ddl m Z m Z mZmZmZded efd Zd ed efd Zd ed efd Zd ed efdZde ded efdZdeded efdZdede de d dfdZdedede d dfdZdede d eeeee ffdZdS)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) )CallableIterator)Optionalcast)PdfCommonDocProtocol)logger_warning) ArrayObjectDictionaryObject NullObject NumberObjectis_null_or_nonenumreturncgddtdttffd }dt ||S)N) )iM)iCM)iD)iCD)dC)ZXC)2L)(XL) X) IX)V)IV)rIrrc3rKD]0\}}t||\}}||zV|||zz}|dkrdS1dS)Nr)divmod)rdecimal roman_reprx_romans @C:\Projects\DSCons\.venv\Lib\site-packages\pypdf\_page_labels.py roman_numz1number2uppercase_roman_numeral..roman_num\sk#(   GZ#w''DAqq. 7Q; Caxx   )intrstrjoinlist)rr/r-s @r.number2uppercase_roman_numeralr6Ksh   E sx} 774 #'' ( ((r0numbercDt|SN)r6lowerr7s r.number2lowercase_roman_numeralr<gs )& 1 1 7 7 9 99r0c|dkrtddttdtddzD}d}|dkr+|dz}|dkrd}||dz |z}||z}|dz}|dk+|S) NrzExpecting a positive numberc,g|]}t|S)chr).0is r. z+number2uppercase_letter..ns>>>1A>>>r0AZrr1) ValueErrorrangeord)r7alphabetrep remainders r.number2uppercase_letterrMks {{6777>>c#hhC1 = =>>>H C 1**RK >>Iy1}%+)2 1** Jr0cDt|Sr9)rMr:r;s r.number2lowercase_letterrO{s "6 * * 0 0 2 22r0dictionary_objectindexctt|d}t|}d}d}d}||krj|dz|krtdtnJ||}||dz}|dz|krn||dz|krn |dz }||kjdt ttttd}t|tst |dzS| d d}tt | d d } | | d } | z%get_label_from_nums..sr0)Nz/Dz/Rz/rz/Az/az/Stz/Pr1z/Sz?Ignoring unknown page label numbering style %(style)r in /Nums.)rUstylezLIgnoring malformed page label entry in /Nums (/St=%(start)r, /P=%(prefix)r).)rUstartprefix)rr lenr __name__ get_objectr3r6r<rMrO isinstancedictget TypeErrorrG) rPrQnums nums_lengthrBvalue start_indexmrZr[mapping_functions r.get_label_from_numsris  .w7 8 8Dd))K A EK k// q5K   :8     1g QU &&(( q5K    A;    Q k//l,,%% 44A eT " "519~~ IIeQ  E #uyyr** + +FuuUYYt__-- M))D//    519~~ (()Ignoring kid with missing or malformed /Limits in /PageLabels.rTNz"Too deep nesting is not supported.z6Could not reliably determine page label for %(index)d.)rUrQ)rr root_objectr3r^rir_r r5rar\r r]rNotImplementedError)rjrQroot number_treelevelkidskidlimitss r. index2labelrts  &"4 5 5DD  519~~'m)<)G)G)I)IJJK+";666+jW1Ez&R&Rckk-. G0DEED  JLL99DDFF!&$//3v;;??"X'!9222222222*3777D+A+ABB   C<<"5 D##'* .sE:::::3 9ckk<KT\dijjjj uqy>>r0keyrercNc|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 rVr6A nums like array must have an even number of elementsrN)r\rGinsert)rurercrBs r. nums_insertrys  4yy1}QRRR D A q&&SDQK'' E q&&SDQK'' 3t99}}QQU  As AE5!!!!!r0 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 rVrrwz/page_index_to must be greater or equal than keyN)r\rGrQpop)rurzrcrBs r.nums_clear_ranger}s  4yy1}QRRRsJKKK 3!A c$ii--DG}44     c$ii--DG}4444----44r0ct|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 rVrrwr)NN)r\rGrQ)rurcrBs r. nums_nextr-sg 4yy1}QRRR 3!A3t99}}Qa!e%% rsG::x/.......!!!!!!!!,,,,,,""""""))))))8:3:3:::: C C     3C3C3333:+;:C:C::::z5,5S5S5555p" " " " """"<   6   8L !8,<#= =>r0