=Xj7 \UdZdZdZddlZddlZddlZddlmZddlm Z ddl m Z ddl m Z dd lmZmZmZmZmZmZmZmZmZ dd lmZd d lmZmZmZeeeeefeeeefeeeeffZ ee!d <eeeeeeefZ"ee!d<eZ#ee$e#fZ%dZ&dZ'dZ(dZ)de*de*de*fdZ+dQde#dee,de*fdZ-de#de*fdZ.de#de/fdZ0de#ddfdZ1 dRde#dee*de/de*fdZ2de#d e,de*fd!Z3de#de*fd"Z4d#e d$e de fd%Z5de#ddfd&Z6iZ7eee$e*fe*fe!d'<d(ee$e*fde*fd)Z8ed$e$de$fd*Z9ed$e*de$fd+Z9d$ee$e*fde$fd,Z9ed$e$de,fd-Z:ed$e*de*fd.Z:ed$e,de,fd/Z:d$ee,e$e*fdee,e*ffd0Z:d$e*de*fd1Z;d2e,de$fd3ZdSd9e$d:e,ddfd;Z?d9e$ddfd<Z@ dTd=e$d>e$d?e$ddfd@ZA dTd=e$d>e$d?e$ddfdAZBdTdBe$d?e$ddfdCZCdTdBe$d?e$ddfdDZDd9e$dEe$ddfdFZEdGe$defdHZF dRdIe$dJee$efdGee$e$fdKe/fdLZGdMe,de$fdNZHe GdOdPZIy#e$r dd lmZYwxYw)Uz"Utility functions for PDF library.zMathieu Fenniakzbiziqe@mathieu.fenniak.netN getencoder) dataclass)DEFAULT_BUFFER_SIZE)SEEK_CUR) IOAnyCallableDictOptionalPatternTupleUnionoverload) TypeAlias)STREAM_TRUNCATED_PREMATURELYDeprecationErrorPdfStreamErrorTransformationMatrixTypeCompressedTransformationMatrixz2{} is deprecated and will be removed in PyPDF2 {}.z.{} is deprecated and was removed in PyPDF2 {}.zE{} is deprecated and will be removed in PyPDF2 3.0.0. Use {} instead.z>{} is deprecated and was removed in PyPDF2 {}. Use {} instead.header1header2returncd}g}||vr |j|j|||vr |j|j|t|dk(rtd|d|d|t |S)N)s%PDF-1.3s%PDF-1.4s%PDF-1.5s%PDF-1.6s%PDF-1.7s%PDF-2.0rzneither z nor z are proper headers)appendindexlen ValueErrormax)rrversionspdf_header_indicess S/var/www/html/content_generation/venv/lib/python3.12/site-packages/PyPDF2/_utils.py_get_max_pdf_version_headerr$OsH(!!(.."9:(!!(.."9: !#8G;eG;>QRSS C*+ ,,streammaxcharscd} |jd}|js|s |S||z }t||k(r |S=)z~ Read non-whitespace characters and return them. Stops upon encountering whitespace or when maxchars is reached. r%r)readisspacer)r&r'txttoks r#read_until_whitespacer-bsR C kk!n ;;=  J s  s8x   J r%cl|jd}|tvr|jd}|tvr|S)zEFind and read the next non-whitespace character (ignores whitespace).r)r) WHITESPACESr&r,s r#read_non_whitespacer1ss3 ++a.C  kk!n   Jr%cptd}d}|tvr|jd}|dz }|tvr|dkDS)zr Similar to read_non_whitespace, but return a Boolean if more than one whitespace character was read. rr)r/r))r&r,cnts r#skip_over_whitespacer4{sE a.C C  kk!n q   7Nr%c|jd}|jdd|dk(r|dvr|jd}|dvryyy)Nr%)  )r)seekr0s r#skip_over_commentr;sH ++a.C KKA d{'++a.C'r%regex ignore_eofcd} |jd}|s|r|Stt|j|}|E||d|j z }|j |j t |z d |S||z })z Read until the regular expression pattern matched (ignore the match). :raises PdfStreamError: on premature end-of-file :param bool ignore_eof: If true, ignore end-of-line and return immediately :param regex: re.Pattern r%Nr)r)rrsearchstartr:r)r&r<r=namer,ms r#read_until_regexrDs D kk"o  !=> > LL  = C !'')$ $D KK CH,a 0  K   r%to_readc|j|kr td|j| t|j |}|j| t|S)z 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. z!Could not read malformed PDF file)tellrr:rr))r&rEr)s r#read_block_backwardsrHsQ{{}w@AA KK(# ;;w D KK(# Kr%cg}d}|jdk(rtt tt|j}|dk(rnt ||}t |dz }|s%|dk\r||dvr|dz}|dk\r||dvr|dk\rd}|r6|j||dzd|dk\r+||dvr$|dz}|dk\r||dvrn|j||dk\r|j|dztndj|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. FrTrs Nr%r6) rGrrminrrHrrr:rjoin)r& line_content found_crlfrEblockidxs r#read_previous_linerPs?LJ {{}9:: )6;;=9 a< %VW5%j1n(uSz8q(uSz8ax!    cAgi 0 1(uSzW4q(uSzW4    & !8 KKa * A D 88L2& ''r%abc,tfd|DS)Nc3TK|]tfdtD yw)c3VK|] }tdt|D"yw)c3PK|]\}}t|t|z ywN)float).0ijs r# z6matrix_multiply....s"@-$!Q%(U1X%-s$&N)sumzip)rYcolrows r#r\z,matrix_multiply...s# TGSc@#c3-@@Gs&)N)tupler^)rYr`rRs @r#r\z"matrix_multiply..s)C  TCQRG TTs$()ra)rQrRs `r#matrix_multiplyrbs  r%c8d}|j| dtdd5}|j|j||jd|j|j|ddd|j| dy#1swYxYw)z5Create text file showing current location in context.irzPyPDF2_pdfLocation.txtwbsHEREN)r:openwriter))r&radius output_fhs r# mark_locationris|F KK & - F+,  F+, . KK . -s ABBB_CACHEsct}||vr||St|tr|S |jd}t |dkr|||<|S#t $r)|jd}t |dkr|||<|cYSwxYw)Nlatin-1zutf-8)rj isinstancebytesencoder Exception)rkbcrs r#b_rus BBw!u !U  HHY  q6A:BqE  HHW  q6A:BqE s%A /A;:A;cyrWrRs r#str_ryr%cyrWrwrxs r#ryryrzr%cHt|tr|jdS|S)Nrm)rorpdecoderxs r#ryry"s !Uxx ""r%cyrWrwrxs r#ord_r)rzr%cyrWrwrxs r#rr.rzr%cyrWrwrxs r#rr3rzr%c<t|tr t|S|SrW)rostrordrxs r#rr8s!S1v Hr%c2td}||}|dS)N hex_codecrr)rRcodercodeds r# hexencoder>s { #E !HE 8Or%numc8t|jddS)NL)hexreplace)rs r#hex_strrEs s8  C $$r%) r8r9 leftupup_leftc||z|z }t||z }t||z }t||z }||kr||kr|S||kr|S|SrW)abs)rrrp dist_leftdist_up dist_up_lefts r#paeth_predictorrLs^ r GAAH I!b&kGq7{#LG \ 9 L  r%msg stacklevelc<tj|t|y)N)r)warningswarnDeprecationWarning)rrs r# deprecaterZs MM#)jAr%ct|rW)r)rs r# deprecationr^s 3 r%old_namenew_name removed_incFttj|||dy)zS Raise an exception that a feature will be removed, but has a replacement. N)rDEPR_MSGformatrrrs r#deprecate_with_replacementrbs hooh*=qAr%cDttj|||y)zW Raise an exception that a feature was already removed, but has a replacement. N)rDEPR_MSG_HAPPENEDrrs r#deprecation_with_replacementrks !((:xHIr%rBcDttj||dy)zP Raise an exception that a feature will be removed without replacement. rN)rDEPR_MSG_NO_REPLACEMENTrrBrs r#deprecate_no_replacementrts%,,T:>Br%cBttj||y)zT Raise an exception that a feature was already removed without replacement. N)r DEPR_MSG_NO_REPLACEMENT_HAPPENEDrrs r#deprecation_no_replacementr{s077jIJr%srccLtj|j|y)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 PyPDF2, e.g. a non-compliant PDF being read in a way that PyPDF2 could apply a robustness fix to still read it. This applies mainly to strict=False mode. N)logging getLoggerwarning)rrs r#logger_warningrs  c""3'r%aliasesc dtffd }|S)z Decorator for deprecated term "bookmark" To be used for methods and function arguments outline_item = a bookmark outline = a collection of outline items funccFtjfd}|S)NcFtj|d|i|S)NT)fail) rename_kwargs__name__)argskwargsrrs r#wrapperz9deprecation_bookmark..decoration..wrappers% $--t D(( (r%) functoolswraps)rrrs` r# decorationz(deprecation_bookmark..decorations%   )  )r%)r )rrs` r#deprecation_bookmarkrs r% func_namerrc  |jD]p\}}||vs |rt|d|d||vrt|d|d|d|d|d |j|||<t j |d|dt ry ) z1 Helper function to deprecate arguments. z# is deprecated as an argument. Use z insteadz received both z and z as an argument. z is deprecated. Use z instead.)messagecategoryN)itemsr TypeErrorpoprrr)rrrrold_termnew_terms r#rrs&mmo( v &j CH:XV6! k %zIZj 4XJiI &zz(3F8  MMj CH:XV+  .r%rpc`|dkr|dS|dkr |dz ddS|dkr |dz ddS|dz ddS) Niz Bytei@Bz.1fz kBiʚ;z MBz GBrw)rps r#_human_readable_bytesrs_ u} %-$C(( %-$C((%-$C((r%c:eZdZUeed<eed<defdZdefdZy)FilerBdatarc`d|jdtt|jdS)N File(name=, data: ))rBrrrselfs r#__str__z File.__str__s+DII;h/DS^/T.UUVWWr%cd|jdtt|jdt |jdS)Nrrz, hash: r)rBrrrhashrs r#__repr__z File.__repr__s@DII;h/DS^/T.UU]^bcgclcl^m]nnoppr%N)r __module__ __qualname__r__annotations__rprrrwr%r#rrs( I KXXq#qr%rrW)F))z3.0.0)J__doc__ __author____author_email__rrrcodecsr dataclassesriorosrtypingrr r r r r rrrr ImportErrortyping_extensionserrorsrrrrXrrr StreamTyper StrByteTyperrrrrpr$intr-r1boolr4r;rDrHrPrbrirjruryrrrr/rrrrrrrrrrrrrwr%r#rs8)  /!"   ,  ', % eUE&9 :E%PUBU