SCons.Platform package

Submodules

SCons.Platform.aix module

SCons.Platform.aix

Platform-specific initialization for IBM AIX systems.

There normally shouldn’t be any need to import this module directly. It will usually be imported through the generic SCons.Platform.Platform() selection method.

SCons.Platform.aix.generate(env)

SCons.Platform.aix.get_xlc(env, xlc=None, packages=[])

SCons.Platform.cygwin module

SCons.Platform.cygwin

Platform-specific initialization for Cygwin systems.

There normally shouldn’t be any need to import this module directly. It will usually be imported through the generic SCons.Platform.Platform() selection method.

SCons.Platform.cygwin.generate(env)

SCons.Platform.darwin module

SCons.Platform.darwin

Platform-specific initialization for Mac OS X systems.

There normally shouldn’t be any need to import this module directly. It will usually be imported through the generic SCons.Platform.Platform() selection method.

SCons.Platform.darwin.generate(env)

SCons.Platform.hpux module

SCons.Platform.hpux

Platform-specific initialization for HP-UX systems.

There normally shouldn’t be any need to import this module directly. It will usually be imported through the generic SCons.Platform.Platform() selection method.

SCons.Platform.hpux.generate(env)

SCons.Platform.irix module

SCons.Platform.irix

Platform-specific initialization for SGI IRIX systems.

There normally shouldn’t be any need to import this module directly. It will usually be imported through the generic SCons.Platform.Platform() selection method.

SCons.Platform.irix.generate(env)

SCons.Platform.mingw module

SCons.Platform.mingw

Platform-specific initialization for the MinGW system.

SCons.Platform.os2 module

SCons.Platform.os2

Platform-specific initialization for OS/2 systems.

There normally shouldn’t be any need to import this module directly. It will usually be imported through the generic SCons.Platform.Platform() selection method.

SCons.Platform.os2.generate(env)

SCons.Platform.posix module

SCons.Platform.posix

Platform-specific initialization for POSIX (Linux, UNIX, etc.) systems.

There normally shouldn’t be any need to import this module directly. It will usually be imported through the generic SCons.Platform.Platform() selection method.

SCons.Platform.posix.escape(arg)

escape shell special characters

SCons.Platform.posix.exec_popen3(l, env, stdout, stderr)

SCons.Platform.posix.exec_subprocess(l, env)

SCons.Platform.posix.generate(env)

SCons.Platform.posix.piped_env_spawn(sh, escape, cmd, args, env, stdout, stderr)

SCons.Platform.posix.subprocess_spawn(sh, escape, cmd, args, env)

SCons.Platform.sunos module

SCons.Platform.sunos

Platform-specific initialization for Sun systems.

There normally shouldn’t be any need to import this module directly. It will usually be imported through the generic SCons.Platform.Platform() selection method.

SCons.Platform.sunos.generate(env)

SCons.Platform.virtualenv module

SCons.Platform.virtualenv

Support for virtualenv.

SCons.Platform.virtualenv.ImportVirtualenv(env)

Copies virtualenv-related environment variables from OS environment to env['ENV'] and prepends virtualenv’s PATH to env['ENV']['PATH'].

SCons.Platform.virtualenv.IsInVirtualenv(path)

Returns True, if path is under virtualenv’s home directory. If not, or if we don’t use virtualenv, returns False.

SCons.Platform.virtualenv.Virtualenv()

Returns path to the virtualenv home if scons is executing within a virtualenv or None, if not.

SCons.Platform.virtualenv._enable_virtualenv_default()

SCons.Platform.virtualenv._ignore_virtualenv_default()

SCons.Platform.virtualenv._inject_venv_path(env, path_list=None)

Modify environment such that SCons will take into account its virtualenv when running external tools.

SCons.Platform.virtualenv._inject_venv_variables(env)

SCons.Platform.virtualenv._is_path_in(path, base)

Returns true, if path is located under the base directory.

