tf=ddlZddlmZddlmZddlmZddlZddl m Z m Z ddl m Z ejdgd Zd Zd Zd Zejd GddeZdZdZdZdZdZejddGddeZejd GddeZejddGddeZeZdZGdd eZ dS)!Nwraps)count)getfullargspec) Transitioner Automaton) preserveNameArgSpecargsvarargsvarkwdefaults kwonlyargskwonlydefaults annotationsc ft|}tt|j|j|j|jr|jndt|j|jr&t|j ndt|j S)z Normalize inspect.ArgSpec across python versions and convert mutable attributes to immutable types. :param Callable func: A function. :return: The function's ArgSpec. :rtype: ArgSpec r ) getArgsSpecr tupler rrrrritemsr)funcspecs R/var/www/surfInsights/venv3-11/lib/python3.11/site-packages/automat/_methodical.py _getArgSpecrs t  D  49   j"&-7R))" +E$%++-- . . .(*$*002233    czt|j|jz|jrdndz|jrdndz|jzS)a0 Get the name of all arguments defined in a function signature. The name of * and ** arguments is normalized to "*args" and "**kwargs". :param ArgSpec spec: A function to interrogate for a signature. :return: The set of all argument names in `func`s signature. :rtype: Set[str] )z*argsr)z**kwargs)setr rrrr)rs r _getArgNamesr ,sZ  /  -::2 /!J .==B 0      rc<tfd}|S)a Decorate a function so all its arguments must be passed by keyword. A useful utility for decorators that take arguments so that they don't accidentally get passed the thing they're decorating as their first argument. Only works for methods right now. c|fi|SNr)selfkwfs rgz_keywords_only..gIsq}}}}rr)r&r's` r_keywords_onlyr(?s3 1XXX HrT)frozenceZdZdZejdZejZejdZdde fdZ dZ dS)MethodicalStatez- A state for a L{MethodicalMachine}. FreprNc ||}|g}t|j}|D]}t|j}||s^td|jj|jjt|jt|j|j |||||dS)ac Declare a state transition within the :class:`automat.MethodicalMachine` associated with this :class:`automat.MethodicalState`: upon the receipt of the `input`, enter the `state`, emitting each output in `outputs`. :param MethodicalInput input: The input triggering a state transition. :param MethodicalState enter: The resulting state. :param Iterable[MethodicalOutput] outputs: The outputs to be triggered as a result of the declared state transition. :param Callable collector: The function to be used when collecting output return values. :raises TypeError: if any of the `outputs` signatures do not match the `inputs` signature. :raises ValueError: if the state transition from `self` via `input` has already been defined. Nzdmethod {input} signature {inputSignature} does not match output {output} signature {outputSignature})inputoutputinputSignatureoutputSignature) r argSpecissubset TypeErrorformatmethod__name__rmachine_oneTransition)r$r/enteroutputs collector inputArgsr0 outputArgss ruponzMethodicalState.uponXs& =E ?G //   F%fn55J&&y11 228&#l3%}5'25<'@'@(3FM(B(B 3933  ##D%KKKKKrc|jjSr#r7r8r$s r_namezMethodicalState._name~ {##r) r8 __module__ __qualname____doc__attribr9r7 serializedlistr@rDrrrr+r+Osdg5!!!G TWYYFe$$$J $dd$L$L$L$LL$$$$$rr+cxt||d}|&t||j}t||||S)z Get a L{Transitioner} N)getattrr initialStatesetattr)oselfsymbol automaton transitioners r_transitionerFromInstancerUsM5&$//L#   "   v|,,, rcdSr#rrrr_emptyrWsDrcdS) docstringNrrrr _docstringrZsrc|jjtjjtjjfvrt ddS)Nzfunction body must be empty)__code__co_coderWrZ ValueError)inst attributer&s r assertNoCoderasD z&/"9","5"="???6777??rc tt|jdd|}jr|}nfd|D}t| |D] \}} ||fz t|jddd|jddd} fd|D} | |jr| } n7jddjz fd| D} || fS)a Filter out arguments that were passed to input that output won't accept. :param tuple args: The *args that input received. :param dict kwargs: The **kwargs that input received. :param ArgSpec inputSpec: The input's arg spec. :param ArgSpec outputSpec: The output's arg spec. :return: The args and kwargs that output will accept. :rtype: Tuple[tuple, dict] rNc,g|]\}}|jv|Sr)r ).0nv outputSpecs r z_filterArgs..s)HHHTQ1 3G3Gq3G3G3Grc$i|] \}}|v || Srr)rdrerfpassed_arg_namess r z_filterArgs..s*JJJDAq9I0I0I1a0I0I0Irc$i|] \}}|v || Srr)rdrerfall_accepted_namess rrlz_filterArgs..s4555$!Q!333A333r) rzipr rrupdaterrr) r kwargs inputSpecrg named_args return_argsnamevaluer full_kwargs return_kwargsrnrks ` @@r _filterArgsrysOs9>!""-t4455JI IHHHZHHH V}}!** eT5M)9>$$B$');DDbD)ABBHJJJJHJJJKv5# (_QRR0:3HH5555+*;*;*=*=555   %%rF)eqhashc eZdZdZejdZejeZejdZ ejej e dZ ejddZ e jdZd d Zd ZdS) MethodicalInputz. An input for a L{MethodicalMachine}. Fr,) validator)defaultr-initr-c*t|jSr#rr7rCs r _buildArgSpeczMethodicalInput._buildArgSpec4;'''rNctjjtjt jfd}|S)z Return a function that takes no arguments and returns values returned by output functions produced by the given L{MethodicalInput} in C{oself}'s current state. c` j g|Ri| j}  \}} j|}g}|D]a}|r||t || j|j\}} | g|Ri| } || b||Sr#)r7_state transition collectorsrDryr3append)r rq previousStater< outTracerr=valuesr0akrvrQr$rTs rdoInputz(MethodicalInput.__get__..doInputs DK / / / / / / /(/M#/#:#:4#@#@ Wi 6IF! % %.Ifllnn---"4v~NN1u.q...A.. e$$$$9V$$ $r)rUrRrSr r7r)r$rQtyperrTs`` @r__get__zMethodicalInput.__get__sw 1 15AA dk " " t{   % % % % % %   # " %rc|jjSr#rBrCs rrDzMethodicalInput._namerErr#)r8rFrGrHrIrJrSrar7rRFactorydictrr3rrrrDrrrr}r}sU###I TW| , , ,F TW% Fd!3!3%@@@Jdg5u---G _((_(2$$$$$rr}ceZdZdZejdZejZejddZej dZ d dZ dZ d Z dS) MethodicalOutputz/ An output for a L{MethodicalMachine}. Fr,rc*t|jSr#rrCs rrzMethodicalOutput._buildArgSpecrrNchtd|j|jj)zX Outputs are private, so raise an exception when we attempt to get one. zf{cls}.{method} is a state-machine output method; to produce this output, call an input method instead.)clsr7)AttributeErrorr6r8r7r$rQrs rrzMethodicalOutput.__get__sA DDJFM{+EKEE   rc$|j|g|Ri|S)z- Call the underlying method. )r7)r$rQr rqs r__call__zMethodicalOutput.__call__s&t{5242226222rc|jjSr#rBrCs rrDzMethodicalOutput._namerErr#)r8rFrGrHrIrJr9r7r3rrrrrDrrrrrsdg5!!!G TWYYFdg5u---G _((_(     333 $$$$$rrcZeZdZejdZejdZddZdS)MethodicalTracerFr,NcHt||j|jfd}|S)Nc2|dSr#)setTrace)tracerrTs rrz*MethodicalTracer.__get__..setTrace's  ! !& ) ) ) ) )r)rUrRrS)r$rQrrrTs @rrzMethodicalTracer.__get__$s=0 15AA  * * * * *rr#)r8rFrGrIrJrSrRrrrrrrsPU###I TW% FrrcJdtttzS)z, Create a unique Python identifier. _symbol_)strnextcounterrrrgensymr.s DMM** **rceZdZdZdZddZe ddZedZedZ d Z ed Z ed Z e d Zd ZdS)MethodicalMachinezj A :class:`MethodicalMachine` is an interface to an `Automaton` that uses methods on a class. c`t|_i|_t|_dSr#)r _automaton _reducersr_symbolrCs r__init__zMethodicalMachine.__init__<s##++xx rNc(|td|S)z L{MethodicalMachine} is an implementation detail for setting up class-level state; applications should never need to access it on an instance. Nz.MethodicalMachine is an implementation detail.)rrs rrzMethodicalMachine.__get__Bs'   @BB B rFcfd}|S)a Declare a state, possibly an initial state or a terminal state. This is a decorator for methods, but it will modify the method so as not to be callable any more. :param bool initial: is this state the initial state? Only one state on this :class:`automat.MethodicalMachine` may be an initial state; more than one is an error. :param bool terminal: Is this state a terminal state? i.e. a state that the machine can end up in? (This is purely informational at this point.) :param Hashable serialized: a serializable value to be used to represent this state to external systems. This value should be hashable; :py:func:`unicode` is a good type to use. cHt|}r |j_|S)N)r9r7rK)r+rrO) stateMethodstateinitialr$rKs r decoratorz*MethodicalMachine.state..decoratords8#D+6/9;;;E 5/4,Lrr)r$rterminalrKrs`` ` rrzMethodicalMachine.stateNs0,       rcfd}|S)zM Declare an input. This is a decorator for methods. c<tj|jS)N)rSr7rR)r}rr) inputMethodr$s rrz*MethodicalMachine.input..decoratorus&"T_*5*.,888 8rrr$rs` rr/zMethodicalMachine.inputns$ 8 8 8 8 8rcfd}|S)z Declare an output. This is a decorator for methods. This method will be called when the state machine transitions to this state as specified in the decorated `output` method. c&t|S)N)r9r7)r) outputMethodr$s rrz+MethodicalMachine.output..decorators#DFFF Frrrs` rr0zMethodicalMachine.output|s' G G G G Grcn|j|||t|||j|<dS)z. See L{MethodicalState.upon}. N)r addTransitionrr)r$ startState inputTokenendState outputTokensr=s rr:z MethodicalMachine._oneTransitionsB& %%j*h&+L&9&9 ; ; ;,5 j)))rcfd}|S) c@tfd}|S)Ncft|jj}||jjSr#)rUrrrrK)rQrT decorateer$s r serializezBMethodicalMachine.serializer..decorator..serializes78 9= J J  y (;(FGGGrr)rrr$s` rrz/MethodicalMachine.serializer..decoratorsC 9   H H H H H  H rrrs` r serializerzMethodicalMachine.serializers$      rcfd}|S)rc@tfd}|S)Nc|g|Ri|}i}jD] }|||j< t|jj}|||_dSr#)rstatesrKrUrr) rQr rqrmapping eachStaterTrr$s r unserializezFMethodicalMachine.unserializer..decorator..unserializes! %9$999&99!%!7!7!9!9>>I4=GI01184< : : &-en #trr)rrr$s` rrz1MethodicalMachine.unserializer..decorators= 9          rrrs` r unserializerzMethodicalMachine.unserializers$     rc6t|j|jSr#)rrrrCs r _setTracezMethodicalMachine._setTraces>>>rc<ddlm}||jdddS)a Generate a L{graphviz.Digraph} that represents this machine's states and transitions. @return: L{graphviz.Digraph} object; for more information, please see the documentation for U{graphviz} r) makeDigraphc|jjSr#rB)rs rz-MethodicalMachine.asDigraph..  (=rc|jjSr#rB)r/s rrz-MethodicalMachine.asDigraph..rrc|jjSr#rB)r0s rrz-MethodicalMachine.asDigraph..s &-*@r) stateAsString inputAsStringoutputAsString) _visualizerr)r$rs r asDigraphzMethodicalMachine.asDigraphsF ,+++++{ O====@@     rr#)FFN)r8rFrGrHrrr(rr/r0r:rrpropertyrrrrrrr6s        ,1^>  ^   ^ 6660  ^ ^$??X?     rr)! collections functoolsr itertoolsrinspectrrrI_corerr _introspectionr namedtupler rr r(sobjectr+rUrWrZraryr}rrrrrrrrrs111111 ********(((((( !+ -N-N-N O O 0&    t/$/$/$/$/$f/$/$/$d      888"%&%&%&P5u($($($($($f($($($Vt $ $ $ $ $v $ $ $D5u     v    %''+++b b b b b b b b b b r