hb! dZddlmZddlmZmZddlmZddlm Z ddl m Z m Z m Z mZmZded 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) )Iterator)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 Q/var/www/html/aiagenthome/venv/lib/python3.12/site-packages/pypdf/_page_labels.py roman_numz1number2uppercase_roman_numeral..roman_num\sH#( GZ#w'DAqq. 7Q; Cax $)s,44)intrstrjoinlist)rr.r,s @r-number2uppercase_roman_numeralr4Ks; E sx} 774 #' ((numberc4t|jSN)r4lowerr6s r-number2lowercase_roman_numeralr;gs )& 1 7 7 99r5c|dkr tdttdtddzDcgc] }t|}}d}|dkDr'|dz}|dk(rd}||dz |z}||z}|dz}|dkDr'|Scc}w)NrzExpecting a positive numberAZrr/) ValueErrorrangeordchr)r6ialphabetrep remainders r-number2uppercase_letterrHks {677 %c#hC1 => =1A =H> C 1*RK >Iy1}%+)2 1* J?sA8c4t|jSr8)rHr9r:s r-number2lowercase_letterrJ{s "6 * 0 0 22r5dictionary_objectindexctt|d}d}d}d}|t|krM||}||dzj}|dzt|k(rn ||dz|kDrn|dz }|t|krMddtt t td}t|tst|dzS|jdd}|jd d }|||jd ||z |zzS) N/Numsrrcy)Nr/)r+s r-z%get_label_from_nums..sr5ct|Sr8)r1)ns r-rRz%get_label_from_nums..sAr5)Nz/Dz/Rz/rz/Az/az/Stz/Pr/z/S) rr len get_objectr4r;rHrJ isinstancedictr1get) rKrLnumsrDvalue start_indexmstartprefixs r-get_label_from_numsr`s   .w7 8D A EK c$i-1g QU &&( q5CI   A;   Q c$i-,,%%  A eT "519~ IIeQ E YYtR F &Aeiio&u{':U'BC CCr5readercltt|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 /PageLabelsrrNz/Kidsrrz/LimitsNz"Too deep nesting is not supported.z,Could not reliably determine page label for .)rr root_objectr1rVr`rWr r3r0r rYNotImplementedErrorr__name__)rarLroot number_treelevelkidskidlimitss r- index2labelrmsI  &"4"4 5DD 519~'m)<)G)G)IJK+";66+jW1Ez&Rck-. G0DEDd3iY8!922*3777D+AB  C<"5 D#'* .sE::&+ck.A%JHU uqy>r5keyr[rZNc*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 rOr6A nums like array must have an even number of elementsrN)rUr@insert)rnr[rZrDs r- nums_insertrrs  4y1}QRR D A q&SDQK' E q&SDQK' 3t9}QQU  As AE5!r5 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 rOrrpz/page_index_to must be greater or equal than keyN)rUr@rLpop)rnrsrZrDs r-nums_clear_rangervs  4y1}QRRsJKK 3!A c$i-DG}4     c$i-DG}4-4-r5ct|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 rOrrpr)NN)rUr@rL)rnrZrDs r- nums_nextrx sW 4y1}QRR 3!A3t9}Qa!e%% r5)__doc__collections.abcrtypingrr _protocolsr_utilsrgenericr r r r r r0r1r4r;rHrJr`rmrrrvtuplerxrQr5r-rs1:x%!,")))8:3:3: C C  3C3C3!D+;!DC!DC!DH.,.S.S.b" " " " "<   6   8L !8,<#= =>r5