g`dZddlZGddZGddZGddZGd d Zy) zU h2/config ~~~~~~~~~ Objects for controlling the configuration of the HTTP/2 stack. Nc"eZdZdZdZdZdZy)_BooleanConfigOptionz Descriptor for handling a boolean config option. This will block attempts to set boolean config options to non-bools. c:||_d|jz|_y)Nz_%s)name attr_name)selfrs >/var/www/openai/venv/lib/python3.12/site-packages/h2/config.py__init__z_BooleanConfigOption.__init__s *c.t||jSN)getattrr)rinstanceowners r __get__z_BooleanConfigOption.__get__sx00r ct|tstd|jzt ||j |y)Nz%s must be a bool) isinstancebool ValueErrorrsetattrr)rrvalues r __set__z_BooleanConfigOption.__set__s1%&0499<= =$..%0r N)__name__ __module__ __qualname____doc__r rrr r rr s+11r rc"eZdZdZdZdZdZy) DummyLoggera. A Logger object that does not actual logging, hence a DummyLogger. For the class the log operation is merely a no-op. The intent is to avoid conditionals being sprinkled throughout the h2 code for calls to logging functions when no logger is passed into the corresponding object. cyr r)rvargss r r zDummyLogger.__init__&s r cyz; No-op logging. Only level needed for now. Nrrr!kwargss r debugzDummyLogger.debug) r cyr#rr$s r tracezDummyLogger.trace/r'r N)rrrrr r&r)rr r rrs   r rc0eZdZdZdfd ZdZdZxZS) OutputLoggeraF A Logger object that prints to stderr or any other file-like object. This class is provided for convenience and not part of the stable API. :param file: A file-like object passed to the print function. Defaults to ``sys.stderr``. :param trace: Enables trace-level output. Defaults to ``False``. cbt||xstj|_||_yr )superr sysstderrfile trace_level)rr0r1 __class__s r r zOutputLogger.__init__@s& &CJJ &r c>td||z|jy)Nz h2 (debug): r0)printr0rfmtstrargss r r&zOutputLogger.debugEs Vd]O,499=r cX|jrtd||z|jyy)Nz h2 (trace): r4)r1r5r0r6s r r)zOutputLogger.traceHs)    L$0tyy A r )NF)rrrrr r&r) __classcell__)r2s@r r+r+6s' >Br r+ceZdZdZedZedZedZedZedZ d dZ e d Z e jd Z y) H2Configurationa4 An object that controls the way a single HTTP/2 connection behaves. This object allows the users to customize behaviour. In particular, it allows users to enable or disable optional features, or to otherwise handle various unusual behaviours. This object has very little behaviour of its own: it mostly just ensures that configuration is self-consistent. :param client_side: Whether this object is to be used on the client side of a connection, or on the server side. Affects the logic used by the state machine, the default settings values, the allowable stream IDs, and several other properties. Defaults to ``True``. :type client_side: ``bool`` :param header_encoding: Controls whether the headers emitted by this object in events are transparently decoded to ``unicode`` strings, and what encoding is used to do that decoding. This defaults to ``None``, meaning that headers will be returned as bytes. To automatically decode headers (that is, to return them as unicode strings), this can be set to the string name of any encoding, e.g. ``'utf-8'``. .. versionchanged:: 3.0.0 Changed default value from ``'utf-8'`` to ``None`` :type header_encoding: ``str``, ``False``, or ``None`` :param validate_outbound_headers: Controls whether the headers emitted by this object are validated against the rules in RFC 7540. Disabling this setting will cause outbound header validation to be skipped, and allow the object to emit headers that may be illegal according to RFC 7540. Defaults to ``True``. :type validate_outbound_headers: ``bool`` :param normalize_outbound_headers: Controls whether the headers emitted by this object are normalized before sending. Disabling this setting will cause outbound header normalization to be skipped, and allow the object to emit headers that may be illegal according to RFC 7540. Defaults to ``True``. :type normalize_outbound_headers: ``bool`` :param validate_inbound_headers: Controls whether the headers received by this object are validated against the rules in RFC 7540. Disabling this setting will cause inbound header validation to be skipped, and allow the object to receive headers that may be illegal according to RFC 7540. Defaults to ``True``. :type validate_inbound_headers: ``bool`` :param normalize_inbound_headers: Controls whether the headers received by this object are normalized according to the rules of RFC 7540. Disabling this setting may lead to h2 emitting header blocks that some RFCs forbid, e.g. with multiple cookie fields. .. versionadded:: 3.0.0 :type normalize_inbound_headers: ``bool`` :param logger: A logger that conforms to the requirements for this module, those being no I/O and no context switches, which is needed in order to run in asynchronous operation. .. versionadded:: 2.6.0 :type logger: ``logging.Logger`` client_sidevalidate_outbound_headersnormalize_outbound_headersvalidate_inbound_headersnormalize_inbound_headersNc||_||_||_||_||_||_|xst t|_yr ) r=header_encodingr>r?r@rArrlogger)rr=rCr>r?r@rArDs r r zH2Configuration.__init__sE'.)B&*D'(@%)B&5 H 5 r c|jS)a Controls whether the headers emitted by this object in events are transparently decoded to ``unicode`` strings, and what encoding is used to do that decoding. This defaults to ``None``, meaning that headers will be returned as bytes. To automatically decode headers (that is, to return them as unicode strings), this can be set to the string name of any encoding, e.g. ``'utf-8'``. )_header_encoding)rs r rCzH2Configuration.header_encodings$$$r ct|tttdfs t d|dur t d||_y)zG Enforces constraints on the value of header encoding. Nz-header_encoding must be bool, string, or NoneTzheader_encoding cannot be True)rrstrtyperrF)rrs r rCzH2Configuration.header_encodings@ %$T$Z!89LM M D==> > %r )TNTTTTN)rrrrrr=r>r?r@rAr propertyrCsetterrr r r<r<MsAD'}5K 4#!"6$" 4" !5#! "!%+/,0*.+/6  % %&&r r<)rr.rrr+r<rr r rLs; 11$  0BB.v&v&r