PǻiHddlZddlZddlZddlZddlZddlmZddlmZddl 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 dded ed edefdZdedfdZ 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 Q/opt/lhia/marcimex/agent/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;cr |s|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<|sr|j |jt|jvrD|j|jt|j|j }|J|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  PreventGCr)r#pdf ExceptionAttributeError incremental_readeridnumlen_objectsid_id_translated get_object IndexErrorappendr")r,r;r9r>indiobjs r-_reference_clonezPdfObject._reference_clones" "u'?'?'C'Cx'O  ))C  8+++ S!2!233 AH%%&*A ?#''{("9"9979''377 4DGGG''377 4[A#II!8!8CGG!EE))++BswwK8C& >?H # #BswwK 0 ; '',H  a!e $$2!Q#A  I     L 6 '    $ $U +H%%&A 's4G G)3G: G&%G&) G76G7:9H65H6c|S)zResolve indirect references.r+s r-rOzPdfObject.get_object r/Nstreamencryption_keyctr1)r(r,rYrZs r-write_to_streamzPdfObject.write_to_streams "!r/FrW)Fr1)r* __module__ __qualname__hashlibsha1r!r__annotations__r intr.bytesr4r8rr=boolrr strr;rrrUrOrr]rWr/r-r r @s07 Ix,-< !122  #  ""E $#$ $(!&=?  #   sCx 9:    @PU88$58HL8 8tH[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.ri)r rUrirAs r-r;zNullObject.clones' $// hX  r/c.t|jfSr&hashr)r+s r-r.zNullObject.hash_binsT^^%&&r/NrYrZcB| 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)NrszCould not read Null object)readrri)rYnulltxts r-read_from_streamzNullObject.read_from_streams+++a. g ;< <|r/cy)NrirWr+s r-__repr__zNullObject.__repr__sr/otherc"t|tSr1) isinstancerir,r|s r-__eq__zNullObject.__eq__s%,,r/c"|jSr1r.r+s r-__hash__zNullObject.__hash__}}r/r^r1)r*r_r`rrfr rr rgrdr;r.rrer] staticmethodryr{objectrrrWr/r-riris!&=?  #     sCx 9:    '#'MQ 27c58H2I   #-F-t-#r/ric eZdZdeddfdZ ddededeee e e fddfdZ de fd Z d 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)rkr)r rUrrrAs r-r;zBooleanObject.clones/   ! !- ";X W  r/cDt|j|jfSrm)ror)rr+s r-r.zBooleanObject.hash_binsT^^TZZ011r/oct|tr|j|jk(St|tr|j|k(Sy)NF)r~rrrfr,rs r-rzBooleanObject.__eq__s: a '::( ( a ::? "r/c"|jSr1rr+s r-rzBooleanObject.__hash__rr/c"|jrdSdS)NTrueFalserr+s r-r{zBooleanObject.__repr__"sv00r/rYrZc~| tdd|jr|jdy|jdy)Nrqrrtruesfalse)rrrtr\s r-r]zBooleanObject.write_to_stream%s8  % &A7  :: LL ! LL "r/c|jd}|dk(r tdS|dk(r|jdtdStd)NrvrTsfalsrCFzCould not read Boolean object)rwrr)rYwords r-ryzBooleanObject.read_from_stream1sJ{{1~ 7? & & 7? KKN ' ':;;r/r^r1)r*r_r`rrrrfr rr rgrdr;r.rrrr{rrer]rryrWr/r-rrscd !&=?  #     sCx 9:    2#2d#1#1MQ #  #27c58H2I #  #<<<r?cz|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|||}|Jd|j Jd|j S)rkrDmypy) rErMrNrJrOr#r"rrir~ _add_objectr;)r,r9r>r?dupidrefrTs r-r;zIndirectObject.cloneUs 88x K dhh ::00DHH> >%%h&=&=bl&KDJJ&WXC&--999..%ekk53C3CUYYOO//#C{ l!$(9:::)-&&& (O]CC&&%%19691%%%r/c|Sr1rWr+s r-r#z!IndirectObject.indirect_referenceyrXr/c8|jj|Sr1)rErOr+s r-rOzIndirectObject.get_object}sxx""4((r/memocXt|j|j|jSr1)r"rJrrE)r,rs r- __deepcopy__zIndirectObject.__deepcopy__sdjj$//488DDr/c|j}t|tr,t|j d|j |S)Nz references an IndirectObject )rOr~r"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)getattrrrGr,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)rO __float__r+s r-rzIndirectObject.__float__s **,,r/c>|jjSr1)rO__int__r+s r-rzIndirectObject.__int__ ((**r/c>|jjSr1)rO__str__r+s r-rzIndirectObject.__str__rr/chd|jd|jdt|jdS)NzIndirectObject(z, ))rJrrMrEr+s r-r{zIndirectObject.__repr__s/ b0C2bl^STUUr/r|c|duxr`t|txrN|j|jk(xr3|j|jk(xr|j|juSr1)r~r"rJrrErs r-rzIndirectObject.__eq__sc   &5.1 & ekk) &5#3#33 &EII%  r/c&|j| Sr1)rrs r-__ne__zIndirectObject.__ne__s;;u%%%r/rYrZc| tdd|j|jd|jdj y)Nrqrr z R)rrtrJrr3r\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)rkr)r rUrrAs r-r;zFloatObject.clones+   ! !+d"3X O  r/cDt|j|jfSrmror) as_numericr+s r-r.zFloatObject.hash_binsT^^T__566r/c|dk(rytttt|z }|dt d|dj dj dS)Nr0.0.rCf0)FLOAT_WRITE_PRECISIONrdrabsmaxrstrip)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/rYrZc|| tdd|j|jjdyNrqrrutf8)rrtrr3r\s r-r]zFloatObject.write_to_streams6  % &A7   T[[]))&12r/)rNr^r1)r*r_r`rr rrrfrr rgrdr;r.rr{rrrrer]rWr/r-rrs:> + +*23- +  +"!&=?       sCx 9:    7#7@@ #EMQ3 327c58H2I3 3r/rc eZdZejdZdedefdZ ddede de e e e efddfdZdefd Zdefd Z dd ed e d e efdd fdZed ede dfdZy ) NumberObjects [^+-.0-9]rr$c tj|t|S#t$r-td|dttj|dcYSwxYw)Nz NumberObject(z) invalid; use 0 insteadr)rdr ValueErrorrr*)rrs r-rzNumberObject.__new__ sP ';;sCJ/ / ' ]5'1IJH U;;sA& & 's!3AAr9r>r?cNtd|jt|||S)rkr)r rUrrAs r-r;zNumberObject.clone's+   ! !,t"4h P  r/cLt|j|jfSrmrr+s r-r.zNumberObject.hash_bin3sT^^T__%6788r/cHtt|jdS)Nr)rdreprr3r+s r-rzNumberObject.as_numeric=s4:$$V,--r/NrYrZcr| tdd|jt|jdyr)rrtrr3r\s r-r]zNumberObject.write_to_stream@s4  % &A7   T$Z&&v./r/)rrcjt|tj}d|vr t|St|S)N.)rr NumberPatternr)rYnums r-ryzNumberObject.read_from_streamIs1v|'A'AB 3;s# #C  r/r^r1)r*r_r`recompilerrrrrfr rr rgrdr;r.rrrer]rryrWr/r-rrsBJJ|,M'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)rkr)r rUrrerAs r-r;zByteStringObject.cloneZs2   ! ! t-x   r/cBt|jt|fSrm)ror)rer+s r-r.zByteStringObject.hash_binhsT^^U4[122r/c|S)z7For compatibility with TextStringObject.original_bytes.rWr+s r-original_byteszByteStringObject.original_bytesrs  r/NrYrZc| tdd|jd|jtj||jdy)Nrqrr<>)rrtbinasciihexlifyr\s r-r]z ByteStringObject.write_to_streamwsH  % &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*r_r`__doc__rrfr rr rgrdr;r.rrerrr]rrWr/r-rrQs!&=?       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$re}t|d|jttj ||jd|j jd}Yd}~d}~wwxYw#t$$r d|_tj|_Y|SwxYw)NcharmapFr/r rz initial string:T)r~rer rgrrrrrcodecs BOM_UTF16_LE BOM_UTF16_BEr rrr*startencode_pdfdocencodingUnicodeEncodeError)rrrtext_string_object exceptions 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"<"!!& l m#4Y5E5E4HI&)[[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)rkr)rrrrrr rU)r,r9r>r?rTs r-r;zTextStringObject.clonesdt$"22(,(F(F%#44   5 5c8_ U  r/cDt|j|jfSrm)ror)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) rrrrr3rrrrFr+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') rrrrrrrr3r)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$rYrZcT| tdd|j}|jdtd|D]Y}t t |d}|j s#|dk7r|jdt|zI|j|[|jdy) Nrqrr(cr s\%03o))rr-rtrr reisalnumord)r,rYrZr,c_r0s r-r]z TextStringObject.write_to_streams  % &A7 ((* Tc7+ BUBqE"A99;19  YQ/0 Q   Tr/r^r1)r*r_r`rrfrcrerr rrrrr rgrdr;r.rrr$r-rr]rWr/r-rrs $#'+OXe_+!"C!"D!"L!&=?     sCx 9:    ;#; ) ) )?E? 5(MQ 27c58H2I r/rc eZdZUejdZdZidDcic] }t|d|dj"c}}}e dDcic] }t|d|dj"c}}}Z e e e efed< dded ed eeee efd dfd Zd efd Z ddedede efd dfdZd efdZddZed efdZeded efdZdZ ededed dfdZ!ycc}}}wcc}}}w)r s\s+|[\(\)<>\[\]{}/%]/s #()<>[]{}/%#02X!renumber_tabler9r>r?r$cNtd|jt|||S)rkr )r rUr rAs r-r;zNameObject.clone$s+   ! !*T"2Ho N  r/c0t|j|fSrmrnr+s r-r.zNameObject.hash_bin0sT^^T*++r/NrYrZc^| tdd|j|jy)Nrqrr)rrtrenumberr\s r-r]zNameObject.write_to_stream:s+  % &A7   T]]_%r/c|djd}|dk7rtd|dd|g}|ddD]N}|dkDr(|jd |jdD0 |j|j|Pd j |S#t $r#|j|jdYwxYw) Nrutf-8r7zz&NameObject.renumber..Ms!Maq3[//1Ms r/)r3rextendrQr;KeyErrorjoin)r,outpartsr0s r-r?zNameObject.renumberCs1gnnW% $; &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. /z\ _z[^a-zA-Z0-9_-])rg removeprefixrsubr rs r- _sanitizezNameObject._sanitizeUsL4y%%c*vveS$'vv'd3#*%%r/ctdddy)Nsurfixprefixrrr7)r)rs r-rSzNameObject.surfixds$XxAr/sinc2t}d}|t|kr^|||dzdk(r+ |jt||dz|dzd|dz }D|j|||dz }|t|kr^t |S#tt f$rYDwxYw)NrrC#r ) bytearrayrKrQrdrrPre)rUresultrSs r-unnumberzNameObject.unnumberis #c(l1QU|t#MM#c!a%!a%&8""=>FA MM#a& ! FA#c(lV} #J/s)BBB)rAgbklatin1rEc4|jd}|tjk7r td|t |tj z } tj |}tjD] } |j|}t|cStd|ddd#t$rY=wxYw#ttf$rT}|js3td|dtt|jdcYd}~Std|d |d}~wwxYw) NrCzName read errorr)rzCode Not Foundz!Illegal character in NameObject (z-), you may need to adjust NameObject.CHARSETSrz.). You may need to adjust NameObject.CHARSETS.)rwr rTrrdelimiter_patternr[r r rFr rstrictrr*)rYrErrretrs r-ryzNameObject.read_from_stream}s*{{1~ :$$ $01 1  )E)EFF &&t,D!** ++c*C%c?*  %Rq!5EF F!#$67 ::7x@AA "$++i"8993D8<>>  sN(B47B%B4B4% B1.B40B11B44D9D<DDDr^r1)r$r )"r*r_r`rrr_rTchrr3ranger;rdictrgrercrrfr rr rdr;r.rr]r?rQrrSrr[r ry)rDrSrbs000r-r r s" #;< F21? @ @A3q6Qqg;%%' ' @216r ; ;A3q6Qqg;%%' ' ;2NHT#u*-.!&=?       sCx 9:    ,#,MQ& &27c58H2I& &%$ &ue"*H#,} A ;s %C5 %C< r unicode_stringr$c t|Dcgc] }t| c}Scc}w#t$rtd|dddwxYw)Npdfdocencodingr+z#does not exist in translation table)rerrHr)reks r-rrsQ  ~F!*1-FGGF       1    s '"''ArEc|duxsDt|txr2|jduxst|jtS)z< Returns: True if x is None or NullObject. N)r~r rOri)rEs r-is_null_or_nonerjsE 9 1i  O \\^t # Mz!,,.*'Mr/)9rrrarsyscollections.abcrmathrstructrtypingrrrr r r version_infortyping_extensionsr_codecsr _protocolsrr_utilsrrrrrrrerrorsrrr __author____author_email__r rirr"rrrrdrrerrgrr rrjrWr/r-rxsF6  $AABQ7" +w&*=PO  /K"!K"\--`;ui8>vMsIM`}i}@  #  %   s ytZ/O)PQ r/