ib! ,SrSSKJr SSKJrJr SSKJr SSKJ r SSK J r J r J r JrJr S\S \4S jrS \S \4S jrS \S \4S jrS \S \4SjrS\ S\S \4SjrS\S\S \4SjrS\S\ S\ S S4SjrS\S\S\ S S4SjrS\S\ S \\\\\ 44Sjrg)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^/SQmS[S[[4U4SjjnSR[ U"U555$)N) )iM)iCM)iD)iCD)dC)ZXC)2L)(XL) X) IX)V)IV)rIrrc3h># TH'up[X5up4X#-v XU--nUS::dM' g g7f)Nr)divmod)rdecimal roman_reprx_romans L/home/james-whalen/.local/lib/python3.13/site-packages/pypdf/_page_labels.py roman_num1number2uppercase_roman_numeral..roman_num\s=#( G#'DA. Q; Cax $)s&22)intrstrjoinlist)rr.r,s @r-number2uppercase_roman_numeralr5Ks; E sx} 774 #' ((numberc4[U5R5$N)r5lowerr7s r-number2lowercase_roman_numeralr<gs )& 1 7 7 99r6cUS::a [S5e[[S5[S5S-5Vs/sHn[U5PM nnSnUS:a(US-nUS:XaSnX$S- U-nX-nUS-nUS:aM(U$s snf)NrzExpecting a positive numberAZrr0) ValueErrorrangeordchr)r7ialphabetrep remainders r-number2uppercase_letterrIks {677 %c#hC1 => =1A =H> C 1*RK >I1}%+2 1* J?sA>c4[U5R5$r9)rIr:r;s r-number2lowercase_letterrK{s "6 * 0 0 22r6dictionary_objectindexc[[US5nSnSnSnU[U5:aNX#nX#S-R5nUS-[U5:XaO"X#S-U:aOUS- nU[U5:aMNSS[[ [ [S.n[U[5(d[US-5$URSS5nURS S 5nXURS 5"X- U-5-$) N/Numsrrcg)Nr0)r+s r-%get_label_from_nums..sr6c[U5$r9)r2)ns r-rSrTsAr6)Nz/Dz/Rz/rz/Az/az/Stz/Pr0z/S) rr len get_objectr5r<rIrK isinstancedictr2get) rLrMnumsrEvalue start_indexmstartprefixs r-get_label_from_numsrbs  .w7 8D A EK c$i-g U &&( q5CI   A;   Q c$i-,,%%  A eT " "519~ IIeQ E YYtR F eiio&u':U'BC CCr6readerc[[UR5nSU;a[US-5$[[USR 55nSU;a [ X15$SU;a[ US[5(dSnUS:a[[[US5nUH{n[[[US5nUSUs=::a US::dM2O M6[URSS55(dUS- nUS:Xa [S 5eUn O[ Xa5s $ OUS:aM[S US 3[5 [US-5$) 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_objectr2rXrbrYr r4r1r r[NotImplementedErrorr__name__)rcrMroot number_treelevelkidskidlimitss r- index2labelrosN  &"4"4 5DD 519~'m)<)G)G)IJK+";66+jW1Ez&R&Rck-. G0DEDd3iY8!9222*3777D+ABB  C<"5 D#'* .s::&+ck.A%JHU uqy>r6keyr]r\Nc0[U5S-S:wa [S5e[U5nUS:wa#XUS- ::aUS- nUS:wa XUS- ::aMU[U5:aXU:XaXUS-'gURX05 URUS-U5 g)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)rWrAinsert)rpr]r\rEs r- nums_insertrts  4y1}QRR D A q&SQK' E q&SQK' 3t9}QQU  A AE5!r6 page_index_toc0[U5S-S:wa [S5eX:a [S5eURU5S-nU[U5:aFX#U::a=URU5 URU5 U[U5:a X#U::aM;gggg)z 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 rPrrrz/page_index_to must be greater or equal than keyN)rWrArMpop)rprur\rEs r-nums_clear_rangerxs  4y1}QRRJKK 3!A c$i-DG}4     c$i-DG}4-4-r6c[U5S-S:wa [S5eURU5S-nU[U5:a XXS-4$g)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 rPrrrr)NN)rWrArM)rpr\rEs r- nums_nextrz sS 4y1}QRR 3!A3t9}!e%% r6)__doc__collections.abcrtypingrr _protocolsr_utilsrgenericr r r r r r1r2r5r<rIrKrbrortrxtuplerzrRr6r-rs1:x%!,")))8:3:3: C C  3C3C3!D+;!DC!DC!DH.,.S.S.b" " " " "<   6   8L !8,<#= =>r6