U g}<@sHdZddlZddlmZddlmZmZddlmZddlm Z ddl m Z m Z m Z mZmZmZddlmZmZd d d d d ddddddddddddddddddd d!d"d#d$d%d&gZd'Zd(d)Zd*dZd+d,Zd-Zd.Zdleeed/d0dZed1d2dZdmeed3d4d5Zed6d7dZ dnd9dZ!doe"d1d:dZ#e"d1d;dZ$dpe"d<d=dZ%ed>d?Gd@ddZ&GdAd d e'Z(GdBd d e(Z)GdCd d e)Z*GdDdde)Z+GdEd d e(Z,GdFd d e)Z-dGdZ.GdHddeZ/GdIdJdJeZ0GdKdLdLZ1ddMe2e dNdOdZ3edPZ4edQZ5edRZ6e e4de6fe e4ge5fe e5de6fdSdTdUZ7e e4e e4ddfdVdWdXZ8dqee9e:fe ee9e:fdYdZd!Z;dre9d[d\d ZZ?d_dZ@d`dZAdadZBe eCgefd1dbdcZDeCeddded%ZEGdfdgdgee4ZFe e4ee4dhdid&ZGdjdkZHdS)tz Utility functions for PDF library. Taken from PyPDF2 with modifications and additions, see :ref:`here ` for the original license of the PyPDF2 project. Generally, all of these constitute internal API, except for the exception classes. N) dataclass)datetimetimezone)Enum)BytesIO)Callable GeneratorIterableOptionalTypeVarUnion)CancelableAsyncIteratorConsListPdfError PdfReadErrorPdfStrictReadError PdfWriteErrorPdfStreamErrorIndirectObjectExpected get_and_apply OrderedEnumStringWithLanguageis_regular_characterread_non_whitespaceread_until_whitespaceread_until_delimiterread_until_regexskip_over_whitespaceskip_over_comment instance_testpeek!assert_writable_and_random_accessprepare_rw_output_streamfinalise_outputDEFAULT_CHUNK_SIZE chunked_writechunked_digest chunk_streamr Singletonrdisoparselift_iterable_asyncicCs t|dS)N)roundxr0:/tmp/pip-unpacked-wheel-owvgwkas/pyhanko/pdf_utils/misc.py9r2cs fddS)Ncs t|SN) isinstancer.clsr0r1r2=r3zinstance_test..r0r6r0r6r1r<sccsft|}z t|}Wntk r*YdSXz t|}Wntk rTtdYnX||fVqdS)NzList has odd number of elements)iternext StopIteration ValueError)lstix1Zx2r0r0r1 pair_iter@s  r?s s ()<>[]{}/%)maxcharsreturncCstt||dS)a Reads non-whitespace characters and returns them. Stops upon encountering whitespace, or, if ``maxchars`` is not ``None``, when maxchars is reached. :param stream: stream to read :param maxchars: maximal number of bytes to read before returning )r@)_read_until_classPDF_WHITESPACE)streamr@r0r0r1rRs rAcCs ttt|}|dtj|S)z Read until a token delimiter (i.e. a delimiter character or a PDF whitespace character) is encountered, and rewind the stream to the previous character. :param stream: A stream. :return: The bytes read. )rBrCPDF_DELIMITERSseekosSEEK_CUR)rDresultr0r0r1ras ) class_charsrAcs(dkr dSfdd}d|S)Nrr3c3sPdkr dn }dks,|krLd}|ksL|sDqL|VqdS)N)tellread)Zstop_attokrLr@rDr0r1_buildus   z!_read_until_class.._build)join)rLrDr@rRr0rQr1rBqsrBZ byte_valuecCs|tko|tkSr4)rCrGrTr0r0r1rsFcCsrtd}|tkr0|s$|rdStd|d}q|dkr._itr)r8r9)rzr{r0rxr1r sc@s0eZdZdZddZddZddZdd Zd S) rz6 Ordered enum (from the Python documentation) cCs |j|jkr|j|jkStdSr4rurcNotImplementedErrorrgotherr0r0r1__ge__.s  zOrderedEnum.__ge__cCs |j|jkr|j|jkStdSr4r|r~r0r0r1__gt__3s  zOrderedEnum.__gt__cCs |j|jkr|j|jkStdSr4r|r~r0r0r1__le__8s  zOrderedEnum.__le__cCs |j|jkr|j|jkStdSr4r|r~r0r0r1__lt__=s  zOrderedEnum.__lt__Nrirjrkrlrrrrr0r0r0r1r)s c@s0eZdZdZddZddZddZdd Zd S) VersionEnumz Ordered enum with support for ``None``, for future-proofing version-based enums. In such enums, the value ``None`` can be used as a stand-in for "any future version". cCs@|j|jkr8|j}|j}|dkr$dS|dkr0dS||kStdSNTFr|rgrvalZ other_valr0r0r1rJs zVersionEnum.__ge__cCsD|j|jkr<|j}|j}|dkr(|dk S|dkr4dS||kStdSNFr|rr0r0r1rVs zVersionEnum.__gt__cCs@|j|jkr8|j}|j}|dkr$dS|dkr0dS||kStdSrr|rr0r0r1rbs zVersionEnum.__le__cCsD|j|jkr<|j}|j}|dkr(|dk S|dkr4dS||kStdSrr|rr0r0r1rns zVersionEnum.__lt__Nrr0r0r0r1rCs    rc@seZdZddZddZdS)LazyJoincCs||_||_dSr4)sepiterator)rgrrr0r0r1rr|szLazyJoin.__init__cCs|j|jSr4)rrSrrfr0r0r1rhszLazyJoin.__str__N)rirjrkrrrhr0r0r0r1r{sr)default) dictionaryfunctioncCs.z ||}Wntk r$|YSX||Sr4)KeyError)rkeyrrrcr0r0r1rs   XYR)genfuncrAc csFz|t|VWqtk r>}z|jWYSd}~XYqXqdSr4)r9r:rc)rrer0r0r1map_with_returnsr)r/rAccs|EdHdSr4r0r.r0r0r1_as_gensr) temp_bufferrAccsd}|dks||kr|}|dk rD||}|t|krDt|d|}||}||7}|s^dS|t|kr|t|d|}n|}|VqdS)Nr)r^ memoryviewreadinto)rrDmax_readZ total_readZ read_bufferZto_read bytes_readZto_feedr0r0r1r's   )rcCs"t|||dD]}||qdSN)r)r'update)rrDZmdrchunkr0r0r1r&scCs"t|||dD]}||qdSr)r'write)rrDoutputrrr0r0r1r%sc@seZdZddZdS)r(cs,t||||}t|fdd|_|S)NcsSr4r0)_instancer0r1r2r3z#Singleton.__new__..)type__new____call__)Zmcsr`basesdctr7r0rr1rs zSingleton.__new__N)rirjrkrr0r0r0r1r(scCs |std|o|S)z Raise an error if the buffer in question is not writable, and return a boolean to indicate whether it supports random-access reading. :param output: :return: zOutput buffer is not writable)writableIOErrorseekablereadablerr0r0r1r!s cCs"|dkrt}nt|st}|S)aB Prepare an output stream that supports both reading and writing. Intended to be used for writing & updating signed files: when producing a signature, we render the PDF to a byte buffer with placeholder values for the signature data, or straight to the provided output stream if possible. More precisely: this function will return the original output stream if it is writable, readable and seekable. If the ``output`` parameter is ``None``, not readable or not seekable, this function will return a :class:`.BytesIO` instance instead. If the ``output`` parameter is not ``None`` and not writable, :class:`.IOError` will be raised. :param output: A writable file-like object, or ``None``. :return: A file-like object that supports reading, writing and seeking. N)rr!rr0r0r1r"s cCs@|dk r<||k rs     !    8