Please note:The SCons wiki is now restored from the attack in March 2013. All old passwords have been invalidated. Please reset your password if you have an account. If you note missing pages, please report them to webmaster@scons.org. Also, new account creation is currently disabled due to an ongoing spam flood (2013/08/27).

Python Binary Builder (InstallPython method)

The InstallPython method is not yet a part of SCons. The current code is viewable here. Creating Python Binary Builder is a part of my Google Summer of Code project.

An installation package is also available for download:

InstallPython method provides a possibility to install Python source files along with its binary versions (.pyc or .pyo files) in chosen directory for public use.

InstallPython takes target (destination) directory as its first argument and a list of source files/directories as a second argument.

A simple example of SConstruct file:

env = Environment()
hello = File('hello.py')
env.InstallPython('/usr/local/bin/', hello)
env.Alias('install', '/usr/local/bin/')

SCons invoked with -Q install parameter will compile hello.py file into hello.pyc and copy both files into /usr/local/bin/ directory.

Sample output:

$ scons -Q install
Install file: "hello.py" as "/usr/local/bin/hello.py"
Install file: "hello.pyc" as "/usr/local/bin/hello.pyc"

InstallPython method can also compile Python source files into optimized binary files (.pyo suffix) instead of ordinary binaries (.pyc files). To achieve this change the call to Environment():

env = Environment(TARGETSUFFIX = 'PYO')
hello = File('hello.py')
env.InstallPython('/usr/local/bin/', hello)
env.Alias('install', '/usr/local/bin/')

Sample output:

$ scons -Q install
Install file: "hello.py" as "/usr/local/bin/hello.py"
Install file: "hello.pyo" as "/usr/local/bin/hello.pyo"

InstallPython method accepts both files and directories as its source arguments:

env = Environment()
pyfiles = Dir('pyfiles/')
env.InstallPython('/usr/local/bin/', pyfiles)
env.Alias('install', '/usr/local/bin')

Running scons -Q install will copy all the .py files from pyfiles directory into /usr/local/lib/pyfiles directory along with corresponding .pyc files.

Sample output:

$ scons -Q install
Install file: "pyfiles/hello.py" as "/usr/local/bin/pyfiles/hello.py"
Install file: "pyfiles/hello.pyc" as "/usr/local/bin/pyfiles/hello.pyc"
Install file: "pyfiles/hello2.py" as "/usr/local/bin/pyfiles/hello2.py"
Install file: "pyfiles/hello2.pyc" as "/usr/local/bin/pyfiles/hello2.pyc"

Mixing files and directories is also possible:

env = Environment()
hello = File('hello.py')
pyfiles = Dir('pyfiles/')
env.InstallPython('/usr/local/bin/', [hello, pyfiles])
env.Alias('install', '/usr/local/bin')

Sample output:

$ scons -Q install
Install file: "hello.py" as "/usr/local/bin/hello.py"
Install file: "hello.pyc" as "/usr/local/bin/hello.pyc"
Install file: "pyfiles/hello.py" as "/usr/local/bin/pyfiles/hello.py"
Install file: "pyfiles/hello.pyc" as "/usr/local/bin/pyfiles/hello.pyc"
Install file: "pyfiles/hello2.py" as "/usr/local/bin/pyfiles/hello2.py"
Install file: "pyfiles/hello2.pyc" as "/usr/local/bin/pyfiles/hello2.pyc"

GSoC2008/MatiGruca/InstallPython (last edited 2008-07-31 12:54:16 by apn-77-114-173-108)