U Nf @sdZddlmZmZmZmZmZddlmZddl m Z ddl m Z m Z mZmZeeddd Zeed d d Zeed d dZeed ddZe eedddZeeedddZee e ddddZeee ddddZee eeeee fddd ZdS)!u& 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.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 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) )IteratorListOptionalTuplecast)PdfCommonDocProtocol)logger_warning) ArrayObjectDictionaryObject NullObject NumberObjectnumreturnc sHddddddddd d d d d g tttdfdd }dt||S)N)iM)iZCM)iD)iZCD)dC)ZZXC)2L)(ZXL) X) ZIX)V)ZIV)rIrc3sBD]8\}}t||\}}||V|||8}|dkrq>qdS)Nr)divmod)rdecimalZ roman_reprx_Zroman6/tmp/pip-unpacked-wheel-zevpxvmc/pypdf/_page_labels.py roman_numTs    z1number2uppercase_roman_numeral..roman_num)intrstrjoinlist)rr'r%r$r&number2uppercase_roman_numeralCs r-)numberrcCs t|SN)r-lowerr.r%r%r&number2lowercase_roman_numeral_sr2cCsv|dkrtdddttdtddD}d}|dkrr|d }|dkrPd }||d|}||8}|d }q4|S) NrzExpecting a positive numbercSsg|] }t|qSr%)chr).0ir%r%r& fsz+number2uppercase_letter..AZrr() ValueErrorrangeord)r.alphabetrep remainderr%r%r&number2uppercase_lettercs  r@cCs t|Sr/)r@r0r1r%r%r&number2lowercase_letterssrA)dictionary_objectindexrc Cstt|d}d}d}d}|t|krl||}||d}|dt|krPql||d|krbql|d7}qddddttttd}t|t st |dS| d d}| d d }||| d |||S) N/NumsrrcSsdS)Nr(r%nr%r%r&z%get_label_from_nums..cSst|Sr/)r*rFr%r%r&rHrI)Nz/Dz/Rz/rz/Az/az/Stz/Pr(z/S) rr len get_objectr-r2r@rA isinstancedictr*get) rBrCnumsr5value start_indexmstartprefixr%r%r&get_label_from_numsws0      rU)readerrCrcCstt|j}d|kr t|dStt|d}d|krDt||Sd|krt|dtsd}|dkrttt|d}|D]t}ttt |d}|d|kr|dkr|nq|| dddk r|d7}|dkrt d |}q^t||Sq|qq^t d |d t 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 /PageLabelsrrDz/Kidsrrz/LimitsNz"Too deep nesting is not supported.z,Could not reliably determine page label for .)rr Z root_objectr*rKrUrLr rr)rNNotImplementedErrorr __name__)rVrCrootZ number_treelevelZkidsZkidZlimitsr%r%r& index2labels4     r\N)keyrPrOrcCst|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 rEr6a nums like array must have an even number of elementsrN)rJr:insert)r]rPrOr5r%r%r& nums_inserts  r`)r] page_index_torOrcCsht|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 rErr^z/page_index_to must be greater or equal than keyN)rJr:rCpop)r]rarOr5r%r%r&nums_clear_ranges rc)r]rOrcCsNt|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 rErr^r)NNN)rJr:rC)r]rOr5r%r%r& nums_nexts  rd)__doc__typingrrrrrZ _protocolsr_utilsr Zgenericr r r r r)r*r-r2r@rArUr\r`rcrdr%r%r%r&s0;  $2