mjHddlZddlZddlZddlZddlZddlmZddlmZddl m Z ddl m Z m Z mZmZmZmZej$dddk\rddl mZnddlmZej$d k\rdd l mZndd lmZdd lmZdd lmZmZdd lmZmZmZmZm Z m!Z!m"Z"ddl#m$Z$m%Z%m&Z&dZ'dZ(GddeZ)Gdde)Z*Gdde)Z+Gdde)Z,dZ-Gdde.e)Z/Gdde0e)Z1Gdde2e)Z3Gd d!e4e)Z5Gd"d#e4e)Z6d$e4d%e2fd&Z7d'e d%eede*e,ffd(Z8y))N)Sequence)log10) iter_unpack)AnyCallableClassVarOptionalUnioncast) ) TypeGuard)r )Self)_pdfdoc_encoding_rev)PdfObjectProtocolPdfWriterProtocol) StreamType classpropertydeprecation_no_replacementdeprecation_with_replacementlogger_warningread_non_whitespaceread_until_regex)STREAM_TRUNCATED_PREMATURELY PdfReadErrorPdfStreamErrorzMathieu Fenniakzbiziqe@mathieu.fenniak.netc eZdZUejZeded<eded<de fdZ de fdZ de fdZ d eddfd Z dd ed ed eeeee fddfd Z dddd ed eddfdZdedfdZ ddededee fddfdZy) PdfObject).z hashlib._Hash hash_funcIndirectObjectindirect_referencereturncFt|jjd)q Used to detect modified object. Returns: Hash considering type and value. z& does not implement .hash_bin() so farNotImplementedError __class____name__selfs F/root/.hermes/venv/lib/python3.12/site-packages/pypdf/generic/_base.pyhash_binzPdfObject.hash_binEs'"~~&&''M N  c$|jSNencoder+s r-hash_value_datazPdfObject.hash_value_dataQs!!r/c|jjd|j|jj j S)N:)r)r*r!r4 hexdigestr3r+s r- hash_valuezPdfObject.hash_valueTsG~~&&'q~~d2245??AB D &( r/pdf_destc$|j|S)a/ Clone object into pdf_dest (PdfWriterProtocol which is an interface for PdfWriter) without ensuring links. This is used in clone_document_from_root with incremental = True. Args: pdf_dest: Target to clone to. Returns: The cloned PdfObject )cloner,r9s r- replicatezPdfObject.replicateZszz(##r/force_duplicate ignore_fieldscFt|jjd)a Clone object into pdf_dest (PdfWriterProtocol which is an interface for PdfWriter). By default, this method will call ``_reference_clone`` (see ``_reference``). Args: pdf_dest: Target to clone to. force_duplicate: By default, if the object has already been cloned and referenced, the copy will be returned; when ``True``, a new copy will be created. (Default value = ``False``) ignore_fields: List/tuple of field names (for dictionaries) that will be ignored during cloning (applies to children duplication as well). If fields are to be considered for a limited number of levels, you have to add it as integer, for example ``[1,"/B","/TOTO"]`` means that ``"/B"`` will be ignored at the first level only but ``"/TOTO"`` on all levels. Returns: The cloned PdfObject z! does not implement .clone so farr'r,r9r>r?s r-r;zPdfObject.cloneks'6"~~&&''H I  r/r;c |s'|j|jj|k(r|S |j}|jrJ|H|j|j k(r/|j t|jkr |j }nt|jdz}|(t|j|jvrQi|jt|j<|j|jt|jd<|s|j |jt|jvrW|j|jt|j|j }t|tsJd|S||jt|j|j < ||j|dz <t!|d||_|S#t$rYwxYw#t$r|cYSwxYw#t$r3|jj|t|j}YpwxYw)aX Reference the object within the _objects of pdf_dest only if indirect_reference attribute exists (which means the objects was already identified in xref/xobjstm) if object has been already referenced do nothing. Args: clone: pdf_dest: Returns: The clone  PreventGCmypyr)r#pdf ExceptionAttributeError incremental_readeridnumlen_objectsid_id_translated get_object isinstancer IndexErrorappendr")r,r;r9r>indiobjs r-_reference_clonezPdfObject._reference_clones" #,,8,,00H<  ))C  8+++ S!2!233 AH%%&*A ?#''{("9"9979''377 4DGGG''377 4[A#II!8!8CGG!EE))++BswwK8C"#y19691 >?H # #BswwK 0 ; '',H  a!e $$2!Q#A  I     L 6 '    $ $U +H%%&A 's4(G8 HH8 HH HH9IIc|S)zResolve indirect references.r+s r-rPzPdfObject.get_object r/Nstreamencryption_keyctr1)r(r,r[r\s r-write_to_streamzPdfObject.write_to_streams "!r/FrY)Fr1)r* __module__ __qualname__hashlibsha1r!r__annotations__r intr.bytesr4r8rr=boolrr strr;rWrPrr_rYr/r-r r @s07 Ix,-< !122  #  ""E $#$ $(!&=?  #   sCx 9:    @X]< <,=<PT< <|H[1 MQ" "27c58H2I" "r/r c eZdZ ddededeeeee fddfdZ de fdZ dde d edee fddfd Zede ddfd Zdefd Zd edefdZde fdZy) NullObjectr9r>r?r$cLtd|jt||S)Clone object into pdf_dest.rk)r rWrkrAs r-r;zNullObject.clones' $// hX  r/c.t|jfSr&hashr)r+s r-r.zNullObject.hash_binsT^^%&&r/Nr[r\cB| tdd|jdy)N/the encryption_key parameter of write_to_stream5.0.0null)rwriter^s r-r_zNullObject.write_to_streams%  % &A7   Wr/cX|jd}|dk7r tdtS)NruzCould not read Null object)readrrk)r[nulltxts r-read_from_streamzNullObject.read_from_streams+++a. g ;< <|r/cy)NrkrYr+s r-__repr__zNullObject.__repr__sr/otherc"t|tSr1)rQrkr,r~s r-__eq__zNullObject.__eq__s%,,r/c"|jSr1r.r+s r-__hash__zNullObject.__hash__}}r/r`r1)r*rarbrrhr rr rirfr;r.rrgr_ staticmethodr{r}objectrrrYr/r-rkrks!&=?  #     sCx 9:    '#'MQ 27c58H2I   #-F-t-#r/rkc eZdZUeed<deddfdZ ddededee e e e fddfdZ de fd Zd edefd Zde fd Zde fd Z ddede de efddfdZededdfdZy) BooleanObjectvaluer$Nc||_yr1r)r,rs r-__init__zBooleanObject.__init__s  r/r9r>r?cbtd|jt|j||S)rmr)r rWrrrAs r-r;zBooleanObject.clones/   ! !- ";X W  r/cDt|j|jfSro)rqr)rr+s r-r.zBooleanObject.hash_binsT^^TZZ011r/oct|tr|j|jk(St|tr|j|k(Sy)NF)rQrrrhr,rs r-rzBooleanObject.__eq__s: a '::( ( a ::? "r/c"|jSr1rr+s r-rzBooleanObject.__hash__%rr/c"|jrdSdS)NTrueFalserr+s r-r}zBooleanObject.__repr__(sv00r/r[r\c~| tdd|jr|jdy|jdy)Nrsrttruesfalse)rrrvr^s r-r_zBooleanObject.write_to_stream+s8  % &A7  :: LL ! LL "r/c|jd}|dk(r tdS|dk(r|jdtdStd)NrxrTsfalsrCFzCould not read Boolean object)ryrr)r[words r-r{zBooleanObject.read_from_stream7sJ{{1~ 7? & & 7? KKN ' ':;;r/r`r1)r*rarbrhrerrrr rr rirfr;r.rrrr}rrgr_rr{rYr/r-rrs Kcd !&=?  #     sCx 9:    2#2d#1#1MQ #  #27c58H2I #  #<<<r?c|j|k(r|s|St|j|jvrQi|jt|j<|j|jt|jd<|j|jt|jvr|j |jt|j|j}|r|J|j J|j }t |j|j|jS|j }|$t}t|t fsJ||_|j|j|||}t|tsJd|j Jd|j S)rmrDrE) rFrNrOrKrPr#r"rrkrQ _add_objectr;r )r,r9r>r?dupidrefrVs r-r;zIndirectObject.clone[s 88x K dhh ::00DHH> >%%h&=&=bl&KDJJ&WXC&--999..%ekk53C3CUYYOO//#C{ l!$(9:::)-&&& (O]CC#y)161)%%19691%%%r/c|Sr1rYr+s r-r#z!IndirectObject.indirect_referencerZr/c<|jj|}|Sr1)rFrP)r,rVs r-rPzIndirectObject.get_objects#'88#6#6t#< r/memocXt|j|j|jSr1)r"rKrrF)r,rs r- __deepcopy__zIndirectObject.__deepcopy__sdjj$//488DDr/c|j}t|tr,t|j d|j |S)Nz references an IndirectObject )rPrQr"rr}rs r-_get_object_with_checkz%IndirectObject._get_object_with_checksH OO  a ( ==?##A!**,P r/namecp t|j|S#t$rtd|dwxYw)Nz No attribute z* found in IndirectObject or pointed object)getattrrrHr,rs r- __getattr__zIndirectObject.__getattr__sF 4668$? ?  v%OP  s5keyc(|j|Sr1rr,rs r- __getitem__zIndirectObject.__getitem__s**,S11r/c&||jvSr1rrs r- __contains__zIndirectObject.__contains__sd11333r/c>|jjSr1)r__iter__r+s r-rzIndirectObject.__iter__s**,5577r/c>|jjSr1)rP __float__r+s r-rzIndirectObject.__float__s **,,r/c>|jjSr1)rP__int__r+s r-rzIndirectObject.__int__ ((**r/c>|jjSr1)rP__str__r+s r-rzIndirectObject.__str__rr/chd|jd|jdt|jdS)NzIndirectObject(z, ))rKrrNrFr+s r-r}zIndirectObject.__repr__s/ b0C2bl^STUUr/r~c|duxr`t|txrN|j|jk(xr3|j|jk(xr|j|juSr1)rQr"rKrrFrs r-rzIndirectObject.__eq__sc   &5.1 & ekk) &5#3#33 &EII%  r/c&|j| Sr1)rrs r-__ne__zIndirectObject.__ne__s;;u%%%r/r[r\c| tdd|j|jd|jdj y)Nrsrt z R)rrvrKrr3r^s r-r_zIndirectObject.write_to_streamsD  % &A7    |1T__$5R8??ABr/cd} |jd}|stt|jrn||z }9d} |jd}|stt|jr|s6n||z }r?cNtd|jt|||S)rmr)r rWrrAs r-r;zFloatObject.clones+   ! !+d"3X O  r/cDt|j|jfSrorqr) as_numericr+s r-r.zFloatObject.hash_binsT^^T__566r/c|dk(rytttt|z }|dt d|dj dj dS)Nr0.0.rCf0)FLOAT_WRITE_PRECISIONrfrabsmaxrstrip)r,nbs r-myreprzFloatObject.myreprsS 19 "Ss4y)9%: :qQ Ao&..s3::3??r/c"|jSr1)rr+s r-r}zFloatObject.__repr__s{{}r/ct|Sr1)rr+s r-rzFloatObject.as_numerics T{r/r[r\c|| tdd|j|jjdyNrsrtutf8)rrvrr3r^s r-r_zFloatObject.write_to_streams6  % &A7   T[[]))&12r/)rNr`r1)r*rarbrr rrrhrr rirfr;r.rr}rrrrgr_rYr/r-rrs:>++*23-+ +(!&=?       sCx 9:    7#7@@ #EMQ3 327c58H2I3 3r/rc eZdZejdZdZdedefdZ ddede de e e eefddfd Zdefd Zdefd Z dd ede d eefdd fdZed ede dfdZy ) NumberObjects [^+-.0-9]@rr$c tj|t|S#t$r+tdt|tj|dcYSwxYw)Nz.NumberObject(%(value)s) invalid; use 0 instead)rrr)rfr ValueErrorrr*)rrs r-rzNumberObject.__new__+sK ';;sCJ/ / ' KT\di j;;sA& & 's!1AAr9r>r?cNtd|jt|||S)rmr)r rWrrAs r-r;zNumberObject.clone2s+   ! !,t"4h P  r/cLt|j|jfSrorr+s r-r.zNumberObject.hash_bin>sT^^T__%6788r/cHtt|jdS)Nr)rfreprr3r+s r-rzNumberObject.as_numericHs4:$$V,--r/Nr[r\cr| tdd|jt|jdyr)rrvrr3r^s r-r_zNumberObject.write_to_streamKs4  % &A7   T$Z&&v./r/)rrct|tjtj}d|vr t |St|S)Nr[regexlength.)rr NumberPattern _LENGTH_LIMITr)r[nums r-r{zNumberObject.read_from_streamTs:fL4N4NWcWqWqr 3;s# #C  r/r`r1)r*rarbrecompilerrrrrrhr rr rirfr;r.rrrgr_rr{rYr/r-rr'sBJJ|,MM'C'D'!&=?       sCx 9:    9#9.C.MQ0 027c58H2I0 0!!6S0T!!r/rc eZdZdZ ddededeeee e fddfdZ de fdZ e defdZ dd ed ed e efdd fd Zde fd Zy )ByteStringObjecta> Represents a string object where the text encoding could not be determined. This occurs quite often, as the PDF spec doesn't provide an alternate way to represent strings -- for example, the encryption data stored in files (like /O) is clearly not text, but is still stored in a "String" object. r9r>r?r$c `td|jtt|||S)rmr)r rWrrgrAs r-r;zByteStringObject.clonees2   ! ! t-x   r/cBt|jt|fSro)rqr)rgr+s r-r.zByteStringObject.hash_binssT^^U4[122r/c|S)z7For compatibility with TextStringObject.original_bytes.rYr+s r-original_byteszByteStringObject.original_bytes}s  r/Nr[r\c| tdd|jd|jtj||jdy)Nrsrt<>)rrvbinasciihexlifyr^s r-r_z ByteStringObject.write_to_streamsH  % &A7   T X%%d+, Tr/cdgttj}|D]} |j|cSt d#t$rY.wxYw)Nutf-16zCannot decode ByteStringObject.)list NameObjectCHARSETSdecodeUnicodeDecodeErrorr)r,charset_to_tryencs r-rzByteStringObject.__str__s_"?T**=*=%>?! C {{3''  <==&  sA A Ar`r1)r*rarb__doc__rrhr rr rirfr;r.rrgrrr_rrYr/r-rr\s!&=?       sCx 9:    3#3 MQ   27c58H2I   >>r/rc eZdZUdZeed<eed<eed<dZeeed<de de fd Z dd e d ed ee e eefddfd ZdefdZedefdZdefdZdefdZ ddede deefddfdZy)TextStringObjectz A string object that has been decoded into a real unicode string. If read from a PDF document, this string appeared to match the PDFDocEncoding, or contained a UTF-16BE BOM mark to cause UTF-16 decoding to occur. autodetect_pdfdocencodingautodetect_utf16 utf16_bomN_original_bytesrr$cd}t|tr|}|jd}tj ||}||_d|_d|_d|_|e|ddtjtjhvr@ tj ||jd}||_d|_|dd|_|S t#|d|_|S#t$rc}tdt||jtj ||jd|j jd}Yd}~d}~wwxYw#t$$r d|_tj|_Y|SwxYw) NcharmapFr/r rz1%(exception)s; initial string: %(initial_string)r)r exceptioninitial_stringT)rQrgrrirrrrrcodecs BOM_UTF16_LE BOM_UTF16_BErrr*rstartencode_pdfdocencodingUnicodeEncodeError)rrrtext_string_objectr s r-rzTextStringObject.__new__s} eU #"NLL+E [[e4-;*.3+7<4'*$  %.!*<ATATV\ViVi@j*j l%([[n6K6KH6U%V"2@  .26  /+9"1+=  ("!  C%&89?C"<"!%& lG#'#,#3#3  &)[[i6F6FGX6Y6`6`ai6j%k" l& C6:"3/5/B/B",!! Cs+%CE EAD;;E%E,+E,r9r>r?ct|}|j|_|j|_|j|_|j|_t d|j |||S)rmr)rrrrrr rW)r,r9r>r?rVs r-r;zTextStringObject.clonesdt$"22(,(F(F%#44   5 5c8_ U  r/cDt|j|jfSro)rqr)rr+s r-r.zTextStringObject.hash_binsT^^T%8%89::r/cR|j |jS|jS)a- It is occasionally possible that a text string object gets created where a byte string object was expected due to the autodetection mechanism -- if that occurs, this "original_bytes" property can be used to back-calculate what the original encoded bytes were. )rget_original_bytesr+s r-rzTextStringObject.original_bytess+    +'' '&&((r/c||jr|jtjk(r"tj|j dzS|jtj k(r"tj |j dzS|j dS|j r t|Std)Nutf-16leutf-16bez#no information about original bytes) rrr"r#r3r$rr&rGr+s r-r,z#TextStringObject.get_original_bytess  ~~!4!44**T[[-DDD~~!4!44**T[[-DDD;;z* *  ) )(. .=>>r/c |j |jS|jrtdddddt|}|S#t$r|jt j k(r%t j |jdz}Y|S|jt jk(r%t j|jdz}Y|S|jd}Y|SwxYw)Nforcedr.r/) rrr'r&rr"r#r3r$)r,bytearrs r-get_encoded_bytesz"TextStringObject.get_encoded_bytess 2##/+++$$(Xr2rBB+D1G" 2~~!4!44 -- J0GG  6#6#66 -- J0GG++j1 2s#A&AAC$ ?C$C$#C$r[r\cT| tdd|j}|jdtd|D]Y}t t |d}|j s#|dk7r|jdt|zI|j|[|jdy) Nrsrt(cr s\%03o))rr5rvrr rgisalnumord)r,r[r\r4c_r8s r-r_z TextStringObject.write_to_streams  % &A7 ((* Tc7+ BUBqE"A99;19  YQ/0 Q   Tr/r`r1)r*rarbrrhrergrr rrrrr rirfr;r.rrr,r5rr_rYr/r-rrs $#'+OXe_+#"C#"D#"P!&=?     sCx 9:    ;#; ) ) )?E? 5(MQ 27c58H2I r/rc eZdZUejdZdZidDcic] }t|d|dj"c}}}e dDcic] }t|d|dj"c}}}Z e e e efed<dZ dd ed ed eeee efd dfd Zd efdZ ddedede efd dfdZd efdZddZed efdZeded efdZ dZ!ededed dfdZ"ycc}}}wcc}}}w)rs\s+|[\(\)<>\[\]{}/%]/s #()<>[]{}/%#02X!renumber_tableir9r>r?r$cNtd|jt|||S)rmr)r rWrrAs r-r;zNameObject.clone2s+   ! !*T"2Ho N  r/c0t|j|fSrorpr+s r-r.zNameObject.hash_bin>sT^^T*++r/Nr[r\c^| tdd|j|jy)Nrsrt)rrvrenumberr^s r-r_zNameObject.write_to_streamHs+  % &A7   T]]_%r/c|djd}|dk7rtd|dd|g}|ddD]N}|dkDr(|jd |jdD0 |j|j|Pd j |S#t $r#|j|jdYwxYw) Nrutf-8r?zz&NameObject.renumber..[s!Maq3[//1Ms r/)r3rextendrSrCKeyErrorjoin)r,outpartsr8s r-rGzNameObject.renumberQs1gnnW% $; &NtfTUV ab 4A3w M188G;LMM4LL!4!4Q!78  4xx 4LL'!234s#B)C?Cct|jd}tjdd|}tjdd|}t d|zS)a0 Sanitize the NameObject's name to be a valid PDF name part (alphanumeric, underscore, hyphen). The _sanitize method replaces spaces and any non-alphanumeric/non-underscore/non-hyphen with underscores. Returns: NameObject with sanitized name. /r_z[^a-zA-Z0-9_-])ri removeprefixrsubrrs r- _sanitizezNameObject._sanitizecsL4y%%c*vvdC&vv'd3#*%%r/ctdddy)Nsurfixprefixrtr?)r)rs r-r[zNameObject.surfixrs$XxAr/sinc2t}d}|t|kr^|||dzdk(r+ |jt||dz|dzd|dz }D|j|||dz }|t|kr^t |S#tt f$rYDwxYw)NrrC#r ) bytearrayrLrSrfrrRrg)r]resultrUs r-unnumberzNameObject.unnumberws #c(l1QU|t#MM#c!a%!a%&8""=>FA MM#a& ! FA#c(lV} #J/s)BBB)rIgbklatin1rFcP|jd}|tjk7r td|t |tj tj z } tj|}tjD] } |j|}t|cStd|ddd#t$rY=wxYw#ttf$rR}|js1tdt|t|jd cYd}~Std |d |d}~wwxYw) NrCzName read errorrr1rzCode Not FoundzVIllegal character in NameObject (%(name)r), you may need to adjust NameObject.CHARSETS)rrrz!Illegal character in NameObject (z.). You may need to adjust NameObject.CHARSETS.)ryrr\rrdelimiter_patternrrcrrrGrr'strictrr*)r[rFrrretrs r-r{zNameObject.read_from_streams%{{1~ :$$ $01 1  j6R6R[e[s[stt &&t,D!** ++c*C%c?*  %Rq!5EF F!#$67 ::l# "$++i"8993D8<>>  sN(CB5"C%C5 C>CCCD%7D  D%D  D%r`r1)r$r)#r*rarbrrrgr\chrr3rangerCrdictrirgrerrrhr rr rfr;r.rr_rGrYrr[rrcrr{)rLrUrjs000r-rr)s" #;< F21? @ @A3q6Qqg;%%' ' @216r ; ;A3q6Qqg;%%' ' ;2NHT#u*-.M !&=?       sCx 9:    ,#,MQ& &27c58H2I& &%$ &ue"*H#, A ;s %C7 %C> runicode_stringr$c t|Dcgc] }t| c}Scc}w#t$rtd|dddwxYw)Npdfdocencodingr3z#does not exist in translation table)rgrrPr')rmks r-r&r&sQ  ~F!*1-FGGF       1    s '"''ArMc|duxsDt|txr2|jduxst|jtS)z< Returns: True if x is None or NullObject. N)rQr rPrk)rMs r-is_null_or_nonerrsE 9 1i  O \\^t # Mz!,,.*'Mr/)9r r"rcrsyscollections.abcrmathrstructrtypingrrrr r r version_infortyping_extensionsr_codecsr _protocolsrr_utilsrrrrrrrerrorsrrr __author____author_email__r rkrr"rrrrfrrgrrirrr&rrrYr/r-rsF6  $AABQ7" +w&*=PO  /O"!O"d--`=ui8>vOsIOd~i~B  #  %   s ytZ/O)PQ r/