__init__(self, path=None)
(Constructor)

Initialize the Node.FS subsystem.

The supplied path is the top of the source tree, where we expect to find the top-level build file. If no path is supplied, the current directory is the default.

The path argument must be a valid absolute path.

build_dir_target_climb(self, orig, dir, tail)

Create targets in corresponding build directories

Climb the directory tree, and look up path names relative to any linked build directories we find.

Even though this loops and walks up the tree, we don't memoize the return value because this is really only used to process the command-line targets.

BuildDir(self, build_dir, src_dir, duplicate=1)

Link the supplied build directory to the source directory for purposes of building files.

chdir(self, dir, change_os_dir=0)

Change the current working directory for lookups. If change_os_dir is true, we will also change the "real" cwd to match.

Dir(self, name, directory=None, create=True)

Lookup or create a Dir node with the specified name. If the name is a relative path (begins with ./, ../, or a file name), then it is looked up relative to the supplied directory node, or to the top level directory of the FS (supplied at construction time) if no directory is supplied.

This method will raise TypeError if a normal file is found at the specified path.

Entry(self, name, directory=None, create=1)

Lookup or create a generic Entry node with the specified name. If the name is a relative path (begins with ./, ../, or a file name), then it is looked up relative to the supplied directory node, or to the top level directory of the FS (supplied at construction time) if no directory is supplied.

File(self, name, directory=None, create=1)

Lookup or create a File node with the specified name. If the name is a relative path (begins with ./, ../, or a file name), then it is looked up relative to the supplied directory node, or to the top level directory of the FS (supplied at construction time) if no directory is supplied.

This method will raise TypeError if a directory is found at the specified path.

get_root(self, drive)

Returns the root directory for the specified drive, creating it if necessary.

Glob(self, pathname, ondisk=True, source=True, strings=False, cwd=None)

Globs

This is mainly a shim layer

Repository(self, *dirs)

Specify Repository directories to search.

_lookup(self, p, directory, fsclass, create=1)

The generic entry point for Node lookup with user-supplied data.

This translates arbitrary input into a canonical Node.FS object of the specified fsclass. The general approach for strings is to turn it into a fully normalized absolute path and then call the root directory's lookup_abs() method for the heavy lifting.

If the path name begins with '#', it is unconditionally interpreted relative to the top-level directory of this FS. '#' is treated as a synonym for the top-level SConstruct directory, much like '~' is treated as a synonym for the user's home directory in a UNIX shell. So both '#foo' and '#/foo' refer to the 'foo' subdirectory underneath the top-level SConstruct directory.

If the path name is relative, then the path is looked up relative to the specified directory, or the current directory (self._cwd, typically the SConscript directory) if the specified directory is None.