o ZhT! @s&dZddlmZmZmZmZmZddlmZddl m Z ddl m Z m Z mZmZmZdedefd d Zd edefd d Zd edefddZd edefddZde dedefddZdededefddZdede de ddfddZdedede ddfd d!Zdede deeeee ffd"d#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 NumberObjectis_null_or_nonenumreturncs4gddtdttffdd }dt||S)N) )iM)iZCM)iD)iZCD)dC)ZZXC)2L)(ZXL) X) ZIX)V)ZIV)rIrrc3sFD]\}}t||\}}||V|||8}|dkr dSqdS)Nr)divmod)rdecimalZ roman_reprx_romanI/var/www/html/lang_env/lib/python3.10/site-packages/pypdf/_page_labels.py roman_num[s   z1number2uppercase_roman_numeral..roman_num)intrstrjoinlist)rr(r&r$r'number2uppercase_roman_numeralJsr.numbercC t|SN)r.lowerr/r&r&r'number2lowercase_roman_numeralf r4cCs||dkrtdddttdtddD}d}|dkr<|d }|dkr(d }||d|}||8}|d }|dks|S) NrzExpecting a positive numbercSsg|]}t|qSr&)chr).0ir&r&r' msz+number2uppercase_letter..AZrr)) ValueErrorrangeord)r/alphabetrep remainderr&r&r'number2uppercase_letterjs rCcCr0r1)rCr2r3r&r&r'number2lowercase_letterzr5rDdictionary_objectindexc Cstt|d}d}d}d}|t|kr;||}||d}|dt|kr(n||d|kr1n |d7}|t|ksddddttttd}t|t sSt |dS| d d}| d d }||| d |||S) N/NumsrrcSsdS)Nr)r&)r#r&r&r'sz%get_label_from_nums..cSst|Sr1)r+)nr&r&r'rIs)Nz/Dz/Rz/rz/Az/az/Stz/Pr)z/S) rr len get_objectr.r4rCrD isinstancedictr+get) rErFnumsr8value start_indexmstartprefixr&r&r'get_label_from_nums~s2      rVreadercCstt|j}d|vrt|dStt|d}d|vr"t||Sd|vr~t|dts~d}|dkr~ttt|d}|D]:}ttt |d}|d|krW|dkrxnq>t | ddsq|d7}|dkrmt d |}n t||Sq>n|dks3t d |d tt|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 /PageLabelsrrGz/Kidsrrz/LimitsNz"Too deep nesting is not supported.z,Could not reliably determine page label for .)rr Z root_objectr+rLrVrMr rr*rrONotImplementedErrorr __name__)rWrFrootZ number_treelevelZkidskidZlimitsr&r&r' index2labels6     r^keyrQrPNcCst|ddkr tdt|}|dkr,|||dkr,|d}|dkr,|||dks|t|kr@|||kr@|||d<dS|||||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 rHr6A nums like array must have an even number of elementsrN)rKr=insert)r_rQrPr8r&r&r' nums_inserts rb page_index_tocCst|ddkr td||krtd||d}|t|kr?|||krC|||||t|krA|||ks'dSdSdSdS)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 rHrr`z/page_index_to must be greater or equal than keyN)rKr=rFpop)r_rcrPr8r&r&r'nums_clear_ranges  (recCsJt|ddkr td||d}|t|kr#||||dfSdS)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 rHrr`r)NN)rKr=rF)r_rPr8r&r&r' nums_next s  rf)__doc__typingrrrrrZ _protocolsrZ_utilsr Zgenericr r r r rr*r+r.r4rCrDrVr^rbrerfr&r&r&r'sH<   $1