jy, FdZddlZddlmZmZmZddlmZddlm Z ddl m Z m Z m Z mZmZerddlmZd Zd Zd ed efd Zded efdZded efdZded efdZde ded efdZdeded efdZdede de d dfdZdedede d dfdZdede d eeeee ffdZdS)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) N) TYPE_CHECKINGOptionalcast)PdfCommonDocProtocol)logger_warning) ArrayObjectDictionaryObject NullObject NumberObjectis_null_or_none)Callableiinumreturnc|dkrtd|tkrtdgd}g}|D]0\}}t||\}}|||z1d|S)NrExpecting a positive number.zNumber is out of range.) )iM)iCM)iD)iCD)dC)ZXC)2L)(XL) X) IX)V)IV)rI) ValueErrorMAXIMUM_ROMAN_NUMERALdivmodappendjoin)rromanresultvaluesymbolcounts /Users/tedpeters/Documents/Projects/Claude Projects/TPC Houses/house-viewer/.venv/lib/python3.11/site-packages/pypdf/_page_labels.pynumber2uppercase_roman_numeralr4Xs axx7888 """2333   E F&& vC'' s fun%%%% 776??numbercDt|SN)r4lowerr6s r3number2lowercase_roman_numeralr;us )& 1 1 7 7 9 99r5c|dkrtdt|dz d\}}|dz}|tkrtdtj||dzzS)NrrrzNumber is too large.)r)r+MAXIMUM_PAGE_LABEL_LENGTHstringascii_uppercase)r6 repetitionspositionlengths r3number2uppercase_letterrDysm {{7888"6A:r22K 1_F )))/000  !( +{Q ??r5cDt|Sr8)rDr9r:s r3number2lowercase_letterrFs "6 * * 0 0 2 22r5dictionary_objectindexctt|d}t|}d}d}d}||krj|dz|krtdtnJ||}||dz}|dz|krn||dz|krn |dz }||kjdt ttttd}t|tst |dzS| d d}tt | d d } | | d } | z%get_label_from_nums..sr5)Nz/Dz/Rz/rz/Az/az/Stz/Pr(z/Sz?Ignoring unknown page label numbering style %(style)r in /Nums.)rLstylezZIgnoring malformed page label entry in /Nums (/St=%(start)r, /P=%(prefix)r): %(exception)s)rLstartprefix exception)rr lenr__name__ get_objectstrr4r;rDrF isinstancedictget TypeErrorr)) rGrHnums nums_lengthir0 start_indexmrSrTmapping_functionrUs r3get_label_from_numsrds/  .w7 8 8Dd))K A EK k// q5K   :8     1g QU &&(( q5K    A;    Q k//l,,%% 44A eT " "519~~ IIeQ  E #uyyr** + +FuuUYYt__-- M))D//    519~~ (()Ignoring kid with missing or malformed /Limits in /PageLabels.Nz"Too deep nesting is not supported.z6Could not reliably determine page label for %(index)d.)rLrH)rr root_objectrYrXrZrrWrdr r r\listrVr NotImplementedError)rerHrootrglevelrhkidlimitss r3 index2labelrps  &"4 5 5DD  519~~}%0022K k#3 4 4 ?#    519~~+";666+jW1Ez&R&Rckkw'2244DdK00 @# ! ! nn&&!#'788"P'JLL99DDFF!&$//3v;;??"X'!9222222222*3777D+A+ABB   C<<"5 D##'* .sE:::::3 UckkXKT\dijjjj uqy>>r5keyr0r^c|t|dzdkrtdt|}|dkr)|||dz kr|dz }|dkr|||dz k|t|kr|||kr |||dz<dS|||||dz|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 rMr6A nums like array must have an even number of elementsrN)rVr)insert)rqr0r^r`s r3 nums_insertrus  4yy1}QRRR D A q&&SDQK'' E q&&SDQK'' 3t99}}QQU  As AE5!!!!!r5 page_index_toct|dzdkrtd||krtd||dz}|t|krW|||krO|||||t|kr|||kIdSdSdSdS)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 rMrrsz/page_index_to must be greater or equal than keyN)rVr)rHpop)rqrvr^r`s r3nums_clear_rangery1s  4yy1}QRRRsJKKK 3!A c$ii--DG}44     c$ii--DG}4444----44r5ct|dzdkrtd||dz}|t|kr||||dzfSdS)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 rMrrsr)NN)rVr)rH)rqr^r`s r3 nums_nextr{Lsg 4yy1}QRRR 3!A3t99}}AwQU ## :r5) __doc__r?typingrrr _protocolsr_utilsrgenericr r r r r collections.abcrr*r>intrYr4r;rDrFrdrprurytupler{rOr5r3rsw::v 0000000000,,,,,,"""""")((((((   ::3:3::::@C@C@@@@3C3C3333;+;;C;C;;;;|J,JSJSJJJJZ" " " " """"<   6   8L !8,<#= =>r5