o Yi@sddlmZddlZddlZddlZddlmZm Z m Z ddl m Z m Z ddlmZmZmZgdZzdd lmZdd lmZmZWney\dddd d"ddZ d#d$ddZYnwdddd d"ddZ d#d$ddZGd d!d!ZdS)%) annotationsN)AnyCallableLiteral)RequestResponse)ServerServerConnectionserve)route unix_routeRouter)NotFound)MapRequestRedirect) server_namessl create_routerurl_maprargsrr str | Noner,ssl_module.SSLContext | Literal[True] | Nonertype[Router] | Nonekwargsreturnr cOtd)Nzroute() requires werkzeug ImportError)rrrrrrr P/home/kim/smarthome/.venv/lib/python3.10/site-packages/websockets/sync/router.pyr sr pathcKr)Nzunix_route() requires werkzeugrrr"rr r r!rsrcs|durdnd}|dur|dur||d<|durt}|||||dddur.j}ndfd d }tjg|Rd|i|S)a\ Create a WebSocket server dispatching connections to different handlers. This feature requires the third-party library `werkzeug`_: .. code-block:: console $ pip install werkzeug .. _werkzeug: https://werkzeug.palletsprojects.com/ :func:`route` accepts the same arguments as :func:`~websockets.sync.server.serve`, except as described below. The first argument is a :class:`werkzeug.routing.Map` that maps URL patterns to connection handlers. In addition to the connection, handlers receive parameters captured in the URL as keyword arguments. Here's an example:: from websockets.sync.router import route from werkzeug.routing import Map, Rule def channel_handler(websocket, channel_id): ... url_map = Map([ Rule("/channel/", endpoint=channel_handler), ... ]) with route(url_map, ...) as server: server.serve_forever() Refer to the documentation of :mod:`werkzeug.routing` for details. If you define redirects with ``Rule(..., redirect_to=...)`` in the URL map, when the server runs behind a reverse proxy that modifies the ``Host`` header or terminates TLS, you need additional configuration: * Set ``server_name`` to the name of the server as seen by clients. When not provided, websockets uses the value of the ``Host`` header. * Set ``ssl=True`` to generate ``wss://`` URIs without enabling TLS. Under the hood, this bind the URL map with a ``url_scheme`` of ``wss://`` instead of ``ws://``. There is no need to specify ``websocket=True`` in each rule. It is added automatically. Args: url_map: Mapping of URL patterns to connection handlers. server_name: Name of the server as seen by clients. If :obj:`None`, websockets uses the value of the ``Host`` header. ssl: Configuration for enabling TLS on the connection. Set it to :obj:`True` if a reverse proxy terminates TLS connections. create_router: Factory for the :class:`Router` dispatching requests to handlers. Set it to a wrapper or a subclass to customize routing. NwswssTrprocess_request connectionr requestrrResponse | Nonecs"||}|dur |S||SN) route_request)r'r(responseZ_process_requestZrouterr r!r&s  zroute..process_requestr'r r(rrr))rpopr+r handler)rrrrrr url_schemer&r r-r!r (sE  cKst|fd|d|S)ag Create a WebSocket Unix server dispatching connections to different handlers. :func:`unix_route` combines the behaviors of :func:`route` and :func:`~websockets.sync.server.unix_serve`. Args: url_map: Mapping of URL patterns to connection handlers. path: File system path to the Unix socket. T)unixr")r r#r r r!rsc@sReZdZdZ  dd d d Zd!ddZd"ddZd#ddZd$ddZd%ddZ dS)&rz*WebSocket router supporting :func:`route`.Nr$rrrrr1strrNonecCs,||_||_||_|jD]}d|_qdS)NT)rrr1Z iter_rulesZ websocket)selfrrr1ruler r r!__init__s zRouter.__init__r'r r(rcCs|jdur |jdS|jS)NHost)rheaders)r5r'r(r r r!get_server_names  zRouter.get_server_nameurlrcCs$|tjjd|}||jd<|S)Nz Found at ZLocation)respondhttp HTTPStatusFOUNDr9)r5r'r;r,r r r!redirects zRouter.redirectcCs|tjjdS)Nz Not Found)r<r=r> NOT_FOUNDr5r'r r r! not_foundszRouter.not_foundr)c Cs|jj||||jd}ztj|j}|j|j|j d\}}Wn&t y:}z | ||j WYd}~Sd}~wt yG||YSw|||_|_dS)zRoute incoming request.)rr1)Z path_infoZ query_argsN)rbindr:r1urllibparseurlparser"matchqueryrr@new_urlrrCr0handler_kwargs)r5r'r(Zurl_map_adapterparsedr0rr@r r r!r+s$  zRouter.route_requestcCs|j|fi|jS)zHandle a connection.)r0rKrBr r r!r0szRouter.handler)Nr$)rrrrr1r3rr4)r'r r(rrr3)r'r r;r3rr)r'r rrr.)r'r rr4) __name__ __module__ __qualname____doc__r7r:r@rCr+r0r r r r!rs   r)rrrrrrrrrrrrrr r*)rrr"rrrrr ) __future__rr=rZ ssl_module urllib.parserEtypingrrrZhttp11rrserverr r r __all__Zwerkzeug.exceptionsrZwerkzeug.routingrrrr rrr r r r!s4    h