U c@sdZddlmZmZmZddlmZddlmZddl m Z m Z m Z e eddd Ze ed d d Ze ed d dZe ed ddZee edddZe e e ddddZe e e ddddZe e eee ee fdddZdS)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 NumberObjectnumreturnc sNddddddddd d d d d g tttdfdd }ddd||DS)N)iM)iZCM)iD)iZCD)dC)ZZXC)2L)(ZXL) X) ZIX)V)ZIV)rIr c3sBD]8\}}t||\}}||V|||8}|dkrq>qdS)Nr)divmod)r decimalZ roman_reprx_Zroman6/tmp/pip-unpacked-wheel-u_n6aelj/pypdf/_page_labels.py roman_numTs    z1number2uppercase_roman_numeral..roman_numcSsg|]}|qSr"r").0ar"r"r# \sz2number2uppercase_roman_numeral..)intrstrjoin)r r$r"r!r#number2uppercase_roman_numeralCs r,)numberr cCs t|SN)r,lowerr-r"r"r#number2lowercase_roman_numeral_sr1cCsv|dkrtdddttdtddD}d}|dkrr|d }|dkrPd }||d|}||8}|d }q4|S) NrzExpecting a positive numbercSsg|] }t|qSr")chr)r&ir"r"r#r(fsz+number2uppercase_letter..AZrr%) ValueErrorrangeord)r-alphabetrep remainderr"r"r#number2uppercase_lettercs  r=cCs t|Sr.)r=r/r0r"r"r#number2lowercase_letterssr>)readerindexr c Cs6|jd}d|krt|dS|d}d|kr |d}d}d}d}|t|kr||}||d}|dt|krvq||d|krq|d7}qDdd d d ttttd }t|ts| |}t|tst|dS| d d} | d d} | || d||| Sd|ks d|kr*t dt t|dS)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/NumsrNcSsdS)Nr%r"nr"r"r#zindex2label..cSst|Sr.)r*rBr"r"r#rDrE)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) trailerr*lenr,r1r=r> isinstancedictZ get_objectgetr__name__) r?r@rootZ number_treenumsr3value start_indexmstartprefixr"r"r# index2labelwsJ             rSN)keyrNrMr cCst|ddkrtdt|}|dkrB|||dkrB|d}q |t|krh|||krh|||d<n|||||d|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 rAr6a nums like array must have an even number of elementsrN)rGr7insert)rTrNrMr3r"r"r# nums_inserts  rW)rT page_index_torMr cCsht|ddkrtd||kr(td||d}|t|krd|||krd||||q6dS)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 rArrUz/page_index_to must be greater or equal than keyN)rGr7r@pop)rTrXrMr3r"r"r#nums_clear_ranges rZ)rTrMr cCsNt|ddkrtd||d}|t|krF||||dfSdSdS)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 rArrUr)NNN)rGr7r@)rTrMr3r"r"r# nums_nexts  r[)__doc__typingrrrZ _protocolsr_utilsrZgenericrr r r)r*r,r1r=r>rSrWrZr[r"r"r"r#s.;  @