B bi@sdZddlZddlZddlmZmZddlZddlm Z m Z ej j ej j ej j gZeefaddZddZGd d d ZGd d d Zd dZGdddejZddZGdddZGdddejZGdddZGdddej jZeZ ddZ!dddd hZ"Gd!d"d"Z#Gd#d$d$ejZ$dZ%d%Z&d&Z'e(d'Z)e(d(Z*e)de*gZ+d)d*Z,d+d,Z-e,de-gZ.d-Z/e(d.e/Z0e(d/e/Z1e(d0Z2e&ddiidfd1d2Z3e&ddiidfd3d4Z4d5d6Z5dS)7zSCons string substitution.N) signature Parameter) is_String is_SequencecGsdd|DadS)NcSsg|] }|r|qSr).0Z_frr*lib/python3.7/site-packages/SCons/Subst.py -sz*SetAllowableExceptions..)AllowableExceptions)ZexceptsrrrSetAllowableExceptions+sr cCs>|jj}d|||f}|r.tj|d|n tj|dS)Nz%s `%s' trying to evaluate `%s'r) __class____name__SConsErrorsZ BuildError UserError)Z exceptiontargetsnamemsgrrrraise_exception0s rc@sPeZdZdZddZddZddZdd Zd d Zd d Z ddZ ddZ dS)LiteralzA wrapper for a string. If you use this object wrapped around a string, then it will be interpreted as literal. When passed to the command interpreter, all special characters will be escaped.cCs ||_dS)N)lstr)selfrrrr__init__>szLiteral.__init__cCs|jS)N)r)rrrr__str__AszLiteral.__str__cCs ||jS)N)r)r escape_funcrrrescapeDszLiteral.escapecCs|jS)N)r)rrrr for_signatureGszLiteral.for_signaturecCsdS)Nr)rrrr is_literalJszLiteral.is_literalcCst|tsdS|j|jkS)NF) isinstancerr)rotherrrr__eq__Ms zLiteral.__eq__cCs || S)N)r")rr!rrr__neq__RszLiteral.__neq__cCs t|jS)N)hashr)rrrr__hash__UszLiteral.__hash__N) r __module__ __qualname____doc__rrrrrr"r#r%rrrrr9src@s:eZdZdZd ddZddZddZd d Zd d ZdS)SpecialAttrWrapperaThis is a wrapper for what we call a 'Node special attribute.' This is any of the attributes of a Node that we can reference from Environment variable substitution, such as $TARGET.abspath or $SOURCES[1].filebase. We implement the same methods as Literal so we can handle special characters, plus a for_signature method, such that we can return some canonical string during signature calculation to avoid unnecessary rebuilds.NcCs||_|r||_n||_dS)zThe for_signature parameter, if supplied, will be the canonical string we return from for_signature(). Else we will simply return lstr.N)rforsig)rrrrrrraszSpecialAttrWrapper.__init__cCs|jS)N)r)rrrrrkszSpecialAttrWrapper.__str__cCs ||jS)N)r)rrrrrrnszSpecialAttrWrapper.escapecCs|jS)N)r*)rrrrrqsz SpecialAttrWrapper.for_signaturecCsdS)Nrr)rrrrrtszSpecialAttrWrapper.is_literal)N) r r&r'r(rrrrrrrrrr)Xs  r)cCs$d|ksd|krd|St|SdS)z\Generic function for putting double quotes around any string that has white space in it.  z"%s"N)str)argrrr quote_spaceswsr/cs6eZdZdZd fdd ZddZefddZZS) CmdStringHoldera6This is a special class used to hold strings generated by scons_subst() and scons_subst_list(). It defines a special method escape(). When passed a function with an escape algorithm for a particular platform, it will return the contained string with the proper escape sequences inserted. Ncst|||_dS)N)superrliteral)rcmdr2)r rrrs zCmdStringHolder.__init__cCs|jS)N)r2)rrrrrszCmdStringHolder.is_literalcCs:|r||jSd|jks&d|jkr0||jS|jSdS)aOEscape the string with the supplied function. The function is expected to take an arbitrary string, then return it with all special characters escaped and ready for passing to the command interpreter. After calling this function, the next call to str() will return the escaped string. r+r,N)rdata)rrZ quote_funcrrrrs   zCmdStringHolder.escape)N) r r&r'r(rrr/r __classcell__rr)r rr0sr0cCs|fdd}tt||S)z|Escape a list of arguments by running the specified escape_func on every object in the list that has an escape() method.cSs,y |j}Wntk r|SX||SdS)N)rAttributeError)objrerrrrs  zescape_list..escape)listmap)mylistrrrrr escape_lists r<c@s,eZdZdZddZddZddZeZdS) NLWrappera9A wrapper class that delays turning a list of sources or targets into a NodeList until it's needed. The specified function supplied when the object is initialized is responsible for turning raw nodes into proxies that implement the special attributes like .abspath, .source, etc. This way, we avoid creating those proxies just "in case" someone is going to use $TARGET or the like, and only go through the trouble if we really have to. In practice, this might be a wash performance-wise, but it's a little cleaner conceptually... cCs||_||_dS)N)r9func)rr9r>rrrrszNLWrapper.__init__cCs|jS)N)nodelist)rrrr_return_nodelistszNLWrapper._return_nodelistcCsJ|j}|dkrg}nt|s"|g}tjtt|j||_|j|_ |jS)N) r9rrUtilZNodeListr:r>r?r@_create_nodelist)rr;rrr _gen_nodelistszNLWrapper._gen_nodelistN)r r&r'r(rr@rCrBrrrrr=s   r=c@s8eZdZdZddZddZddZdd Zd d Zd S) Targets_or_SourcesaA class that implements $TARGETS or $SOURCES expansions by in turn wrapping a NLWrapper. This class handles the different methods used to access the list, calling the NLWrapper to create proxies on demand. 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)nl)rrErrrrszTargets_or_Sources.__init__cCs|j}t||S)N)rErBgetattr)rattrrErrr __getattr__s zTargets_or_Sources.__getattr__cCs|j}||S)N)rErB)rirErrr __getitem__s zTargets_or_Sources.__getitem__cCs|j}t|S)N)rErBr-)rrErrrrs zTargets_or_Sources.__str__cCs|j}t|S)N)rErBrepr)rrErrr__repr__s zTargets_or_Sources.__repr__N) r r&r'r(rrHrJrrLrrrrrDs  rDc@s0eZdZdZddZddZddZdd Zd S) Target_or_SourcezA class that implements $TARGET or $SOURCE expansions by in turn wrapping a NLWrapper. This class handles the different methods used to access an individual proxy Node, calling the NLWrapper to create a proxy on demand. cCs ||_dS)N)rE)rrErrrrszTarget_or_Source.__init__cCsB|j}y |d}Wn tk r6td|YnXt||S)NrzNodeList has no attribute: %s)rErB IndexErrorr6rF)rrGrEZnl0rrrrHs   zTarget_or_Source.__getattr__cCs|j}|rt|dSdS)Nr)rErBr-)rrErrrrs  zTarget_or_Source.__str__cCs|j}|rt|dSdS)NrrO)rErBrK)rrErrrrLs  zTarget_or_Source.__repr__N)r r&r'r(rrHrrLrrrrrMs  rMc@seZdZddZddZdS) NullNodeListcOsdS)NrOr)rargskwargsrrr__call__zNullNodeList.__call__cCsdS)NrOr)rrrrrrTzNullNodeList.__str__N)r r&r'rSrrrrrrPsrPcCsi}|rDdd}t||}t||d<t||d<d|d<d|d<nt|d<t|d<|rdd }t||}t||d <t||d <d |d <d |d<nt|d <t|d <|S)aCreate a dictionary for substitution of special construction variables. This translates the following special arguments: target - the target (object or array of objects), used to generate the TARGET and TARGETS construction variables source - the source (object or array of objects), used to generate the SOURCES and SOURCE construction variables cSs*y |}Wntk r$|}YnX|S)N)get_subst_proxyr6)thingZ subst_proxyrrrget_tgt_subst_proxys   z'subst_dict..get_tgt_subst_proxyTARGETSTARGETz$TARGETSZCHANGED_TARGETSZUNCHANGED_TARGETScSsHy |j}Wntk rYnX|}y|Stk rB|SXdS)N)rfiler6rU)ZnoderZrrrget_src_subst_proxy+s z'subst_dict..get_src_subst_proxySOURCESZSOURCEz$SOURCESZCHANGED_SOURCESZUNCHANGED_SOURCES)r=rDrM NullNodesList)rsourcedictrWZtnlr[Zsnlrrr subst_dicts(        r`rr^envrc@s(eZdZdZddZddZddZdS) StringSubberzA class to construct the results of a scons_subst() call. This binds a specific construction environment, mode, target and source with two methods (substitute() and expand()) that handle the expansion. cCs||_||_||_||_dS)N)ramodeconvgvars)rrarcrdrerrrrRszStringSubber.__init__c CsVt|ry|dd\}}Wnttfk r6|SX|dkrD|S|dkrPdS|dkr\|S|dd}|ddks|d |kr|ddkr|dd }|}d}||kr||}n||jkr|j|}nlyt||j|}WnXtk rYnDtk r.}z$|jtkrd St ||d |Wdd}~XYnX|dkrZt tkrZt t ||d |n|dkrhd S| }| d d} d || <| ||Snt|r|j|j |fd d} tt| |St|r@t|tjjsddt|jDtkr||d |d|j|jtkd}n|jtkr*|S||}| ||S|dkrNd S|SdS)aExpand a single "token" as necessary, returning an appropriate string containing the expansion. This handles expanding different types of things (strings, lists, callables) appropriately. It calls the wrapper substitute() method to re-expand things as necessary, so that the results of expansions of side-by-side strings still get re-evaluated separately, not smushed together. N$z$$z()rr{.rOrXcSs||||S)Nr)lrd substitutelvarsrrrr>sz!StringSubber.expand..funccSs(h|] \}}|tks |jtjkr|qSr)_callable_args_setdefaultrempty)rkvrrr sz&StringSubber.expand..r\)rr^rar)rrN ValueErrorreevalKeyboardInterrupt Exceptionr r r NameErrorcopysplitrlrrdr9r:callabler rrANullr parametersitemsrnrarc SUBST_SIG SUBST_RAW) rrrms0s1keyold_sr8lvvarr>rrrexpandXsl        "   &    zStringSubber.expandc st|rt|tst|}yfdd}t||}Wnntk rt|}g}x$|D]}|   |q\Wt |dkr|d}nd tt|}YnX|S |SdS)zSubstitute expansions in an argument or list of arguments. This serves as a wrapper for splitting up a string into separate tokens. cs|dS)Nr)rdrgroup)match)rmrrr sub_matchsz*StringSubber.substitute..sub_matchrrrON)rr r0r- _dollar_expssub TypeError_separate_argsfindallappendrdrlenjoinr:)rrQrmrresultar)rmrrrls    zStringSubber.substituteN)r r&r'r(rrrlrrrrrbIserbcsxeZdZdZfddZddZddZdd Zd d Zd d Z ddZ ddZ ddZ ddZ ddZddZZS) ListSubberaA class to construct the results of a scons_subst_list() call. Like StringSubber, this class binds a specific construction environment, mode, target and source with two methods (substitute() and expand()) that handle the expansion. In addition, however, this class is used to track the state of the result(s) we're gathering so we can do the appropriate thing whenever we have to append another word to the result--start a new line, start a new word, append to the current word, etc. We do this by setting the "append" attribute to the right method so that our wrapper methods only need ever call ListSubber.append(), and the rest of the object takes care of doing the right thing internally. csZtg|_|_|_|_jtkr>fdd_n dd_d_ dS)Ncs |S)N)r)x)rrrrTz%ListSubber.__init__..cSsdS)Nr)rrrrrrT) r1rrarcrdrer add_stripin_strip next_line)rrarcrdre)r )rrrs   zListSubber.__init__cCs,t|rt|trdSt|}t|dkS)abDetermines if the string s requires further expansion. Due to the implementation of ListSubber expand will call itself 2 additional times for an already expanded string. This method is used to determine if a string is already fully expanded and if so exit the loop early to prevent these recursive calls. FN)rr r0r-rr)rrrrrexpandeds zListSubber.expandedc Cst|ry|dd\}}Wn"ttfk r@||dSX|dkrX||dS|dkrn|dq|dkr|dq|dkr|dq|dd}|d d ks|d d kr|d d kr|dd }|}d}||kr||}n||jkr |j|}nnyt||j|}WnZt k r4YnDt k rv}z$|j t krVdSt ||d |Wdd}~XYnX|dkrtt krt t|d |n|dkrdS||r||dS|} |d d } d| | <||| d |nt|r0x|D]} || |d|qWnt|rt|tjjshddt|jDtkr||d |d|j|j t!kd}n$|j t"kr||dS|#|}||||n|dkr|n ||dS)aExpand a single "token" as necessary, appending the expansion to the current result. This handles expanding different types of things (strings, lists, callables) appropriately. It calls the wrapper substitute() method to re-expand things as necessary, so that the results of expansions of side-by-side strings still get re-evaluated separately, not smushed together. Nrfrg(z$()z$)rrrhrirjrXrOcSs(h|] \}}|tks |jtjkr|qSr)rnrorrp)rrqrrrrrrsZsz$ListSubber.expand..r\)rr^rar)$rrNrtr open_strip close_stripfindrerurvrwr r rrxrryrzrl this_wordr next_wordr{r rrAr|rr}r~rnrarc SUBST_CMDrrd) rrrm within_listrrrrr8rrrrrrr s          "       &     zListSubber.expandcCst|rzt|tszt|}t|}xb|D]J}|ddkrfd|krL|qt|r\||qt|q*| |||q*Wn| |||dS)zSubstitute expansions in an argument or list of arguments. This serves as a wrapper for splitting up a string into separate tokens. rz  N) rr r0r-rrrrrr)rrQrmrrrrrrlos      zListSubber.substitutecCstj|g|dS)zArrange for the next word to start a new line. This is like starting a new word, except that we have to append another line to the result.N) collectionsUserListrr)rrrrrszListSubber.next_linecCs |j|_dS)z^Arrange for the next word to append to the end of the current last word in the result.N)add_to_current_wordr)rrrrrszListSubber.this_wordcCs |j|_dS)z.Arrange for the next word to start a new word.N) add_new_wordr)rrrrrszListSubber.next_wordcCs|jr|jtkry|dd}Wntk r>||YnpXyt|d}Wntk rhd}YnX|dkr~||n0||}||}t|rt|d}||dd<dS)a6Append the string x to the end of the current last word in the result. If that is not possible, then just add it as a new word. Make sure the entire concatenated string inherits the object attributes of x (in particular, the escape function) by wrapping it as CmdStringHolder.rjz<>|N) rrcrrNrr-rdrr0)rrZ current_wordZ last_charyrrrrs      zListSubber.add_to_current_wordcCsP|jr|jtkrD||}||}t|r6t||}|d||j|_dS)Nrj) rrcrr2rdrr0rr)rrr2rrrrs   zListSubber.add_new_wordcCs*y |j}Wntk rdSX|SdS)N)rr6)rrrkrrrr2s  zListSubber.literalcCs||d|_dS)z!Handle the "open strip" $( token.rN)rr)rrrrrrs zListSubber.open_stripcCs||d|_dS)z"Handle the "close strip" $) token.N)rr)rrrrrrs zListSubber.close_strip)r r&r'r(rrrrlrrrrrr2rrr5rr)r rrs f0 rrrfz\$[()]z(?.r)r9rrr_rm_listsrcCsfg}d}xL|D]D}|dkr$|d7}q|dkr@|d8}|dkrRPq|dkr||qW|dkrbdS|S)Nrz$(rz$))r)r9rZdepthrkrrr _remove_lists  rz'\$[\$\(\)]|\$[_a-zA-Z][\.\w]*|\${[^}]*}z(%s)z(%s|\s+|[^\s$]+|\$)z[\t ]+(?![^{]*})c Csht|trd|kst|tr |S|dkr0t|}d|krXt||}|rX|}||t|d<t||||} | ||} y |d=Wnt k rYnX| } t | r&t |} | r|t krt|| | } | dkrtjd| d| } n | d| } |tkrtd| } | dd} n>t| rdt|} | rd| | } | dkrdtjdt| | S) aTExpand a string or list containing construction variable substitutions. This is the work-horse function for substitutions in file names and the like. The companion scons_subst_list() function (below) handles separating command lines into lists of arguments, so see that function if that's what you're looking for. rgNrY __builtins__zUnbalanced $(/$) in: r+rOz$$)r r-r0_strconvr`ryupdaterrbrlKeyErrorr _regex_remover _list_removerzrrrrrr _space_sepstripreplacer) strSubstrarcrr^rermrddZssrZresremoverrr scons_subst'sH            rc Cs|dkrt|}d|kr8t||}|r8|}||t|d<t||||} | ||dy |d=Wntk rzYnX| jS)a&Substitute construction variables in a string (or list or other object) and separate the arguments into a command list. The companion scons_subst() function (above) handles basic substitutions within strings, so see that function instead if that's what you're looking for. NrYrr) rr`ryrrrrlrr4) rrarcrr^rermrdrZlsrrrscons_subst_listus    rcCst|tr|ddkr|Sd|d|dg}||d}||fdd}t|rg}x^|D]V}t|r||kr|}t|r||q||q|t ||q\||q\W|St|rt ||S|SdS) aPerform single (non-recursive) substitution of a single construction variable keyword. This is used when setting a variable when copying or overriding values in an Environment. We want to capture (expand) the old value before we override it, so people can do things like: env2 = env.Clone(CCFLAGS = '$CCFLAGS -g') We do this with some straightforward, brute-force code here... rgrz${}rOcSs:|d}||kr|}t|r.dtt|St|SdS)Nrr+)rrrr:r-)rval matchlistrrrrrs  z#scons_subst_once..sub_matchN) r r-rgetrrextendrrr)rrarrrrrr.rrrscons_subst_onces(       r)6r(rreinspectrrZ SCons.ErrorsrZ SCons.UtilrrrAZto_String_for_substZto_String_for_signaturerrNrxr r rrr)r/ UserStringr0r<r=rrDrMZNullSeqrPr]r`rnrbrrrrcompileZ_rmZ _rm_splitrrrrZ_dollar_exps_strrrrrrrrrrrsX    B       N,