jS\ UdZdZdZddlZddlZddlZddlZddlZddlm Z ddl m Z m Z ddl m Z ddlmZdd lmZdd lmZmZmZmZmZejdd d krdd lmZndd lmZejdkrddlmZnddlmZddlmZmZmZmZe e e!e!e!fe e!e!e!fe e!e!e!ffZ"ee#d<e e!e!e!e!e!e!fZ$ee#d<eeZ%ee&Z'ee(e%fZ)dee(dee fdZ*de de(fdZ+de(de(de(fdZ,dZ-d.e-Z/de/zdzZ0d^d e%d!ee1de&fd"Z2d e'de&fd#Z3d e%de4fd$Z5d%e&de4fd&Z6d'Z7d_d)e(d*e(de4fd+Z8d,Z9d`d)e(d-e(d.e(de4fd/Z:d e%ddfd0Z;ej<d1d e%d2ee&d3e1de&fd4Z=d e'd5e1de&fd6Z>d e%de&fd7Z?d8e"d9e"de"fd:Z@d e%ddfd;ZAdad=e(d>e1ddfd?ZBd=e(defd@ZCdAe(dBe(dCe(ddfdDZDdAe(dBe(dCe(defdEZEdFe(dCe(ddfdGZFdFe(dCe(defdHZGdIe(dJe(dKeddfdLZHdIe(dJe(dKeddfdMZI dbdOe(dPeJe(efdQeJe(e(fdRe4ddf dSZKdTe1de(fdUZLGdVdWZMe GdXdYZNejOGdZd[ZPe Gd\d]ZQdS)cz"Utility functions for PDF library.zMathieu Fenniakzbiziqe@mathieu.fenniak.netN) dataclass)datetimetimezone)DEFAULT_BUFFER_SIZE)SEEK_CUR)Pattern)IOAnyNoReturnOptionalUnion) ) TypeAlias)r )Self)STREAM_TRUNCATED_PREMATURELYDeprecationErrorLimitReachedErrorPdfStreamErrorTransformationMatrixTypeCompressedTransformationMatrixtextreturnc|}|sdS|drd|z}|dr|dz }|dddddd }t|d|d }|dkr|t |d z kr|d z }d D]`} t j||}|dr |tj }|cS#t$rY]wxYwtd|)NrzD:)Zz0000r+r'-00)zD:%YzD:%Y%mzD:%Y%m%dz D:%Y%m%d%Hz D:%Y%m%d%H%MD:%Y%m%d%H%M%SzD:%Y%m%d%H%M%S%zz+0000)tzinfozCan not convert date: ) isdigitendswithreplacemaxfindlenrstrptimerutc ValueError)rorgtextifds :C:\Projects\DSCons\.venv\Lib\site-packages\pypdf\_utils.pyparse_iso8824_dater7PscG t Awd{ }}Z    <<S ! ! ) )#s 3 3 ; ;C D DD DIIcNNDIIcNN++A1uuc$ii!m##   !$**A}}W%% 3IIX\I22HHH     H  7g77 8 88sD(( D54D5dtc,|d}|jw|}|Jt|}t t |d\}}|dz}|dkrdnd}|||dd |dd z }|S) a Convert a datetime object to PDF date string format. Converts datetime to the PDF date format D:YYYYMMDDHHmmSSOHH'mm as specified in the PDF Reference. Args: dt: A datetime object to convert. Returns: A date string in PDF format. r'Ni<rr!r$02dr")strftimer( utcoffsetint total_secondsdivmodabs)r8date_stroffsetr?hours remainderminutessigns r6format_iso8824_daterHps{{+,,H y!!!F002233 !#m"4"4d;;yr/#q((ssct7U77777777 Oheader1header2c6d}g}||vr(|||||vr(|||t|dkrtd|d|d|t |S)N)z%PDF-1.3z%PDF-1.4z%PDF-1.5z%PDF-1.6z%PDF-1.7z%PDF-2.0rzNeither z nor z are proper headers)appendindexr.r1r,)rJrKversionspdf_header_indicess r6_get_max_pdf_version_headerrQsH(!!(.."9"9:::(!!(.."9"9::: !##RGRRGRRRSSS C*++ ,,rI)     rI[]stream max_bytesct} |d}|s|sn||z }t||krnFt |S)a> Read non-whitespace characters and return them. Stops upon encountering whitespace or when max_bytes is reached. Args: stream: The data stream from which was read. max_bytes: The maximum number of bytes returned; by default unlimited. Returns: The data which was read. Tr) bytearrayreadisspacer.bytes)rZr[txttoks r6read_until_whitespacercsk ++Ckk!nn ;;==    s  s88y   ::rIc~|d}|tvr|d}|tv|S)z Find and read the next non-whitespace character (ignores whitespace). Args: stream: The data stream from which was read. Returns: The data which was read. rr^ WHITESPACESrZrbs r6read_non_whitespacerhs? ++a..C   kk!nn    JrIc|d}d}|tvr#|dz }|d}|tv#|dkS)a  Similar to read_non_whitespace, but return a boolean if at least one whitespace character was read. Args: stream: The data stream from which was read. Returns: True if one or more whitespace was skipped, otherwise return False. rrre)rZrbcnts r6skip_over_whitespacerksS ++a..C C    qkk!nn    7NrIvaluec4td|DS)z Check if the given value consists of whitespace characters only. Args: value: The bytes to check. Returns: True if the value only has whitespace characters, otherwise return False. c3(K|] }|tvVdSN)WHITESPACES_AS_BYTES).0bs r6 z+check_if_whitespace_only..s(88Qq((888888rI)all)rls r6check_if_whitespace_onlyrus! 88%888 8 88rI))/):@)u u)u₠u⇿r#charcustom_special_characterscntfdtDrdSt|o|vS)z8Check if a character is part of neutral character rangesc3>K|]\}}|cxko|kncVdSrorqstartendrzs r6rsz"is_char_neutral..sC K KJE35D    C     K K K K K KrIT)anyNEUTRAL_CHARACTER_RANGESbool)rzr{s` r6is_char_neutralrsH K K K K2J K K KKKt )Od6O.O P PPrI))u֐uࣿ)uיִu﷿)uﹰucustom_rtl_mincustom_rtl_maxctfdtDrdSt|o|o|cxko|kncS)z4Check if a character is part of RTL character rangesc3>K|]\}}|cxko|kncVdSror~rs r6rszis_char_rtl..sC G GJE35D    C     G G G G G GrIT)rRTL_CHARACTER_RANGESr)rzrrs` r6 is_char_rtlrsc G G G G2F G G GGGt `>`~7_7_7_7_Q_7_7_7_7_ a aarIc|d}|dd|dkr4|dvr2|d}|dkrtd|dv.dSdSdS)Nr%)rTrVrIzFile ended unexpectedly.)r^seekrrgs r6skip_over_commentr s ++a..C KKA d{{''++a..Cczz$%?@@@''''{''rI)lengthregexrc*g}d}d}d} ||}|sd|St|}||zx} |krtd| d|d||z} || } ||| bt|} || z | z} || |z |z d d|d| S||z }|d d}|d kr|d z} ) a Read until the regular expression pattern matched (ignore the match). Treats EOF on the underlying stream as the end of the token to be matched. Args: stream: The stream to read from. regex: The pattern to search for. length: The (approximated) maximum number of bytes to read before raising an exception. Returns: The read bytes. rrITzRead stream length of z# exceeds maximum allowed length of .Nrii )r^joinr.rsearchrMrr)rZrrparts total_lengthtail chunk_sizetoken token_lengthcurrent_lengthcurrent_buffer search_matchoverlap actual_starts r6read_until_regexrsSEL DJ J'' #88E?? "5zz *\9 9Nf D D#eee\beee  ||N33  U  #$iiG''1L4F4F4H4HHL KK |3lBA F F F88E??=L=1 1 $ STT{    1 J5rIto_readc||krtd|| t||}|| t|S)a Given a stream at position X, read a block of size to_read ending at position X. This changes the stream's position to the beginning of where the block was read. Args: stream: to_read: Returns: The data which was read. z!Could not read malformed PDF file)tellrrrr^)rZrr^s r6read_block_backwardsrEsh{{}}w@AAA KK(### ;;w  D KK(### KrIcg}d}|dkrtt tt|}|dkrnt ||}t |dz }|s-|dkr||dvr|dz}|dkr ||dv|dkrd}|rF|||dzd|dkr||dvr|dz}|dkr ||dvn|||dkr||dztnd |dddS) a Given a byte stream with current position X, return the previous line. All characters between the first CR/LF byte found before X (or, the start of the file, if no such byte is found) and position X After this call, the stream will be positioned one byte after the first non-CRLF character found beyond the first CR/LF byte before X, or, if no such byte is found, at the beginning of the stream. Args: stream: StreamType: Returns: The data which was read. FrTrs NrIr) rrrminrrr.rMrrr)rZ line_content found_crlfrblockidxs r6read_previous_liner^s"LJ {{}}9::: )6;;==99 a<< %VW55%jj1n "((uSz88q((uSz88axx!  '   cAgii 0 1 1 1((uSzW44q((uSzW44    & & & !88 KKa * * * A D 88L2& ' ''rIarrc:tfd|DS)Nc3^K|]&tfdtDV'dS)c3fK|]+}tdt|DV,dS)c3ZK|]&\}}t|t|zV'dSro)float)rqr3js r6rsz6matrix_multiply....s7@@$!Q%((U1XX%@@@@@@rIN)sumzip)rqcolrows r6rsz,matrix_multiply...sB T TSc@@#c3--@@@@@ T T T T T TrIN)tupler)rqrrrs @r6rsz"matrix_multiply..sZ   T T T TCQRG T T TTTrI)r)rrrs `r6matrix_multiplyrs=   rIcd}|| dtdd5}||||d|||dddn #1swxYwY|| ddS)z5Create text file showing current location in context.irzpypdf_pdfLocation.txtwbsHEREN)ropenwriter^)rZradius output_fhs r6 mark_locationrsF KK %t , ,-  F++,,,    F++,,,--------------- KKsA&BB #B rmsg stacklevelc>tj|t|dS)N)r)warningswarnDeprecationWarning)rrs r6 deprecaters  M#)jAAAAAArIc t|ro)r)rs r6 deprecationrs 3  rIold_namenew_name removed_inc8t|d|d|dddS)zFIssue a warning that a feature will be removed, but has a replacement., is deprecated and will be removed in pypdf . Use instead.Nrrrrs r6deprecate_with_replacementrs> ffffS[fff rIc6t|d|d|ddS)zMRaise an exception that a feature was already removed, but has a replacement.( is deprecated and was removed in pypdf rrNrrs r6deprecation_with_replacementrs: bbZbbxbbbrInamec2t|d|dddS)zCIssue a warning that a feature will be removed without replacement.rrrNrrrs r6deprecate_no_replacementrs* PP:PPPRSTTTTTrIc0t|d|ddS)zJRaise an exception that a feature was already removed without replacement.rrNrrs r6deprecation_no_replacementrs'4NNNNNOOOOOrImessagesourcevaluesc |r*tj|||dStj||dS)z Use this instead of logger.error directly. That allows people to overwrite it more easily. See the docs on when to use which: https://pypdf.readthedocs.io/en/latest/user/suppress-warnings.html N)logging getLoggererrorrrrs r6 logger_errorrsX1&!!''88888&!!''00000rIc |r*tj|||dStj||dS)a Use this instead of logger.warning directly. That allows people to overwrite it more easily. ## Exception, warnings.warn, logger_warning - Exceptions should be used if the user should write code that deals with an error case, e.g. the PDF being completely broken. - warnings.warn should be used if the user needs to fix their code, e.g. DeprecationWarnings - logger_warning should be used if the user needs to know that an issue was handled by pypdf, e.g. a non-compliant PDF being read in a way that pypdf could apply a robustness fix to still read it. This applies mainly to strict=False mode. N)rrwarningrs r6logger_warningrsZ 3&!!))'6::::: &!!))'22222rIF func_namekwargsaliasesfailc (|D]|\}}||vrs|rt|d|d||vrt|d|d|d|d|d ||||<t j|d|dt d }d S) z Helper function to deprecate arguments. Args: func_name: Name of the function to be deprecated kwargs: aliases: fail: z# is deprecated as an argument. Use z insteadz received both z and z as an argument. z is deprecated. Use rr)rcategoryrN)itemsr TypeErrorpoprrr)rrrrold_termnew_terms r6 rename_kwargsrs&mmoo( v   &VVHVVV6!! //////$,//#/// &zz(33F8  MVVHVVV+     rIr`cf|dkr|dS|dkr |dz ddS|dkr |dz ddS|dz ddS) Niz Bytei@Bz.1fz kBiʚ;z MBz GBr~)r`s r6_human_readable_bytesrsk u}} u}}%-((((( u}}%-(((((em $ $ $ $$rIc6eZdZdZdddZddefdZdefdZdS) classpropertyz Decorator that converts a method with a single cls argument into a property that can be accessed directly from the class. Nrc||_dSrofgetselfmethods r6__init__zclassproperty.__init__Ls  rIc,||Sror)rinstanceclss r6__get__zclassproperty.__get__Osyy~~rIc||_|Srorrs r6getterzclassproperty.getterRs  rIro)rN) __name__ __module__ __qualname____doc__rr rrr r~rIr6rrFsr SrIrcpeZdZUddlmZdZeed< dZe ed< dZ e eed< d efd Z d efd Z dS) Filer)IndirectObjectr#rrIdataNindirect_referencerc t|jjd|jdtt |jdS)Nz(name=z, data: )) __class__r rrr.rrs r6__str__z File.__str__hs>.)llllDYZ]^b^gZhZhDiDillllrIcl|dddt|jdzS)Nrz, hash: r)rhashrrs r6__repr__z File.__repr__ks2||~~crc"%BTY%B%B%BBBrI)r r r genericrrstr__annotations__rr`rr rrr~rIr6rrWs''''''D#NNND%480777mmmmmC#CCCCCCrIrceZdZejdZdeddfdZdedee e effdZ de de fdZde fd Zdede fd ZdS) Versionz ^(\d+)(.*)$ version_strrNcH||_|||_dSro)r _parse_version components)rr s r6rzVersion.__init__ss#&--k::rIcT|d}g}|D]}tj|}|s|d|f;|d}|d}|d}|t ||f|S)Nrrrr)splitrCOMPONENT_PATTERNmatchrMgroupr>)rr r#parsed_components componentr'integer_prefixsuffixs r6r"zVersion._parse_versionws &&s++ # D DI-33I>>E !((!Y888"[[^^N[[^^F%!"  $ $c.&9&96%B C C C C  rIothercPt|tsdS|j|jkS)NF) isinstancerr#)rr-s r6__eq__zVersion.__eq__s)%)) 5%"222rIcRt|jt|jfSro)rrrr#rs r6__hash__zVersion.__hash__s!T^U4?%;%;<===rIcZt|tstdt|t |j|jD]3\}}|\}}|\}}||krdS||krdS||krdS||krdS4t |jt |jkS)Nz#Version cannot be compared against TF)r/rr1typerr#r.)rr-self_componentother_component self_value self_suffix other_value other_suffixs r6__lt__zVersion.__lt__s%)) RP4;;PPQQ Q/24?EDT/U/U   +NO&4 #J (7 %KK''ttK''uu\))tt\))uu*4?##c%*:&;&;;;rI)r r r recompiler&rrlistrr>r"objectrr0r2r r;r~rIr6rros" >22;C;D;;;; !# !$uS#X2G ! ! ! !3F3t3333 >#>>>>rrCrr~rIr6rArAs8GGKJrIrAro)r#)r#r#)r)F)Rr  __author____author_email__ functoolsrr<sysr dataclassesrrriorosrrtypingr r r r r version_infortyping_extensionsrerrorsrrrrrrrrr StreamTyper`BinaryStreamTyper StrByteTyper7rHrQrfrrpWHITESPACES_AS_REGEXPr>rcrhrrkrurrrrrmaxsizerrrrrrrrrrrrrdictrrrrtotal_orderingrrAr~rIr6rVs8)((  / !!!!!!''''''''""""""BQB7""       ++++++w&&&&&&', % eUE&9 :E%PUBU,3,af,,,,^!1CE27(z7(e7(7(7(7(t$< *     BB3BCBBBBB S X    QU3#3S[U3UCUDUUUU PSPcPhPPPP 1# 1# 1 1 1 1 1 13C3C333433334SX    cN 59#s(^ KO      F%%%%%%Z" CCCCCCC C. 1<1<1<1<1<1<1<1