o 6Wj7 @sHUdZdZdZddlZddlZddlZddlmZddlm Z ddl m Z ddl m Z dd lmZmZmZmZmZmZmZmZmZzdd lmZWneyXdd lmZYnwd d lmZmZmZeeeeefeeeefeeeeffZ ee!d <eeeeeeefZ"ee!d<eZ#ee$e#fZ%dZ&dZ'dZ(dZ)de*de*de*fddZ+dnde#dee,de*fddZ-de#de*fddZ.de#de/fddZ0de#ddfd d!Z1 "dode#d#ee*d$e/de*fd%d&Z2de#d'e,de*fd(d)Z3de#de*fd*d+Z4d,e d-e de fd.d/Z5de#ddfd0d1Z6iZ7eee$e*fe*fe!d2<d3ee$e*fde*fd4d5Z8ed-e$de$fd6d7Z9ed-e*de$fd8d7Z9d-ee$e*fde$fd9d7Z9ed-e$de,fd:d;Z:ed-e*de*fdd;Z:d-e*de*fd?d@Z;dAe,de$fdBdCZdpdKe$dLe,ddfdMdNZ?dKe$ddfdOdPZ@ QdqdRe$dSe$dTe$ddfdUdVZA QdqdRe$dSe$dTe$ddfdWdXZBdqdYe$dTe$ddfdZd[ZCdqdYe$dTe$ddfd\d]ZDdKe$d^e$ddfd_d`ZEdae$defdbdcZF "dodde$deee$efdaee$e$fdfe/fdgdhZGdie,de$fdjdkZHe GdldmdmZIdS)rz"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.header1header2returncCsfd}g}||vr|||||vr|||t|dkr-td|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_indicesr!\/home/esfera/Documents/content_generation/venv/lib/python3.10/site-packages/PyPDF2/_utils.py_get_max_pdf_version_headerOs  r#streammaxcharscCs>d} |d}|s|s |S||7}t||kr |Sq)z~ Read non-whitespace characters and return them. Stops upon encountering whitespace or when maxchars is reached. Tr)readisspacer)r$r%txttokr!r!r"read_until_whitespacebs   r+cCs(|d}|tvr|d}|tvs |S)zEFind and read the next non-whitespace character (ignores whitespace).r)r' WHITESPACESr$r*r!r!r"read_non_whitespacess  r.cCs6td}d}|tvr|d}|d7}|tvs |dkS)zr Similar to read_non_whitespace, but return a Boolean if more than one whitespace character was read. rr)r,r')r$r*cntr!r!r"skip_over_whitespace{s r0cCsD|d}|dd|dkr|dvr |d}|dvsdSdSdS)Nr%)  )r'seekr-r!r!r"skip_over_comments    r6Fregex ignore_eofcCsrd} |d}|s|r|Stt||}|dur4||d|7}||t|d |S||7}q)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&TNr)r'rrsearchstartr5r)r$r7r8namer*mr!r!r"read_until_regexs   r>to_readcCs>||kr td|| t||}|| 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)tellrr5rr')r$r?r'r!r!r"read_block_backwardss  rAcCsg}d}|dkrtt tt|}|dkrndt||}t|d}|sF|dkr@||dvr@|d8}|dkr@||dvs2|dkrFd}|rl|||dd|dkrk||dvrk|d8}|dkrk||dvs]n|||dkr~||dt nqd |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&r1) r@rrminrrArrr5rjoin)r$ line_content found_crlfr?blockidxr!r!r"read_previous_lines8     "rHabcstfdd|DS)Nc3s*|]tfddtDVqdS)c3s(|]}tddt|DVqdS)css$|] \}}t|t|VqdSN)float).0ijr!r!r" s"z6matrix_multiply....N)sumzip)rMcolrowr!r"rPs&z,matrix_multiply...N)tuplerR)rMrJrTr"rPs  z"matrix_multiply..)rV)rIrJr!rWr"matrix_multiplys rXcCsxd}|| dtdd}||||d|||Wdn1s.wY|| ddS)z5Create text file showing current location in context.irzPyPDF2_pdfLocation.txtwbsHEREN)r5openwriter')r$radius output_fhr!r!r" mark_locations  r^B_CACHEscCs|t}||vr ||St|tr|Sz|d}t|dkr!|||<|WSty=|d}t|dkr9|||<|YSw)Nlatin-1zutf-8)r_ isinstancebytesencoder Exception)r`bcrr!r!r"b_s       ricCdSrKr!rWr!r!r"str_rkcCrjrKr!rWr!r!r"rkrlcCst|tr |dS|S)Nra)rcrddecoderWr!r!r"rk"s  cCrjrKr!rWr!r!r"ord_)rlrncCrjrKr!rWr!r!r"rn.rlcCrjrKr!rWr!r!r"rn3rlcCst|tr t|S|SrK)rcstrordrWr!r!r"rn8s cCstd}||}|dS)N hex_codecrr)rJcodercodedr!r!r" hexencode>srtnumcCst|ddS)NL)hexreplace)rur!r!r"hex_strEsrz) r3r4 leftupup_leftcCsT|||}t||}t||}t||}||kr"||kr"|S||kr(|S|SrK)abs)r~rrp dist_leftdist_up dist_up_leftr!r!r"paeth_predictorLs    rmsg stacklevelcCstj|t|ddS)N)r)warningswarnDeprecationWarning)rrr!r!r" deprecateZsrcCst|rK)r)rr!r!r" deprecation^sr3.0.0old_namenew_name removed_incCstt|||ddS)zS Raise an exception that a feature will be removed, but has a replacement. N)rDEPR_MSGformatrrrr!r!r"deprecate_with_replacementbsrcCstt|||dS)zW Raise an exception that a feature was already removed, but has a replacement. N)rDEPR_MSG_HAPPENEDrrr!r!r"deprecation_with_replacementksrr<cCstt||ddS)zP Raise an exception that a feature will be removed without replacement. rN)rDEPR_MSG_NO_REPLACEMENTrr<rr!r!r"deprecate_no_replacementtsrcCstt||dS)zT Raise an exception that a feature was already removed without replacement. N)r DEPR_MSG_NO_REPLACEMENT_HAPPENEDrrr!r!r"deprecation_no_replacement{srsrccCst||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 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)rrr!r!r"logger_warningsraliasesc sdtffdd }|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 funccstfdd}|S)Ncs tj|dd|i|S)NT)fail) rename_kwargs__name__)argskwargs)rrr!r"wrappersz9deprecation_bookmark..decoration..wrapper) functoolswraps)rrr)rr" decorationsz(deprecation_bookmark..decoration)r )rrr!rr"deprecation_bookmarksr func_namerrc Cs|D]?\}}||vrC|rt|d|d||vr/t|d|d|d|d|d ||||<tj|d|dtdqd S) 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_termr!r!r"rs*rrdcCsR|dkr |dS|dkr|dddS|dkr!|dddS|dddS) Niz Bytei@Bz.1fz kBiʚ;z MBz GBr!)rdr!r!r"_human_readable_bytess rc@s:eZdZUeed<eed<defddZdefddZdS) Filer<datarcCsd|jdtt|jdS)N File(name=, data: ))r<rrrselfr!r!r"__str__sz File.__str__cCs*d|jdtt|jdt|jdS)Nrrz, hash: r)r<rrrhashrr!r!r"__repr__s*z File.__repr__N)r __module__ __qualname__ro__annotations__rdrrr!r!r!r"rs rrK)F)r)r)J__doc__ __author____author_email__rrrcodecsr dataclassesriorosrtypingrrr r r r r rrr ImportErrortyping_extensionserrorsrrrrLrrr StreamTypero StrByteTyperrrrrdr#intr+r.boolr0r6r>rArHrXr^r_rirkrnrtrzr,rrrrrrrrrrrrr!r!r!r"s    ,  &      3   $