Package SCons :: Package Node :: Module Alias :: Class Alias

Class Alias

object --+    
         |    
      Node --+
             |
            Alias

Nested Classes

[hide private]

NodeInfo
The generic base class for signature information for a Node.

BuildInfo
The generic base class for build information for a Node.

Inherited from Node: Attrs

Instance Methods

[hide private]

__init__(self, name)
x.__init__(...) initializes x; see help(type(x)) for signature

source code

str_for_display(self)

source code

__str__(self)
str(x)

source code

make_ready(self)
Get a Node ready for evaluation.

source code

really_build(self, **kw)
Actually build the node.

source code

is_up_to_date(self)
Alternate check for whether the Node is current: If all of our children were up-to-date, then this Node was up-to-date, too.

source code

is_under(self, dir)

source code

get_contents(self)
The contents of an alias is the concatenation of the content signatures of all its sources.

source code

sconsign(self)
An Alias is not recorded in .sconsign files

source code

changed_since_last_build(self, target, prev_ni)
Must be overridden in a specific subclass to return True if this Node (a dependency) has changed since the last time it was used to build the specified target. prev_ni is this Node's state (for example, its file timestamp, length, maybe content signature) as of the last time the target was built.

source code

build(self)
A "builder" for aliases.

source code

convert(self)

source code

get_csig(self)
Generate a node's content signature, the digested signature of its content.

source code

Inherited from Node: Decider, add_dependency, add_ignore, add_prerequisite, add_source, add_to_implicit, add_to_waiting_parents, add_to_waiting_s_e, add_wkid, all_children, alter_targets, builder_set, built, changed, children, children_are_up_to_date, clear, clear_memoized_values, del_binfo, disambiguate, do_not_store_info, env_set, executor_cleanup, exists, explain, for_signature, get_abspath, get_binfo, get_build_env, get_build_scanner_path, get_builder, get_cachedir_csig, get_env, get_env_scanner, get_executor, get_found_includes, get_implicit_deps, get_ninfo, get_source_scanner, get_state, get_stored_implicit, get_stored_info, get_string, get_subst_proxy, get_suffix, get_target_scanner, has_builder, has_explicit_builder, is_derived, is_literal, missing, multiple_side_effect_has_builder, new_binfo, new_ninfo, postprocess, prepare, push_to_cache, release_target_info, remove, render_include_tree, reset_executor, retrieve_from_cache, rexists, scan, scanner_key, select_scanner, set_always_build, set_executor, set_explicit, set_nocache, set_noclean, set_precious, set_pseudo, set_specific_source, set_state, state_has_changed, store_info, visited

Inherited from Node (private): _add_child, _children_get, _children_reset

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __new__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __subclasshook__

Class Variables

[hide private]

Inherited from Node: __metaclass__, memoizer_counters

Properties

[hide private]

Inherited from object: __class__

Method Details

[hide private]

init(self, name)
(Constructor)

source code

x.__init__(...) initializes x; see help(type(x)) for signature

Overrides: object.__init__: (inherited documentation)

str(self)
(Informal representation operator)

source code

str(x)

Overrides: object.__str__: (inherited documentation)

make_ready(self)

source code

Get a Node ready for evaluation.

This is called before the Taskmaster decides if the Node is up-to-date or not. Overriding this method allows for a Node subclass to be disambiguated if necessary, or for an implicit source builder to be attached.

Overrides: Node.make_ready: (inherited documentation)

really_build(self, **kw)

source code

Actually build the node.

This is called by the Taskmaster after it's decided that the Node is out-of-date and must be rebuilt, and after the prepare() method has gotten everything, uh, prepared.

This method is called from multiple threads in a parallel build, so only do thread safe stuff here. Do thread unsafe stuff in built().

is_up_to_date(self)

source code

Alternate check for whether the Node is current: If all of our children were up-to-date, then this Node was up-to-date, too.

The SCons.Node.Alias and SCons.Node.Python.Value subclasses rebind their current() method to this method.

Overrides: Node.is_up_to_date

changed_since_last_build(self, target, prev_ni)

source code

Must be overridden in a specific subclass to return True if this Node (a dependency) has changed since the last time it was used to build the specified target. prev_ni is this Node's state (for example, its file timestamp, length, maybe content signature) as of the last time the target was built.

Note that this method is called through the dependency, not the target, because a dependency Node must be able to use its own logic to decide if it changed. For example, File Nodes need to obey if we're configured to use timestamps, but Python Value Nodes never use timestamps and always use the content. If this method were called through the target, then each Node's implementation of this method would have to have more complicated logic to handle all the different Node types on which it might depend.

Overrides: Node.changed_since_last_build: (inherited documentation)

build(self)

source code

A "builder" for aliases.

Overrides: Node.build

get_csig(self)

source code

Generate a node's content signature, the digested signature of its content.

node - the node cache - alternate node to use for the signature cache returns - the content signature

Overrides: Node.get_csig

Class Alias

__init__(self, name) (Constructor)

__str__(self) (Informal representation operator)

make_ready(self)

really_build(self, **kw)

is_up_to_date(self)

changed_since_last_build(self, target, prev_ni)

build(self)

get_csig(self)

init(self, name)
(Constructor)

str(self)
(Informal representation operator)