j*ddlZddlZddlZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZmZmZmZmZmZejdkrdd lmZndd lmZd d lmZd d lmZmZd d lmZmZd dl m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+d dl,m-Z.d dl/m0Z0m1Z1m2Z2m3Z3m4Z4m5Z5d dl6m7Z7m8Z8m9Z9m:Z:m;Z;mZ>m?Z?m@Z@mAZAmBZBmCZCmDZDd dlEmFZFerd dlGmHZHGddeZIdS)N)Iterable)BytesIOUnsupportedOperation) itemgetter)Path) TracebackType) TYPE_CHECKINGAnyCallableOptionalUnioncast) )Self)apply_legacy_configuration) PdfDocCommonconvert_to_int) Encryption PasswordType) WHITESPACES_AS_BYTES StrByteType StreamTypeget_stream_dataget_stream_sizelogger_warningread_non_whitespaceread_previous_lineread_until_whitespaceskip_over_commentskip_over_whitespace) TrailerKeys)EmptyFileErrorFileNotDecryptedErrorLimitReachedError PdfReadErrorPdfStreamErrorWrongPasswordError) ArrayObjectByteStringObject DestinationDictionaryObjectEncodedStreamObjectIndirectObject NameObject NullObject NumberObject PdfObject StreamObjectTextStringObjectis_null_or_none read_object)XmpInformation) PageObjectc teZdZUdZeeeeeffed<eed< dVddde e e fd e d e e edfd eed df d Zde e e fd dfdZd ee e efd dfdZd efdZdeeedeedeed dfdZdWdZed efdZed eefdZed eefdZed e fdZed ee fdZ!de ee"e#dfd eefdZ$de#d e%fdZ&de ee#fd ee%fdZ'de(d e)eeffdZ*d ed!ed ee%fd"Z+d ed!ed#ee%d ee%fd$Z,de#d#e%d e%fd%Z-de(d dfd&Z.de(d dfd'Z/de(d dfd(Z0de(d efd)Z1d*Z2e3d+ed e fd,Z4e5de(d efd-Z6d.ed eee)eefffd/Z7de(d eefd0Z8de(d dfd1Z9de(d2eed3ed dfd4Z:e;j<e;j=e;j>e;j?e;j@fZAd5ed dfd6ZBde(d eefd7ZCde(d2ed eefd8ZDd9eEed:eEed;eFd eEefd<ZGde(d eFfd=ZHe3de(d2ed efd>ZIe5d.ed eJe)eeeffd?ZKe5d.ed eJefd@ZLde(d dfdAZMdBeEedCeNege ee)edDfffdEeNee ee)edDffge fd dfdFZOdGeEed eJe)eeffdHZPd e e efd eQfdIZRed e fdJZSdKe d eefdLZTdKe d eefdMZU dXdNe eJe dfdOe eJe dfd ee effdPZVddddQdReedSeee eWfdTeeXed ee eWfffdUZYxZZS)Y PdfReadera| Initialize a PdfReader object. This operation can take some time, as the PDF stream's cross-reference tables are read into memory. Args: stream: A File object or an object that supports the standard read and seek methods similar to a File object. Could also be a string representing a path to a PDF file. strict: Determines whether user should be warned of all problems and also causes some correctable problems to be fatal. Defaults to ``False``. password: Decrypt PDF file at initialization. If the password is None, the file will not be decrypted. Defaults to ``None``. root_object_recovery_limit: The maximum number of objects to query for recovering the Root object in non-strict mode. To disable this security measure, pass ``None``. xreftrailerFNi')root_object_recovery_limitstreamstrictpasswordr>returnc||_d|_i|_d|_d|_i|_i|_i|_t|_ t|tr|n tj |_td|_d|_||t'|_d|_d|_|jr||n|t3dd|_g|_dS)NrFzNot an encrypted file)r@flattened_pagesresolved_objects _startxref xref_indexr<xref_free_entry xref_objStmr-r= isinstanceintsysmaxsize_root_object_recovery_limitr _page_id2num_validated_root_initialize_streamset_known_objects_override_encryption _encryption is_encrypted_handle_encryptionr'_named_destinations_cache_object_stream_resolution_stack)selfr?r@rAr>s /Users/tedpeters/Documents/Projects/Claude Projects/TPC Houses/house-viewer/.venv/lib/python3.11/site-packages/pypdf/_reader.py__init__zPdfReader.__init__}s ;?MO  :<79')) +55OQT*U*U f & &[^[f ( #$$$7;;? '''47EE$)!15   8  # #H - - - -  !677 7KO&:<,,,ct|drd|jvrtdtd|_t |t tfrPt|d5}t| }dddn #1swxYwYd|_| |||_ dS)NmodebzQPdfReader stream/file object is not in binary mode. It may not be read correctly.sourceFrbT) hasattrr_r__name___stream_openedrJstrropenrreadr?)rZr?fhs r[rQzPdfReader._initialize_streams 66 " " s&+'='= 0     $ fsDk * * 'fd## ,r ++ , , , , , , , , , , , , , , ,"&D  & s#"BBBcd|_|jtjt }d}t|trW|rU|d}t|ttfr|j }nBtdtn+t|t stdt|jtj}t|tst!dt#j|||_||nd}|j||jt,jkr|t1d d |_dS) NTr]rz2Ignoring non-string first /ID entry of the trailerraz+Ignoring malformed /ID entry of the trailerz1/Encrypt entry of the trailer is not a dictionaryr@zWrong passwordF)rTr=getTKIDr1 get_objectrJr*r+r5original_bytesrreENCRYPTr-r'rrirUverifyr@r NOT_DECRYPTEDr))rZrAid_entry id1_entryfirst_id_entry encrypt_entrypwds r[rWzPdfReader._handle_encryptionsn$(!<##BE:<<88CCEE h , , [ [%a[3355N.+;=M*NOO f*9 S\deeeeeHj11 [ HQY Z Z Z Z RZ0 -)9:: TRSS S%?=)DD#.hhC   # #C # < < @Z Z Z$%%566 6$)!!!r]c|SNrZs r[ __enter__zPdfReader.__enter__s r]exc_typeexc_valexc_tbc.|dSr{)close)rZrrrs r[__exit__zPdfReader.__exit__s r]c|jr|jg|_i|_t |_i|_i|_i|_ dS)z8Close the stream if opened in __init__ and clear memory.N) rfr?rrDrEr-r=r<rHrIr}s r[rzPdfReader.closes[   K     ! "'))  !r]c |jr|jS|jtjt }t|tr|}nt}t|rtdtn7|ddkr||_ntdt|jtdttt|jdd }t|D]}||jkrt!d  ||d z}n#t"$rd}YnwxYwt|tr>|ddkr%||_td t|j n|j7d|vr$tdt|j||_nt'd|jS)z7Provide access to "/Root". Standardized with PdfWriter.z"Cannot find "/Root" key in trailerra/Typez/CatalogzInvalid Root object in trailerNz$Searching object with "/Catalog" key/Sizerz+Maximum Root object recovery limit reached.rzRoot found at %(obj_reference)r)rb obj_referencez/Pagesz=Possible root found at %(root_ref)r, but missing /Catalog key)rbroot_refzCannot find Root object in pdf)rPr=rmrnROOTr1rprJr-r6rrerrKrangerNr& Exceptionindirect_referencer')rZrootroot_dictionarynumber_of_objectsiobjs r[ root_objectzPdfReader.root_objects4   (' '|66AACC d, - - 1"OO/00O 4  N ? Q Q Q Q Q   ) )Z 7 7#2D ;H M M M M   ' A( S S S S $S$,*:*:7A*F*F G G ,--  888+,YZZZ//!a%00CC CCCc#3449I9IZ9W9W+.D("9'&)&< E   '?**S#,? (7$$"#CDDD##s E%% E43E4c|jtjd}t |rdS| Jd|}t |tstd|S)z Provide access to "/Info". Standardized with PdfWriter. Returns: /Info Dictionary; None if the entry does not exist NmypyzHTrailer not found or does not point to a document information dictionary) r=rmrnINFOr6rprJr-r')rZinfos r[_infozPdfReader._infos|.. 4  4  $ 011 Z  r]c|jtjd}t |rdS| Jdt t |S)z Provide access to "/ID". Standardized with PdfWriter. Returns: /ID array; None if the entry does not exist Nr)r=rmrnror6rr*rp)rZfile_identifierss r[_IDz PdfReader._ID2se <++BE488 + , , 4++V+++K!1!!>???r]c|j}|jdd|jddd}|j|d|S)z The first 8 bytes of the file. This is typically something like ``'%PDF-1.6'`` and can be used to detect if the file is actually a PDF file and which version it is. rzutf-8backslashreplace)r?tellseekridecode)rZlocpdf_file_versions r[ pdf_headerzPdfReader.pdf_headerAstk   A;++A..55g?QRR a   r]c |jduo |jj |_tt|jjd|_S#d|_wxYw)z(XMP (Extensible Metadata Platform) data.NF)rUEncryptMetadatarTrr8r xmp_metadatar}s r[rzPdfReader.xmp_metadataQs^ . ,UT5E5U1U  %(8(EFF(-D % %D % - - - -s 9A A rcZ|j#dt|jD|_t|rdSt |t t fs Jdt |t r|}n|j}|j Jd|j|dS)z Retrieve the page number from an indirect reference. Args: indirect_reference: The indirect reference to locate. Returns: Page number or None. Nc.i|]\}}|jj|Sr|)ridnum).0rxs r[ z:PdfReader._get_page_number_by_indirect..ls1!!!26!Q$*A!!!r]rz hint for mypy) rO enumeratepagesr6rJrKr/rrm)rZrrs r[_get_page_number_by_indirectz&PdfReader._get_page_number_by_indirect^s   $!!:CDJ:O:O!!!D  - . . 4,sN.CDDLLfLLD (# . . -&EE&,E ,,o,,, $$UD111r]c  |j}||jvre|j|}g|j|d|}tddt t |z|j| |j|j\}}t|d| }tt |ddksJt| }|d} |d} t| t rt| t std|d t#| } t#| } |j} | dksd| cxkr| ksbn|jrtd | d | d |d t+dt,| | |t/|jS|jdz}|d| |kr;|jrt5d| d|d|d t+dt,| |||} g}t7| D]}t9||ddt!j|}t9||ddt!j|}t9||dd|dks|dks | |z| kr:|jrtd|d|d |d t+dt,||||t#|t#|ft/}d}t=|D]#\}\}}|d|}|||jkr|}d}1|| |zdt9||dd tA||}nX#tB$rK}t+dt,||||jrtd ||t/}Yd}~nd}~wwxYw|j|d!\}}||kr|"d||||jkr|}d}%|s|jrtd"||jS#|jwxYw)#Nz+Circular object-stream reference detected: z -> rr/ObjStm/Nz/Firstz"Invalid /ObjStm header for object z&: /N or /First missing or not a numberz Invalid /N (z ) or /First (z) in object stream .zZInvalid /N (%(n)d) or /First (%(first)d) in object stream %(stmnum)d; ignoring the stream.)rbnfirststmnumrz Value /N z for object z exceeds maximum allowed value zdValue /N %(n)d for object %(stmnum)d exceeds maximum allowed value %(max_n)d. Limiting to %(max_n)d.)rbrrmax_nrzInvalid object number (z ) or offset (zjInvalid object number (%(objnum)d) or offset (%(offset)d) in object stream %(stmnum)d; skipping the entry.)rbobjnumoffsetrFTzEInvalid stream (index %(index)d) within object %(obj_num)d 0: %(exc)s)rbindexobj_numexczCannot read object stream: NNz%This is a fatal error in strict mode.)#rrYrr'joinmaprgappendrIr/rprrget_datarmrJr2rK getbuffernbytesr@rrer1poprr&rrread_from_streamrcache_get_indirect_objectr7r(cache_indirect_object)rZrobj_idstartcycler_idxobj_stm stream_datan_value first_valuer first_offset stream_lengthr obj_index_irr target_objfoundrr obj_offsetcachedrrauthoritative_stms r[_get_object_from_streamz!PdfReader._get_object_from_streamzsp$) T9 9 98>>vFFEKd:566BKFKE= CPSUZOO@\@\\  ,33F;;;W 7 +,>,DELFD+9&!T+J+J+U+U+W+WGWW-..);;;;"'"2"2"4"455Kkk$''G!++h//Kg|44 J\== #;;;;G A{++L'1133:M1uuA>>>>>>>>;&aqaa|aaX^aaa;$&!    "||Z  0 4 4 6 6 6 6Q ))++2a7E   Q   5yy;x+,v,v,vv,v,vns,v,v,vwww1$!    02IAhh = =#K000  Q'''%6{CC#K000  Q'''%6{CC#K000  Q'''A::!|f/D}/T/T {*:f::6::06:::#O (%%%      #f++s6{{!;<<<<%/LLJE,5i,@,@* !* !((GZ777CC%"4":::%+ $   !:A>>>$K000  Q''''%k488CC%'''#_' ' {#*?#??"#%,,CCCCCC'&+/*:*>*>w *U*U'!4$....q'3???0666!$J E T[ ";  0 4 4 6 6 6 6D 0 4 4 6 6 6 6s@E3T4H-T4 QT4 R2'AR-(T4-R22A(T44Uc  t|trt|d|}||j|j}|j|jf}||jvr|S|jdkr%|j|jvr||}n|j|j vrD|j|j |jvr*|j |ji |jdrtS|j |j|j}|j |d ||j \}}||jks ||jkrt!dn#t"$rt%|j }t'jd|jd|jd|}|t-dt.|j|j|dd z|j |j|j<|j |dd z||j \}}nd }d }YnwxYw||jkr5|jr.|jr&t!d |jd |jd |d |d n8||jkr-|jr&t!d |jd |jd |d |d |jr ||jksJ|j|jf} | |jvrt9d|d|j| t=|j |}|j| |j s\|j!U|j!"stGd|j!$||j|j|j}n_tK|j dr'tM|j '}ni|j (} |j dd|j )d }|j | dt'jd|jd|jd|}|Gt-dt.|j|j|j|j vri|j |j<|dd z|j |j|j<|j |*dd ztW|j |j d d t=|j |}|j s\|j!U|j!"stGd|j!$||j|j|j}n8t-dt.|j|j|jrt!d|jdkr|j|jvs!|,|j|j||S)NrFz&Not matching, we parse the file for itz\sz\s+z\s+objz/Object ID %(idnum)d,%(generation)d ref repairedrbr generationrrzExpected object ID ( z) does not match actual (z); xref table not zero-indexed.z).z&Detected loop with self reference for rzFile has not been decryptedrlrz%Object %(idnum)d %(generation)d foundz,Object %(idnum)d %(generation)d not defined.zCould not find object.)-rJrKr/rrrrErIrr<rHrmr1r?rread_object_headerr'rrresearchencoderrerrGr@rSr&addr7removerTrU is_decryptedr%decrypt_objectrdbytesrrriendr"r) rZrretvalkeyrrrbufmcurrent_objectps r[rpzPdfReader.get_objectsW (# . . M!/0BAt!L!L //  )+=+C    )  $  $' ' 'M  )Q . ."(D,<<<112DEEFF  )TY 6 6"(DI6H6S,TTT#''(:(ErJJNN"(% $"||#I0;<=O=UVE K  UA & & & $$($;$;DK$H$H!z/555!%7%BBB&'OPPPC $ $ $%dk22I\,2\\7I7T\\\ccee="I'06#5#@ aI0;<*0K$$QWWQZZ!^444(,(?(? (L(L%E::E!#J) $**000T_0;&7/A/G77J\Jg772777:D777,222t{2"E+=+CEEFXFcEE.3EE6@EEE{ C!%7%BBBBB068J8UVN!444'(hQc(h(h(hiii   # #N 3 3 3 d33F   & &~ 6 6 6, 1A1M'4466O/0MNNN)88.46H6S;9 t{K00 'DK113344K$$&&   A&&&k&&r**   A&&& X(.XX3E3PXXX__aaA};#,21<  &0 AA?ADI0;<GGAJJN ,789K9QR   qA...$T[111   Q'''$T[$770T5E5Q+88::S34QRRR!-<< 2 8:L:W#{=F B#,21<  ;A&'?@@@  )Q . ."(D,<<<  & &"-/A/G    s9AE==CP>VWX!3 r]c ||||||}|dkrtdt|d}||_|||}|dkr/|jr|rtdtdt|| ||||j r|js| }|j D]\}}|dkr t|}|D]}|||d ||\} } n&#t$$r||YnBwxYw| ||j z kr/|j |||j || <|j ||=||d|js| }|j D]\}}|dkr t)|} | D]f}|||d ||5#t$$r%tdt|||| ||=YcwxYw||dd Sd S) z Read and process the PDF stream, extracting necessary data. Args: stream: The PDF file stream. rz@Negative startxref pointer (%(startxref)d), treating it as zero.rb startxrefzBroken xref tablez.incorrect startxref pointer(%(xref_issue_nr)d))rb xref_issue_nrzAIgnoring wrong pointing object %(id)d %(gen)d (offset %(offset)d))rbidgenrN)_basic_validation_find_eof_marker_find_startxref_posrrerF_get_xref_issuesr@r'_read_xref_tables_and_trailersrGrr<itemssortedkeysrrr_rebuild_xref_tablelist) rZr?rrrr xref_entryxref_kxref_idpid_pgenidss r[rizPdfReader.readsP v&&& f%%%,,V44 q== R#     I#--fi@@ A  { 8} 8"#6777 @+     ++FI}MMM ? 4; ++--C#'9??#4#4 4 4Z%<<OO%% & 4 4GKK 7 3Q777%)%<%t dt ||tz |zdSdkr7|r5tfd d Drt d t dSd }d vrt dt ||kr,|j rtdt dt |}t|G)a Jump to the %%EOF marker. According to the specs, the %%EOF marker should be at the very end of the file. Hence for standard-compliant PDF documents this function will read only the last part (DEFAULT_BUFFER_SIZE). Producers that omit the line break before the marker (``startxref 256%%EOF`` or ``256%%EOF``) are accepted as well (#4127). rr]T%%EOFrNzEOF marker not at start of linerac3fK|]+}|V,dSr{)stripendswith)rtrlines r[ z-PdfReader._find_eof_marker..sJ24DJJLL))"--r])s%%EOs%%Es%%%zEOF marker seems truncatedF startxrefzpCAUTION: startxref found while searching for %%EOF. The file might be truncated and some data might not be read.zEOF marker not found) rfindlstriprrrerlenanyr@r'r)rZr? header_sizer end_position marker_indexr's @r[r zPdfReader._find_eof_markerds {{}} $ .99X..Lq  aE   &--.BCCI"9'KK s4yy 8< GHHHs{{u{8V ##?QQQQEt##S# {{}}{**;?&'=>>>5hGGGG!;;==L%f--DI$ .r]cPt|}d}|dre|dkrM||jkrnAt|}|dz }|dr|dkM|rt dt  t |}t|}|ds+|jrtd| |}n#t$r}|dstd||dd  }| |std|t |}t d t Yd }~nd }~wwxYw|S) z Find startxref entry - the location of the xref table. Args: stream: Returns: The bytes offset rr"rz.Duplicate %%EOF marker(s) found, skipping themrar*startxref not found Nz startxref on same line as offset) r startswithr_MAX_STARTXREF_RECOVERY_LINESrrerKr@r'_find_previous_startxref_posrr$_is_valid_startxref_value)rZr?r'duplicate_markersrrvalues r[r zPdfReader._find_startxref_poss"&))ooh'' #FKKMMA,=,= D$FFF%f--D  "  ooh'' #FKKMMA,=,=   @     FD I&f--D??<00 F;>&'<=== ==fEE ) P P P??<00 I"#899yHHNN$$E11%88 I"#899yHE I =h O O O O O O O O O P*s%D F#B FF#ir:ctjd|dSttdd}|ddd}| pt ||kS)Ns[+-]?[0-9]+(?:_[0-9]+)*Fget_int_max_str_digitscdS)Nrr|r|r]r[z5PdfReader._is_valid_startxref_value..sAr]s+-_r])r fullmatchgetattrrLr,replacer-)r: max_digitsdigitss r[r8z#PdfReader._is_valid_startxref_valueso <3U ; ; C5FWS":IIFFHH e$$,,T377~:V !::r]cd}t|jD]}|dkrnt|}|ds$ t |}n#t $rd}YnwxYwdt|dkrC|dd}| |st |cS|tdt|cStd)a Recover the most recent intact ``startxref`` pointer by scanning backwards from the current position. This is used as a fallback when the ``startxref`` keyword belonging to the final ``%%EOF`` is corrupt (#3238). The offset always appears on the line directly below the keyword, so the value read immediately before encountering ``startxref`` (while moving backwards) is returned. At most ``_MAX_STARTXREF_RECOVERY_LINES`` lines are inspected. Args: stream: The PDF byte stream, positioned just above the corrupt trailing pointer. Returns: The bytes offset of the recovered ``startxref``. Nrr*r4zCfound startxref pointing to a previous revision after a corrupt onerar3) rr6rrr5rKrr-r$r8rrer')clsr?r_r'r:s r[r7z&PdfReader._find_previous_startxref_poss((!%s899  A{{}}!!%f--D??<00 " YYFF!"""!FFF"4yy1}}QRR((44U;;5zz!!!!$#  0111sA(( A76A7datacZi}||D]\}}}||vr ||f||<|Sr{)_find_pdf_objects)rZrHcache object_numbergeneration_number object_starts r[_load_recovery_cachezPdfReader._load_recovery_cachesU>B>T>TUY>Z>Z E E :M,l%%$02C#DE-  r]cTttt||}t|tsAt dt |||dSt|dz}||krtd|d|d|S)Nz,Invalid/Truncated xref table. Rebuilding it.razDeclared size z exceeds allowed limit of !) rrKr7rJrrerrirr&)rZr?size size_limits r[&_read_standard_xref_table__handle_sizez0PdfReader._read_standard_xref_table__handle_sizesCVT2233$$$  >      $ $V , , , KKMMM4$V,,2 *  #$bT$b$bU_$b$b$bcc c r]c|d}|dkrtdt||ddd}d} t t t ||}|r*|dkr$||_|jrtdt d }t||dd| |}|dSt||ddd}||kr |d }|std |dd vrW|dd|d }t|d krtd|dd vW|ddvr|dd |dd d\} } |dd} t | t | } } n|#t$ro|$t|}||}||vrtdt|d} d} d} n$tdt|||\} } d} YnwxYw| |jvri|j| <i|j| <||j| vrnb| dkr| |j| |< | dk|j| |<n#t$rYnwxYw | dk|jd|<n#t$rYnwxYw|dz }|dz }||k t||dd|ddkrc|ddt'|t||dd|ddkc|dd|d}|dkr|ddndS)Nrsrefzxref table read errorrrTrzFXref table not zero-indexed. ID numbers for objects will be corrected.raFrQz$Unexpected empty line in Xref table. izUnexpected EOF in Xref table.s 0123456789t z5entry %(num)d in Xref table invalid; object not found)rbnumrfz4entry %(num)d in Xref table invalid but object foundnr)traileri)rir'rrrrKr7rGr@rrerUr-splitrrrOr<rHr!)rZr?ref first_timerecovery_cacher\rScntr'offset_b generation_b entry_type_brrr trailer_tags r[_read_standard_xref_tablez#PdfReader._read_standard_xref_table'skk!nn &==677 7F### B ?Cp sK5566C cQhh"%;"`' J  ' ' ' KKA   >>vFFD|  ' ' ' KKA   C**{{2O&'MNNN1g,,KK+++!;;r??D4yyB*+JKKK 1g,,8~--KKA&&&,-1#2#Y__T-B-B*Hl#'2;L),XL8I8IJFF ,,,%--f55)-)B)B3)G)G.00&S#+ # &+ !#'+ &R#+ # .> L  L rrci|_i|_i|_t|_t }|||vrt dt|dS||| |d| d}|dvr| d}|dkr| |}n|r* | |dS#t$rd}YnwxYw|r ||}nZ#t$rM}t j|jvr"t dt|j Yd}~dSt'd ||d}~wwxYw||d |vrt+t,|d }ndS|||}|dSdS) z?Read the cross-reference tables and trailers in the PDF stream.Nz>Circular xref chain detected at offset %(startxref)d, stoppingrrrrWxz)Previous trailer cannot be read: %(args)s)rbargszTrailer cannot be read: /Prev)r<rHrIr-r=rRrrerrri _read_xrefrrisdigit_read_pdf15_xref_streamrnrrmr'_process_xref_streamrrK_read_xref_other_error)rZr?rrvisited_xref_offsetsr xrefstreamrs r[r z(PdfReader._read_xref_tables_and_trailerss0 !')) ),#000T#'  $ $Y / / / KK 1 % % % AAG||KKNNDyy OOF33  K&,,V444E &&&$%MMM& K `!%!=!=f!E!EJJ ```w$,..&G#+!* &'O)'O'OPPV__`))*555j(( $S*W*= > >IIE 77 JJ S#####s0C&& C54C5 D## E:-/E5"E55E:ruc|jD]9}||vr3||jvr*|||jt|<:d|vr|j}|jtt|ddzd| |j|j|ddSdS)z#Process and handle the xref stream./XRefStmrrN) _XREF_STREAM_TRAILER_KEYSr=raw_getr0r?rrrrKrq)rZrurrs r[rrzPdfReader._process_xref_streams1 H HCj  S %<%<0:0B0B30G0G Z__-  # #   ""A K  T#z*'=>>BA F F F  ( ( 5 5 5 K  Q " " " " " $ #r]c @|||ddkrdS|ddt||ddt t t tft||}| D]\}}||j vr ||j |<d|vr| }|t t|ddzd | |n:#t$r-tdt t|dYnwxYw||dd|vrt t|dSdS) Nrr]rrwrzGXRef object at %(xref_stm)d can not be read, some object may be missing)rbxref_stmrn)rjrirrrdictrgr r7rr=rrKrqrrre)rZr? new_trailerrr:rs r[rozPdfReader._read_xrefs &&v... ;;q>>S 4 BF### B4S>;vt+D+DEE %++-- * *JC$,&&$) S!  $ $ A KKS+j"9::Q> B B B ,,V4444   ]# Z!899  KK1    k ! ![122 2tsD//4E&%E&c|dkr.|jrtdtdtdS|dd|d}|d}|d kr |d |z z}|S||dtd D]2}|dr ||z }|cS3d |j vrX|jsQtd t | |n"#t$r}td|d}~wwxYwdStd)Nrz6/Prev=0 in the trailer (try opening with strict=False)zA/Prev=0 in the trailer - assuming there is no previous xref tablerairrQxrefr z/Rootz"Invalid parent xref., rebuild xrefzCannot rebuild xrefz/Could not find xref table at specified location) r@r'rrerrir+rrpr=rr)rZr?rtmpxref_loclookrs r[rsz PdfReader._read_xref_other_errors >>{ "L S    4  Ckk"oo88G$$ r>> h &I  Iq!!!"II ! !D{{1~~%%'' !T!      ! dl " "4; " ? Q Q Q Q I((0000 I I I"#899yH I4LMMMsD D9$D44D9 index_pairs entry_sizes xref_streamc tfdtttdD}|dkr0d}|jrt |t |tgSt||zdz}g}d}t|D]\} } t| } | dzdkr[|| z|krM|jrtd|| zd |d td||z } t d t| | | } || z }| | |S) Nc3BK|]}t|VdSr{)rK)rrrs r[r(zDPdfReader._sanitize_pdf15_xref_stream_index_pairs...s/[[ac+a.11[[[[[[r]rrz-Cross-reference stream encodes no entry data.rarzTotal XRef entries z exceed maximum allowed value rzKClamping XRef count from %(old_count)d to %(new_count)d to fit stream size.)rb old_count new_count)sumrminr-r@r(rrerrrKr&maxr) rZrrrmin_entry_bytesmessage max_entriesresulttotalr pair_valuepair_value_intnew_vs ` r['_sanitize_pdf15_xref_stream_index_pairsz1PdfReader._sanitize_pdf15_xref_stream_index_pairs)s [[[[5SEUEUWXAYAY;Z;Z[[[[[ a  EG{ .$W--- 78 4 4 4 4I+..0011_DqH !*;!7!7 * * E: __NqyA~~>)K77{/v%.2Hvvhsvvv ;#677E"e'"0"'  &+N' MM. ) ) ) ) r]c |dd|\}}ttt |}tt |ddkrt d|d|||d|vrt d|d|d d |dg}ttt|d td ksJj r%td krt d  ||}t| dtdt tt"tdfff fd }dtdt tt"tdffdt$ffd }||||S)z-Read the cross-reference stream for PDF 1.5+.rrr/XRefzUnexpected type rzSize missing from XRef stream rRz/Indexrz/WrzToo many entry sizes: )rrrrrB.c|dkr1|}t||S|dkrdSdS)Nrr)rir)rdrrs r[ get_entryz4PdfReader._read_pdf15_xref_stream..get_entrypsT1~!!$$[^44%aQ888Avvq1r]r\rcP|j|gvp|jvSr{)r<rmrI)r\rrZs r[ used_beforez6PdfReader._read_pdf15_xref_stream..used_before}s+$)-- B777R3$BR;R Rr])rrrr4r7rgr'rrmrrKr-r@rrrr tuplebool_read_xref_subsections) rZr? stream_idnumstream_generationrrrrrrs ` @@r[rqz!PdfReader._read_pdf15_xref_streamVs8 B*.*A*A&*I*I' '<VT)B)BCC [) * *g 5 5J+g2FJJKK K ""#4lKPPP + % %P PPPQQ Q!oohK4H0IJJ 49kood&;&;<< ;1$$$$ ; G3{++a//E EEFF FBB#+C  k224455   sE#s(O';!<        SS SeCsCx4H.I Sd S S S S S S ##KKHHHr]c|dkrdS||dz d|d}|dkr|d}|dvrdS|d}|dkrYd}|dvr!|d}|dkrd S|dv!||d z }|d krd SdS) z Return an int which indicates an issue. 0 means there is no issue. Args: stream: startxref: Returns: 0 means no issue, other values represent specific issues. rrjs rr]s 0123456789 rsobjr)rrilower)r?rr's r[r zPdfReader._get_xref_issuess >>1 IM1%%%{{1~~ 4<<;;q>>D z ! !1{{1~~ 7??D***{{1~~3;;1*** FKKNN "Dzz||v%%qqr]c#Kd}td}td} |d|}|dkrdS|dz }|dkr)||tvr|dz}|dkr||tv|dz}|dkr6|||cxkr|kr#nn |dz}|dkr|||cxkr|kn|dz}|dkr)||tvr|dz}|dkr||tv|dz}|dkr6|||cxkr|kr#nn |dz}|dkr|||cxkr|kn|dz} | |kr;||kr5t|| |} t|||} | | | fV|dz }U) Nr09Ts objrrr)ordr+rrK) rFrHrord_0ord_9index_before_spacegeneration_endgeneration_start object_endrNrLrMs r[rJzPdfReader._find_pdf_objectssWCC" IIgu--E{{!& %))d3E.FJ^.^.^"a'"%))d3E.FJ^.^.^0!3N$))etQRefgRg>g9hlq9q9q)))) QJE r]c Pi|_|dd|d}||D])\}}}||jvr i|j|<||j||<*t dt g}|jD].}|j|D]}|j||}||d ||}ttt||}| dd} | dkrYt} |j D]+} | |vr%| | | t| <,||| f| dkrt!|} d} t%| t&j|j }|snt/|}t1| | dd t%| t&j|j }|sn!t/|}||f|j|<| d z } tt.|d }| |krt d t | |||#t4$rt6$rYwxYw0|ddt9|}||D]b}||d||tt<t>t>ft||fctA|tCdD])\}}|"D]\} }||j#| <*dS)Nrrzparsing for Object StreamsrarrrTrrrzsfound %(actual_count)d objects within Object(%(object_number)d,%(generation_number)d) whereas %(expected)d expected)rb actual_countrLrMexpected)r)$r<rrirJrrerrr4r7rmr-rxryr0rrrr r/rr@rprKr"rIr&rrrr|r rrrr=)rZr?rrLrMrNxref_stream_trailersrGr object_typer=r object_streamrcurrentinner_object_number inner_offsetexpected_counttrailerspositionr}r:s r[rzPdfReader._rebuild_xref_tables  Aqkk"oo >B>T>TU`>a>a G G :M,l  11/1 +,:FDI' ( 7 73HEEEEDF!%8 8  !%+;;s;K;K 3 8,33\74KLLL "i// $+CLLNN$;$;M#$L*"7)^5Xaeal### '00"!.1'll+,];;;%**2q111"7)^5Xaeal### '00"!'*7|| ANP\@]()<=$) !*"&*#s4y%9%9N#~55&!@$,)5*7.?%3    ) Dm7 r  Aq59:N5O5O// << Y YH KK! $ $ $ OOXtDcNKPT>'0y||$&/illOO!^^"+)A,,K!*1J!2202 *-&;sJ77A5@ *-c2!^^!*1J ) ! I!"J&;sJ77H1;Y0G(-[J&'HY'H'HIIIJ/ J J Jr]arrayc#Kd}|dzt|kr2||||dzfV|dz }|dzt|k0dSdS)z Iterate over pairs in the array.rrrN)r-)rZrrs r[rzPdfReader._pairs\si !ec%jj  (E!a%L( ( ( ( FA!ec%jj      r]cp|jstd|j||jS)a When using an encrypted / secured PDF file with the PDF Standard encryption handler, this function will allow the file to be decrypted. It checks the given password against the document's user password and owner password, and then stores the resulting decryption key if either password is correct. It does not matter which password was matched. Both passwords provide the correct decryption key that will allow the document to be used with this library. Args: password: The password to match. Returns: An indicator if the document was decrypted and whether it was the owner password or the user password. zNot encrypted filerl)rUr'rsr@)rZrAs r[decryptzPdfReader.decryptcs<( 5344 4&&x &DDDr]c(tj|jvS)z Read-only boolean property showing whether this PDF file is encrypted. Note that this property, if true, will remain true even after the :meth:`decrypt()` method is called. )rnrrr=r}s r[rVzPdfReader.is_encrypted|szT\))r]namec |j}d|vst|dtsdStt|t d}d|vrdSt}t ||t d<|t d|t d<t tt|j dddz t d |j Dd t |j d t d |j Dd dz}|d||t}||j||t d<tt|dD]M}|}d |vrt'd t(|j|j|t d <N|S)z Add a top level form that groups all form fields below it. Args: name: text string of the "/T" Attribute of the created object Returns: The created object. ``None`` means no object was created. /AcroFormN/Fields/Tz/Kidsrrrc3$K|] }|D]}|V dSr{r|)rentriesrs r[r(z-PdfReader.add_form_topname..s/FFwgFFFFFFFFFr])defaultc3 K|] \}}|V dSr{r|)rrGrs r[r(z-PdfReader.add_form_topname..s&55tq!555555r]z/Parentz:Top Level Form Field %(obj_ref)s has a non-expected parent)rbobj_ref)rrJr-rr0r5rrKr=rmr<rrIrErr*rrrprre) rZrcatalogacroforminterim object_idarrors r[add_form_topnamezPdfReader.add_form_topnames " g % %Z K "2. . %4('*[2I2I*JKK H $ $4"$$$4T$:$: 4  !'/ 90E0E'F 7##$ dl&&w22 3 3a 7 FF$)"2"2"4"4FFFPQ R R R  ! , , , 55t4555q A A A     ""1i999mm 7-...*-I&&'k77#344 D DA,,..CCP#2 *1)CC 9%% & &r]c |j}d|vst|dtsdStt|t d}d|vrdStttt |t dd}t||t d<|S)z Rename top level form field that all form fields below it. Args: name: text string of the "/T" field of the created object Returns: The modified object. ``None`` means no object was modified. rNrrr)rrJr-rr0r*rpr5)rZrrrrs r[rename_form_topnamezPdfReader.rename_form_topnames" g % %Z K "2. . %4('*[2I2I*JKK H $ $4  hz)'<'<= > >q A L L N N  %5T$:$: 4  !r]includeexcludec|jd|j}d|i} fd|D} fd|D}|S)z Integration into Jupyter Notebooks. This method returns a dictionary that maps a mime-type to its representation. .. seealso:: https://ipython.readthedocs.io/en/stable/config/integrating.html rzapplication/pdfNc$i|] \}}|v || Sr|r|)rkvrs r[rz/PdfReader._repr_mimebundle_..s$BBBTQQ'\\Aq\\\r]c$i|] \}}|v || Sr|r|)rrrrs r[rz/PdfReader._repr_mimebundle_..s)FFFTQQg5E5EAq5E5E5Er])r?rrir)rZrrpdf_datarHs `` r[_repr_mimebundle_zPdfReader._repr_mimebundle_s ;##%% x   BBBBTZZ\\BBBD  FFFFTZZ\\FFFD r]treervisitedrrrc|s|r$t|||S|j%t|_|jS)zoOverride from PdfDocCommon. In the reader we can assume this is static, but not in the writer. r)super_get_named_destinationsrX)rZrrr __class__s r[rz!PdfReader._get_named_destinationss`  ^6 ^7722VU\2]] ]  ) 1-2WW-L-L-N-ND *--r])FN)rBNr)[re __module__ __qualname____doc__r|rKr __annotations__r-r rrrrgrr r\rQrWrr~type BaseExceptionrrrpropertyrrr*rrr8rr1r/rr3rrprrrrrrrir r r r6 staticmethodr8 classmethodr7rOrUrjr rnrrrrroSIZErxrrrorsrr4rrqr rrJrrr rrrrrVrrrr,rRr __classcell__)rs@r[r;r;cs , sDcN" ####  ,0 += 5; +=+=+=k4'(+=+=UD() += %-SM += +=+=+=+=Z {D/@)A d    *8E#u*4E+F*4****<44 ./-('       .$-.$.$.$X.$`x 01X& @Xk* @ @ @X @  C    X   .h~6 . . .X .2"'Z(M"N2 #22228c7"0c7 c7c7c7c7JZ"'^(;"<Z ) ZZZZx""c3h""""HRR&)R ) RRRR  &) 080C  )     .yU^Q :Q $Q Q Q Q f$ $t$$$$$5.z5.d5.5.5.5.n3*33333r%)!;;4;;;\;,2*,2,2,2,2[,2\4U38_8L3MZHUXM y ytyyyyv2K 2K-5c]2KKN2K 2K2K2K2Kl"$"*bgrubg N #/? #D # # # # 6'N 'N-0'N #'N'N'N'NR+#Cy+7;Cy+O[+ c++++Z-j-\----^      \ D&U&xc3m8L/M&&&[&Pe [(Q**Q*Q*Q*Q*Q*f!J9!JSE5eCHo)=#>>?!JsE#uS#X*>$?@$FG !J  !J!J!J!JFDI(5c?*CEc5j 1ElEEEE2*d***X*-S-X6F-G----^9I0J</3.2x}d*+x}d*+ c3h D,037&* ...'(.c;./0 . #c(# . c;  ..........r]r;)JrrrLcollections.abcriorroperatorrpathlibrtypesrtypingr r r r r r version_infortyping_extensions_configurationr _doc_commonrrrUrr_utilsrrrrrrrrr r!r" constantsr#rnerrorsr$r%r&r'r(r)genericr*r+r,r-r.r/r0r1r2r3r4r5r6r7xmpr8_pager9r;r|r]r[rs=< $$$$$$,,,,,,,,w&&&&&&6666665555555511111111                          )(((((  "!!!!!!\.\.\.\.\. \.\.\.\.\.r]