B ›³ëb4hã@sŽdZddlZddlZddlZddlZddlZddlZddlZddlZddl Zddl Zddl Zddl Zddl mZmZmZmZddlmZddlmZddlZddlZddlZddlZddlZddlZGdd„deƒZej ej¡a da!iZ"da#d d „Z$d d „Z%Gd d„dƒZ&gZ'dd„Z(dZ)d$dd„Z*dd„Z+ej,fdd„Z-dd„Z.Gdd„dej/j0ƒZ1e1ej/_/dd„Z2da3dd„Z4Gd d!„d!ƒZ5d"d#„Z6dS)%z@This module defines the Python API provided to SConscript files.éN)Úis_ListÚ is_StringÚis_DictÚflatten)ÚSConscriptNodesé)ÚMainc@s eZdZdS)ÚSConscriptReturnN)Ú__name__Ú __module__Ú __qualname__©r r ú6lib/python3.7/site-packages/SCons/Script/SConscript.pyr 1sr cCsZy ddWn$tk r0t ¡djj}YnXx|j d¡tkrL|j}q4W|j|jfS)zjReturn the locals and globals for the function that called into this module in the current call stack.rrér ) ÚZeroDivisionErrorÚsysÚexc_infoÚtb_frameÚf_backÚ f_globalsÚgetr Úf_locals)Úframer r rÚget_calling_namespaces>s   rc Csžtƒ\}}i}yXxR|D]J}t|ƒr.| |¡qy||||<Wqtk r^||||<YqXqWWn2tk r˜}ztj d|¡‚Wdd}~XYnX|S)zCompute a dictionary of exports given one of the parameters to the Export() function or the exports argument to SConscript().z$Export of non-existent variable '%s'N)rrÚupdateÚKeyErrorÚSConsÚErrorsÚ UserError)ÚexportsZlocZglobÚretvalZexportÚxr r rÚcompute_exportsTs   "r"c@seZdZdZdd„ZdS)ÚFramez/A frame on the SConstruct/SConscript call stackcCs\tƒ|_d|_| ¡|_t|ƒ|_t|tj j ƒr8||_ n |dkrHd|_ n|  t |ƒ¡|_ dS)Nú-) ÚBuildDefaultGlobalsÚglobalsr ÚgetcwdÚprev_dirr"rÚ isinstancerÚNodeÚ sconscriptÚFileÚstr)ÚselfÚfsrr+r r rÚ__init__ks  zFrame.__init__N)r r r Ú__doc__r0r r r rr#isr#c Osºg}y@t|ƒ}x2|D]*}x$| ¡D]}| tdj|¡q"WqWWn2tk rv}ztj d|¡‚Wdd}~XYnXt |ƒdkr”|dtd_ nt |ƒtd_ |  dd¡}|r¶t ‚dS)Néÿÿÿÿz$Return of non-existent variable '%s'rrÚstopT)rÚsplitÚappendÚ call_stackr&rrrrÚlenr Útuplerr )ÚvarsÚkwr ZfvarsÚvarÚvr!r3r r rÚReturn}s  "  r=z% Stack boTTom %cCs†|stjjr,|dk r,d| ¡}tj |¡‚|dkr‚tjjrdd| ¡}tj tjj |¡dtj_nd| ¡}tj tjj |¡dS)a†Take appropriate action on missing file in SConscript() call. Print a warning or raise an exception on missing file, unless missing is explicitly allowed by the *must_exist* value. On first warning, print a deprecation message. Args: f (str): path of missing configuration file must_exist (bool): if true, fail. If false, but not ``None``, allow the file to be missing. The default is ``None``, which means issue the warning. The default is deprecated. Raises: UserError: if *must_exist* is true or if global :data:`SCons.Script._no_missing_sconscript` is true. FzFatal: missing SConscript '%s'NzŠCalling missing SConscript without error is deprecated. Transition by adding must_exist=False to SConscript calls. Missing SConscript '%s'z Ignoring missing SConscript '%s') rÚScriptZ_no_missing_sconscriptZget_internal_pathrrZ#_warn_missing_sconscript_deprecatedÚWarningsÚwarnZMissingSConscriptWarning)ÚfÚ must_existÚmsgr r rÚhandle_missing_SConscript”s     rDcOsø|j}|j ¡}| dg¡}g}x²|D]¨}t t|||ƒ¡tj}zÈt j j dt j _ |dkr|t tj  ¡tdjƒn’t|t jjƒr|} n| t|ƒ¡} d} t | ¡|j|dd|  ¡rÚ|  ¡} t|  ¡dƒ} nf|  ¡ ¡r|  ¡ ¡} t|  ¡dƒ} n<|  ¡r@|  ¡|  ¡|  d¡|   ¡r@t|  ¡dƒ} | rüy |d} Wn(t!k rz| "| j# $|¡¡} Yn,X| "| ¡} |  %| j#¡s¦| "| j# $|¡¡} y|j| t&dWn4t'k rì|j| ddt( | j# ¡¡YnX| j# ¡gtjt_tdj )t*di¡tdj d ¡}ytdjd =Wnt!k rLYnXz^yBt+j,rbt- .¡}|  ¡}| j/}|  0¡t t1||d ƒtdjƒWnt2k r¨YnXWdt+j,rÚt- .¡|}t3d |  ¡|d fƒ|dk røtdj )t4|i¡Xnt5| | d d¡ƒWdt j j dt j _ |t_t 6¡}y|j|j7t&dWn~t'k rÂ|j|j7dd|j7 ¡}| 8¡yt( | ¡¡Wn2t'k r¼}zt j9j:r¬|‚Wdd}~XYnXYnX| |j;¡Xq(Wt<|ƒdkrì|dSt=|ƒSdS)Nrrr$r2)Z change_os_dirÚrbÚsrc_dirrÚ__file__ÚexeczSConscript:%s took %0.3f msg@@rB)>ZTopZSConstruct_dirÚrdirrr6r5r#rÚpathrr>Úsconscript_readingrHÚstdinÚreadr&r)r*r,r-rÚaddÚchdirZrexistsZrfileÚopenÚ get_abspathZsrcnodeZhas_src_builderZbuildZbuiltZ builder_setÚexistsrÚDirÚdirÚget_pathÚis_underÚsconscript_chdirÚOSErrorÚosrÚ stack_bottomrZ print_timeÚtimeZ perf_counterÚnameÚcloseÚcompiler ÚprintrGrDÚpopr(Z_createZActionZexecute_actionsr r7r8)r/Úfilesr:ÚtopZsdrZresultsÚfnZ old_sys_pathrAZ_file_ZactualrFZldirZold_fileZ start_timeZ scriptdataZ scriptnameÚelapsedrrIÚer r rÚ _SConscript·s¦                rfc CsÐt ¡\}}}|}x|r,t|jjkr,|j}qW|s6|}t |¡}y |j}Wn8t k r‚t |ƒ}|dd…dkr~|dd…}YnX|  d||f¡x4|D],\}}} } |  d||f¡|  d| ¡qœWdS)zöPrint an exception stack trace just for the SConscript file(s). This will show users who have Python errors where the problem is, without cluttering the output with all of the internal calls leading up to where we exec the SConscript.Né z exceptions.z%s: %s: z File "%s", line %d: z %s ) rrrZrrÚtb_nextÚ tracebackÚ extract_tbr ÚAttributeErrorr-Úwrite) ÚfileÚexc_typeÚ exc_valueZexc_tbÚtbÚstackÚtypeÚfnameÚlineÚfuncÚtextr r rÚSConscript_exceptionOs"   rwcCsLt ¡d}x|r&t|jjkr&|j}qW|s8tj d¡‚t   |¡d|_ dS)zhAnnotate a node with the stack frame describing the SConscript file and line number that created it.rz%could not find SConscript stack framerN) rrrZrrrhrrZ InternalErrorriÚ extract_stackZcreator)Znoderpr r rÚannotatehs    ryc@s–eZdZdZdd„Zdd„Zdd„Zdd „Zd d „Zd%d d„Z dd„Z d&dd„Z dd„Z dd„Z dd„Zd'dd„Zdd„Zdd„Zd d!„Zd"d#„Zd$S)(ÚSConsEnvironmenta9An Environment subclass that contains all of the methods that are particular to the wrapper SCons interface and which aren't (or shouldn't be) part of the build engine itself. Note that not all of the methods of this class have corresponding global functions, there are some private methods. cCs||kp||ko||kS)zqReturn 1 if 'major' and 'minor' are greater than the version in 'v_major' and 'v_minor', and 0 otherwise.r )r.ÚmajorÚminorÚv_majorÚv_minorr r rÚ_exceeds_version„sz!SConsEnvironment._exceeds_versioncCsl| d¡d d¡}t|dƒ}tt d|d¡ ¡ƒ}t|ƒdkr^tt d|d¡ ¡ƒ}nd}|||fS)zµSplit a version string into major, minor and (optionally) revision parts. This is complicated by the fact that a version string can be something like 3.2b1.ú rÚ.z\d+rér)r4ÚintÚreÚmatchÚgroupr7)r.Zversion_stringÚversionr}r~Z v_revisionr r rÚ_get_major_minor_revision‰s  z*SConsEnvironment._get_major_minor_revisionc sög}t|ƒdkrzy |d}Wn tk r<tj d¡‚YnXt|ƒsL|g}ttt|ƒƒ}|  dd¡‰‡fdd„|Dƒ}nFt|ƒdkr|d}n0t|ƒd kr´|d}|  |d¡}n tj d ¡‚t|ƒsÎ|g}|  d ¡rì|  |  |d ¡¡|  d ¡}|rît|ƒdkrtj d ¡‚|  dd¡}|  d¡}|s`t j  t|dƒ¡\}} t j  t|ƒ| ¡g}n~t|tjjƒs||j |¡}|d} t| tjjƒs |j | ¡} |  |¡rÌ|  |¡} t j  t|ƒ| ¡g}n |  ¡g}||d<|j |||¡||fS)a$ Convert the parameters passed to SConscript() calls into a list of files and export variables. If the parameters are invalid, throws SCons.Errors.UserError. Returns a tuple (l, e) where l is a list of SConscript filenames and e is a list of exports. rÚdirsz(Invalid SConscript usage - no parametersr\Ú SConscriptcsg|]}tj |ˆ¡‘qSr )rYrJÚjoin)Ú.0Ún)r\r rú ­sz>SConsEnvironment._get_SConscript_filenames..rrz/Invalid SConscript() usage - too many argumentsrÚ variant_dirzOInvalid SConscript() usage - can only specify one SConscript with a variant_dirÚ duplicaterF)r7rrrrrÚlistÚmapr-rÚSplitÚextendrYrJr4r‹r)r*r/rSr,rVrUrQZ VariantDir) r.Úlsr:rr‰rarrrFrsrcr )r\rÚ_get_SConscript_filenames˜sT                 z*SConsEnvironment._get_SConscript_filenamescOs>tjjstj d¡‚| dd¡d|d<tjjj|f|ž|ŽS)Nz1Calling Configure from Builders is not supported.Ú_depthrr) rr>rKrrrÚ EnvironmentÚBaseÚ Configure)r.Úargsr:r r rršâs zSConsEnvironment.ConfigurecGstj ||¡dS)N)rr>Z_Set_Default_Targets)r.Ztargetsr r rÚDefaultèszSConsEnvironment.DefaultrcCsztjdkr tj tjjd¡dS| tj¡}||||fkrv|rNd|||f}n d||f}td|tjfƒt d¡dS)z8Exit abnormally if the SCons version is not late enough.Z __VERSION__z5EnsureSConsVersion is ignored for development versionNz%d.%d.%dz%d.%dz3SCons %s or greater required, but you have SCons %sr) rÚ __version__r?r@ZDevelopmentVersionWarningrˆr_rÚexit)r.r{r|ZrevisionZ scons_verZscons_ver_stringr r rÚEnsureSConsVersionës    z#SConsEnvironment.EnsureSConsVersioncCs<tj||fkr8tj ¡d}td|||fƒt d¡dS)z9Exit abnormally if the Python version is not late enough.rz8Python %d.%d or greater required, but you have Python %srN)rÚ version_infor‡r4r_rž)r.r{r|r<r r rÚEnsurePythonVersionüsz$SConsEnvironment.EnsurePythonVersioncCst |¡dS)N)rrž)r.Úvaluer r rÚExitszSConsEnvironment.ExitcOs0x |D]}t t| |¡ƒ¡qWt |¡dS)N)Úglobal_exportsrr"r“)r.r9r:r;r r rÚExports zSConsEnvironment.ExportcCstS)N)Ú launch_dir)r.r r rÚ GetLaunchDir szSConsEnvironment.GetLaunchDircCs| |¡}tjj |¡S)N)Úsubstrr>rÚ GetOption)r.r\r r rr©s zSConsEnvironment.GetOptionFcCs"|j|dd}tjj||ddS)Nr)Úraw)r5)r¨rr>Z HelpFunction)r.rvr5r r rÚHelpszSConsEnvironment.Helpc Gs¶y~td}|j}|j}xd|D]\}| |¡}xL|D]D}|dkrR| t¡| |¡q0||krh||||<q0t|||<q0WqWWn2tk r°}ztj  d|¡‚Wdd}~XYnXdS)Nr2Ú*z$Import of non-existent variable '%s') r6r&rr“rr¤rrrr)r.r9rr&rr;r<r!r r rÚImports     zSConsEnvironment.Importc sšˆjfdd„}tt||ƒƒ}i}xN| ¡D]B\}}t|ƒrFˆ |¡}ntj |¡rd‡fdd„|Dƒ}|||<q*Wˆ ||¡\}}||d<t ˆj f|ž|ŽS)aûExecute SCons configuration files. Parameters: *ls (str or list): configuration file(s) to execute. Keyword arguments: dirs (list): execute SConscript in each listed directory. name (str): execute script 'name' (used only with 'dirs'). exports (list or dict): locally export variables the called script(s) can import. variant_dir (str): mirror sources needed for the build in a variant directory to allow building in it. duplicate (bool): physically duplicate sources instead of just adjusting paths of derived files (used only with 'variant_dir') (default is True). must_exist (bool): fail if a requested script is missing (default is False, default is deprecated). Returns: list of variables returned by the called script Raises: UserError: a script is not found and such exceptions are enabled. cSs(tj |¡rtt||ƒƒ}n||ƒ}|S)N)rÚUtilrr‘r’)r!r¨r r rÚ subst_elementDs z2SConsEnvironment.SConscript..subst_elementcs"g|]}t|ƒrˆ |¡n|‘qSr )rr¨)rŒr<)r.r rrŽPsz/SConsEnvironment.SConscript..r) r¨r‘r’Úitemsrrr®rr–rfr/) r.r•r:r¯Zsubst_kwÚkeyÚvalrarr )r.rrŠ*s   zSConsEnvironment.SConscriptcCs|adS)N)rW)r.Úflagr r rÚSConscriptChdirWsz SConsEnvironment.SConscriptChdircCs| |¡}tjj ||¡dS)N)r¨rr>rÚ SetOption)r.r\r¢r r rrµ[s zSConsEnvironment.SetOptionN)r)r)F)r r r r1rrˆr–ršrœrŸr¡r£r¥r§r©r«r­rŠr´rµr r r rrzxs"J   -rzcOs*tjjstj d¡‚d|d<tjj||ŽS)Nz1Calling Configure from Builders is not supported.rr—)rr>rKrrZSConf)r›r:r r rršds ršcCststj ¡}tj |¡atS)N)Ú_DefaultEnvironmentProxyrÚDefaultsÚDefaultEnvironmentr˜ZNoSubstitutionProxy)Z default_envr r rÚget_DefaultEnvironmentProxy{s  r¹c@s"eZdZdZddd„Zdd„ZdS) ÚDefaultEnvironmentCallaöA class that implements "global function" calls of Environment methods by fetching the specified method from the DefaultEnvironment's class. Note that this uses an intermediate proxy class instead of calling the DefaultEnvironment method directly so that the proxy can override the subst() method and thereby prevent expansion of construction variables (since from the user's point of view this was called as a global function, with no associated construction environment).rcCs ||_|rtjj|_nt|_dS)N)Ú method_namerr·r¸Úfactoryr¹)r.r»r¨r r rr0‹s zDefaultEnvironmentCall.__init__cOs| ¡}t||jƒ}|||ŽS)N)r¼Úgetattrr»)r.r›r:ÚenvÚmethodr r rÚ__call__‘s zDefaultEnvironmentCall.__call__N)r)r r r r1r0rÀr r r rrº‚s rºcCs^tdkrViaddl}|jj}|t|jƒfdd„}x$t|t|jƒƒD]}||t|<qBWt ¡S)zi Create a dictionary containing all the default globals for SConstruct and SConscript files. NrcSst|||ƒ S)N)r))ÚmÚdZmtyper r rÚ not_a_module£sz)BuildDefaultGlobals..not_a_module)Ú GlobalDictZ SCons.Scriptr>Ú__dict__rrÚfilterrTÚcopy)rrÂrÃrÁr r rr%—sr%)N)7r1rZ SCons.ActionZ SCons.BuilderZSCons.DefaultsZSCons.EnvironmentZ SCons.ErrorsZ SCons.NodeZSCons.Node.AliasZ SCons.Node.FSZSCons.PlatformZ SCons.SConfZ SCons.ToolZ SCons.UtilrrrrrÚrrYÚos.pathr„rrir[Ú Exceptionr rJÚabspathÚcurdirr¦rÄr¤rWrr"r#r6r=rZrDrfÚstderrrwryr˜r™rzršr¶r¹rºr%r r r rÚsZ   #k