'j*MddlmZddlmZddlmZmZmZmZm Z m Z ddl m Z ddl mZddlmZmZddlmZmZddlmZmZmZdd lmZmZdd lmZdd lmZdd l m!Z!dd l"m#Z#ddl$m%Z%ddl&m'Z'ddl(m)Z)GddZ*GddZ+dde,deedefdZ-ddeedefdZ. ddeedefdZ/dS))wraps)Logger)CallableUnionOptionalSequencePatternList) BoltContext) BoltError)ListenerCustomListener)ListenerMatcherCustomListenerMatcher)workflow_step_editworkflow_step_saveworkflow_step_execute)CustomMiddleware Middleware) BoltResponse)_is_used_without_argument)Complete Configure)FailUpdate) WebClientc eZdZUdZeeefed<ee ed<ee ed<ee ed<ee ed< ddeeefdeed ee fd Z dddd d eee d e fefdeee efdeee dfdZdddd d eee d e fefdeee efdeee dfdZdddd d eee d e fefdeee efdeee dfdZdd ee ddfdZ ddedee e ee fd eee d e fefdeee efde f dZe dded eeee d e fefd ee deefdZe ddedeeee efd ee deefdZdS)WorkflowStepBuilderzdSteps from apps Refer to https://docs.slack.dev/legacy/legacy-steps-from-apps/ for details. callback_id _base_logger_edit_save_executeNapp_name base_loggerch||_|pt|_||_d|_d|_d|_dS)a Deprecated: Steps from apps for legacy workflows are now deprecated. Use new custom steps: https://docs.slack.dev/workflows/workflow-steps/ This builder is supposed to be used as decorator. my_step = WorkflowStep.builder("my_step") @my_step.edit def edit_my_step(ack, configure): pass @my_step.save def save_my_step(ack, step, update): pass @my_step.execute def execute_my_step(step, complete, fail): pass app.step(my_step) For further information about WorkflowStep specific function arguments such as `configure`, `update`, `complete`, and `fail`, refer to `slack_bolt.workflows.step.utilities` API documents. Args: callback_id: The callback_id for the workflow app_name: The application name mainly for logging base_logger: The base logger N)r!__name__r&r"r#r$r%)selfr!r&r's _/usr/local/lib/hermes-agent/venv/lib/python3.11/site-packages/slack_bolt/workflows/step/step.py__init__zWorkflowStepBuilder.__init__$s:D' ,H '   )matchers middlewarelazyr..r/r0).Nct|r'|d}d|_|Sfd}|S)a Deprecated: Steps from apps for legacy workflows are now deprecated. Use new custom steps: https://docs.slack.dev/workflows/workflow-steps/ Registers a new edit listener with details. You can use this method as decorator as well. @my_step.edit def edit_my_step(ack, configure): pass It's also possible to add additional listener matchers and/or middleware @my_step.edit(matchers=[is_valid], middleware=[update_context]) def edit_my_step(ack, configure): pass For further information about WorkflowStep specific function arguments such as `configure`, `update`, `complete`, and `fail`, refer to `slack_bolt.workflows.step.utilities` API documents. Args: *args: This method can behave as either decorator or a method matchers: Listener matchers middleware: Listener middleware lazy: Lazy listeners reditcgngz}d|_tfd}|S)Nr2c|i|SNargskwargsfuncs r+_wrapperz:WorkflowStepBuilder.edit.._inner.._wrapper{tT,V,,,r-) _to_listenerr#rr: functionsr;r0r.r/r*s` r+_innerz(WorkflowStepBuilder.edit.._innerwd$*:$$CI**69h SSDJ 4[[ - - - -[ -Or-)rr=r#r*r.r/r0r8r:r@s```` r+r2zWorkflowStepBuilder.editMsqJ %T * * 7D**64:NNDJK         r-ct|r'|d}d|_|Sfd}|S)a  Deprecated: Steps from apps for legacy workflows are now deprecated. Use new custom steps: https://docs.slack.dev/workflows/workflow-steps/ Registers a new save listener with details. You can use this method as decorator as well. @my_step.save def save_my_step(ack, step, update): pass It's also possible to add additional listener matchers and/or middleware @my_step.save(matchers=[is_valid], middleware=[update_context]) def save_my_step(ack, step, update): pass For further information about WorkflowStep specific function arguments such as `configure`, `update`, `complete`, and `fail`, refer to `slack_bolt.workflows.step.utilities` API documents. Args: *args: This method can behave as either decorator or a method matchers: Listener matchers middleware: Listener middleware lazy: Lazy listeners rsavecgngz}d|_tfd}|S)NrDc|i|Sr5r6r7s r+r;z:WorkflowStepBuilder.save.._inner.._wrapperr<r-)r=r$rr>s` r+r@z(WorkflowStepBuilder.save.._innerrAr-)rr=r$rBs```` r+rDzWorkflowStepBuilder.savesqH %T * * 7D**64:NNDJK         r-ct|r'|d}d|_|Sfd}|S)a Deprecated: Steps from apps for legacy workflows are now deprecated. Use new custom steps: https://docs.slack.dev/workflows/workflow-steps/ Registers a new execute listener with details. You can use this method as decorator as well. @my_step.execute def execute_my_step(step, complete, fail): pass It's also possible to add additional listener matchers and/or middleware @my_step.save(matchers=[is_valid], middleware=[update_context]) def execute_my_step(step, complete, fail): pass For further information about WorkflowStep specific function arguments such as `configure`, `update`, `complete`, and `fail`, refer to `slack_bolt.workflows.step.utilities` API documents. Args: *args: This method can behave as either decorator or a method matchers: Listener matchers middleware: Listener middleware lazy: Lazy listeners rexecutecgngz}d|_tfd}|S)NrHc|i|Sr5r6r7s r+r;z=WorkflowStepBuilder.execute.._inner.._wrapperr<r-)r=r%rr>s` r+r@z+WorkflowStepBuilder.execute.._innersd$*:$$CI --iHjYYDM 4[[ - - - -[ -Or-)rr=r%rBs```` r+rHzWorkflowStepBuilder.executesqH %T * * 7D --ixTTDMK         r-return WorkflowStepc|jtd|jtd|jtdt |j|j|j|j|j|S)a Deprecated: Steps from apps for legacy workflows are now deprecated. Use new custom steps: https://docs.slack.dev/workflows/workflow-steps/ Constructs a WorkflowStep object. This method may raise an exception if the builder doesn't have enough configurations to build the object. Returns: WorkflowStep object Nzedit listener is not registeredzsave listener is not registeredz"execute listener is not registered)r!r2rDrHr&r')r#r r$r%rLr!r&)r*r's r+buildzWorkflowStepBuilder.builds} : =>> > : =>> > = @AA A(M]#     r-namelistener_or_functionsc t|j|j||||j||j||j||j|jS)N)r!r&rPrOr.r/r')rLbuild_listenerr!r&to_listener_matchersr"to_listener_middleware)r*rOrPr.r/s r+r=z WorkflowStepBuilder._to_listener sl**(]"7..t}hHYZZ224=*dN_``)+   r-c g}||D]}t|tr||-t|tr&|t |||ht dt ||S)Nr&r:r'zInvalid matcher: ) isinstancerappendrr ValueErrortype)r&r.r' _matchersms r+rSz(WorkflowStepBuilder.to_listener_matcherss    D Da11 D$$Q''''8,, D$$-%-!"(3%%Ba%B%BCCCr-c g}||D]}t|tr||-t|tr&|t |||ht dt ||S)NrVzInvalid middleware: )rWrrXrrrYrZ)r&r/r' _middlewarer\s r+rTz*WorkflowStepBuilder.to_listener_middleware3s   ! G Ga,, G&&q))))8,, G&&(%-!"(3%%EDGG%E%EFFFr-)NNr5)r) __module__ __qualname____doc__rstrr __annotations__rrr r,rboolrrr r2rDrHrNr= staticmethodrSrTr6r-r+r r ssG|$$$$6"""" H  H x    #'(, ''3<('3-'f% ''''XKO<@48 4445#t)!4o!EFG4U8Z#789 4 tHY/01 4444rKO<@48 3335#t)!4o!EFG3U8Z#789 3 tHY/01 3333pKO<@48 3335#t)!4o!EFG3U8Z#789 3 tHY/01 3333j  &!1 ^    DKO<@     %Xxh%GH 5#t)!4o!EFG  U8Z#789       ")-4hsDy&9?&J KLMf% o  \,)-T%*(<"=>?f% j  \r-r ceZdZUeeefed< eed< eed< eed< ddddeeefdeede e fee efdeede e fee efdeede e fee efde ed e e f d Z eddeeefd e e d efd Ze ddeeefded eeeeefdede eede eed e e d efdZe ddedeeefd e e d efdZe ddedeeefd e e d efdZdS)rLr!r2rDrHN)r&r'.r&r'c||_|pt}||||d||_||||d||_||||d||_dS)aC Deprecated: Steps from apps for legacy workflows are now deprecated. Use new custom steps: https://docs.slack.dev/workflows/workflow-steps/ Args: callback_id: The callback_id for this step from app edit: Either a single function or a list of functions for opening a modal in the builder UI When it's a list, the first one is responsible for ack() while the rest are lazy listeners. save: Either a single function or a list of functions for handling modal interactions in the builder UI When it's a list, the first one is responsible for ack() while the rest are lazy listeners. execute: Either a single function or a list of functions for handling step from app executions When it's a list, the first one is responsible for ack() while the rest are lazy listeners. app_name: The app name that can be mainly used for logging base_logger: The logger instance that can be used as a template when creating this step's logger r2)r!r&rPrOr'rDrHN)r!r)rRr2rDrH)r*r!r2rDrHr&r's r+r,zWorkflowStep.__init__Us4''x''#"&# (   ''#"&# (   **#")# +   r-rKc$t||S)z Deprecated: Steps from apps for legacy workflows are now deprecated. Use new custom steps: https://docs.slack.dev/workflows/workflow-steps/ r')r )clsr!r's r+builderzWorkflowStep.builders!# #    r-rPrOr.r/c .|t|d|dt|tr|g}t|tr|St|tr|r|ng}|d|||||r|ng}|d|||||}|d} t|||| ||dk|Std|dt|d |d) Nz$ listener is required (callback_id: )rrirH)r&r.r/ ack_functionlazy_functionsauto_acknowledgementr'zInvalid z listener: z detected (callback_id: ) r rWrr listinsert_build_primary_matcher_build_single_middlewarepoprrZ) rjr!r&rPrOr.r/r'r?rns r+rRzWorkflowStep.build_listeners ! (tWWWWWXX X +X 6 6 <%:$; ! +X 6 6! }( ( -t 4 4 }#+3xxH OO** ++   (29rJ   ,, +-   .I$==++L!!!%)(%)Y%6' {t{{=R8S8S{{mx{{{|| |r-c|dkrt||S|dkrt||S|dkrt||Std|Nr2rirDrHz Invalid name )rrrrYrjrOr!r's r+rsz#WorkflowStep._build_primary_matchersq 6>>%k{KKK K V^^%k{KKK K Y  (+NNN N3T3344 4r-c|dkrt||S|dkrt|S|dkrt|Std|rw)_build_edit_listener_middleware_build_save_listener_middleware"_build_execute_listener_middlewarerYrxs r+rtz%WorkflowStep._build_single_middlewaresm 6>>2;KXXX X V^^2{KKK K Y  5+NNN N3T3344 4r-r5)NNN)r)r_r`rrbr rcr rrrrrr, classmethodr rkr rrrRrsrtr6r-r+rLrLKssG|$$$$. NNNE NNN_ E#'(,0 0 0 3<(0 HS(<"8898XhEWWX 0 HS(<"8898XhEWWX 0 xXl%; ;.edit_listener_middlewares4 )#     tvv r-rVr rdictrrrr))r!r'rs` r+rzrzsq    r<'(        %   r-c dtdtdtdtgtffd}t t ||S)Nrrrrc>t|||d<|S)Nrrupdaterrrrrs r+save_listener_middlewarezA_build_save_listener_middleware..save_listener_middlewares0 #   tvv r-rVr)r'rs r+r{r{sf    r<'(      %   r-c dtdtdtdtgtffd}t t ||S)Nrrrrcft|||d<t|||d<|S)Nrcompletefail)rrrs r+execute_listener_middlewarezG_build_execute_listener_middleware..execute_listener_middleware#sP '       tvv r-rVr)r'rs r+r|r| sfr<'(   (   r-r5)0 functoolsrloggingrtypingrrrrr r slack_bolt.context.contextr slack_bolt.errorr slack_bolt.listenerr rslack_bolt.listener_matcherrr$slack_bolt.listener_matcher.builtinsrrrslack_bolt.middlewarerrslack_bolt.responser#slack_bolt.workflows.step.internalsr,slack_bolt.workflows.step.utilities.completer-slack_bolt.workflows.step.utilities.configurer(slack_bolt.workflows.step.utilities.failr*slack_bolt.workflows.step.utilities.updater slack_sdk.webrr rLrbrzr{r|r6r-r+rsvEEEEEEEEEEEEEEEE222222&&&&&&88888888NNNNNNNN ?>>>>>>>,,,,,,IIIIIIAAAAAACCCCCC999999======######ooooooood Z5Z5Z5Z5Z5Z5Z5Z5D8FCS_i4&1AZ4%)&!r-