This is the README.md file for the Software Construction Toolkit.
You are likely reading this file in one of the following two situations:
- You have downloaded Software Construction Toolkit from GitHub (formerly found on code.google.com) and are examining the contents.
- This file was included in some other software package so that the package could be built using Software Construction Toolkit. In this case, follow the instructions provided with the rest of the software package for how to use Software Construction Toolkit to build and/or install the software.
Once upon a time, this code was hosted at Google Code. Now it's been archived at that location. There are a number of GitHub Clones, but none appear to be authoritative. I'm cloning here as well, but I'm updating the README.md to reflect that reality and trying to update this README.md to be more accurate.
Software Construction Toolkit requires:
-
Python 2.4 or later.
- For example, from http://www.python.org
- If on Windows, also need the pywin32 extensions
- Software Construction Toolkit is not yet compatible with Python 3.
-
SCons 1.2 or later.
- For example, from http://www.scons.org/download.php
- A scons or scons-local install is required for building projects.
- A scons-src install is required for developing Software Construction Toolkit.
There should be no other direct dependencies or requirements to run the Software Construction Toolkit.
Installation of this package is as simple as copying its directory tree to any directory.
If you are using the hammer.bat or hammer.sh entry point, you also need to set up a SCONS_DIR environment variable to point to the directory containing SCons.
- For a normal SCons install, this is the engine subdir.
- For a scons-local install, this is the . subdir.
- For a scons-src install, this is the src/engine subdir.
- For a Windows install of SCons which used a .exe or .msi installer, SCons may be installed in a subdirectory of the Python directory. For example,
C:\Python24\Lib\site-packages\scons-1.2.0
.
If you are modifying Software Construction Toolkit and need to run the unit tests, set up a SCONS_DEV_DIR environment variable to point to the directory containing the scons-src install.
Once you have installed this package, you should write a main.scons file at the top level of your source tree to build your software.
Then modify the build/install instructions for your package to instruct your users to execute Software Construction Toolkit by running hammer.bat or hammer.sh.
This package consists of the following:
A copy of the copyright and terms under which Software Construction Toolkit is distributed (the BSD license).
What you're looking at right now.
Change history for major releases.
The entry point for Software Construction Toolkit on Windows.
The entry point for Software Construction Toolkit on posix and unix-like systems, including Cygwin.
A script called by hammer which does some additional setup and then calls SCons.
Tools and modules for Software Construction Toolkit.
Sample projects which demonstrate usage of the Software Construction Toolkit.
Additional executables and utilities for developing the Software Construction Toolkit, including the test-runner.
Additional libraries for developing the Software Construction Toolkit, including the test framework module.
Tests for Software Construction Toolkit.
At one time, up-to-date documentation for the Software Construction Toolkit could be found online at its archived homepage. In theory that remains true until someone takes up the project.
Software Construction Toolkit is distributed under the BSD license, a full copy of which is available in the COPYING file in this package.
Once upon a time, you could report Software Construction Toolkit bugs on the Software Construction Toolkit's Issues Page. Now it's just an archive of old issues. You can open issues here too, but I'm not in any position to take this project over. Maybe someone will come along and take ownership.
A mailing list for users of Software Construction Toolkit is available. You may send questions or comments to the list at: [email protected]
You may subscribe to the mailing list. It hasn't seen action for a few years.
Randall Spangler <randall dot spangler at gmail dot com>
With plenty of help from the Software Construction Toolkit Development team:
- Brad Nelson
- Steven Knight
- Stephen Ng
- Greg Spencer