o >e @sdZddlmZmZmZddlmZddlmZddl m Z m Z m Z de defd d Zd e defd d Zd e defddZd e defddZdede defddZde de de ddfddZde de de ddfddZde de deee ee ffdd ZdS)!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 NumberObjectnumreturncs4gddtdttffdd }dt||S)N) )iM)iCM)iD)iCD)dC)ZXC)2L)(XL) X) IX)V)IV)rIr r c3sFD]\}}t||\}}||V|||8}|dkr dSqdS)Nr)divmod)r decimal roman_reprx_romanS/var/www/html/humari/django-venv/lib/python3.10/site-packages/pypdf/_page_labels.py roman_numTs   z1number2uppercase_roman_numeral..roman_num)intrstrjoinlist)r r+r)r'r*number2uppercase_roman_numeralCsr1numbercC t|SN)r1lowerr2r)r)r*number2lowercase_roman_numeral_ r7cCs||dkrtdddttdtddD}d}|dkr<|d }|dkr(d }||d|}||8}|d }|dks|S) NrzExpecting a positive numbercSsg|]}t|qSr))chr).0ir)r)r* fsz+number2uppercase_letter..AZrr,) ValueErrorrangeord)r2alphabetrep remainderr)r)r*number2uppercase_lettercs rFcCr3r4)rFr5r6r)r)r*number2lowercase_lettersr8rGreaderindexc Cs*|jd}d|vrt|dS|d}d|vr|d}d}d}d}|t|krO||}||d}|dt|krszindex2label..cSst|Sr4)r.rKr)r)r*rMs)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.len get_objectr1r7rFrG isinstancedictgetr__name__) rHrIroot number_treenumsr;value start_indexmstartprefixr)r)r* index2labelwsH         r]keyrXrWNcCst|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 rJr6a nums like array must have an even number of elementsrN)rOr@insert)r^rXrWr;r)r)r* nums_inserts ra 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 rJrr_z/page_index_to must be greater or equal than keyN)rOr@rIpop)r^rbrWr;r)r)r*nums_clear_ranges  (rdcCsJt|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 rJrr_r)NN)rOr@rI)r^rWr;r)r)r* nums_nexts   re)__doc__typingrrr _protocolsr_utilsrgenericrr r r-r.r1r7rFrGr]rardrer)r)r)r*sF;  >