o NK&h}$@sddlmZddlmZddlmZddlmZddlm Z m Z m Z ddl m Z ddlmZddlmZdd lmZdd lmZdd lmZdd lmZdd lmZddlmZmZmZddlm Z dZ!dZ"GdddeZ#dS)) annotations)Iterable) lru_cache) signature)AnyOptionalUnion)UUID) BaseRouter)NoMethod)NotFound) RouteGroup)Route) HTTP_METHODS)check_error_format)MethodNotAllowedr SanicException) RouteHandleri) __file_uri__cseZdZdZdZeZd:d d Zee d d:d dZ           d;d<fd%d& Z ee d  d=d>d)d*Z e d?d,d-Ze d@d/d0Ze d@d1d2Ze d@d3d4ZdAfd6d7 ZdBd8d9ZZS)CRouterz`The router implementation responsible for routing a `Request` object to the appropriate handler.GETpathstrmethodhost Optional[str]return*tuple[Route, RouteHandler, dict[str, Any]]c Csz|j|||rd|idWSddWSty(}z td|jddd}~wtyL}ztd|d|||jrCt|jdddddd}~ww)Nr)rrextrazRequested URL z not foundzMethod z not allowed for URL )rallowed_methods)resolveRoutingNotFoundr rr rrtuple)selfrrrer%?/var/www/html/venv/lib/python3.10/site-packages/sanic/router.py_gets4  z Router._get)maxsizecCsd}||||S)aRetrieve a `Route` object containing the details about how to handle a response for a given request :param request: the incoming request object :type request: Request :return: details needed for handling the request and returning the correct response :rtype: Tuple[ Route, RouteHandler, Dict[str, Any]] Args: path (str): the path of the route method (str): the HTTP method of the route host (Optional[str]): the host of the route Raises: NotFound: if the route is not found MethodNotAllowed: if the method is not allowed for the route Returns: Tuple[Route, RouteHandler, Dict[str, Any]]: the route, handler, and match info T)r')r#rrr__tracebackhide__r%r%r&get3sz Router.getNF/vurimethods Iterable[str]handlerr#Optional[Union[str, Iterable[str]]]strict_slashesboolstream ignore_bodyversion Optional[Union[str, float, int]]nameunquotestaticversion_prefix overwrite error_formatUnion[Route, list[Route]]c sN|durt|dd}d| ||dg}|||}t|||r.ttt|nd| || | d}t|tr?|g}n|pCdg}g}|D]R}|rU| dd|ii| }t |dkrl| rj| d| d dnd }t j d i|}||j_||j_||j_||j_| |j_||j_|rt|jj||qHt |dkr|d S|S) aAdd a handler to the router Args: uri (str): The path of the route. methods (Iterable[str]): The types of HTTP methods that should be attached, example: ["GET", "POST", "OPTIONS"]. handler (RouteHandler): The sync or async function to be executed. host (Optional[str], optional): Host that the route should be on. Defaults to None. strict_slashes (bool, optional): Whether to apply strict slashes. Defaults to False. stream (bool, optional): Whether to stream the response. Defaults to False. ignore_body (bool, optional): Whether the incoming request body should be read. Defaults to False. version (Union[str, float, int], optional): A version modifier for the uri. Defaults to None. name (Optional[str], optional): An identifying name of the route. Defaults to None. Returns: Route: The route object. N/v)rr/r-r7strictr8r; requirementsr_. __unnamed__rr%)rstriplstripjoin _normalizedict frozensetmap isinstanceupdatelenreplacesuperaddridentr4r3hostsr9r<rappend)r#r,r-r/rr1r3r4r5r7r8r9r:r;r<paramsrTroutesrSroute __class__r%r&rRNsN$       z Router.add view_nameOptional[Route]cCs>|sdS|j|}|s|jj|}|j|}|sdS|S)a+Find a route in the router based on the specified view name. Args: view_name (str): the name of the view to search for name (Optional[str], optional): the name of the route. Defaults to `None`. Returns: Optional[Route]: the route object N) name_indexr*ctxapp generate_name)r#r[r7rX full_namer%r%r&find_route_by_view_names   zRouter.find_route_by_view_namedict[tuple[str, ...], Route]cCsdd|jDS)z|Return all routes in the router. Returns: Dict[Tuple[str, ...], Route]: a dictionary of routes cSsi|]}|j|qSr%)parts).0rXr%r%r& sz%Router.routes_all..)rWr#r%r%r& routes_allszRouter.routes_all!dict[tuple[str, ...], RouteGroup]cC|jS)a0Return all static routes in the router. _In this context "static" routes do not refer to the `app.static()` method. Instead, they refer to routes that do not contain any path parameters._ Returns: Dict[Tuple[str, ...], Route]: a dictionary of routes ) static_routesrgr%r%r& routes_statics zRouter.routes_staticcCrj)zReturn all dynamic routes in the router. _Dynamic routes are routes that contain path parameters._ Returns: Dict[Tuple[str, ...], Route]: a dictionary of routes )dynamic_routesrgr%r%r&routes_dynamics zRouter.routes_dynamiccCrj)aReturn all regex routes in the router. _Regex routes are routes that contain path parameters with regex expressions, or otherwise need regex to resolve._ Returns: Dict[Tuple[str, ...], Route]: a dictionary of routes ) regex_routesrgr%r%r& routes_regexs zRouter.routes_regexNonecsJtj|i||jD]}tdd|jDr"td|dqdS)zFinalize the router. Raises: SanicException: if a route contains a parameter name that starts with "__" and is not in ALLOWED_LABELS css"|] }|do |tvVqdS)__N) startswithALLOWED_LABELS)relabelr%r%r& s  z"Router.finalize..zInvalid route: z". Parameter names cannot use '__'.N)rQfinalizermvaluesanylabelsr)r#argskwargsrXrYr%r&rws zRouter.finalizec Csd|vr|St|}dd|jD}g}|dD]&}|dr.r>:rB>)r parametersrxsplitrsr*rUrH) r#r,r/sigmappingreconstructionpartr7r~r%r%r&rIs    zRouter._normalize)rrrrrrrr) NFFFNNFFr+FN)r,rr-r.r/rrr0r1r2r3r2r4r2r5r6r7rr8r2r9r2r:rr;r2r<rrr=)N)r[rr7rrr\)rrc)rri)rrq)r,rr/rrr)r __module__ __qualname____doc__DEFAULT_METHODrALLOWED_METHODSr'rROUTER_CACHE_SIZEr*rRrbpropertyrhrlrnrprwrI __classcell__r%r%rYr&rs@  X     rN)$ __future__rcollections.abcr functoolsrinspectrtypingrrruuidr sanic_routingr sanic_routing.exceptionsr r r!sanic_routing.groupr sanic_routing.routersanic.constantsrsanic.errorpagesrsanic.exceptionsrrsanic.models.handler_typesrrrtrr%r%r%r&s$