o Th"@sddlmZmZmZmZmZmZmZddlm Z ddl m Z ddl m Z ddlmZmZer@ddlmZddlmZdd l mZGd d d Zd S) ) TYPE_CHECKINGAnyDictListOptionalTupleUnion)Config) ParserContext)debug)CallTask) Collection)Result) ParseResultc @seZdZdZ  ddddeddedd dfd d Zd eeeee ee ffe fd e d fddZ d eeeeee ee ffe fdfd e dfddZde dd e dfddZde dd e dfddZdS)Executorz An execution strategy for Task objects. Subclasses may override various extension points to change, add or remove behavior. .. versionadded:: 1.0 N collectionrconfigr corerreturncCs$||_|dur |nt|_||_dS)a  Initialize executor with handles to necessary data structures. :param collection: A `.Collection` used to look up requested tasks (and their default config data, if any) by name during execution. :param config: An optional `.Config` holding configuration state. Defaults to an empty `.Config` if not given. :param core: An optional `.ParseResult` holding parsed core program arguments. Defaults to ``None``. N)rr rr)selfrrrrB/var/www/html/venv/lib/python3.10/site-packages/invoke/executor.py__init__s zExecutor.__init__tasks)rrcGstddd|D||}td|t|}||}z|jjj}Wn ty3d}Ynw|r;||n|}i}|D]G}||voI|j }td||j} |j |j } | | | td|| } | g|jR} |j| i|j} |rt| | ||j<qA|S)a Execute one or more ``tasks`` in sequence. :param tasks: An all-purpose iterable of "tasks to execute", each member of which may take one of the following forms: **A string** naming a task from the Executor's `.Collection`. This name may contain dotted syntax appropriate for calling namespaced tasks, e.g. ``subcollection.taskname``. Such tasks are executed without arguments. **A two-tuple** whose first element is a task name string (as above) and whose second element is a dict suitable for use as ``**kwargs`` when calling the named task. E.g.:: [ ('task1', {}), ('task2', {'arg1': 'val1'}), ... ] is equivalent, roughly, to:: task1() task2(arg1='val1') **A `.ParserContext`** instance, whose ``.name`` attribute is used as the task name and whose ``.as_kwargs`` attribute is used as the task kwargs (again following the above specifications). .. note:: When called without any arguments at all (i.e. when ``*tasks`` is empty), the default task from ``self.collection`` is used instead, if defined. :returns: A dict mapping task objects to their return values. This dict may include pre- and post-tasks if any were executed. For example, in a collection with a ``build`` task depending on another task named ``setup``, executing ``build`` will result in a dict with two keys, one for ``build`` and one for ``setup``. .. versionadded:: 1.0 zExamining top level tasks {!r}cSsg|]}|qSrr).0xrrr csz$Executor.execute..z#Tasks (now Calls) with kwargs: {!r}TzExecuting {!r}z/Finished loading collection & shell env configs)r format normalizelist expand_callsrrdedupeAttributeError autoprintr configuration called_asload_collectionload_shell_env make_contextargstaskkwargsprint)rrcallsdirectexpandedr#resultscallr%rcollection_configcontextr+resultrrrexecute1s62      zExecutor.execute.r cCsg}|D]+}t|tr|}i}nt|tr|j}|j}n|\}}t|j|||d}||q|sB|jjdurBt|j|jjg}|S)z Transform arbitrary task list w/ various types, into `.Call` objects. See docstring for `~.Executor.execute` for details. .. versionadded:: 1.0 )r-r'N) isinstancestrr name as_kwargsr rappenddefault)rrr/r,r:r-crrrr s    zExecutor.normalizer/cCsJg}td|D]}||vrtd|||qtd|q|S)z Deduplicate a list of `tasks <.Call>`. :param calls: An iterable of `.Call` objects representing tasks. :returns: A list of `.Call` objects. .. versionadded:: 1.0 zDeduplicating tasks...z{!r}: no duplicates found, okz%{!r}: found in list already, skipping)r rr<)rr/dedupedr3rrrr#s  zExecutor.dedupecCs`g}|D])}t|trt|}td||||j|||||j q|S)a Expand a list of `.Call` objects into a near-final list of same. The default implementation of this method simply adds a task's pre/post-task list before/after the task itself, as necessary. Subclasses may wish to do other things in addition (or instead of) the above, such as multiplying the `calls <.Call>` by argument vectors or similar. .. versionadded:: 1.0 zExpanding task-call {!r}) r8rr r rextendr"prer<post)rr/retr3rrrr"s   zExecutor.expand_calls)NN)__name__ __module__ __qualname____doc__rrrr9rrrr r7rr r#r"rrrrrs6   c  rN)typingrrrrrrrrr parserr utilr rr rrrrunnersrrrrrrrs$