Clone wiki

SCons / EnvValue

The SCons wiki has moved to

This value node has a string argument which substitutes values from the environment. This is usefull for:

  • Generating small initialization files
  • Ensuring that builders which are python function gets the correct dependencies if the function uses environment values.
import SCons.Node.Python

class EnvValue(SCons.Node.Python.Value):
    """Node class which substitutes variables from the environment"""
    def __init__(self,env,value):
        """Initialiser takes an Environment and a string to be
    def __str__(self):
        return env.subst(self.value)

Now you can do something like this:

env.Command('target',EnvValue(env,'$MYVAR'),'echo $SOURCE > $TARGET')

There is one scenario in which the results might not be as expected. This is when the builder creates an override environment. In this case the environment used for the value node is not the same as that used for the builder:

env.Command('target',EnvValue(env,'$MYVAR'),'echo $SOURCE > $TARGET',MYVAR='SomeValue')

In this example the command becomes

echo DefaultValue

For a builder which is a python function which references environment values, you might want to have add an emitter function which adds a EnvValue as a dependency (I have not tried that yet).