o vhT! @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)iCM)iD)iCD)dC)ZXC)2L)(XL) X) IX)V)IV)rIrrc3sFD]\}}t||\}}||V|||8}|dkr dSqdS)Nr)divmod)rdecimal roman_reprx_romanP/var/www/html/hyperkenya/venv/lib/python3.10/site-packages/pypdf/_page_labels.py roman_num[s   z1number2uppercase_roman_numeral..roman_num)intrstrjoinlist)rr/r-r+r.number2uppercase_roman_numeralJsr5numbercC t|SN)r5lowerr6r-r-r.number2lowercase_roman_numeralf r;cCs||dkrtdddttdtddD}d}|dkr<|d }|dkr(d }||d|}||8}|d }|dks|S) NrzExpecting a positive numbercSsg|]}t|qSr-)chr).0ir-r-r. msz+number2uppercase_letter..AZrr0) ValueErrorrangeord)r6alphabetrep remainderr-r-r.number2uppercase_letterjs rJcCr7r8)rJr9r:r-r-r.number2lowercase_letterzr<rKdictionary_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)Nr0r-)r*r-r-r.sz%get_label_from_nums..cSst|Sr8)r2)nr-r-r.rPs)Nz/Dz/Rz/rz/Az/az/Stz/Pr0z/S) rr len get_objectr5r;rJrK isinstancedictr2get) rLrMnumsr?value start_indexmstartprefixr-r-r.get_label_from_nums~s2      r]readercCstt|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 /PageLabelsrrNz/Kidsrrz/LimitsNz"Too deep nesting is not supported.z,Could not reliably determine page label for .)rr root_objectr2rSr]rTr rr1rrVNotImplementedErrorr __name__)r^rMroot number_treelevelkidskidlimitsr-r-r. index2labels6     rikeyrXrWNcCst|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 rOr6A nums like array must have an even number of elementsrN)rRrDinsert)rjrXrWr?r-r-r. nums_inserts rm 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 rOrrkz/page_index_to must be greater or equal than keyN)rRrDrMpop)rjrnrWr?r-r-r.nums_clear_ranges  (rpcCsJt|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 rOrrkr)NN)rRrDrM)rjrWr?r-r-r. nums_next s  rq)__doc__typingrrrrr _protocolsr_utilsr genericr r r r rr1r2r5r;rJrKr]rirmrprqr-r-r-r.sH<   $1