Pǻi! dZddlmZmZddlmZmZddlmZddl m Z ddl m Z m Z mZmZmZded efd Zd ed efd Zd ed efd Zd ed efdZde ded efdZdeded efdZdede de d dfdZdedede d dfdZdede d eeeee ffdZy)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) )CallableIterator)Optionalcast)PdfCommonDocProtocol)logger_warning) ArrayObjectDictionaryObject NullObject NumberObjectis_null_or_nonenumreturnc~gddtdttffd }djt ||S)N) )iM)iCM)iD)iCD)dC)ZXC)2L)(XL) X) IX)V)IV)rIrrc3lKD]*\}}t||\}}||z|||zz}|dks*yyw)Nr)divmod)rdecimal roman_reprx_romans P/opt/lhia/marcimex/agent/venv/lib/python3.12/site-packages/pypdf/_page_labels.py roman_numz1number2uppercase_roman_numeral..roman_num\sM#(  GZ#w'DAqq. 7Q; Cax  s,44)intrstrjoinlist)rr/r-s @r.number2uppercase_roman_numeralr5Ks; E sx} 774 #' ((numberc4t|jSN)r5lowerr7s r.number2lowercase_roman_numeralr<gs )& 1 7 7 99r6c|dkr tdttdtddzDcgc] }t|}}d}|dkDr'|dz}|dk(rd}||dz |z}||z}|dz}|dkDr'|Scc}w)NrzExpecting a positive numberAZrr0) ValueErrorrangeordchr)r7ialphabetrep remainders r.number2uppercase_letterrIks {677 %c#hC1 =>1A>H> C 1*RK >Iy1}%+)2 1* J?sA8c4t|jSr9)rIr:r;s r.number2lowercase_letterrK{s "6 * 0 0 22r6dictionary_objectindexctt|d}d}d}d}|t|krM||}||dzj}|dzt|k(rn ||dz|kDrn|dz }|t|krMdtt t ttd}t|tst |dzS|jdd}|jdd }||jd } || ||z |zzS) N/Numsrrcy)Nr0)r,s r.z%get_label_from_nums..sr6)Nz/Dz/Rz/rz/Az/az/Stz/Pr0z/S) rr len get_objectr2r5r<rIrK isinstancedictget) rLrMnumsrEvalue start_indexmstartprefixmapping_functions r.get_label_from_numsr`s  .w7 8D A EK c$i-1g QU &&( q5CI   A;   Q c$i-,,%% 4A eT "519~ IIeQ E YYtR F4) $U[%85%@A AAr6readercltt|j}d|vrt|dzStt|dj }d|vr t ||Sd|vrt |dtsd}|dkrttt|d}|D]r}ttt|d}|d|cxkr |dks/n2t|jdds|dz }|dk(r td |}nt ||cSn|dkrtd |d tt|dzS) 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 /PageLabelsrrOz/Kidsrrz/LimitsNz"Too deep nesting is not supported.z,Could not reliably determine page label for .)rr root_objectr2rUr`rVr r4r1rrXNotImplementedErrorr __name__)rarMroot number_treelevelkidskidlimitss r. index2labelrmsN  &"4"4 5DD 519~'m)<)G)G)IJK+";66+jW1Ez&Rck-. G0DED d3iY8!922*3777D+AB  C<"5 D#'* .sE:: &+ck.A%JHU uqy>r6keyrZrYNc*t|dzdk7r tdt|}|dk7r!|||dz kr|dz }|dk7r |||dz kr|t|kr|||k(r |||dz<y|j|||j|dz|y)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 rPr6A nums like array must have an even number of elementsrN)rTrAinsert)rnrZrYrEs r. nums_insertrrs  4y1}QRR D A q&SDQK' E q&SDQK' 3t9}QQU  As AE5!r6 page_index_toc(t|dzdk7r td||kr td|j|dz}|t|krD|||kr;|j||j||t|kr |||kr9yyyy)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 rPrrpz/page_index_to must be greater or equal than keyN)rTrArMpop)rnrsrYrEs r.nums_clear_rangervs  4y1}QRRsJKK 3!A c$i-DG}4     c$i-DG}4-4-r6ct|dzdk7r td|j|dz}|t|kr ||||dzfSy)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 rPrrpr)NN)rTrArM)rnrYrEs r. nums_nextrxsW 4y1}QRR 3!A3t9}Qa!e%% r6)__doc__collections.abcrrtypingrr _protocolsr_utilsr genericr r r r rr1r2r5r<rIrKr`rmrrrvtuplerxrRr6r.rs1:x/!,")))8:3:3: C C  3C3C3"B+;"BC"BC"BJ.,.S.S.b" " " " "<   6   8L !8,<#= =>r6