tf5 &ddlZddlmZmZddlmZddlmZmZdZ de fdZ eGdd e Z eddee d eed eefd Zeddee d eed eefd Zede fdZdS)N)OptionalUnion)public)RegisterOptionsSubscribeOptions)Patternregister subscribeerrorconvert_starred_uriurict|tksJ|d}|dkrd}n7|dkr|ddkr d}|dd}nd}|dd }||fS) a Convert a starred URI to a standard WAMP URI and a detected matching policy. A starred URI is one that may contain the character '*' used to mark URI wildcard components or URI prefixes. Starred URIs are more comfortable / intuitive to use at the user/API level, but need to be converted for use on the wire (WAMP protocol level). This function takes a possibly starred URI, detects the matching policy implied by stars, and returns a pair (uri, match) with any stars removed from the URI and the detected matching policy. An URI like 'com.example.topic1' (without any stars in it) is detected as an exact-matching URI. An URI like 'com.example.*' (with exactly one star at the very end) is detected as a prefix-matching URI on 'com.example.'. An URI like 'com.*.foobar.*' (with more than one star anywhere) is detected as a wildcard-matching URI on 'com..foobar.' (in this example, there are two wildcard URI components). Note that an URI like 'com.example.*' is always detected as a prefix-matching URI 'com.example.'. You cannot express a wildcard-matching URI 'com.example.' using the starred URI notation! A wildcard matching on 'com.example.' is different from prefix-matching on 'com.example.' (which matches a strict superset of the former!). This is one reason we don't use starred URIs for WAMP at the protocol level. *rexactprefixNwildcard)typestrcountreplace)r cnt_starsmatchs P/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/autobahn/wamp/uri.pyr r +s: 99     #IA~~ aCGsNN#2#hkk#r"" :c eZdZdZdZdZdZdZdZdZ e j dZ e j dZ e j dZ dd ed ed eeeefd eefd ZeedZeedZedZdZedZedZedZdS)rz A WAMP URI Pattern. .. todo:: * suffix matches * args + kwargs * uuid converter * multiple URI patterns per decorated object * classes: Pattern, EndpointPattern, .. rz^[a-z0-9][a-z0-9_\-]*$z^<([a-z][a-z0-9_]*)>$z^<([a-z][a-z0-9_]*):([a-z]*)>$Nr targetoptions check_typesct|tksJt|dksJ|tjtjtjfvsJ|tjkr|t|tksJn/|tjkr|t|tksJnd}| d}d}g}i}d} tt|D]} || } tj | } | r| \} }|dvrtd|dkr%| t|dz krtd| |vrtd|d vr t|| <n |d kr t|| <ntd |d | || dz } tj | } | rg| d} | |vrtdt|| <|d | || dz } ztj | } | r|| | d kr9| dz } |d|t|| <td|rMtj|_dd|zdz}t/j||_||_ntj|_d|_d|_||_||_||_||_dS)a :param uri: The URI or URI pattern, e.g. ``"com.myapp.product..update"``. :type uri: str :param target: The target for this pattern: a procedure endpoint (a callable), an event handler (a callable) or an exception (a class). :type target: callable or obj :param options: An optional options object :type options: None or RegisterOptions or SubscribeOptions :param check_types: Enable automatic type checking against (Python 3.5+) type hints specified on the ``endpoint`` callable. Types are checked at run-time on each invocation of the ``endpoint`` callable. When a type mismatch occurs, the error is forwarded to the callee code in ``onUserError`` override method of :class:`autobahn.wamp.protocol.ApplicationSession`. An error of type :class:`autobahn.wamp.exception.TypeCheckError` is also raised and returned to the caller (via the router). :type check_types: bool rN.z [^\s\.#]+)rstringintsuffixz invalid URIr(r)rr&r(r'z logic errorz (?P<{}>{})rz({})^z\.$) rrlenrURI_TARGET_ENDPOINTURI_TARGET_HANDLERURI_TARGET_EXCEPTIONrrsplitrange_URI_NAMED_CONVERTED_COMPONENTrgroups TypeErrorr'appendformat_URI_NAMED_COMPONENT_URI_COMPONENTURI_TYPE_WILDCARD_typejoinrecompile_pattern_namesURI_TYPE_EXACT_uri_target_options _check_types)selfr r!r"r# components_URI_COMP_CHARSplnc group_counti componentrname comp_typeps r__init__zPattern.__init__sy0S S    C1 76"5"799999 W0 0 0OtG}}'G'G'G'G w1 1 1OtG}}8H'H'H'H'HGYYs^^ &  s:''1 +1 +A"1 I:@@KKE "',,..i$FFF#M222((Q#j//A2E-E-E#M2222::#M222 ;;;"BtHH%''"BtHH$M222 ,--dODDEEEq 066yAAE ||~~a(2::#M2224 ,--dODDEEEq *00;;E  )$$$Bq  '..99:::"%;M** *  2DJejjnn$s*AJqMMDMDKK!/DJ DMDK   'rc|jS)z Returns the Options instance (if present) for this pattern. :return: None or the Options instance :rtype: None or RegisterOptions or SubscribeOptions )rBrDs rr"zPattern.optionss }rc|jS)z Returns the URI type of this pattern :return: :rtype: Pattern.URI_TYPE_EXACT, Pattern.URI_TYPE_PREFIX or Pattern.URI_TYPE_WILDCARD )r9rQs ruri_typezPattern.uri_types zrc|jS)z Returns the original URI (pattern) for this pattern. :returns: The URI (pattern), e.g. ``"com.myapp.product..update"``. :rtype: str )r@rQs rr z Pattern.uri s yrc<g}i}|jtjkr||fS|jtjkri|j|}|r>|jD]2}||}|j||}|||<3||fStddS)a- Match the given (fully qualified) URI according to this pattern and return extracted args and kwargs. :param uri: The URI to match, e.g. ``"com.myapp.product.123456.update"``. :type uri: str :returns: A tuple ``(args, kwargs)`` :rtype: tuple zno matchN) r9rr?r8r=rr>group ValueError)rDr argskwargsrkeyvals rrz Pattern.matchs :/ / /<  Z74 4 4M'',,E -;&&C++c**C*$+c*3//C"%F3KKV|# ,,,5 4rc,|jtjkS)z Check if this pattern is for a procedure endpoint. :returns: ``True``, iff this pattern is for a procedure endpoint. :rtype: bool )rArr,rQs r is_endpointzPattern.is_endpoint/s|w:::rc,|jtjkS)z Check if this pattern is for an event handler. :returns: ``True``, iff this pattern is for an event handler. :rtype: bool )rArr-rQs r is_handlerzPattern.is_handler9s|w999rc,|jtjkS)z Check if this pattern is for an exception. :returns: ``True``, iff this pattern is for an exception. :rtype: bool )rArr.rQs r is_exceptionzPattern.is_exceptionCs|w;;;rNN) __name__ __module__ __qualname____doc__r,r-r.r?URI_TYPE_PREFIXr8r;r<r7r6r1rr'rrrrboolrOrpropertyr"rSr rr]r_rarrrrZs  NORZ 9::N&2:&>??&0RZ0Q%R%R"mq/3n(n(Cn(n(xFVXgFg@h7in(&tnn(n(n(n(`  X V  X V  V---4 ;; V; :: V: << V<<.decoratebsz{{ ;{{1:..HHHq+&& AK 78W-H'S^__```rrjr r"r#rrs``` rr r Ns/(        Orcfd}|S)a Decorator for WAMP event handlers. :param uri: :type uri: str :param options: :type options: None or SubscribeOptions :param check_types: Enable automatic type checking against (Python 3.5+) type hints specified on the ``endpoint`` callable. Types are checked at run-time on each invocation of the ``endpoint`` callable. When a type mismatch occurs, the error is forwarded to the callee code in ``onUserError`` override method of :class:`autobahn.wamp.protocol.ApplicationSession`. An error of type :class:`autobahn.wamp.exception.TypeCheckError` is also raised and returned to the caller (via the router). :type check_types: bool ct|sJt|dsg|_|jt tj|SNrm)rnrormr4rr-)rpr#r"r s rrrzsubscribe..decoratesZ{{q+&& AK 73(BG[YYZZZrrjrss``` rr r os/( Orcfd}|S)z+ Decorator for WAMP error classes. ct|tsJt|dsg|_|jt t j|Srv) issubclass Exceptionrormr4rr.)clsr s rrrzerror..decoratesZ#y))***sK(( CM WS'*FGGHHH rrj)r rrs` rr r s#  Orrb)r;typingrr autobahn.utilrautobahn.wamp.typesrr__all__rr objectrrhr r r rjrrrs{8 """""""" AAAAAAAA ,S,,,,^p<p<p<p<p