R?ga>SrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSK r SSK J r J r SSK Jr SSKJrJr SSKJrJrJrJrJrJrJrJrJr \R8"\R:R<5r\R8"\R:R@5r!\""\S5(a>\=RF\RH-sl#\!=RF\RH-sl#SRKS 5 SRKS 5 S r&S\RN\&SS 4S \(S\\)S\RTS\(S\\(S\+S\\R4Sjjr,\""\S5(aS\&4S\)S\(S\(S\R4Sjjr-S\RS\\R\/S4S\/S44Sjr.S\)S\+4Sjr/"SS \5r0\RN4S!\)S \(S\RTS\\\(\44S"jjr1"S#S$\05r2"S%S&\05r3"S'S(\05r4"S)S*\45r5"S+S,\45r6"S-S.\05r7\8"/S/Q5r9S7S0\\\)\4\Rt4S1\\+S\Rt4S2jjr;S8S3\RS0\\\)\4\Rt4S4\\)S1\\+S5\S\Rx4 S6jjr=g)9z#Miscellaneous network utility code.N)dummy_executorrun_on_executor)IOLoop) Configurableerrno_from_exception) ListCallableAnyTypeDictUnionTuple AwaitableOptionalOP_NO_COMPRESSIONfooidnalatin1Fportaddressfamilybacklogflags reuse_portreturnc U(a [[S5(d [S5e/nUS:XaSn[R(d$U[R:Xa[R nUc[R nSn[5n[[R"XU[RSU5SS9GHn X;aM URU 5 U uppn[RS:Xa%US :XaU [R:Xa US S:waM[[R"XU 5n[&R(S :wa0UR+[R,[R.S 5 U(a/UR+[R,[R2S 5 U [R:XaD[[S 5(a/UR+[R4[R6S 5 USSunnUS:XaUb[9UU/[;USS5-5nUR=S5 UR?U5 URG5S nURIU5 URKU5 GM U$![Ra*n[!U5["R$:XaSnAGM eSnAff=f![Ra)n[!U5["R0:waeSnAGNSnAff=f![@aIn[!U5["RB:Xa&US :Xa USS:XaURE5 SnAGMeSnAff=f)aCreates listening sockets bound to the given port and address. Returns a list of socket objects (multiple sockets are returned if the given address maps to multiple IP addresses, which is most common for mixed IPv4 and IPv6 use). Address may be either an IP address or hostname. If it's a hostname, the server will listen on all IP addresses associated with the name. Address may be an empty string or None to listen on all available interfaces. Family may be set to either `socket.AF_INET` or `socket.AF_INET6` to restrict to IPv4 or IPv6 addresses, otherwise both will be used if available. The ``backlog`` argument has the same meaning as for `socket.listen() `. ``flags`` is a bitmask of AI_* flags to `~socket.getaddrinfo`, like ``socket.AI_PASSIVE | socket.AI_NUMERICHOST``. ``reuse_port`` option sets ``SO_REUSEPORT`` option for every socket in the list. If your platform doesn't support this option ValueError will be raised. SO_REUSEPORTz)the platform doesn't support SO_REUSEPORTNrc US$Nr)xs 1/usr/lib/python3/dist-packages/tornado/netutil.pybind_sockets..jsad)keydarwin localhostnt IPPROTO_IPV6Fz::1)&hasattrsocket ValueErrorhas_ipv6 AF_UNSPECAF_INET AI_PASSIVEsetsorted getaddrinfo SOCK_STREAMaddsysplatformAF_INET6errorrerrno EAFNOSUPPORTosname setsockopt SOL_SOCKET SO_REUSEADDR ENOPROTOOPTrr. IPV6_V6ONLYtuplelist setblockingbindOSError EADDRNOTAVAILclose getsocknamelistenappend)rrrrrrsockets bound_portunique_addressesresafsocktypeproto canonnamesockaddrsockehostrequested_ports r$ bind_socketsr`8s>'&.99DEEG"} ??v)9)99  }!!Ju7&&2D2DaO   " S!360e LLH $;&foo% q   ==u5D 77d?  1 163F3FJ  OOF--v/B/BA F  v~.. 3 3V5G5GK (|n Q :#9dJ/$x|2DDEH   IIh ,%%'*  Gtef Nu|| #A&%*<*<<  << '*e.?.??@ 6 $Q'5+>+>>{*QK5( ) sTJ /K ?L  K  KKK  L !LL  M [[5H*nTS(a gTR5up4T"X45 M, g![a  g[a MHf=fr!)range_DEFAULT_BACKLOGacceptBlockingIOErrorConnectionAbortedError)rorpi connectionrrmremovedr\s r$accept_handler*add_accept_handler..accept_handlers_'(Aqz &*kkm#  Z )) # )   sA A AAc2>TRT5 STS'g)NTr)remove_handler)io_loopryr\sr$r}*add_accept_handler..remove_handlerst$ r'rN)rcurrentr1int add_handlerREAD)r\rmrzr}r~rys`` @@r$add_accept_handlerrsc(nnGgG*6==*#*$**: nfkk: r'ipc\U(aSU;ag[R"US[R[RS[R5n[ U5$![R a,nURS[R:XaSnAgeSnAf[a gf=f)z[Returns ``True`` if the given string is a well-formed IP address. Supports IPv4 and IPv6. FrN) r1r9r4r:AI_NUMERICHOSTboolgaierrorargs EAI_NONAME UnicodeError)rrVr]s r$ is_valid_iprs 2  6##V%7%7F` class method:: Resolver.configure('tornado.netutil.ThreadedResolver') The implementations of this interface included with Tornado are * `tornado.netutil.DefaultLoopResolver` * `tornado.netutil.DefaultExecutorResolver` (deprecated) * `tornado.netutil.BlockingResolver` (deprecated) * `tornado.netutil.ThreadedResolver` (deprecated) * `tornado.netutil.OverrideResolver` * `tornado.platform.twisted.TwistedResolver` (deprecated) * `tornado.platform.caresresolver.CaresResolver` (deprecated) .. versionchanged:: 5.0 The default implementation has changed from `BlockingResolver` to `DefaultExecutorResolver`. .. versionchanged:: 6.2 The default implementation has changed from `DefaultExecutorResolver` to `DefaultLoopResolver`. rc[$N)rclss r$configurable_baseResolver.configurable_baseWsr'c[$r)DefaultLoopResolverrs r$configurable_defaultResolver.configurable_default[s""r'r^rrc[5e)aResolves an address. The ``host`` argument is a string which may be a hostname or a literal IP address. Returns a `.Future` whose result is a list of (family, address) pairs, where address is a tuple suitable to pass to `socket.connect ` (i.e. a ``(host, port)`` pair for IPv4; additional fields may be present for IPv6). If a ``callback`` is passed, it will be run with the result as an argument when it is complete. :raises IOError: if the address cannot be resolved. .. versionchanged:: 4.4 Standardized all implementations to raise `IOError`. .. versionchanged:: 6.0 The ``callback`` argument was removed. Use the returned awaitable object instead. )NotImplementedErrorselfr^rrs r$resolveResolver.resolve_s 0"##r'Ncg)zKCloses the `Resolver`, freeing any resources used. .. versionadded:: 3.1 Nr"rs r$rOResolver.closeys r'r"r)__name__ __module__ __qualname____firstlineno____doc__ classmethodr rrr1r4strr AddressFamilyrrrr rrO__static_attributes__r"r'r$rr:s8$z"2#T*%5##DJCSCS$$"$,2,@,@$ 4c3h( )$4 r'rr^c[R"XU[R5n/nUHupVpxn URXY45 M U$r)r1r9r:rR) r^rraddrinforesultsfamrXrYrZrs r$ _resolve_addrrsG!!$ff6H6HIHG4<0u~&5= Nr'c p\rSrSrSr\R 4S\S\S\RS\ \ \\ 44Sjjr Srg ) DefaultExecutorResolverizResolver implementation using `.IOLoop.run_in_executor`. .. versionadded:: 5.0 .. deprecated:: 6.2 Use `DefaultLoopResolver` instead. r^rrrcx# [R"5RS[XU5IShvN nU$N7fr)rrrun_in_executorr)rr^rrresults r$rDefaultExecutorResolver.resolves8~~'77 -V    s /:8:r"Nrrrrrr1r4rrrrrr rrr"r'r$rrsQDJCSCS",2,@,@ eCHo r'rc p\rSrSrSr\R 4S\S\S\RS\ \ \\ 44Sjjr Srg ) riz9Resolver implementation using `asyncio.loop.getaddrinfo`.r^rrrc # [R"5RXU[RS9IShvN VVVs/sH un pVXF4PM snnn$Ns snnnf7f)N)rtype)asyncioget_running_loopr9r1r:)rr^rrr_rs r$rDefaultLoopResolver.resolvesq07/G/G/I/U/U60B0B0V0** *%Q1N*  * s!6A!AA!AA!A!r"Nrr"r'r$rrsOCDJCSCS    "  ,2,@,@  eCHo    r'rc \rSrSrSrSS\\RRS\ SS4Sjjr SSjr \ \ R4S \S \S \ R"S\\\\44S jj5rS rg)ExecutorResolveriaResolver implementation using a `concurrent.futures.Executor`. Use this instead of `ThreadedResolver` when you require additional control over the executor being used. The executor will be shut down when the resolver is closed unless ``close_resolver=False``; use this if you want to reuse the same executor elsewhere. .. versionchanged:: 5.0 The ``io_loop`` argument (deprecated since version 4.1) has been removed. .. deprecated:: 5.0 The default `Resolver` now uses `asyncio.loop.getaddrinfo`; use that instead of this class. Nexecutorclose_executorrcHUb XlX lg[UlSUlg)NF)rrr)rrrs r$ initializeExecutorResolver.initializes$  $M"0 *DM"'D r'chUR(aURR5 SUlgr)rrshutdownrs r$rOExecutorResolver.closes"    MM " " $ r'r^rrc[XU5$r)rrs r$rExecutorResolver.resolvesT00r')rr)NTr)rrrrrr concurrentfuturesExecutorrrrOrr1r4rrrrrr rrr"r'r$rrs&;?# (:--667 ( (  ( CICSCS11"1,2,@,@1 eCHo 11r'rc0^\rSrSrSrSU4SjjrSrU=r$)BlockingResolveria5Default `Resolver` implementation, using `socket.getaddrinfo`. The `.IOLoop` will be blocked during the resolution, although the callback will not be run until the next `.IOLoop` iteration. .. deprecated:: 5.0 The default `Resolver` now uses `.IOLoop.run_in_executor`; use that instead of this class. c">[TU]5 gr)superr)r __class__s r$rBlockingResolver.initializes r'r"r)rrrrrrr __classcell__rs@r$rrsr'rc^\rSrSrSrSrSrS S\SS4U4Sjjjr\ S\S\ RR4Sj5r SrU=r$) ThreadedResolveriarMultithreaded non-blocking `Resolver` implementation. Requires the `concurrent.futures` package to be installed (available in the standard library since Python 3.2, installable with ``pip install futures`` in older versions). The thread pool size can be configured with:: Resolver.configure('tornado.netutil.ThreadedResolver', num_threads=10) .. versionchanged:: 3.1 All ``ThreadedResolvers`` share a single thread pool, whose size is set by the first one to be created. .. deprecated:: 5.0 The default `Resolver` now uses `.IOLoop.run_in_executor`; use that instead of this class. N num_threadsrcL>[RU5n[TU] USS9 g)NF)rr)r_create_threadpoolrr)rr threadpoolrs r$rThreadedResolver.initializes%%88E  JuEr'c[R"5nURU:waSUlURc*[R R U5UlX lUR$r)rBgetpid_threadpool_pid _threadpoolrrThreadPoolExecutor)rrpids r$r#ThreadedResolver._create_threadpool sXiik   # %#CO ?? "(00CCKPCO"% r'r") )rrrrrrrrrrrrrrrrrs@r$rrs`(KOFcF4FF      . .  r'rc \rSrSrSrS\S\SS4SjrSSjr\ R4S \ S \ S \ RS\\\\ \44S jjrS rg)OverrideResolveria'Wraps a resolver with a mapping of overrides. This can be used to make local DNS changes (e.g. for testing) without modifying system-wide settings. The mapping can be in three formats:: { # Hostname to host or ip "example.com": "127.0.1.1", # Host+port to host+port ("login.example.com", 443): ("localhost", 1443), # Host+port+address family to host+port ("login.example.com", 443, socket.AF_INET6): ("::1", 1443), } .. versionchanged:: 5.0 Added support for host-port-family triplets. resolvermappingrNcXlX lgr)rr)rrrs r$rOverrideResolver.initialize2s   r'c8URR5 gr)rrOrs r$rOOverrideResolver.close6s r'r^rrc XU4UR;aURXU4upOBX4UR;aURX4upOXR;aURUnURRXU5$r)rrrrs r$rOverrideResolver.resolve9s}  4<< /t6&:;JD$\T\\ )tl3JD$ \\ !<<%D}}$$T88r')rrr)rrrrrrdictrrOr1r4rrrrrrr rrr"r'r$rrsu,8dtDJCSCS 9 9" 9,2,@,@ 9 4c3h( ) 9 9r'r) ssl_versioncertfilekeyfile cert_reqsca_certsciphers ssl_options server_sidec[U[R5(aU$[U[5(de[ SU55(dU5e[R nU(a[R nOUb[Rn[R"URSU55nSU;a%URUSURSS55 SU;a(US[R:XaSUl USUl SU;aURUS5 S U;aURUS 5 [[S 5(a#U=R [R"-slU$) aPTry to convert an ``ssl_options`` dictionary to an `~ssl.SSLContext` object. The ``ssl_options`` dictionary contains keywords to be passed to ``ssl.SSLContext.wrap_socket``. In Python 2.7.9+, `ssl.SSLContext` objects can be used instead. This function converts the dict form to its `~ssl.SSLContext` equivalent, and may be used when a component which accepts both forms needs to upgrade to the `~ssl.SSLContext` version to use features like SNI or NPN. .. versionchanged:: 6.2 Added server_side argument. Omitting this argument will result in a DeprecationWarning on Python 3.10. c32# UH o[;v M g7fr)_SSL_CONTEXT_KEYWORDS).0ks r$ )ssl_options_to_context..ds?;a));sNrrrrFrrr) isinstancessl SSLContextrall PROTOCOL_TLSPROTOCOL_TLS_SERVERPROTOCOL_TLS_CLIENTgetload_cert_chain CERT_NONEcheck_hostname verify_modeload_verify_locations set_ciphersr0optionsr)rrdefault_versioncontexts r$ssl_options_to_contextrMsK(+s~~.. k4 ( (( ( ?;? ? ?LL ?&&O11  11nn[__]OLMG[   #[__Y%E k! { #s}} 4&+G ")+6[ %%k*&=>KK 23s'(( 3000 Nr'r1server_hostnamekwargsc v[XS9nUcSn[R(deUR"U4X#S.UD6$)a~Returns an ``ssl.SSLSocket`` wrapping the given socket. ``ssl_options`` may be either an `ssl.SSLContext` object or a dictionary (as accepted by `ssl_options_to_context`). Additional keyword arguments are passed to `ssl.SSLContext.wrap_socket`. .. versionchanged:: 6.2 Added server_side argument. Omitting this argument will result in a DeprecationWarning on Python 3.10. )rF)rr)rrHAS_SNI wrap_socket)r1rrrrrs r$ssl_wrap_socketrsM$%[JG ;;;     / LR r'r)NN)>rrconcurrent.futuresrr@rBr<r1rretornado.concurrentrrtornado.ioloopr tornado.utilrrtypingrr r r r r rrrcreate_default_contextPurpose SERVER_AUTH_client_ssl_defaults CLIENT_AUTH_server_ssl_defaultsr0rrencodersr4rrrrr`rlrrrrrrrrrr frozensetrrr SSLSocketrr"r'r$r's: * >!;UUU11#++2I2IJ11#++2I2IJ 3#$$  C$9$99   C$9$99  V X "#)#3#3# C C c]C  C C C= C  C &--CL 69 %5E   /2   F9 --9#+V]]C,@$,F#G9 b$h9xCD6E |E R:@9I9I    "("6"6  %S/ h& ( &'1x'1T ' ('(V'9x'9Z"N#'4tCH~s~~564$4 ^^4t&*"&  MMtCH~s~~56c]$     ]] r'