gSTdZddlZddlmZmZGddZGddeZGd d eZGd d eZGd deZ Gdde Z Gdde Z Gdde Z Gdde Z GddeZGddeZGddeZGddeZGdd eZGd!d"eZGd#d$eZGd%d&eZGd'd(eZGd)d*eZGd+d,eZGd-d.eZGd/d0eZGd1d2eZd3Zy)4a h2/events ~~~~~~~~~ Defines Event types for HTTP/2. Events are returned by the H2 state machine to allow implementations to keep track of events triggered by receiving data. Each time data is provided to the H2 state machine it processes the data and returns a list of Event objects. N)ChangedSetting_setting_code_from_intceZdZdZy)Eventz# Base class for h2 events. N__name__ __module__ __qualname____doc__>/var/www/openai/venv/lib/python3.12/site-packages/h2/events.pyrrs  rrceZdZdZdZdZy)RequestReceiveda The RequestReceived event is fired whenever request headers are received. This event carries the HTTP headers for the given request and the stream ID of the new stream. .. versionchanged:: 2.3.0 Changed the type of ``headers`` to :class:`HeaderTuple `. This has no effect on current users. .. versionchanged:: 2.4.0 Added ``stream_ended`` and ``priority_updated`` properties. c<d|_d|_d|_d|_yN stream_idheaders stream_endedpriority_updatedselfs r__init__zRequestReceived.__init__%& !!%rc<d|jd|jdS)Nzrrrs r__repr__zRequestReceived.__repr__: NNDLL  rNr r r r rr!r rrrr %* rrceZdZdZdZdZy)ResponseReceiveda The ResponseReceived event is fired whenever response headers are received. This event carries the HTTP headers for the given response and the stream ID of the new stream. .. versionchanged:: 2.3.0 Changed the type of ``headers`` to :class:`HeaderTuple `. This has no effect on current users. .. versionchanged:: 2.4.0 Added ``stream_ended`` and ``priority_updated`` properties. c<d|_d|_d|_d|_yrrrs rrzResponseReceived.__init__Mrrc<d|jd|jdS)Nz`. This has no effect on current users. .. versionchanged:: 2.4.0 Added ``stream_ended`` and ``priority_updated`` properties. c<d|_d|_d|_d|_yrrrs rrzTrailersReceived.__init__xs& !!%rc<d|jd|jdS)Nz`. This has no effect on current users. .. versionchanged:: 2.4.0 Added ``priority_updated`` property. c.d|_d|_d|_yr)rrrrs rrz&InformationalResponseReceived.__init__s !%rc<d|jd|jdS)Nz)`. .. versionchanged:: 2.0.0 Prior to this version the user needed to acknowledge settings changes. This is no longer the case: h2 now automatically acknowledges them. ci|_yrchanged_settingsrs rrzRemoteSettingsChanged.__init__H !#rc|}|jD]=\}}t|}|j|}t|||}||j|<?|S)a Build a RemoteSettingsChanged event from a set of changed settings. :param old_settings: A complete collection of old settings, in the form of a dictionary of ``{setting: value}``. :param new_settings: All the changed settings and their new values, in the form of a dictionary of ``{setting: value}``. )itemsrgetrrN)cls old_settings new_settingsesetting new_valueoriginal_valuechanges r from_settingsz#RemoteSettingsChanged.from_settingsNsb E"."4"4"6 GY,W5G)--g6N#G^YGF*0A  w ' #7 rcjddjd|jjDdS)Nz)z1RemoteSettingsChanged.__repr__..cH)G2d2h)G}>joinrNvaluesrs rr!zRemoteSettingsChanged.__repr__a- IIH)>)>)E)E)GH H  rN)r r r r r classmethodr[r!r rrrKrK4s%&# $ rrKceZdZdZdZdZy) PingReceivedz The PingReceived event is fired whenever a PING is received. It contains the 'opaque data' of the PING frame. A ping acknowledgment with the same 'opaque data' is automatically emitted after receiving a ping. .. versionadded:: 3.1.0 cd|_yr ping_datars rrzPingReceived.__init__o rc4dt|jdS)Nzr}rs rr!zStreamEnded.__repr__s+dnn<->  rNr#r rrrrs ! rrceZdZdZdZdZy)PushedStreamReceivedz The PushedStreamReceived event is fired whenever a pushed stream has been received from a remote peer. The event carries on it the new stream ID, the ID of the parent stream, and the request headers pushed by the remote peer. c.d|_d|_d|_yrpushed_stream_idparent_stream_idrrs rrzPushedStreamReceived.__init__s $!% rcVd|jd|jd|jdS)Nz'.rerfrgrhrs rr!zSettingsAcknowledged.__repr__rkrNr#r rrrrs #  rrceZdZdZdZdZy)PriorityUpdateda" The PriorityUpdated event is fired whenever a stream sends updated priority information. This can occur when the stream is opened, or at any time during the stream lifetime. This event is purely advisory, and does not need to be acted on. .. versionadded:: 2.0.0 c<d|_d|_d|_d|_yrrweight depends_on exclusivers rrzPriorityUpdated.__init__s$  rc pd|jd|jd|jd|jd S)Nz`_ Alternative Service using an ALTSVC frame. This event always carries the origin to which the ALTSVC information applies. That origin is either supplied by the server directly, or inferred by h2 from the ``:authority`` pseudo-header field that was sent by the user when initiating a given stream. This event also carries what RFC 7838 calls the "Alternative Service Field Value", which is formatted like a HTTP header field and contains the relevant alternative service information. h2 does not parse or in any way modify that information: the user is required to do that. This event can only be fired on the client end of a connection. .. versionadded:: 2.3.0 c d|_d|_yr)origin field_valuers rrz$AlternativeServiceAvailable.__init__@s   rc|d|jjddd|jjdddS)Nz$r rs rr!zUnknownFrameReceived.__repr__js'rNr#r rrrrXs (rrcP|ytj|jdS)a  Converts a bytestring into something that is safe to print on all Python platforms. This function is relatively expensive, so it should not be called on the mainline of the code. It's safe to use in things like object repr methods though. Nascii)binasciihexlifyr)r?s rrCrCns( |   D ! ( ( 11r)r rsettingsrrrrr&r*r.r0r3r5r7r9r=rErKrnrwr{rrrrrrrrCr rrrs2 <  % e% P% u% P' u' T 5  L  <   L    ( E( V& 5& R E ,0 E0 f 5 $ e * =% = % 6 5 6 5 &# e# L 5 B) %) X(5(, 2r