B bU@sdZddlZddlZddlZddlZddlmZddlZddlm Z GdddZ Gdddej Z Gd d d Z d d Zd dZddZeedZddZddZeedZGdddeedZiZddZddZdaGdddejjZdd ZGd!d"d"eedZdS)#z?Execute actions with specific lists of target and source Nodes.N) NoSlotsPyPy)logInstanceCreationc@s"eZdZdZdZggfddZdS)BatchzHRemembers exact association between targets and sources of executor.)targetssourcescCs||_||_dS)N)rr)selfrrr-lib/python3.7/site-packages/SCons/Executor.py__init__*szBatch.__init__N)__name__ __module__ __qualname____doc__ __slots__r rrrr r#src@s8eZdZdZddZddZddZdd Zd d Zd S) TSListaA class that implements $TARGETS or $SOURCES expansions by wrapping an executor Method. This class is used in the Executor.lvars() to delay creation of NodeList objects until they're needed. Note that we subclass collections.UserList purely so that the is_Sequence() function will identify an object of this class as a list during variable expansion. We're not really using any collections.UserList methods in practice. cCs ||_dS)N)func)rrrrr r :szTSList.__init__cCs|}t||S)N)rgetattr)rattrnlrrr __getattr__<szTSList.__getattr__cCs|}||S)N)r)rirrrr __getitem__?szTSList.__getitem__cCs|}t|S)N)rstr)rrrrr __str__BszTSList.__str__cCs|}t|S)N)rrepr)rrrrr __repr__EszTSList.__repr__N) r r r rr rrrrrrrr r0s  rc@s0eZdZdZddZddZddZdd Zd S) TSObjectz^A class that implements $TARGET or $SOURCE expansions by wrapping an Executor method. cCs ||_dS)N)r)rrrrr r MszTSObject.__init__cCs|}t||S)N)rr)rrnrrr rOszTSObject.__getattr__cCs|}|rt|SdS)N)rr)rrrrr rRszTSObject.__str__cCs|}|rt|SdS)Nr)rr)rrrrr rWszTSObject.__repr__N)r r r rr rrrrrrr rIs rcCs*y |j}Wntk r|SX|SdS)z A function to return the results of a Node's rfile() method, if it exists, and the Node itself otherwise (if it's a Value Node, e.g.). N)rfileAttributeError)noderrrr r]s  rcCsdS)Nrr)objtargetkwrrr execute_nothingksr%cCs|}||}d}xf|D]Z}gg|f}|||}t|tjjrR||_|q |r d|}tjj||jdj ||dq W|S)z!Actually execute the action list.rzError %s)Zerrstrr!executoraction) get_build_envget_kwget_action_list isinstanceSConsErrorsZ BuildErrorr&batchesr)r"r#r$envZstatusactargsmsgrrr execute_action_listns"     r3)rcs&dfddDS)N cs"g|]}|qSr)Z genstringget_all_targetsget_all_sources).0r')r/r"rr sz'execute_actions_str..)r(joinr*)r"r)r/r"r execute_actions_strsr;cCsdS)Nrr)r"rrr execute_null_strsr<c@seZdZdZdZdigggifddZddZdd Zd d Zd d Z ddZ ddZ ddZ ddZ ddZddZddZddZddZd d!Zd"d#Zd$d%Zd&d'Zd(d)Zejjd*d+Zd,d-Zifd.d/Zd0d1Zd2d3Zd4d5Z d6d7Z!d8d9Z"d:d;Z#dd?Z%d@dAZ&dBdCZ'ejjdDdEZ(dFdGZ)dHdIZ*dJdKZ+dLdMZ,dUdOdPZ-ej.e-dVdQdRZ/dSdTZ0dS)WExecutorzA class for controlling instances of executing an action. This largely exists to hold a single association of an action, environment, list of environment override dictionaries, targets and sources for later processing as needed. ) pre_actions post_actionsr/ overridelistr. builder_kw_memolvars_changed_sources_list_changed_targets_list_unchanged_sources_list_unchanged_targets_list action_list _do_execute _execute_strNcCs~tjjrt|d||g|_g|_||_||_|s<|r\t |dd|ddg|_ ng|_ ||_ d|_ d|_ i|_dS)NzExecutor.Executorr4)r,Debugtrack_instancesrset_action_listr>r?r/r@rr.rArIrJrB)rr'r/r@rrrArrr r s   zExecutor.__init__c Csjy|jStk rdt|jt|jt|jt|jt|jt|j t|j t|j d|_|jSXdS)N)ZCHANGED_SOURCESZCHANGED_TARGETSZSOURCEZSOURCESZTARGETZTARGETSZUNCHANGED_SOURCESZUNCHANGED_TARGETS) rCr r_get_changed_sources_get_changed_targetsr _get_source _get_sources _get_target _get_targets_get_unchanged_sources_get_unchanged_targets)rrrr get_lvarsszExecutor.get_lvarscCsg}g}g}g}xn|jD]d}|jdjsZ|jdrZ|ttt|j||jq|ttt|j||jqWt j ||_ t j ||_ t j ||_t j ||_dS)Nr)r.rZ always_buildZ is_up_to_dateextendlistmaprrr,UtilNodeListrDrErFrG)rZcsZctusutbrrr _get_changess zExecutor._get_changescOs*y|jStk r$||jSXdS)N)rDr r_)rr1r$rrr rNs zExecutor._get_changed_sourcescOs*y|jStk r$||jSXdS)N)rEr r_)rr1r$rrr rOs zExecutor._get_changed_targetscOst|jdjdS)Nr)rr.rget_subst_proxy)rr1r$rrr rPszExecutor._get_sourcecOstjdd|DS)NcSsg|]}t|qSr)rr`)r8rrrr r9sz)Executor._get_sources..)r,rZr[r7)rr1r$rrr rQszExecutor._get_sourcescOs|jdjdS)Nr)r.rr`)rr1r$rrr rRszExecutor._get_targetcOstjdd|DS)NcSsg|] }|qSr)r`)r8rrrr r9sz)Executor._get_targets..)r,rZr[r6)rr1r$rrr rSszExecutor._get_targetscOs*y|jStk r$||jSXdS)N)rFr r_)rr1r$rrr rTs zExecutor._get_unchanged_sourcescOs*y|jStk r$||jSXdS)N)rGr r_)rr1r$rrr rUs zExecutor._get_unchanged_targetscCsB|js gS|jd|j|}|ddkr6|dd}||S)Nr$r4)rHZ get_targetsr/rV)rZtargets_stringrrr get_action_targetss   zExecutor.get_action_targetscCs,tj|s"|stjd|g}||_dS)NzExecutor must have an action.)r,rZZis_Listr-Z UserErrorrH)rr'rrr rMs   zExecutor.set_action_listcCs |jdkrgS|j|j|jS)N)rHr>r?)rrrr r*s zExecutor.get_action_listcCs$g}x|jD]}||jq W|S)z5Returns all targets for all batches of this Executor.)r.rWr)rresultbatchrrr r6s zExecutor.get_all_targetscCs$g}x|jD]}||jq W|S)z5Returns all sources for all batches of this Executor.)r.rWr)rrcrdrrr r7#s zExecutor.get_all_sourcescCs0tjg}x|D]}||qW|S)aReturns all unique children (dependencies) for all batches of this Executor. The Taskmaster can recognize when it's already evaluated a Node, so we don't have to make this list unique for its intended canonical use case, but we expect there to be a lot of redundancy (long lists of batched .cc files #including the same .h files over and over), so removing the duplicates once up front should save the Taskmaster a lot of work. )r,rZ UniqueListr6rWchildren)rrcr#rrr get_all_children*s zExecutor.get_all_childrencCs8tjg}x&|D]}|jdk r||jqW|S)z`Returns all unique (order-only) prerequisites for all batches of this Executor. N)r,rZrer6Z prerequisitesrW)rrcr#rrr get_all_prerequisites:s   zExecutor.get_all_prerequisitescCs.tjg}x|D]}||jqW|S)ziReturns all side effects for all batches of this Executor used by the underlying Action. )r,rZrerbrWZ side_effects)rrcr#rrr get_action_side_effectsDs z Executor.get_action_side_effectscCsny |jdStk rYnXi}x|jD]}||q,Wddl}|jpT|j}||}||jd<|S)zUFetch or create the appropriate build Environment for this Executor. r(rN) rBKeyErrorr@updateZSCons.Defaultsr/ZDefaultsZDefaultEnvironmentZOverride)rZ overridesZodictr,r/ build_envrrr r(Ns    zExecutor.get_build_envc CsT|}y|jdjdj}Wnttfk r:d}YnX|||||S)zHFetch the scanner path for this executor's targets and sources. rN) r(r.rcwd IndexErrorr pathr6r7)rscannerr/rmrrr get_build_scanner_pathis zExecutor.get_build_scanner_pathcCs |j}||||d<|S)Nr&)rAcopyrk)rr$rcrrr r)us  zExecutor.get_kwcKst|j|||S)N)_do_execute_maprI)rr#r$rrr __call__szExecutor.__call__cCs i|_dS)N)rB)rrrr cleanupszExecutor.cleanupcs:tjdkstfdd|D}jdj|dS)zAdd source files to this Executor's list. This is necessary for "multi" Builders that can be called repeatedly to build up a source file list for a given target.r4cs g|]}|jdjkr|qS)r)r.r)r8x)rrr r9sz(Executor.add_sources..rN)lenr.AssertionErrorrrW)rrr)rr add_sourcesszExecutor.add_sourcescCs |jdjS)Nr)r.r)rrrr get_sourcesszExecutor.get_sourcescCs|jt||dS)aoAdd pair of associated target and source to this Executor's list. This is necessary for "batch" Builders that can be called repeatedly to build up a list of matching target and source files that will be used in order to update multiple target files at once from multiple corresponding source files, for tools like MSVC that support it.N)r.appendr)rrrrrr add_batchszExecutor.add_batchcCsBx<|D]0}|r d}tj|||jdjdfq WdS)zs Preparatory checks for whether this Executor can go ahead and (try to) build its targets. z-Source `%s' not found, needed by target `%s'.rN)r7Zmissingr,r-Z StopErrorr.r)rsr2rrr prepareszExecutor.preparecCs|j|dS)N)r>r{)rr'rrr add_pre_actionszExecutor.add_pre_actioncCs|j|dS)N)r?r{)rr'rrr add_post_actionszExecutor.add_post_actioncCst|j|S)N)_execute_str_maprJ)rrrr rszExecutor.__str__cCs|d|_d|_dS)Nr)rurIrJ)rrrr nullifyszExecutor.nullifycspy |jdStk rYnX||}||tddfdd|D}||jd<|S)zFetch the signature contents. This is the main reason this class exists, so we can compute this once and cache it regardless of how many target or source Nodes there are. Returns bytes get_contentsrzutf-8csg|]}|qSr)r)r8r') all_sources all_targetsr/rr r9sz)Executor.get_contents..)rBrjr(r*r6r7 bytearrayr:)rrHrcr)rrr/r rs   zExecutor.get_contentscCsdS)zFetch a time stamp for this Executor. We don't have one, of course (only files do), but this is the interface used by the timestamp module. rr)rrrr get_timestampszExecutor.get_timestampcCs|||dS)N)scanr6)rrprrr scan_targetsszExecutor.scan_targetscCs |jdjr|||dS)Nr)r.rrr7)rrprrr scan_sourcess zExecutor.scan_sourcesc Cst|}|j}|}g}x*|D]"}|||||||q W||x|D]}||q^WdS)aScan a list of this Executor's files (targets or sources) for implicit dependencies and update all of the targets with them. This essentially short-circuits an N*M scan of the sources for each individual target, which is a hell of a lot more efficient. N)r(rqr)Z disambiguaterWget_implicit_depsr6Zadd_to_implicit) rrpZ node_listr/ror$depsr!Ztgtrrr rs z Executor.scanrcCs|ft|S)N)tuple)rr!ignorerrr _get_unignored_sources_keysz#Executor._get_unignored_sources_keycs|ft|}y|jd}Wn"tk r>i}||jd<Yn Xy||Stk r\YnX|rg}x*|jD]}||jkrn|j}PqnWn|}|rix|D] }d|<qWfdd|D}|||<|S)Nget_unignored_sourcesr4csg|]}|kr|qSrr)r8r})idictrr r9sz2Executor.get_unignored_sources..)rrBrjr.rrr7)rr!rkeyZ memo_dictZ sourcelistr^rr)rr rs0    zExecutor.get_unignored_sourcescCsBg}|}x0|D]$}||||}||qW|S)zcReturn the executor's implicit dependencies, i.e. the nodes of the commands to be executed.)r(r*rr6r7rW)rrcrlr0rrrr rs zExecutor.get_implicit_deps)r)r)1r r r rrr rVr_rNrOrPrQrRrSrTrUrbrMr*r6r7rgrhrir,ZMemoizeZCountMethodCallr(rqr)rtruryrzr|r~rrrrrrrrrrZ CountDictCallrrrrrr r=sX        !r=) metaclasscCst|S)N)_batch_executors)rrrr GetBatchExecutor)srcCs|tks t|t|<dS)N)rrx)rr&rrr AddBatchExecutor,s rc@s,eZdZddlZdZejdZddZdS)NullEnvironmentrNcCs|jS)N) _CacheDir)rrrr get_CacheDir7szNullEnvironment.get_CacheDir) r r r ZSCons.CacheDirr,Z_CacheDir_pathZCacheDirrrrrrr r3s rcCstdkrtatS)z,Use singleton pattern for Null Environments.N)nullenvrrrrr get_NullEnvironment;src@seZdZdZdZddZddZddZd d Zd d Z d dZ ddZ ddZ ddZ ddZddZddZddZddZdd Zd!d"Zd#d$Zd%d&Zd'd(Zd)S)*Nulla,A null Executor, with a null build Environment, that does nothing when the rest of the methods call it. This might be able to disappear when we refactor things to disassociate Builders from Nodes entirely, so we're not going to worry about unit tests for this--at least for now. )r>r?r/r@r.rArBrCrDrErFrGrHrIrJcOs0tjjrt|dt|dddgg|_dS)Nz Executor.Nullr)r,rKrLrrr.)rr1r$rrr r \s z Null.__init__cCstS)N)r)rrrr r(`szNull.get_build_envcCsdS)Nr)rrrr rqbszNull.get_build_scanner_pathcCsdS)Nr)rrrr rudsz Null.cleanupcCsdS)Nr)rrrr r~fsz Null.preparecOstdS)Nr)r)rr1r$rrr rhszNull.get_unignored_sourcescCsgS)Nr)rrrr rbjszNull.get_action_targetscCsgS)Nr)rrrr r*lszNull.get_action_listcCs |jdjS)Nr)r.r)rrrr r6nszNull.get_all_targetscCs|jdjdjS)Nr)r.rr)rrrr r7pszNull.get_all_sourcescCs|jdjdS)Nr)r.rrf)rrrr rgrszNull.get_all_childrencCsgS)Nr)rrrr rhtszNull.get_all_prerequisitescCsgS)Nr)rrrr rivszNull.get_action_side_effectscOsdS)Nrr)rr1r$rrr rtxsz Null.__call__cCsdS)Nrr)rrrr rzszNull.get_contentscCs |j}t|_|g||_dS)z3Morph this Null executor to a real Executor object.N)r.r= __class__r )rr.rrr _morph|s z Null._morphcCs|||dS)N)rr)rr'rrr rszNull.add_pre_actioncCs|||dS)N)rr)rr'rrr rszNull.add_post_actioncCs|||dS)N)rrM)rr'rrr rMszNull.set_action_listN)r r r rrr r(rqrur~rrbr*r6r7rgrhrirtrrrrrMrrrr rCs* r)r collectionsZ SCons.Errorsr,Z SCons.MemoizeZ SCons.UtilZ SCons.compatrZ SCons.DebugrrUserListrrrr%r3rsr;r<robjectr=rrrrrZrrrrrrr s<