a cf!@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 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) )IteratorListOptionalTuplecast)PdfCommonDocProtocol)logger_warning) ArrayObjectDictionaryObject NullObject NumberObjectnumreturncs2gdtttdfdd }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_romanO/home/httpd/docs/test/DocsMgr/lib/python3.9/site-packages/pypdf/_page_labels.py roman_numUs    z1number2uppercase_roman_numeral..roman_num)intrstrjoinlist)rr(r&r$r'number2uppercase_roman_numeralDsr.)numberrcCs t|SN)r.lowerr/r&r&r'number2lowercase_roman_numeral`sr3cCsv|dkrtdddttdtddD}d}|dkrr|d }|dkrPd }||d|}||8}|d }q4|S) NrzExpecting a positive numbercSsg|] }t|qSr&)chr).0ir&r&r' gz+number2uppercase_letter..AZrr)) ValueErrorrangeord)r/alphabetrep remainderr&r&r'number2uppercase_letterds  rBcCs t|Sr0)rBr1r2r&r&r'number2lowercase_lettertsrC)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'r8z%get_label_from_nums..cSst|Sr0)r+rHr&r&r'rJr8)Nz/Dz/Rz/rz/Az/az/Stz/Pr)z/S) rr len get_objectr.r3rBrC isinstancedictr+get) rDrEnumsr6value start_indexmstartprefixr&r&r'get_label_from_numsxs0      rV)readerrErcCstt|j}d|vr t|dStt|d}d|vrDt||Sd|vrt|dtsd}|dkrttt|d}|D]t}ttt |d}|d|kr|dkr|nq|| dddur|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 /PageLabelsrrFz/Kidsrrz/LimitsNz"Too deep nesting is not supported.z,Could not reliably determine page label for .)rr Z root_objectr+rLrVrMr rr*rONotImplementedErrorr __name__)rWrErootZ number_treelevelZkidskidZlimitsr&r&r' index2labels4     r^N)keyrQrPrcCst|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 rGr6a nums like array must have an even number of elementsrN)rKr<insert)r_rQrPr6r&r&r' nums_inserts  rb)r_ page_index_torPrcCsht|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 rGrr`z/page_index_to must be greater or equal than keyN)rKr<rEpop)r_rcrPr6r&r&r'nums_clear_ranges re)r_rPrcCsNt|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 rGrr`r)NNN)rKr<rE)r_rPr6r&r&r' nums_nexts  rf)__doc__typingrrrrrZ _protocolsr_utilsr Zgenericr r r r r*r+r.r3rBrCrVr^rbrerfr&r&r&r's0<  $2