8Cfv{ddlmZmZmZddlmZddlmZmZddl m Z ddl m Z m Z mZmZmZmZmZmZmZmZddlmZddlmZddlmZdd lmZdd lmZdd l m!Z!m"Z"dd l#m$Z$dd l%m&Z&e e$gee$eee$fffZ'GddeeZ(y)) NodeVisitorReturnparse)suppress) getsource signature)dedent) AnyCallableDictIterableListOptionalSetTupleUnioncast)Route) SanicMeta) HTTP_METHODS)RESPONSE_MAPPING) BaseMixin) FutureRoute FutureStatic) RouteHandler) HashableDictc#eZdZd)dZdedeefdZ d*ded e e ed e e eeefd e e d e d e e e eefde ede de de eede de de dede ededef"dZedhddddddddf deded e ed e e eeefd e e d e e e eefde ed e dede ede dedefdZ d+ded e e eeefd e e d e e e eefde ede dede ededefdZ d,ded e e eeefd e e d e d e e e eefde edede ededefdZ d,ded e e eeefd e e d e d e e e eefde edede ededefdZ d+ded e e eeefd e e d e e e eefde ede dede ededefdZ d+ded e e eeefd e e d e e e eefde ede dede ededefd Z d,ded e e eeefd e e d e e e eefde edede ededefd!Z d-ded e e eeefd e e d e e e eefde ede dede ededefd"Z d.ded e e eeefd e e de eed e e e eefde ede dede edefd#Z d/ded e e eeefd e e d e e e eefde edede edefd$Zdefd%Zd&Zd'e eefde!fd(Z"y)0 RouteMixinreturnNc@t|_t|_yN)set_future_routes_future_statics)selfargskwargss S/var/www/highfloat_scraper/venv/lib/python3.12/site-packages/sanic/mixins/routes.py__init__zRouteMixin.__init__#s0325%routectr!)NotImplementedError)r%r+s r( _apply_routezRouteMixin._apply_route's!!r*F/vurimethodshoststrict_slashesstreamversionname ignore_bodyapply subprotocols websocketunquotestaticversion_prefix error_format ctx_kwargsc  jdss tdrdz js s tdhj |    fd}|S)aDecorate a function to be registered as a route. Args: uri (str): Path of the URL. methods (Optional[Iterable[str]]): List or tuple of methods allowed. host (Optional[Union[str, List[str]]]): The host, if required. strict_slashes (Optional[bool]): Whether to apply strict slashes to the route. stream (bool): Whether to allow the request to stream its body. version (Optional[Union[int, str, float]]): Route specific versioning. name (Optional[str]): User-defined route name for url_for. ignore_body (bool): Whether the handler should ignore request body (e.g. `GET` requests). apply (bool): Apply middleware to the route. subprotocols (Optional[List[str]]): List of subprotocols. websocket (bool): Enable WebSocket support. unquote (bool): Unquote special characters in the URL path. static (bool): Enable static route. version_prefix (str): URL path that should be before the version value; default: `"/v"`. error_format (Optional[str]): Error format for the route. ctx_kwargs (Any): Keyword arguments that begin with a `ctx_*` prefix will be appended to the route context (`route.ctx`). Returns: RouteWrapper: Tuple of routes, decorated function. Examples: Using the method to define a GET endpoint: ```python @app.route("/hello") async def hello(request: Request): return text("Hello, World!") ``` Adding context kwargs to the route: ```python @app.route("/greet", ctx_name="World") async def greet(request: Request): name = request.route.ctx.name return text(f"Hello, {name}!") ``` /routerGETct|tr|\}}j | t tr t g n rt ts t  ttr tnttr t rdk(rj|t|rdn&t Dcgc]}|jc}   }tdd}|r'ttfdj_jj|tt!|j"j%}r)t'|dkr|j(}t d|d|s|j(}t d |ds r|_rj-|| r||fS|S#t $rt d zwxYwcc}w) Nz:Expected either string or Iterable of host strings, not %sauto_allow_route_overwriteFc"|jk7Sr!)r0)xr0s r(z5RouteMixin.route..decorator..sQUUc\r*z8Required parameter `request` and/or `ws` missing in the z () route?z,Required parameter `request` missing in the ) overwrite) isinstancetuple_generate_namestr frozenset TypeError ValueErrorlistr"_determine_error_formatruppergetattrfilterr#addr parameterskeyslen__name__ is_streamr.)handler_rHr+rKr& handler_namer8r>r2r7r1r6 route_contextr%r<r4r3r9r;r0r5r=r:s r( decoratorz#RouteMixin.route..decoratorzs&'5)% 7&&tW5D$$ $(jy9$T?D ,-$\2 L#.(6 <6#9#;;GD !yW1M!'')1M'N!E$ &>FI&)143F3FG'#    # #E * '*55::<=DSY]&//  *^96&//  *^96 $*!!!%9!=g~%NA!$!#'($2Ns G#G>#G;) startswithhasattrr3rP_build_route_context)r%r0r1r2r3r4r5r6r7r8r9r:r;r<r=r>r?rbras```````````````` @r(r+zRouteMixin.route*suJ~~c"wtX/F)C  !!00Ny(G11*= [ [ [ zr*rCr^c  >t|dr_t}tD]L} t|d}t|| j d}|s-|j | t|dsKd}N| |j }|jd|||||||| | | d | ||S)aA helper method to register class-based view or functions as a handler to the application url routes. Args: handler (RouteHandler): Function or class-based view used as a route handler. uri (str): Path of the URL. methods (Iterable[str]): List or tuple of methods allowed; these are overridden if using an HTTPMethodView. host (Optional[Union[str, List[str]]]): Hostname or hostnames to match for this route. strict_slashes (Optional[bool]): If set, a route's slashes will be strict. E.g. `/foo` will not match `/foo/`. version (Optional[Union[int, str, float]]): Version of the API for this route. name (Optional[str]): User-defined route name for `url_for`. stream (bool): Boolean specifying if the handler is a stream handler. version_prefix (str): URL path that should be before the version value; default: ``/v``. error_format (Optional[str]): Custom error format string. unquote (bool): Boolean specifying if the handler requires unquoting. ctx_kwargs (Any): Keyword arguments that begin with a `ctx_*` prefix will be appended to the route context (``route.ctx``). See below for examples. Returns: RouteHandler: The route handler. Examples: ```python from sanic import Sanic, text app = Sanic("test") async def handler(request): return text("OK") app.add_route(handler, "/test", methods=["GET", "POST"]) ``` You can use `ctx_kwargs` to add custom context to the route. This can often be useful when wanting to add metadata to a route that can be used by other parts of the application (like middleware). ```python from sanic import Sanic, text app = Sanic("test") async def handler(request): return text("OK") async def custom_middleware(request): if request.route.ctx.monitor: do_some_monitoring() app.add_route(handler, "/test", methods=["GET", "POST"], ctx_monitor=True) app.register_middleware(custom_middleware) view_classNr]T) r0r1r2r3r4r5r6r=r>r;)rdr"rrVlowerrXr3r+)r%r^r0r1r2r3r5r6r4r=r>r;r?methodrg_handlers r( add_routezRouteMixin.add_routesD 7L )eG& &$Wl; ":v||~tDKK'x5!%  &  !!00N  ))%    r*c  jtt|j|ftdh|||||||d| S)a0Decorate a function handler to create a route definition using the **GET** HTTP method. Args: uri (str): URL to be tagged to GET method of HTTP. host (Optional[Union[str, List[str]]]): Host IP or FQDN for the service to use. strict_slashes (Optional[bool]): Instruct Sanic to check if the request URLs need to terminate with a `/`. version (Optional[Union[int, str, float]]): API Version. name (Optional[str]): Unique name that can be used to identify the route. ignore_body (bool): Whether the handler should ignore request body. This means the body of the request, if sent, will not be consumed. In that instance, you will see a warning in the logs. Defaults to `True`, meaning do not consume the body. version_prefix (str): URL path that should be before the version value. Defaults to `"/v"`. error_format (Optional[str]): Custom error format string. **ctx_kwargs (Any): Keyword arguments that begin with a `ctx_* prefix` will be appended to the route context (`route.ctx`). Returns: RouteHandler: Object decorated with route method. rCr1r2r3r5r6r7r=r>rrr+rP r%r0r2r3r5r6r7r=r>r?s r(getzRouteMixin.get9sTJ  DJJ !5'*-'-)    r*c  jtt|j|ftdh|||||||d| S)aoDecorate a function handler to create a route definition using the **POST** HTTP method. Args: uri (str): URL to be tagged to POST method of HTTP. host (Optional[Union[str, List[str]]]): Host IP or FQDN for the service to use. strict_slashes (Optional[bool]): Instruct Sanic to check if the request URLs need to terminate with a `/`. stream (bool): Whether or not to stream the request body. Defaults to `False`. version (Optional[Union[int, str, float]]): API Version. name (Optional[str]): Unique name that can be used to identify the route. version_prefix (str): URL path that should be before the version value. Defaults to `"/v"`. error_format (Optional[str]): Custom error format string. **ctx_kwargs (Any): Keyword arguments that begin with a `ctx_*` prefix will be appended to the route context (`route.ctx`). Returns: RouteHandler: Object decorated with route method. POSTr1r2r3r4r5r6r=r>ro r%r0r2r3r4r5r6r=r>r?s r(postzRouteMixin.postnsTF  DJJ !6(+--)    r*c  jtt|j|ftdh|||||||d| S)amDecorate a function handler to create a route definition using the **PUT** HTTP method. Args: uri (str): URL to be tagged to PUT method of HTTP. host (Optional[Union[str, List[str]]]): Host IP or FQDN for the service to use. strict_slashes (Optional[bool]): Instruct Sanic to check if the request URLs need to terminate with a `/`. stream (bool): Whether or not to stream the request body. Defaults to `False`. version (Optional[Union[int, str, float]]): API Version. name (Optional[str]): Unique name that can be used to identify the route. version_prefix (str): URL path that should be before the version value. Defaults to `"/v"`. error_format (Optional[str]): Custom error format string. **ctx_kwargs (Any): Keyword arguments that begin with a `ctx_*` prefix will be appended to the route context (`route.ctx`). Returns: RouteHandler: Object decorated with route method. PUTrtrorus r(putzRouteMixin.putsTF  DJJ !5'*--)    r*c  jtt|j|ftdh|||||||d| S)a2Decorate a function handler to create a route definition using the **HEAD** HTTP method. Args: uri (str): URL to be tagged to HEAD method of HTTP. host (Optional[Union[str, List[str]]]): Host IP or FQDN for the service to use. strict_slashes (Optional[bool]): Instruct Sanic to check if the request URLs need to terminate with a `/`. version (Optional[Union[int, str, float]]): API Version. name (Optional[str]): Unique name that can be used to identify the route. ignore_body (bool): Whether the handler should ignore request body. This means the body of the request, if sent, will not be consumed. In that instance, you will see a warning in the logs. Defaults to `True`, meaning do not consume the body. version_prefix (str): URL path that should be before the version value. Defaults to `"/v"`. error_format (Optional[str]): Custom error format string. **ctx_kwargs (Any): Keyword arguments that begin with a `ctx_*` prefix will be appended to the route context (`route.ctx`). Returns: RouteHandler: Object decorated with route method. HEADrnrorps r(headzRouteMixin.headsTJ  DJJ !6(+-'-)    r*c  jtt|j|ftdh|||||||d| S)a8Decorate a function handler to create a route definition using the **OPTIONS** HTTP method. Args: uri (str): URL to be tagged to OPTIONS method of HTTP. host (Optional[Union[str, List[str]]]): Host IP or FQDN for the service to use. strict_slashes (Optional[bool]): Instruct Sanic to check if the request URLs need to terminate with a `/`. version (Optional[Union[int, str, float]]): API Version. name (Optional[str]): Unique name that can be used to identify the route. ignore_body (bool): Whether the handler should ignore request body. This means the body of the request, if sent, will not be consumed. In that instance, you will see a warning in the logs. Defaults to `True`, meaning do not consume the body. version_prefix (str): URL path that should be before the version value. Defaults to `"/v"`. error_format (Optional[str]): Custom error format string. **ctx_kwargs (Any): Keyword arguments that begin with a `ctx_*` prefix will be appended to the route context (`route.ctx`). Returns: RouteHandler: Object decorated with route method. OPTIONSrnrorps r(optionszRouteMixin.options sTJ  DJJ !9+.-'-)    r*c  jtt|j|ftdh|||||||d| S)aDecorate a function handler to create a route definition using the **PATCH** HTTP method. Args: uri (str): URL to be tagged to PATCH method of HTTP. host (Optional[Union[str, List[str]]]): Host IP or FQDN for the service to use. strict_slashes (Optional[bool]): Instruct Sanic to check if the request URLs need to terminate with a `/`. stream (bool): Set to `True` if full request streaming is needed, `False` otherwise. Defaults to `False`. version (Optional[Union[int, str, float]]): API Version. name (Optional[str]): Unique name that can be used to identify the route. version_prefix (str): URL path that should be before the version value. Defaults to `"/v"`. error_format (Optional[str]): Custom error format string. **ctx_kwargs (Any): Keyword arguments that begin with a `ctx_*` prefix will be appended to the route context (`route.ctx`). Returns: RouteHandler: Object decorated with route method. PATCHrtrorus r(patchzRouteMixin.patch>sTF  DJJ !7),--)    r*c  jtt|j|ftdh|||||||d| S)asDecorate a function handler to create a route definition using the **DELETE** HTTP method. Args: uri (str): URL to be tagged to the DELETE method of HTTP. host (Optional[Union[str, List[str]]]): Host IP or FQDN for the service to use. strict_slashes (Optional[bool]): Instruct Sanic to check if the request URLs need to terminate with a */*. version (Optional[Union[int, str, float]]): API Version. name (Optional[str]): Unique name that can be used to identify the Route. ignore_body (bool): Whether or not to ignore the body in the request. Defaults to `False`. version_prefix (str): URL path that should be before the version value. Defaults to `"/v"`. error_format (Optional[str]): Custom error format string. **ctx_kwargs (Any): Keyword arguments that begin with a `ctx_*` prefix will be appended to the route context (`route.ctx`). Returns: RouteHandler: Object decorated with route method. DELETErnrorps r(deletezRouteMixin.deleteqsTD  DJJ !8*--'-)    r*c  >|jd||d|||||d|| d | S)aDecorate a function to be registered as a websocket route. Args: uri (str): Path of the URL. host (Optional[Union[str, List[str]]]): Host IP or FQDN details. strict_slashes (Optional[bool]): If the API endpoint needs to terminate with a `"/"` or not. subprotocols (Optional[List[str]]): Optional list of str with supported subprotocols. version (Optional[Union[int, str, float]]): WebSocket protocol version. name (Optional[str]): A unique name assigned to the URL so that it can be used with url_for. apply (bool): If set to False, it doesn't apply the route to the app. Default is `True`. version_prefix (str): URL path that should be before the version value. Defaults to `"/v"`. error_format (Optional[str]): Custom error format string. **ctx_kwargs (Any): Keyword arguments that begin with a `ctx_* prefix` will be appended to the route context (`route.ctx`). Returns: tuple: Tuple of routes, decorated function. NT) r0r2r1r3r5r6r8r9r:r=r>rh)r+) r%r0r2r3r9r5r6r8r=r>r?s r(r:zRouteMixin.websocketsHLtzz  )%)%    r*c D|jd|||||||| d| |S)azA helper method to register a function as a websocket route. Args: handler (Callable): A callable function or instance of a class that can handle the websocket request. uri (str): URL path that will be mapped to the websocket handler. host (Optional[Union[str, List[str]]]): Host IP or FQDN details. strict_slashes (Optional[bool]): If the API endpoint needs to terminate with a `"/"` or not. subprotocols (Optional[List[str]]): Subprotocols to be used with websocket handshake. version (Optional[Union[int, str, float]]): Versioning information. name (Optional[str]): A unique name assigned to the URL. version_prefix (str): URL path before the version value. Defaults to `"/v"`. error_format (Optional[str]): Format for error handling. **ctx_kwargs (Any): Keyword arguments beginning with `ctx_*` prefix will be appended to the route context (`route.ctx`). Returns: Callable: Object passed as the handler. )r0r2r3r9r5r6r=r>rh)r:) r%r^r0r2r3r9r5r6r=r>r?s r(add_websocket_routezRouteMixin.add_websocket_routesKF  ~t~~  )%)%       r*cttt5tt |}t |}|j |}t|dk(rtt|cdddS dddy#1swYyxYw)N) rOSErrorrQr rr_get_response_typesr[nextiter)r%r^srctreehttp_response_typess r(rTz"RouteMixin._determine_error_formatsz gy ) 77+,C:D"&":":4"@ &'1,D!456  7 7 -  7 7s AA;;BcjtGfddt}|j|S)Nc"eZdZdedeffd Zy);RouteMixin._get_response_types..HttpResponseVisitornoderctt5|jjjg}|jj r@||jj Dcgc]}|j dk(r |jc}z }|D]#}|tvs jt|% dddycc}w#1swYyxYw)N content_type) rAttributeErrorvaluefuncidkeywordsargrrX)r%rcheckskchecktypess r( visit_ReturnzHRouteMixin._get_response_types..HttpResponseVisitor.visit_Returnsn- ?"jjoo001Fzz**%)ZZ%8%8# ! uu6GG# "(? $44!II&6u&=>? ? ?# ? ?s$AC""B;CC;CC N)r\ __module__ __qualname__rr r)rsr(HttpResponseVisitorrs ? ?C ?r*r)r"rvisit)r%rrrs @r(rzRouteMixin._get_response_typess. ?+ ?" ##D) r*rawc i|jDcic]5}|jdr"|jdd|j|7}}|r-dj |j}t d|t |Scc}w)Nctx_rz, zUnexpected keyword arguments: )rZrcreplacepopjoinrQr)r%rkeyr?unexpected_argumentss r(rezRouteMixin._build_route_context*s#w||~ ~~f% KK #SWWS\ 1  #'99SXXZ#8 01E0FG J'' s:B )rN)NNNFNNFTNFFFr/N)NNNNTr/N)NNFNNr/N)NNNNFr/N)NNNNNTr/N)NNNNNr/N)#r\rrr)rrrr.rOrr rboolintfloatr RouteWrapperr+rPrrlrqrvryr|rrrr:rrTrr rrerhr*r(rr"se8"+"$u+" ,004)-48"!,0"&*!m m(3-(muS$s)^,- m ! m  m%S%01msmmmmtCy)mmmmm sm!m"#m$ %mf"+E7!304)-48""&*]]]# ] uS$s)^,- ] ! ]%S%01]sm]]]sm]]] ]F15)-48" "&*3 3 uS$s)^,-3 ! 3 %S%01 3 sm 3 3 3 sm3 3  3 p15)-48""&*1 1 uS$s)^,-1 ! 1  1 %S%01 1 sm1 1 sm1 1  1 l15)-48""&*1 1 uS$s)^,-1 ! 1  1 %S%01 1 sm1 1 sm1 1  1 l15)-48" "&*3 3 uS$s)^,-3 ! 3 %S%01 3 sm 3 3 3 sm3 3  3 p15)-48" "&*3 3 uS$s)^,-3 ! 3 %S%01 3 sm 3 3 3 sm3 3  3 p15)-48""&*1 1 uS$s)^,-1 ! 1 %S%01 1 sm1 1 sm1 1  1 l15)-48"!"&*0 0 uS$s)^,-0 ! 0 %S%01 0 sm 0 0 0 sm0 0  0 j15)-,048""&*3 3 uS$s)^,-3 ! 3 tCy) 3 %S%01 3 sm3 3 3 sm3 3 r15)-48""&*--uS$s)^,- - ! -%S%01-sm--sm--^ # 0 (S#X (< (r*r) metaclassN))astrrr contextlibrinspectrrtextwrapr typingr r r r rrrrrrsanic_routing.routersanic.base.metarsanic.constantsrsanic.errorpagesrsanic.mixins.basersanic.models.futuresrrsanic.models.handler_typesr sanic.typesrrrrhr*r(rsw**(   &%(-':3$NE,e\.A(BBCC S (iS (r*