mj& 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 E/root/.hermes/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_objectindexc tt|d}t|}d}d}d}||krU|dz|k\rtdtn;||}||dzj }|dz|k(rn||dz|kDrn |dz }||krUdt ttttd}t|tst |dzS|jd d}tt |jd d } |j|jd } | /td t|jd t |dzS | | ||z |zzS#ttf$r$tdt|| t |dzcYSwxYw)N/Numsrrz(Ignoring last /Nums key without a value.sourcecy)Nr0)r,s r.z%get_label_from_nums..sr6)Nz/Dz/Rz/rz/Az/az/Stz/Pr0z/Sz?Ignoring unknown page label numbering style %(style)r in /Nums.)rQstylezLIgnoring malformed page label entry in /Nums (/St=%(start)r, /P=%(prefix)r).)rQstartprefix)rr lenr __name__ get_objectr2r5r<rIrK isinstancedictget TypeErrorrA) rLrMnums nums_lengthrEvalue start_indexmrWrXmapping_functions r.get_label_from_numsrfs  .w7 8Dd)K A EK k/ q5K  :8  1g QU &&( q5K   A;   Q k/,,%% 4A eT "519~ IIeQ E #uyyr* +FuuUYYt_- M))D/ 519~ ()Ignoring kid with missing or malformed /Limits in /PageLabels.rPNz"Too deep nesting is not supported.z6Could not reliably determine page label for %(index)d.)rQrM)rr root_objectr2r[rfr\r r4r^rYr rZrNotImplementedError)rgrMroot number_treelevelkidskidlimitss r. index2labelrqsw  &"4"4 5DD 519~'m)<)G)G)IJK+";66+jW1Ez&Rck-. G0DED JL9DDF!&$/3v;?"X'!922*3777D+AB  C<"5 D#'* .sE::- 49ck<KT\dij uqy>r6keyrbr`Nc*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 rRr6A nums like array must have an even number of elementsrN)rYrAinsert)rrrbr`rEs r. nums_insertrvs  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 rRrrtz/page_index_to must be greater or equal than keyN)rYrArMpop)rrrwr`rEs r.nums_clear_rangerzs  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 rRrrtr)NN)rYrArM)rrr`rEs r. nums_nextr|-sW 4y1}QRR 3!A3t9}Qa!e%% r6)__doc__collections.abcrrtypingrr _protocolsr_utilsr genericr r r r rr1r2r5r<rIrKrfrqrvrztupler|rTr6r.rs-:x/!,")))8:3:3: C C  3C3C3:+;:C:C:z5,5S5S5p" " " " "<   6   8L !8,<#= =>r6