SCons.Platform.virtualenv._running_in_virtualenv()

Returns True, if scons is executed within a virtualenv

SCons.Platform.virtualenv.select_paths_in_venv(path_list)

Returns a list of paths from path_list which are under virtualenv’s home directory.

SCons.Platform.win32 module

SCons.Platform.win32

Platform-specific initialization for Win32 systems.

There normally shouldn’t be any need to import this module directly. It will usually be imported through the generic SCons.Platform.Platform() selection method.

class SCons.Platform.win32.ArchDefinition(arch, synonyms=[])

Bases: object

Determine which windows CPU were running on. A class for defining architecture-specific settings and logic.

SCons.Platform.win32.escape(x)

SCons.Platform.win32.exec_spawn(l, env)

SCons.Platform.win32.generate(env)

SCons.Platform.win32.get_architecture(arch=None)

Returns the definition for the specified architecture string.

If no string is specified, the system default is returned (as defined by the PROCESSOR_ARCHITEW6432 or PROCESSOR_ARCHITECTURE environment variables).

SCons.Platform.win32.get_program_files_dir()

Get the location of the program files directory

SCons.Platform.win32.get_system_root()

SCons.Platform.win32.piped_spawn(sh, escape, cmd, args, env, stdout, stderr)

SCons.Platform.win32.spawn(sh, escape, cmd, args, env)

SCons.Platform.win32.spawnve(mode, file, args, env)

Module contents

SCons.Platform

SCons platform selection.

This looks for modules that define a callable object that can modify a construction environment as appropriate for a given platform.

Note that we take a more simplistic view of “platform” than Python does. We’re looking for a single string that determines a set of tool-independent variables with which to initialize a construction environment. Consequently, we’ll examine both sys.platform and os.name (and anything else that might come in to play) in order to return some specification which is unique enough for our purposes.

Note that because this subsystem just selects a callable that can modify a construction environment, it’s possible for people to define their own “platform specification” in an arbitrary callable function. No one needs to use or tie in to this subsystem in order to roll their own platform definition.

SCons.Platform.DefaultToolList(platform, env)

Select a default tool list for the specified platform.

SCons.Platform.Platform(name='darwin')

Select a canned Platform specification.

class SCons.Platform.PlatformSpec(name, generate)

Bases: object

class SCons.Platform.TempFileMunge(cmd, cmdstr=None)

Bases: object

Convert long command lines to use a temporary file.

You can set an Environment variable (usually TEMPFILE) to this, then call it with a string argument, and it will perform temporary file substitution on it. This is used to circumvent limitations on the length of command lines. Example:

env["TEMPFILE"] = TempFileMunge
env["LINKCOM"] = "${TEMPFILE('$LINK $TARGET $SOURCES','$LINKCOMSTR')}"

By default, the name of the temporary file used begins with a prefix of ‘@’. This may be configured for other tool chains by setting the TEMPFILEPREFIX variable. Example:

env["TEMPFILEPREFIX"] = '-@'        # diab compiler
env["TEMPFILEPREFIX"] = '-via'      # arm tool chain
env["TEMPFILEPREFIX"] = ''          # (the empty string) PC Lint

You can configure the extension of the temporary file through the TEMPFILESUFFIX variable, which defaults to ‘.lnk’ (see comments in the code below). Example:

env["TEMPFILESUFFIX"] = '.lnt'   # PC Lint

Entries in the temporary file are separated by the value of the TEMPFILEARGJOIN variable, which defaults to an OS-appropriate value.

_print_cmd_str(target, source, env, cmdstr)

SCons.Platform.platform_default()

Return the platform string for our execution environment.

The returned value should map to one of the SCons/Platform/*.py files. Since scons is architecture independent, though, we don’t care about the machine architecture.

SCons.Platform.platform_module(name='darwin')

Return the imported module for the platform.

This looks for a module name that matches the specified argument. If the name is unspecified, we fetch the appropriate default for our execution environment.