hKj7ddlZddlZddlmZ GddeZGddeZGddeZGd d eZ Gd d eZ y) N)wrapsc"eZdZdZdZdZdZy)RuleaR A rule is a mapping between a pattern (typically a URI) and a callable (typically a function). The pattern is a regex string pattern and must match entirely a string (typically a URI) for the rule to be considered, i.e. for the endpoint to be resolved and eventually invoked for a given string (typically a URI). c0|jdjd|_tjd|jzdzj |_t|sJtj|r|}t|sJ||_ y)N^$) lstriprstrippatternrecompilematch pattern_matchcallableinspectisclassendpoint)selfr robjs ]/home/oem/CyberBrain26-unified/.venv/lib/python3.12/site-packages/packageurl/contrib/route.py__init__z Rule.__init__@sz~~c*11#6 ZZdll(:S(@AGG!!! ??8 $*CC= =  c~d|jd|jjd|jjdS)Nz Rule(r"""z""", .))r r __module____name__rs r__repr__z Rule.__repr__Os84<<.dmm.F.F-GqI_I_H``abbrc$|j|S)zP Match a string with the rule pattern, return True is matching. )r)rstrings rrz Rule.matchRs!!&))rN)rr __qualname____doc__rrrrrrr7s !c*rrceZdZdZy)RouteAlreadyDefinedzF Raised when this route Rule already exists in the route map. Nrrr"r#r$rrr&r&Yrr&ceZdZdZy)NoRouteAvailablez3 Raised when there are no route available. Nr'r$rrr*r*_r(rr*ceZdZdZy)MultipleRoutesDefinedz= Raised when there are more than one route possible. Nr'r$rrr,r,er(rr,cHeZdZdZd dZdZdZdZdZdZ d Z d Z d Z y) Routera A router is: - a container for a route map, consisting of several rules, stored in an ordered dictionary keyed by pattern text - a way to process a route, i.e. given a string (typically a URI), find the correct rule and invoke its callable endpoint - and a convenience decorator for routed callables (either a function or something with a __call__ method) Multiple routers can co-exist as needed, such as a router to collect, another to fetch, etc. Nc8|xs t|_d|_y)zG 'route_map' is an ordered mapping of pattern -> Rule. N)dict route_map _is_routable)rr1s rrzRouter.__init__ys#,df rc,t|jSN)reprr1rs rrzRouter.__repr__sDNN##rcHt|jjSr4)iterr1itemsrs r__iter__zRouter.__iter__sDNN((*++rc6|jjSr4)r1keysrs rr;z Router.keyss~~""$$rch||jvr t|t|||j|<y)z Append a new pattern and endpoint Rule at the end of the map. Use this as an alternative to the route decorator. N)r1r&r)rr rs rappendz Router.appends0 dnn $%g. ."&w"9wrcfd}|S)a Decorator to make a callable 'endpoint' routed to one or more patterns. Example: >>> my_router = Router() >>> @my_router.route('http://nexb.com', 'http://deja.com') ... def somefunc(uri): ... pass chsJD]}j||t|fd}|S)Nc(j|i|Sr4)process)argskwargsrs r decoratedz2Router.route..decorator..decorateds#t||T4V44r)r=r)rpatrDpatternsrs r decoratorzRouter.route..decoratorsGO8 + C* +8_ 5 5 rr$)rrFrGs`` rroutez Router.routes rct|j|}tj|r|}||g|i|S)z Given a string (typically a URI), resolve this string to an endpoint by searching available rules then execute the endpoint callable for that string passing down all arguments to the endpoint invocation. )resolverr)rr!rBrCrs rrAzRouter.processs< <<' ??8 $ zH0000rcR|jjDcgc]}|j|s|}}|s t|t |dkDr;t |Dcgc]}|j c}}dtz}t||djScc}wcc}w)a} Resolve a string: given a string (typically a URI) resolve and return the best endpoint function for that string. Ambiguous resolution is not allowed in order to keep things in check when there are hundreds rules: if multiple routes are possible for a string (typically a URI), a MultipleRoutesDefined TypeError is raised. z-%(string)r matches multiple patterns %(pats)rr) r1valuesrr*lenr5r localsr,r)rr!r candidatespatsmsgs rrJzRouter.resolves"&!6!6!8LAAGGFOaL L"6* * z?Q J7q78DAFHLC', ,!}%%%M8sBBB$c |sy|js[ddjd|jDzdz}tj|tj j |_t|j|S)z{ Return True if `string` is routable by this router, e.g. if it matches any of the route patterns. Nz^(|c3 K|]}|ywr4r$).0rEs r z%Router.is_routable..s'F'Fs z)$)r2joinr1r r UNICODErbool)rr! routabless r is_routablezRouter.is_routablesh    sxx'Ft~~'FFFMI " 9bjj A G GD D%%f-..rr4) rrr"r#rrr9r;r=rHrArJr]r$rrr.r.ks4 !$,%:0 1&4 /rr.) rr functoolsrobjectr TypeErrorr&r*r,r.r$rrrasT6 0*6*D) y I u/Vu/r