U [e:> @snddlZddlmZddlmZzddlmZWn ek rPddlm ZYnXddl Z ddl Z ddl m Z mZddlmZed d d d d dddgZddZddZddZe jddGdddeZddZddZdd Zd!d"Zd#d$Ze jd%d%d&Gd'd(d(eZe jddGd)d*d*eZe jd%d%d&Gd+d,d,eZ eZ!d-d.Z"Gd/d0d0eZ#dS)1Nwraps)count)getfullargspec) getargspec) Transitioner Automaton) preserveNameArgSpecargsvarargsvarkwdefaults kwonlyargskwonlydefaults annotationsc Cst|}tt|j|jtjr"|jn|j|j r2|j ndtjrDt|j ndtjrd|j r`t|j qfdndtjrzt|j nddS)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 r rrrrr) getArgsSpecr tupler r sixPY3rkeywordsrrritemsr)funcspecrrU/var/www/html/services/stratfitenv/lib/python3.8/site-packages/automat/_methodical.py _getArgSpecs rcCs2t|j|j|jrdnd|jr$dnd|jS)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 rr rr)rrrr _getArgNames2s   rcstfdd}|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. cs |f|SNr)selfkwfrrgOsz_keywords_only..gr)r$r%rr#r_keywords_onlyEs r&T)frozenc@sDeZdZdZejddZeZejddZe fddZ ddZ dS) MethodicalStatez- A state for a L{MethodicalMachine}. FreprcCsjt|j}|D]B}t|j}||stdj|jj|jjt|jt|jdq|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. zdmethod {input} signature {inputSignature} does not match output {output} signature {outputSignature})inputoutputZinputSignatureZoutputSignatureN) rargSpecissubset TypeErrorformatmethod__name__rmachine_oneTransition)r!r+Zenteroutputs collectorZ inputArgsr,Z outputArgsrrrupon^s    zMethodicalState.uponcCs|jjSr r1r2r!rrr_nameszMethodicalState._nameN) r2 __module__ __qualname____doc__attribr3r1 serializedlistr7r:rrrrr(Us    "r(cCs0t||d}|dkr,t||j}t||||S)z Get a L{Transitioner} N)getattrr initialStatesetattr)oselfsymbol automaton transitionerrrr_transitionerFromInstances  rIcCsdSr rrrrr_emptysrJcCsdS)Z docstringNrrrrr _docstringsrKcCs$|jjtjjtjjfkr tddS)Nzfunction body must be empty)__code__co_coderJrK ValueError)inst attributer$rrr assertNoCodes rQc stt|jdd|}jr$|}nfdd|D}t||D]\}}||f7qBt|jddd|jddd}fdd|D} | |jr| } n*jddjfdd| 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] rNcsg|]\}}|jkr|qSr)r .0nv) outputSpecrr s z_filterArgs..csi|]\}}|kr||qSrrrR)passed_arg_namesrr sz_filterArgs..csi|]\}}|kr||qSrrrR)all_accepted_namesrrrZs) rzipr r rupdaterrr) r kwargsZ inputSpecrVZ named_argsZ return_argsnamevaluerZ full_kwargsZ return_kwargsr)r[rVrYr _filterArgss  " raF)eqhashc@sveZdZdZejddZejedZejddZ eje e ddZ ejdddZ e jddZdd d Zd d Zd S)MethodicalInputz. An input for a L{MethodicalMachine}. Fr)) validator)defaultr*initr*cCs t|jSr rr1r9rrr _buildArgSpecszMethodicalInput._buildArgSpecNcs8tjjtjtjfdd}|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 sjf||j}\}}j|}g}|D]D}|rL||t||j|j\}} |f|| } || q8||Sr )r1_stateZ transition collectorsr:rar-append) r r^Z previousStater5Z outTracerr6valuesr,akr`rEr!rHrrdoInputs   z(MethodicalInput.__get__..doInput)rIrFrGr r1r)r!rEtyperrrrqr__get__s zMethodicalInput.__get__cCs|jjSr r8r9rrrr:szMethodicalInput._name)N)r2r;r<r=r>r?rGrQr1rFFactorydictrlr-rfrjrtr:rrrrrds     rdc@sZeZdZdZejddZeZejdddZej ddZ ddd Z d d Z d d Z dS)MethodicalOutputz/ An output for a L{MethodicalMachine}. Fr)rgcCs t|jSr rir9rrrrjszMethodicalOutput._buildArgSpecNcCstdj|j|jjddS)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.)clsr1N)AttributeErrorr0r2r1r!rErsrrrrt s zMethodicalOutput.__get__cOs|j|f||S)z- Call the underlying method. )r1)r!rEr r^rrr__call__szMethodicalOutput.__call__cCs|jjSr r8r9rrrr:szMethodicalOutput._name)N)r2r;r<r=r>r?r3r1r-rfrjrtr{r:rrrrrws   rwc@s.eZdZejddZejddZdddZdS)MethodicalTracerFr)Ncs t||j|jfdd}|S)Ncs|dSr )setTrace)ZtracerrHrrr})sz*MethodicalTracer.__get__..setTrace)rIrFrG)r!rErsr}rr~rrt&s  zMethodicalTracer.__get__)N)r2r;r<r>r?rGrFrtrrrrr| s  r|cCsdtttS)z, Create a unique Python identifier. Z_symbol_)strnextcounterrrrrgensym0src@s|eZdZdZddZdddZeddd Zed d Zed d Z ddZ eddZ eddZ e ddZddZdS)MethodicalMachinezj A :class:`MethodicalMachine` is an interface to an `Automaton` that uses methods on a class. cCst|_i|_t|_dSr )r _automatonZ _reducersr_symbolr9rrr__init__>szMethodicalMachine.__init__NcCs|dk rtd|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.)ryrzrrrrtDs zMethodicalMachine.__get__Fcsfdd}|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. cst|d}r|j_|S)N)r3r1r@)r(rrC)Z stateMethodstateinitialr!r@rr decoratorfsz*MethodicalMachine.state..decoratorr)r!rZterminalr@rrrrrPszMethodicalMachine.statecsfdd}|S)zM Declare an input. This is a decorator for methods. cstj|jdS)N)rGr1rF)rdrr)Z inputMethodr9rrrwsz*MethodicalMachine.input..decoratorrr!rrr9rr+ps zMethodicalMachine.inputcsfdd}|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. cs t|dS)N)r3r1)rw)Z outputMethodr9rrrsz+MethodicalMachine.output..decoratorrrrr9rr,~s zMethodicalMachine.outputcCs$|j|||t|||j|<dS)z. See L{MethodicalState.upon}. N)rZ addTransitionrrl)r!Z startStateZ inputTokenZendStateZ outputTokensr6rrrr4s z MethodicalMachine._oneTransitioncsfdd}|S) cstfdd}|S)Ncst|jj}||jjSr )rIrrrkr@)rErH decorateer!rr serializeszBMethodicalMachine.serializer..decorator..serializer)rrr9rrrsz/MethodicalMachine.serializer..decoratorrrrr9r serializers zMethodicalMachine.serializercsfdd}|S)rcstfdd}|S)NcsL|f||}i}jD]}|||j<qt|jj}|||_dSr )rZstatesr@rIrrk)rEr r^rmappingZ eachStaterHrrr unserializes  zFMethodicalMachine.unserializer..decorator..unserializer)rrr9rrrs z1MethodicalMachine.unserializer..decoratorrrrr9r unserializers zMethodicalMachine.unserializercCst|j|jSr )r|rrr9rrr _setTraceszMethodicalMachine._setTracecCs*ddlm}||jdddddddS)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) makeDigraphcSs|jjSr r8)rrrrz-MethodicalMachine.asDigraph..cSs|jjSr r8)r+rrrrrcSs|jjSr r8)r,rrrrr)Z stateAsStringZ inputAsStringZoutputAsString)Z _visualizerr)r!rrrr asDigraphs zMethodicalMachine.asDigraph)N)FFN)r2r;r<r=rrtr&rr+r,r4rrpropertyrrrrrrr8s&       r)$ collections functoolsr itertoolsrinspectrr ImportErrorrr>rZ_corerr Z_introspectionr namedtupler rrr&sobjectr(rIrJrKrQrardrwr|rrrrrrrsF     .( + "