:jddlmZddlmZddlZddlZddlmZddlm Z ddl m Z ddl m Z ddl m Z dd l mZdd l mZdd lmZdd lmZdd lmZddlmZddlmZddlmZGddeZGddeeZy)) annotationsN)datetime)timezone) base64_decode) base64_encode) bytes_to_int) int_to_bytes) want_bytes) BadSignature)BadTimeSignature)SignatureExpired) _TSerialized) Serializer)SignerceZdZdZd dZd dZd dZej d d dZ ej d ddZ d dfd Z dddZ xZ S)TimestampSignerzWorks like the regular :class:`.Signer` but also records the time of the signing and can be used to expire signatures. The :meth:`unsign` method can raise :exc:`.SignatureExpired` if the unsigning failed because the signature is expired. c<ttjS)zTReturns the current timestamp. The function must return an integer. )inttime)selfs g/home/mcse/projects/srt_converter/srt-converter-venv/lib/python3.12/site-packages/itsdangerous/timed.py get_timestampzTimestampSigner.get_timestamps499;cLtj|tjS)a Convert the timestamp from :meth:`get_timestamp` into an aware :class`datetime.datetime` in UTC. .. versionchanged:: 2.0 The timestamp is returned as a timezone-aware ``datetime`` in UTC rather than a naive ``datetime`` assumed to be UTC. )tz)r fromtimestamprutc)rtss rtimestamp_to_datetimez%TimestampSigner.timestamp_to_datetime#s%%bX\\::rct|}tt|j}t|j}||z|z}||z|j |zS)z:Signs the given string and also attaches time information.)r rr rsep get_signature)rvalue timestampr"s rsignzTimestampSigner.sign-sZ5!!,t/A/A/C"DE " i's{T//666rcyNr signed_valuemax_agereturn_timestamps runsignzTimestampSigner.unsign8s rcyr(r)r*s rr.zTimestampSigner.unsign@s "%rc  t||}d}t |j }||vr|r|t d||j|d\}} d} d} tt| } |+|  |j| } t t||| | t d||b|j!| z } | |kDr$t#d| d |d ||j| | d kr!t#d| d ||j| |r||j| fS|S#t$r}|}|jxsd}Yd}~0d}~wwxYw#t$rYwxYw#tttf$r} t d|| d} ~ wwxYw) aWorks like the regular :meth:`.Signer.unsign` but can also validate the time. See the base docstring of the class for the general behavior. If ``return_timestamp`` is ``True`` the timestamp of the signature will be returned as an aware :class:`datetime.datetime` object in UTC. .. versionchanged:: 2.0 The timestamp is returned as a timezone-aware ``datetime`` in UTC rather than a naive ``datetime`` assumed to be UTC. Nrztimestamp missing)payloadrzMalformed timestamp)r1 date_signedzSignature age z > z secondsrz < 0 seconds)superr.r r1r r"r rsplitr r Exceptionr ValueErrorOSError OverflowErrorstrrr)rr+r,r-result sig_errorer"r$ts_bytests_intts_dtexcage __class__s rr.zTimestampSigner.unsignHs  &W^L1FI " f "#6G G --Q/x!!% !-"9:F  ! 66v>E#3y>5eT T >"#8%H H  $$&/CW}&$SEWIX>! $ : :6 B Qw&$SE6! $ : :6 B $44V<< < G &IYY%#F &.   #G];+-usAD#E 1E# E ,EE  EEF/E==FcJ |j||y#t$rYywxYw)zeOnly validates the given signed value. Returns ``True`` if the signature exists and is valid.)r,TF)r.r )rr+r,s rvalidatezTimestampSigner.validates,  KK gK 6  s  "")returnr)rrrEr)r$ str | bytesrEbytes)NF)r+rFr, int | Noner-zt.Literal[False]rErG)NT)r+rFr,rHr-zt.Literal[True]rEztuple[bytes, datetime])r+rFr,rHr-boolrEztuple[bytes, datetime] | bytesr()r+rFr,rHrErI) __name__ __module__ __qualname____doc__rr r&toverloadr.rD __classcell__rBs@rrrs  ;7ZZ#-2 !+   ZZ#,0 %!%%* % %%#!& V!VV V ( Vprrc|eZdZUdZeZded< d dfd Z d d dZ d d dZ xZ S) TimedSerializerzOUses :class:`TimestampSigner` instead of the default :class:`.Signer`. ztype[TimestampSigner]default_signercJtjdt| |S)Ncabc.Iterator[TimestampSigner])rNcastr3iter_unsigners)rsaltrBs rrXzTimedSerializer.iter_unsignerss!vv68Nt8TUUrc&t|}d}|j|D]6} |j||d\}}|j|} |r| |fcS| cSt jt |#t$rt $r } | }Yd} ~ ld} ~ wwxYw)aReverse of :meth:`dumps`, raises :exc:`.BadSignature` if the signature validation fails. If a ``max_age`` is provided it will ensure the signature is not older than that time in seconds. In case the signature is outdated, :exc:`.SignatureExpired` is raised. All arguments are forwarded to the signer's :meth:`~TimestampSigner.unsign` method. NT)r,r-)r rXr. load_payloadrr rNrW) rsr,r-rYlast_exceptionsignerbase64dr%r1errs rloadszTimedSerializer.loadss qM))$/ %F %%+]]w&3&"++G4#"I-- %$ff\>22$  %!$ %s-A2A22BB  Bc.|j||d|iS)Nr,) load_kwargs)_loads_unsafe_impl)rr\r,rYs r loads_unsafezTimedSerializer.loads_unsafes! &&q$YrosZ" ##"" !!$"QfQh:Rj.:Rr