j dZddlZddlZddlZddlZddlZddlZddlZddlZddl m Z m Z ddl m Z m Z mZddlmZddlmZmZmZmZmZmZddlmZmZmZmZmZmZmZmZm Z m!Z!m"Z"ej#rdd l$m%Z%gd Z&d Z'd Z(ej)d *dZ+ej,e-Z.Gddej/Z0de0fdZ1GddZ2Gdde2Z3e dGdde2Z4ej5Gddej/Z6de6j7fddde8d e6d!d"fd#Z9Gd$d"Z:Gd%d&e:Z;Gd'd(e:Z<Gd)d*e:Z=Gd+d,e>e:Z?Gd-d.e:e2Z@Gd/d0ejAe:ZBGd1d2eCe:ZDd3eeEeFeGfd!ed4fd5ZHd6ZId!ed4fd7ZJd!eFfd8ZKd!ed4fd9ZLGd:d;eFe:ZMGd<d=ej/ZNd>eeFeGfd!eNfd?ZOGd@dAeEe:ZPdBZQdCeFd!dDfdEZRGdFdDeEe:ZSdGZTdHZUGdIdJeVe:ZWGdKdLeWZXdMZYdNZZdOZ[e\e[dPksJdQe]e[DZ^eSZ_ePeMeWe?fZ`dRZaGdSdTe:ZbdUZcdVe d!ePfdWZdej)dXZeej)dYZfej)dZZgej)d[Zhd_d\eEd]e8d!e fd^ZidS)`z Implementation of PDF object types and other generic functionality. The internals were imported from PyPDF2, with modifications. See :ref:`here ` for the original license of the PyPDF2 project. N) dataclassfield)datetime timedeltatimezone)BytesIO)AnyCallableIteratorOptionalTupleUnion) IndirectObjectExpectedPdfError PdfReadErrorPdfStreamErrorPdfStrictReadError PdfWriteErroris_regular_characterread_non_whitespaceread_until_delimiterread_until_regexskip_over_whitespaceSecurityHandler) ArrayObject BooleanObjectByteStringObjectDecryptedObjectProxyDereferenceableDictionaryObjectEncryptedObjAccess FloatObjectIndirectObject NameObject NullObject NumberObject PdfObject Reference StreamObjectTextStringEncodingTextStringObjectTrailerReferencepdf_datepdf_name pdf_string read_objectOperatorLiterals/<[tf(n%s+-.z(\d+)\s+(\d+)\s+R[^a-zA-Z]asciic"eZdZdZdZ dZ dZdS)r#zt Defines what to do when an encrypted object is encountered when retrieving an object from a container. rrN)__name__ __module__ __qualname____doc__PROXY TRANSPARENTRAWh/var/www/finuniver-perm.ru/html/portfolio/venv/lib/python3.11/site-packages/pyhanko/pdf_utils/generic.pyr#r#Hs= E K  Cr?r#eoact|tr.|tjkr|jS|tjkr|jS|SN) isinstancer r#r< decryptedr= raw_object)objrAs r@_deproxy_decryptrHgsH#+,," $0 0 0= &* * *> ! Jr?c eZdZdZddZdZdS)r!aD Represents an opaque reference to a PDF object associated with a PDF Handler (see :class:`PdfHandler <.rw_common.PdfHandler>`). This can either be a reference to an object with an object ID (see :class:`.Reference`) or a reference to the trailer of a PDF document (see :class:`.TrailerReference`). returnr)ct)zgRetrieve the PDF object backing this dereferenceable. :return: A :class:`.PdfObject`. NotImplementedErrorselfs r@ get_objectzDereferenceable.get_objectz "!r?ct)zzReturn the PDF handler associated with this dereferenceable. :return: a :class:`~.rw_common.PdfHandler`. rLrNs r@get_pdf_handlerzDereferenceable.get_pdf_handlerrQr?NrJr))r7r8r9r:rPrSr>r?r@r!r!psA"""""""""r?r!c&eZdZdZdZddZdZdS) r.ao A reference to the trailer of a PDF document. .. warning:: Since the trailer does not have a well-defined object ID in files with "classical" cross-reference tables (as opposed to cross-reference streams), this is not a subclass of :class:`.Reference`. :param reader: a :class:`~pyhanko.pdf_utils.reader.PdfFileReader` c||_dSrCreader)rOrXs r@__init__zTrailerReference.__init__s  r?rJr)c|jjSrC)rXtrailerrNs r@rPzTrailerReference.get_objects {""r?c|jSrCrWrNs r@rSz TrailerReference.get_pdf_handlers {r?NrT)r7r8r9r:rYrPrSr>r?r@r.r.sP  ####r?r.T)frozencheZdZUdZeed< dZeed< eddddZe ed< d d Z d Z dS)r*a A reference to an object with a certain ID and generation number, with a PDF handler attached to it. .. warning:: Contrary to what one might expect, the generation number does *not* indicate the document revision in which the object was modified. In fact, nonzero generation numbers are exceedingly rare these days; in most real-world PDF files, objects are simply overridden without ever increasing the generation number. Except in very specific circumstances, dereferencing a :class:`.Reference` will return the most recent version of the object with the stated object ID and generation number. idnumr generationFN)reprhashcomparedefaultpdfrJr)c|jtSddlm}t |j|sJ|j|S)Nr PdfHandler)rer'pyhanko.pdf_utils.rw_commonrhrDrP)rOrhs r@rPzReference.get_objects` 8 << ::::::$(J/////x""4((33555r?c|jSrC)rerNs r@rSzReference.get_pdf_handlers xr?rT) r7r8r9r:int__annotations__r`rreobjectrPrSr>r?r@r*r*s JJJJ%UtLLLCLLL6666r?r*c&eZdZdZdZdZdZdZdS)ContentOpReadingrr6c"|tjkSrC)roNOrNs r@__bool__zContentOpReading.__bool__s'***r?c6|s tjStjSrC)rorr IN_OBJECTrNs r@nestzContentOpReading.nests .#& &#- -r?N)r7r8r9rr GRAPHIC_OPSrursrvr>r?r@rorosA BKI+++.....r?roF container_refas_metadata_streamin_content_streamrJr)cd|d}|dtjt|}|dkrt |}n7|dkr~|d}|dtj|dkr2t|||| }nt|}n|dkr1t||| }n||d ks|d krt|}nT|d krt|}n=|d kr^|d vr|d}|d vt||dtjt||}n|t jkr|rt'|}|st+d|d|dkrt-S|dkrt+dt/|d}n2|dkrt,|}n|t2vrt4|}n|r|rt4|}n|d}|t9| tjt:|t>||}nBt4|}n't+d|d| ||_!|S)aJ Read a PDF object from an input stream. .. note:: The `container_ref` parameter tells the API which reference to register when the returned object is modified in an incremental update. See also here :ref:`here ` for further information. :param stream: An input stream. :param container_ref: A reference to an object containing this one. *Note:* It is perfectly possible (and common) for `container_ref` to resolve to the return value of this function. :param as_metadata_stream: Whether to dereference the object as an XMP metadata stream. :param in_content_stream: Whether we are parsing inside a content stream (where certain kinds of object cannot occur). :return: A :class:`.PdfObject`. rrr6<<)ryrzrzrp)  zFailed to parse z as operator literalnullRz+Indirect object reference in content streamr4NzUnexpected byte 'z' at position )"readseekosSEEK_CUROBJECT_PREFIXESfindr&read_from_streamr"rvread_hex_string_from_streamrrread_string_from_streamrr2rorwisalpharisasciirr'r3decode NUMBER_SIGNSr(isdigitlenINDIRECT_PATTERNmatchr%tellrx) streamrxryrztokidxresultpeekliterals r@r2r2sp> ++a..C KKBK     s # #C axx,,V44 {{1~~ B $$$ 5==%66#5"3"8"8":": 7FF188FF -- M5F5K5K5M5M.   SAXX//77 (00 ''++a..C''F### B $$$V]33 .: : :s{{}} :&v..   NB7BBB   <<  __LMM M !8!899 ,,V44  ..v66   ?!226::FF;;r??D KKT BK 0 0 0%%d++7'88OO%66v>> B B B6;;== B B   )F Mr?cpeZdZUdZdZeeed< defdZdZ d deddee fd Z dS) r)zSuperclass for all PDF objects.NrxrJc6|j}|td|S)z Return a reference to the closest parent object containing this object. Raises an error if no such reference can be found. NzONo container reference available. This object probably wasn't read from a file.)rxr)rOrefs r@get_container_refzPdfObject.get_container_refjs/   ;,  r?c|S)zpResolves indirect references. :return: `self`, unless an instance of :class:`.IndirectObject`. r>rNs r@rPzPdfObject.get_objectws  r?handlerrct)z Abstract method to render this object to an output stream. :param stream: An output stream. :param container_ref: Local encryption key. :param handler: Security handler rLrOrrrxs r@write_to_streamzPdfObject.write_to_stream~s "!r?NN) r7r8r9r:rxr r!rlrrPr*rr>r?r@r)r)Ls))/3M8O,3334 ?    04-1 ""+," * """"""r?c&eZdZdefdZdZdZdS)r3rc||_dSrC)r)rOrs r@rYzOperatorLiteral.__init__s  r?cLt|to|j|jkSrC)rDr3rrOothers r@__eq__zOperatorLiteral.__eq__s" uo . . P4<5=3P r?c.td|jfS)Nop)rbrrNs r@__hash__zOperatorLiteral.__hash__sT4<()))r?N)r7r8r9strrYrrr>r?r@r3r3sM   *****r?r3cXeZdZdZ d dedfdZedZdZdZ d Z dS) r'zO PDF `null` object. All instances are treated as equal and falsy. Nrrc0|ddS)Nr)writers r@rzNullObject.write_to_streams  Wr?cr|d}|dkrtdtS)NrrzCould not read Null object)rrr')rnulltxts r@rzNullObject.read_from_streams5++a.. g  ;<< <||r?c4||upt|tSrC)rDr'rs r@rzNullObject.__eq__su}= 5* = ==r?c tdSrC)rbrNs r@rzNullObject.__hash__sDzzr?cdS)NFr>rNs r@rszNullObject.__bool__sur?r) r7r8r9r:r r staticmethodrrrrsr>r?r@r'r's04 +,\ >>>r?r'cdeZdZdZdZ d dedfdZedZdZ d Z d Z d Z dS) rzPDF boolean value.c||_dSrC)value)rOrs r@rYzBooleanObject.__init__s  r?Nrrcl|jr|ddS|ddS)Ntruesfalse)rrrs r@rzBooleanObject.write_to_streams> : # LL ! ! ! ! ! LL " " " " "r?c|d}|dkrtdS|dkr(|ddkrtdStd) NrrTsfalsreFzCould not read Boolean object)rrr)rwords r@rzBooleanObject.read_from_streamsc{{1~~ 7?? && & W__{{1~~%%$U+++:;;;r?c*t|jSrC)boolrrNs r@rszBooleanObject.__bool__sDJr?czt|ttfot|t|kSrC)rDrrrs r@rzBooleanObject.__eq__s<%-!677 DJJ$ K K =  r?c:tt|SrC)rrrNs r@__str__zBooleanObject.__str__s4::r?c t|SrC)rrNs r@__repr__zBooleanObject.__repr__s4yyr?r) r7r8r9r:rYr rrrrsrrrr>r?r@rrs 04 # #+, # # # #<<\<      r?rceZdZdZdZejfdefdZejfdefdZ d de dfd Z e e j fd e fd ZdS) ra PDF array object. This class extends from Python's list class, and supports its interface. .. warning:: Contrary to the case of dictionary objects, PyPDF2 does not transparently dereference array entries when accessed using :meth:`__getitem__`. For usability & consistency reasons, I decided to depart from that and dereference automatically. This makes the behaviour of :class:`.ArrayObject` consistent with :class:`.DictionaryObject`. That said, some vestiges of the old PyPDF2 behaviour may linger in the codebase. I'll fix those as I get to them. cP||SrC)raw_getrP)rOindexs r@ __getitem__zArrayObject.__getitem__s ||E""--///r?decryptc#xKtt|D]}|||VdSrC)rangerr)rOrixs r@iteratezArrayObject.iteratesLD "" , ,B,,r7++ + + + + , ,r?cXt||}t||S)ay .. versionchanged:: 0.14.0 ``decrypt`` parameter is no longer boolean Get a value from an array without dereferencing. In other words, if the value corresponding to the given key is of type :class:`.IndirectObject`, the indirect reference will not be resolved. :param index: Key to look up in the dictionary. :param decrypt: What to do when retrieving encrypted objects; see :class:`.EncryptedObjAccess`. The default is :attr:`.EncryptedObjAccess.TRANSPARENT`. :return: A :class:`.PdfObject`. )listrrH)rOrrvals r@rzArrayObject.raw_gets)0tU++W---r?Nrrc|d|D]/}|d||||0|ddS)N[ )rrxs ])rr)rOrrrxdatas r@rzArrayObject.write_to_streamsz  T  D LL     } !      Ur?rzc0t}|d}|dkrtd t|}|dkrnF|dt j|t|||\|S)NrrzCould not read arrayT]r|r) rrrrrrrappendr2)rrxrzarrtmp peekaheads r@rzArrayObject.read_from_stream,s mmkk!nn $;;566 6 +F33ID   KKBK ( ( ( JJM=N     r?r)r7r8r9r:rr#r<rrr rrrorrrr>r?r@rrs"000-?,J,,),,,,'9&D..$....<04  +,    /?.A,\r?rceZdZdZdZdZdZedefdZ edZ dZ d Z d Z d Z dd edfdZeddZd S)r%a Thin wrapper around a :class:`.Reference`, implementing both the :class:`.Dereferenceable` and :class:`.PdfObject` interfaces. .. warning:: For many purposes, this class is functionally interchangeable with :class:`.Reference`, with one important exception: :class:`.IndirectObject` instances pointing to the same reference but occurring at different locations in the file may have distinct `container_ref` values. c2t||||_dSrC)r* reference)rOr_r`res r@rYzIndirectObject.__init__Rs"5*c::r?c|j}t|tr|n|S)zC :return: The PDF object this reference points to. )rrPrDr%)rOrGs r@rPzIndirectObject.get_objectUs=n'')) $.c>#B#BKs~~Kr?c4|jSrC)rrSrNs r@rSzIndirectObject.get_pdf_handler`s~--///r?rJc|jjS)z; :return: the object ID of this reference. )rr_rNs r@r_zIndirectObject.idnumcs ~##r?c|jjS)zC :return: the generation number of this reference. )rr`rNs r@r`zIndirectObject.generationjs ~((r?c(d|jd|jdS)NzIndirectObject(z, ))r_r`rNs r@rzIndirectObject.__repr__qs+/:::tGGr?c8t|j|jfSrC)rbr_r`rNs r@rzIndirectObject.__hash__wsTZ1222r?cT|duo$t|to|j|jkSrC)rDr%rrs r@rzIndirectObject.__eq__zs2   25.11 2%/1 r?c.|| SrC)rrs r@__ne__zIndirectObject.__ne__s;;u%%%%r?NrrcN|d|j|jfzdS)Ns%d %d R)rr_r`rs r@rzIndirectObject.write_to_streams*  Z4:t"??@@@@@r?rxr!cd} |d}|std|r|s>n||z }Dd} |d}|std|r|s>n||z }Dt|}|dkr3t |}t d|z t|t|}}|dkr|dkstnA#t$r4t |}t d|wxYwtt|t|| S) Nr?TrStream has ended unexpectedlyrz2Error reading indirect object reference at byte %srz0Parse error on indirect object reference around ) rrisspacerhexrrrk ValueErrorr%rS) rrx idnum_strrgeneration_strrposr_r`s r@rzIndirectObject.read_from_streams  ++a..C F$%DEEE{{}}    I  "++a..C F$%DEEE{{}} % c !N "  ' ' 99fkkmm$$CDsJ   #IN0C0C:EAII*//  #2   fkkmm$$CH3HH     NNC//1N1N1P1P   s 1D >Er)rxr!)r7r8r9r:rYrPrSpropertyrkr_r`rrrrr rrrr>r?r@r%r%Es&  ;;; L L L000$s$$$X$ ))X) HHH 333   &&& 04 AA+,AAAA( ( ( \( ( ( r?r%cDeZdZdZd dZdZdZ d dedfd ZdS) r$z PDF Float object. Internally, these are treated as decimals (and therefore actually fixed-point objects, to be precise). 0c\tj|t|SrC)decimalDecimal__new__r)clsrs r@rzFloatObject.__new__s &&sCJJ777r?c||kr4t|tjdSt|S)Nr) to_integralrquantizerrrNs r@rzFloatObject.__repr__sI 4##%% % %t}}W_Q%7%78899 9t99 r?c t|S)zD :return: a Python ``float`` value for this object. )floatrNs r@ as_numericzFloatObject.as_numericsT{{r?Nrrcp|t|ddSNr4rraencoders r@rzFloatObject.write_to_stream0  T$ZZ&&w//00000r?)rr) r7r8r9r:rrrr rr>r?r@r$r$s8888 04 11+,111111r?r$cveZdZdZejdZdZdZdZ d de dfd Z e d Z dS) r(zE PDF number object. This is the PDF type for integer values. s [^+-.0-9].cVt|}t||SrC)rkr)rrrs r@rzNumberObject.__new__s!%jj{{3$$$r?c t|S)zB :return: a Python ``int`` value for this object. )rkrNs r@rzNumberObject.as_numerics4yyr?Nrrcp|t|ddSr r rs r@rzNumberObject.write_to_streamr r?ct|tjd}|tjdkr"t |dSt|dS)NT)regex ignore_eofr|r4)rr( NumberPatternrByteDotr$r)rnums r@rzNumberObject.read_from_streamsr ,     88L( ) )R / /szz'2233 3 7 3 344 4r?r)r7r8r9r:recompilerrrrr rrrr>r?r@r(r(sBJ|,,MG%%%04 11+,1111 5 5\ 5 5 5r?r(string)rr-cTt|trt|St|ttfrZt |} t||}||_|S#t$rt|cYSwxYwtd)z Encode a string as a :class:`.TextStringObject` if possible, or a :class:`.ByteStringObject` otherwise. :param string: A Python string. z'pdf_string should have str or bytes arg) rDrr-bytes bytearray_guess_enc_by_bomrautodetected_encodingUnicodeDecodeErrorr TypeError)rguessedretvals r@r1r1s&# C''' FUI. / / C#F++ ,%gnnV&<&<==F+2F (M! , , ,#F++ + + + ,ABBBs*A<<BBs0123456789abcdefABCDEFcddfd}tjd|rdndz}t |S)zp Read a hex string from a stream into a PDF string object. :param stream: An input stream. rFc3K t}|dkrdS|tvrtdt|z|V G)NT>z Unexpected token in hex string: )r HEX_DIGITSrra)roddrs r@ read_tokensz0read_hex_string_from_stream..read_tokens,si %f--Cd{{J&&$6cBIII'C r?r?0)rbinascii unhexlifyjoinr1)rr*rr)s` @r@rrs KKNNN C        3#744C8F f  r?c|dd}t} |d}|std|dkr|dz }n]|dkr|dz}|dkrnanH|dkrA|d}|dvrn&|d krd }n|d krd }n|d krd}n|dkrd}n|dkrd}n|rt dD]Q}|d}|r||z }1|dt jt|d}t|f}n_|dvr<|d}|dvr |dt jd}ntdt|z| || S)NrTr()r\s() /%<>[]#_&$\nrrrt bf r6r|)bases r?zUnexpected escaped string: )rrrrrrrrrkrrrargetvalue)rparenstxtrintokoctals r@_read_string_literal_bytesrC?s  KKNNN F ))C6kk!nn B !@AA A $;; aKFF D[[ aKF{{ E\\++a..C((( N qA!;;q>>D||~~t  B 444Ca(((UHookk!nng%%KKBK000"#@499#LMMM #m6n <<>>r?c:tt|S)z Read a PDF string literal from a stream. Attempt to decode it into a text string by autodetecting the encoding, or failing that, return it as a byte string instead. :param stream: An input stream. )r1rC)rs r@rr}s 088 9 99r?cJeZdZdZedZ ddedfdZdS)rzPDF bytestring class.c|SrCr>rNs r@zByteStringObject.s4r?NrrcH|}|L|J|}||j|j}|||}|d|t j||ddS)Nr?r@rrscX//00N04 +,r?rceZdZdZdZ ejdfZ ejdfZ ej dfZ de de fdZdee efde fd ZdS) r,z) Encodings for PDF text strings. Nutf-16bezutf-8zutf-16lerrJc|tjkrt|S|j\}}|||zS)z Encode a string with BOM. :param string: The string to encode. :return: The encoded string. )r,PDF_DOCencode_pdfdocencodingrr )rOrbomencs r@r zTextStringEncoding.encodesC %- - -(00 0zHCs+++ +r?c|tjkrt|S|tjkr|dS|dS)z Decode a string with BOM. :param string: The string to encode. :return: The encoded string. :raise UnicodeDecodeError: Raised if decoding fails. z utf-8-sigzutf-16)r,rUdecode_pdfdocencodingUTF8r)rOrs r@rzTextStringEncoding.decodesT %- - -(00 0 ', , ,==-- -==** *r?)r7r8r9r:rUcodecs BOM_UTF16_BEUTF16BEBOM_UTF8r[ BOM_UTF16_LEUTF16LErrr rrrr>r?r@r,r,sG"J/G OW %D"J/G ,S ,U , , , ,+U5)#34+++++++r?r,encodedc|tjr tjS|tjr tjS|tjr tjStj SrC) startswithr\r]r,r^r`rar_r[rU)rbs r@rrsr&-.. *!))   F/ 0 0 *!))   FO , ,*!&& "))r?ceZdZUdZdZeeed< dZeeed< e dZ d dedfdZ dS) r-z! PDF text string object. Nr force_output_encodingcb|jr|j|Std)z Retrieve the original bytes of the string as specified in the source file. This may be necessary if this string was misidentified as a text string. z#No information about original bytes)r r rrNs r@rQzTextStringObject.original_bytess6  % B-44T:: :@AA Ar?rrc|j|j|}nC t|}n2#t$r%tj|dz}YnwxYwd}|*|(|jj}|dkrdn|}|\| |j |j }| ||}t|}||dS|d|D]Z} t!| g} | s| dkr|d| zE|| [|ddS)NrS /Identityr0 s\%03or1)rfr rVUnicodeEncodeErrorr\r]crypt_filter_configstring_filter_namerJrKr_r`rLrrrrisalnum) rOrrrxrbrOcf_namerPrGcc_s r@rz TextStringObject.write_to_streams  % 1077==GG  H/55% H H H!- J0G0GG H   =#<1DG K//W5N5N5P5PB >,,#]%=IjjG44G"7++C    ' ' ' ' ' LL    % %A3ZZzz||%T LLQ////LL$$$$ LL     s4,A#"A#r) r7r8r9r:r r r,rlrfrrQrr>r?r@r-r-s;?8$67>>>;?8$67>>> BBXB*04 ))+,))))))r?r-cd|cxkrdkrnn|dz Sd|cxkrdkrnn|dz Sd|cxkrdkrnn|dz Std ) N09AF7afWz6Numeric escape in PDF name must use hexadecimal digits)r) ascii_chars r@ _as_hex_digitr|Ds z!!!!T!!!!!D   # # # #t # # # # #D   # # # #t # # # # #D   D   r? name_bytesr&ct}|dt|} t|}|dkrc t|}t|}n #t$rt d|wxYwt |dzt |z}n3d|cxkrdkrnnt|st d|d d |t|f#t$rYnwxYw| }d }d }|D])} | |}n#t$rY&wxYw|Jt|S) zu Decode the bytes that make up a name object (minus the initial /), expanding all escapes along the way. /T#z!Unterminated escape in PDF name /!~zByte (0x02xz) must be escaped in a PDF name)utf8latin1N) rriternext StopIterationrr|rrr=rrr&) r}r name_itercur_bytedigit1digit2encodings_to_tryname_strrXs r@ _decode_namerQs YYF LLZ  I  -IH4!)__F!)__FF$&JJJJ )0025 f8M8MMh....$.....7K88.#LxLLLL LL{++ , , ,' -(      ""J*H !((--H E    D      h  s<D A*)D*BA=D DD1E EEcFeZdZdZ ddedfdZedZdS)r&z PDF name object. These are valid Python strings, but names and strings are treated differently in the PDF specification, so proper care is required. Nrrct|d}t|dkstd|d|d|D]}|dksd|cxkrdkrnnt |s<|d |d ct|f}||dS) Nr/z Could not serialise name object z, must start with /rrrrz#{:X}r4)rr rrrrformatr)rOrrrx byte_iterras_bytess r@rzNameObject.write_to_streams V,,-- I$&&N4NNN   T! ' 'HD  0000D00000+H551 W^^H55<r?r@r&r&sj04 ''+,''''0((\(((r?ct|ts3t|trt|Std|S)Nzkey must be a name object)rDr&rr)keys r@_normalise_keyrsF c: & &: c3   :c?? "899 9 Jr?c*|}t|d}d}|dkrO|ddkr5t|d|t d}t |t r>|}||}||||}t|}|d} || zd kry|} |d tj |d } | d kr |dd }n5td t| zn|||S)NT) allow_eofsrstream)stop_after_eol/Lengthr;s endstreami r|z:Unable to find 'endstream' marker after stream at byte %s.) rrrrr0rDr%rPrrrrr) rrrrs stream_datalengthtendstreamorig_endstream_posends r@_maybe_read_stream_payloadrs ++--CFd333AKDyyV[[^^x// VD9999hy))* fn - -  A''//F KKNNNkk&))  ' ';;q>> L\ ) )"(  KKR[ ) ) )++a..Cl"")#2#. ")+./A+B+BC *&  C r?ceZdZdZdfd Zejfdeee fdefdZ dZ ddZ d Z d dd d eegeffd ZddefdZ ddedfdZed ejfdddedefdZxZS)r"z A PDF dictionary object. Keys in a PDF dictionary are PDF names, and values are PDF objects. When accessing a key using the standard :meth:`__getitem__` syntax, :class:`.IndirectObject` references will be resolved. Nc|?td|DdStdS)Nc4i|]\}}t||Sr>)r).0kvs r@ z-DictionaryObject.__init__..s&DDD$!Q""ADDDr?)superrYitems)rO dict_data __class__s r@rYzDictionaryObject.__init__sh  GG  DD)//2C2CDDD      GG       r?rrcXt||}t||S)a{ .. versionchanged:: 0.14.0 ``decrypt`` parameter is no longer boolean Get a value from a dictionary without dereferencing. In other words, if the value corresponding to the given key is of type :class:`.IndirectObject`, the indirect reference will not be resolved. :param key: Key to look up in the dictionary. :param decrypt: What to do when retrieving encrypted objects; see :class:`.EncryptedObjAccess`. The default is :attr:`.EncryptedObjAccess.TRANSPARENT`. :return: A :class:`.PdfObject`. )dictrrH)rOrrrs r@rzDictionaryObject.raw_gets).tS))W---r?ct|}t|tstd|j |j|_t |||SNzvalue must be PdfObject)rrDr)rrxr __setitem__rOrrs r@rzDictionaryObject.__setitem__ s\S!!%++ 8677 7   )"&"4E c5111r?ct|}t|tstd|j |j|_t |||Sr)rrDr)rrxr setdefaultrs r@rzDictionaryObject.setdefaultsZS!!%++ 8677 7   )"&"4E tS%000r?crt||}|dkr]t|trHddlm}|}t||sJ||jdS|}t|trt||S)Nz /MetadatarrgT)ry) rrrDr%rirhrSrPrr'KeyError)rOrraw_objrhr deref_objs r@rzDictionaryObject.__getitem__s""4-- +  *Wn"E"E  > > > > > >--//Ggz22 2 2 2%%!d&  **,,I)Z00 !smm#  r?F)rawrdfunctionc~ |r||n||}n#t$r|cYSwxYw||SrCrr)rOrrrrdrs r@ get_and_applyzDictionaryObject.get_and_apply.sZ ),;DLL%%%$s)EE   NNN xs " 11rJcRd}|||d}| |st|S)NcHt|tr|jStrC)rDr%rr)rGs r@as_refz7DictionaryObject.get_value_as_reference..as_ref=s"#~.. %}$( (r?T)r)rr)rOroptionalrrs r@get_value_as_referencez'DictionaryObject.get_value_as_reference<s@ ) ) ) ""3D"99 ==N r?rrcX|dt|D]]\}}|||||d|||||d^|ddS)Ns<< rrs>>)rrrr)rOrrrxrrs r@rz DictionaryObject.write_to_streamGs  Wtzz||,,  JC    ? ? ? LL     ! !&'= A A A LL     Ur?rxr!ryrzc|d}|dkr1tdt|zi}|} t |}|dkr|dn$|dtj t |}nD#t$r7} tdt|z| d} ~ wwxYwt ||dtjt||| } ||vr| ||<nWd t|d |} |j rt| t| P|rd} nt#|||} | 0t$} |r d d lm}|} n#t*$rYnwxYw| || St-|S)Nr6r~z?Dictionary read error at byte 0x%s: stream must begin with '<<'Tr'rr|z=Failed to read dictionary key at byte 0x%s; expected PDF namerz+Multiple definitions in dictionary at byte z for key r)MetadataStream) encoded_data)rrrrrSrrrrr&r Exceptionr2strictrloggerwarningrr+"pyhanko.pdf_utils.metadata.xmp_xmlr ImportErrorr")rrxryrzrrrrrexrerrrstm_clsrs r@rz!DictionaryObject.read_from_streamUsqkk!nn %<<.03FKKMM0B0BC //11 (%f--Cd{{ A KKBK ( ( (  11&99   "S&++--(()   ' ' ' KKBK ( ( ( 9JE$!S  (+6;;=='9'9'9'933@>(,S111NN3'''9 (<  LKK4VT7KKK  "#G! -GG"D74k::: :#D)) )s*1C D 2DD G G,+G,rC)Fr)r7r8r9r:rYr#r<rr&rrrrrr r)r rr*rr rrrorrrr __classcell__rs@r@r"r"s'9&D.. :s? #.$....42221111!!!,    I;+,      Y    04  +,    $).>.A @*@*(@*!@*, @*@*@*\@*@*@*@*@*r?r"c eZdZdZ ddeedeedeededffd Zd ed efd Z e d e fd Z e dddfdedfdZd eeeeeffdZdZdZe d efdZe d efdZ ddee fdZdZe dZ ddedffd ZxZS)r+a PDF stream object. Essentially, a PDF stream is a dictionary object with a binary blob of data attached. This data can be encoded by various filters (not all of which are currently supported, see :mod:`.filters`). A stream object can be initialised with encoded or decoded data. The former is used by :class:`.reader.PdfFileReader` to provide on-demand decoding, with :class:`.writer.BasePdfFileWriter` and its subclasses working the other way around. .. note:: The :class:`.StreamObject` class manages some of its dictionary keys by itself. This is partly the case for the various ``/Filter`` and ``/DecodeParms`` entries, but also for the ``/Length`` entry. The latter will be overwritten as necessary. :param dict_data: The dictionary data for this stream object. :param stream_data: The (unencoded) stream data. :param encoded_data: The encoded stream data. .. warning:: Ordinarily, a stream can be initialised either from decoded and from encoded data. If both `stream_data` and `encoded_data` are provided, the caller is responsible for making sure that both are compatible given the currently relevant filter configuration. :param handler: A reference to the currently active :class:`.pyhanko.pdf_utils.crypt.SecurityHandler`. This is only necessary if the stream requires crypt filters. Nrrrrrctt|||_||_||_dSrC)rrY_data _encoded_data_handler)rOrrrrrs r@rYzStreamObject.__init__s7 ###  ) r?rdecrypted_entriesc8|||_|jr|j}nk|jr|}n|}||j|j}| ||j}| |||S)aJ Internal method to handle decrypting streams that are encrypted with the document's default encryption handler for streams and/or embedded files (i.e. not with any custom crypt filters). This routine is called deep in the object fetching stack, and you should never invoke it yourself. It's defined as a method in :class:`.StreamObject` because it needs to be able to preserve the type (subclass) of the stream object on which it is called, in order to properly feed into the logic surrounding metadata streams. N)rr) r_has_crypt_filterris_embedded_file_streamget_embedded_file_filterget_stream_filterrKr_r`rr)rOrrrdecrypted_datarOrPs r@ _implicit_decrypt_stream_contentz-StreamObject._implicit_decrypt_stream_contents  #DM  ! F".NN+ 15577..00,,SYGGIZZ 43DEEN~~ NG   r?rJcBdd|DvS)N/Cryptc3 K|] \}}|V dSrCr>)rname_s r@ z1StreamObject._has_crypt_filter..s&@@WT1D@@@@@@r?)_filtersrNs r@rzStreamObject._has_crypt_filters$@@ @@@@@r?ric|||_|jtd||jjvrtd|d|p t}t d|d<||d<|t d|d dS) Nz#There is no security handler aroundzThe crypt filter z& is not known to the security handler.z/CryptFilterDecodeParms/Type/NamerT)paramsallow_duplicates)rrrlr"r0 apply_filter)rOrrrs r@add_crypt_filterzStreamObject.add_crypt_filters  #DM =  !FGG G t}8 8 8 PDPPP -+--"#<==ww  X  v      r?c#nK |td}n#t$rYdSwxYwt|tr|f}n$t|tst d |td}t|t r|g}t|tr:t|t|z }|dkr|tg|zz }n/#t$r"tgt|z}YnwxYwt|d|DEd{VdS)N/Filterz5/Filter should be a name object or an array of names. /DecodeParmsrc3>K|]}|VdSrC)rP)r param_sets r@rz(StreamObject._filters..+s.OOI--//OOOOOOr?) r0rrDr&rrr"rrr'zip)rO filter_arr decode_paramslendiffs r@rzStreamObject._filters s hy112JJ    FF  j* - - $JJJ 44  G  = .!9!9:M-)9:: 0!. -.. >j//C ,>,>>Q;;!jll^g%==M = = ='\\NS__Z %C%C>F(**zz';77;FF Bz,7&88< >) M!((}==$ ++ &||~~DJz%%%zr?c|jk|j}|tdt|}t |D]\}}|||}||_|jJ|jS)z Return the encoded stream data as bytes. If the stream hasn't been encoded yet, it will be encoded on-the-fly. :raises .misc.PdfStreamError: If the stream could not be encoded. Nr )rrrtuplerreversedr )rOrdecodersrrs r@rzStreamObject.encoded_datais   %:D|$%9:::T224455H-5h-?-? > >) M!((}==!%D !---!!r?Trc|j}||j|j}t|}t |t st|}$t tst|s'||td<r|td<nt|\}|s||vr|durtd|ddSt|g|R|td<str-fd}t||td<d|_||_dS)a Apply a new filter to this stream. This filter will be prepended to any existing filters. This means that is is placed *last* in the encoding order, but *first* in the decoding order. *Note:* Calling this method on an encoded stream will first cause the stream to be decoded using the filters already present. The cached value for the encoded stream data will be cleared. :param filter_name: Name of the filter (see :const:`~pyhanko.pdf_utils.filters.DECODERS`) :param params: Parameters to the filter (will be written to ``/DecodeParms`` if not ``None``) :param allow_duplicates: If ``None``, silently ignore duplicate filters. If ``False``, raise ValueError when attempting to add a duplicate filter. If ``True`` (default), duplicate filters are allowed. NrrFzFilter z) has already been applied to this stream.c3^Kp tVD]}|p tVdSrC)r')r param_setsrs r@_paramsz*StreamObject.apply_filter.._paramssM 0JLL000%/88 '7:<<777788r?) rrrrrrDr&r0r"rrrany) rO filter_namerrr cur_filters filter_namesrrs ` @r@rzStreamObject.apply_filter}s4z 22TJJJJJr?cX |ddkS#t$rYdSwxYw)Nrz /EmbeddedFileFrrNs r@rz$StreamObject.is_embedded_file_streams@ <<((O; ;   55 s  ))c|j}|S|Q|jsJ|}||j|j}|||}tt||td<t ||||d=| d| || ddS)Nrs stream s endstream) rrrrKr_r`rLr(rr&rrr)rOrrrxrrOrPrs r@rzStreamObject.write_to_streams    )****,,B,,#]%=I::i..D&23t99&=&=Z " "# ??? O ]### T ^$$$$$r?)NNNN)NTr)r7r8r9r:r rrrYr*rrrrr&rr r rrrr rrrrrrrrs@r@r+r+sX$$P%)'+(,/3   D>  e_  uo  +,       $ %$ :>$ $ $ $ LA4AAAXA Z $ $/3   +,     . (5htn)<#=>    B:111eX("e"""X"(LPFF:B4.FFFFPKKKX04 %%+,%%%%%%%%%%r?r+c<fd}t|S)Nc 3xKD]3} t|V#t$rtd|dddwxYwdS)Npdfdocencodingr|#does not exist in translation table)_pdfDocEncoding_revrrk)rpunicode_strings r@_buildz%encode_pdfdocencoding.._buildsu  A )!,,,,,   ($9    s7)r)r&r's` r@rVrVs0      ??r?cHfd}d|S)Nc3KD]:}t|}|dkr!tdt|fddd|V;dS)Nr#r|r$)_pdfDocEncodingr!r)brp byte_arrays r@r'z%decode_pdfdocencoding.._buildsi  A"AH}}($1$KK9 GGGG  r?r)r.)r-r's` r@rZrZs6      776688  r?(r*r*r*r*r*r*r*r*r*r*r*r*r*r*r*r*r*r*r*r*r*r*r*r*u˘uˇuˆu˙u˝u˛u˚u˜ !"#$%&'(r*+,-./r123456789:;<=>?@ABCDEFGHIJKLMNOPQRSTUVWXYZ[\]^r`ar,rpdrfghr@jrlmnopqrrrurwxyz{|}~r*u•u†u‡u…u—u–uƒu⁄u‹u›u−u‰u„u“u”u‘u’u‚u™ufiufluŁuŒuŠuŸuŽuıułuœušužr*u€¡¢£¤¥¦§¨©ª«¬r*®¯°±²³´µ¶·¸¹º»¼½¾¿ÀÁÂÃÄÅÆÇÈÉÊËÌÍÎÏÐÑÒÓÔÕÖ×ØÙÚÛÜÝÞßàáâãäåæçèéêëìíîïðñòóôõö÷øùúûüýþÿci|]\}}|| Sr>r>)rrchars r@rrsKKKHBtRKKKr?cPt|trt||S|SrC)rD PROXYABLEr ) encrypted_objrs r@proxy_encrypted_objrs*-++#M7;;;r?ceZdZUdZeed< defdZedefdZ d de dfd Z d Z ed Z d Z dS)r a Internal proxy class that allows transparent on-demand encryption of objects. .. warning:: Most public-facing APIs won't leave you to deal with these *directly* (that's half the reason this class exists in the first place), and the API of this class is considered internal. However, for reasons related to the historical PyPDF2 codebase from which pyHanko's object handling code ultimately derives, there are some Python builtins that might cause these wrapper objects to inadvertently "leak". Please `tell us about such cases `_ so we can make those types of access more convenient and robust. .. danger:: The ``__eq__`` implementation on this class is not safe for general use, due to the fact that certain structures in PDF are exempt from encryption. Only compare proxy objects with ``==`` in areas of the document where these exemptions don't apply. :param raw_object: A raw object, typically as-parsed from a PDF file. :param handler: The security handler governing this object. rFc0||_d|_||_dSrC)rF _decryptedr)rOrFrs r@rYzDecryptedObjectProxy.__init__Es$/3 r?rJcr |j|jSddlm}|j}|j |j}t |tstd|dt |tst |tr] }| |j |j}t|||j}nt |t$r] fd|D}t |t(r| ||}nht%|}nXt |t,r#t/ fd|}t-|}n t1dt3|d |j|_||_|S) aG The decrypted PDF object exposed as a property. If this object is a container object, its constituent parts will be wrapped in :class:`.DecryptedObjectProxy` as well, in order to defer further decryption until the values are requested through a getter method on the container. NrrzPProxyable objects must have a container ref pointing to a numbered object, not 'z'.c8i|]\}}|t|Sr>r)rdictkeyrrs r@rz2DecryptedObjectProxy.decrypted..ms:!!!"GU,UG<<!!!r?c$t|SrCr)rrs r@rGz0DecryptedObjectProxy.decrypted..xs*=a*I*Ir?zObject of type z is not proxyable.)rcryptrrFrrxrDr*rrr-rJrKr_r`r1rrQr"rr+rrmapr"type) rOrrGrxrOrPrEr decrypted_maprs @r@rEzDecryptedObjectProxy.decryptedJs ? &? "******o#'<) -33 ;)6;;;  c+ , , M !1 1  M**,,B,,#]%=I#2::i9K#L#LMMII - . . M!!!!&)iikk!!! #|,, @@@],= -->?? [ ) ) M I I I I3OOM#M22IIKd3iiKKKLL L"%"3 #r?Nrrc>|j|||dSrC)rErrs r@rz$DecryptedObjectProxy.write_to_streams$ &&vw FFFFFr?c4|jSrC)rErPrNs r@rPzDecryptedObjectProxy.get_objects~((***r?c|jjSrC)rFrxrNs r@rxz"DecryptedObjectProxy.container_refs ,,r?cLt|to|j|jkSrC)rDr rErs r@rzDecryptedObjectProxy.__eq__s( u2 3 3 24>1 r?r)r7r8r9r:r)rlrYrrEr rrPrxrr>r?r@r r #s89 39333X3p04 G G+, G G G G+++--X-     r?r zD:%Y%m%d%H%M%Sdtc2|t}d}|}|T|}|sd}n;d}|dkrd}t |}t |d\}}|dz}|d ||fzz}t ||zS) a Convert a datetime object into a PDF string. This function supports both timezone-aware and naive datetime objects. :param dt: The datetime object to convert. :return: A :class:`TextStringObject` representing the datetime passed in. rNrfr8rr:i<z %02d'%02d')strftime ASN_DT_FORMAT utcoffset total_secondsabsdivmodr-)rbase_dtutc_offset_string utc_offset tz_secondssignhrsminss r@r/r/skk-((GJ--//  D #  DA~~ __ $Z66OC#D !% T{(B C  G&77 8 88r?z ^D:(\d{4})z^(?:D:)?(\d{4})z^(\d\d)z(\d\d)(?:'(\d\d))?'?date_strrc t|ts'tdt|jd||}|rt nt|}|st|dt| d}|| dd}gd}tdD]O}t|}|sn0t| d||<|dd}P|\}}} } } d} |r|d} | d kr#t|dkrtd}n| d vr|dd}t |}|std |d|t| d}t| dpd}t|| }| d kr| }ntd|dt%|} t'|||| | | d| S#t($r}td|d}~wwxYw)Nz'Date string must be a text string, got z: z% does not appear to be a date string.rr)rrrrrrr6rf)r8r:z#Improper timezone specification in )hoursminutesr:z Improper trailing characters in r;)yearmonthdayhourminutesecond microsecondtzinfozImproper date value)rDrrrr7rstripMIN_DATE_REGEXMIN_DATE_REGEX_LENIENTrrkgrouprrTWO_DIGIT_STARTrr UTC_OFFSET fullmatchrrr)rrrsr date_remaining lower_orderrr r r rrtz_infosgn tz_offsettz_spectz_matchtz_hours tz_minutesrs r@parse_pdf_dater"s h $ $  d8nn6M         H! ='=DDXNNA OhMMMNNN qwwqzz??DaeeAhhjj)N!//KAhh,,  ! !. 1 1  Eaggajj// B'+(3$E3ffG&Q #::#n--22!! II J  $QRR(G!++G44H "O(OOgOO8>>!,,--HX^^A..3!44J!*EEEIczz&J M(MMMNN N9%% 5     5550!4445s*I I  II )T)jr:r,r\renumloggingrrtyping dataclassesrrrrriorr r r r r rmiscrrrrrrrrrrr TYPE_CHECKING crypt.apir__all__rrrr r getLoggerr7rEnumr#rHr!r.r*uniquerorrrr2r)r3r'rrrr%rr$rkr(rrrr1r(rrCrrr,rr-r|rr&rrrr"r+rVrZr+r enumerater%r0rrr rr/rrrrr"r>r?r@r0sQ   ((((((((2222222222BBBBBBBBBBBBBBBB                           +******   4 2:;BB7KKLL  8 $ $>1""""""""2. $////////d . . . . .ty . .  .$ %*:*= ff$ff( f  ffffRB"B"B"B"B"B"B"B"J * * * * *i * * *@'''''I'''TZZZZZ$ ZZZzp p p p p Yp p p f11111'/9111@&5&5&5&5&53 &5&5&5XC #ui' (C 12CCCC0'  12@;%;;;;| : 12 : : : :ui4=+=+=+=+=+=+=+=+@ *uUI%56 *;M * * * *LLLLLsILLL^    3 U3 |3 3 3 3 l%(%(%(%(%(i%(%(%(P&&&Ru*u*u*u*u*tYu*u*u*pS%S%S%S%S%#S%S%S%l ""AF s?s""""KK /0J0JKKK  /1A; O x x x x x 9x x x v!  9 9. 9 9 9 9HM**#$677"*Z(( RZ/ 0 0 >5>5S>5$>5(>5>5>5>5>5>5r?