Go to file
Thomas Nagy 41a325496a
waf-2.0.0pre3
2017-05-08 19:13:38 +02:00
build_system_kit Remove the TaskBase class hierarchy level 2017-02-11 15:04:25 +01:00
demos Update check_endianness() example to show that the return value needs to be used 2017-02-08 21:19:19 +01:00
docs Accept nested lists as bld(source=...) 2017-01-21 12:50:52 +01:00
playground Replace param 'source_files' with 'group_files'. 2017-04-16 01:38:30 +02:00
tests Display commands as string with "WAF_CMD_FORMAT=string waf build -v" 2017-03-04 08:20:27 +01:00
utils waf-launcher - Issue 1935 2017-03-29 18:18:26 +02:00
waflib Detect older products with vswhere.exe 2017-05-08 19:12:17 +02:00
zip iso8859-1 -> latin-1 2017-01-21 13:28:06 +01:00
.gitignore Ignore waf.bat (generated by Windows build). 2017-04-08 02:27:04 +02:00
ChangeLog waf-2.0.0pre3 2017-05-08 19:13:38 +02:00
DEVEL docs 2016-11-20 10:11:09 +01:00
README.md Simplify env['FOO'] -> env.FOO 2016-06-25 23:54:12 +02:00
TODO Remove atleast-version, exact-version and max-version from conf.check_cfg 2016-12-03 06:44:20 +01:00
configure Update use_config - Issue 1608 2015-08-29 10:31:02 +02:00
waf-light Update the year in headers to 2017 2017-02-11 16:13:37 +01:00
wscript waf.bat changed to support Python3 installation on Windows. 2017-04-08 02:27:13 +02:00

README.md

ABOUT WAF

Waf is a Python-based framework for configuring, compiling and installing applications. Here are perhaps the most important features of Waf:

  • Automatic build order: the build order is computed from input and output files, among others
  • Automatic dependencies: tasks to execute are detected by hashing files and commands
  • Performance: tasks are executed in parallel automatically, the startup time is meant to be fast (separation between configuration and build)
  • Flexibility: new commands and tasks can be added very easily through subclassing, bottlenecks for specific builds can be eliminated through dynamic method replacement
  • Extensibility: though many programming languages and compilers are already supported by default, many others are available as extensions
  • IDE support: Eclipse, Visual Studio and Xcode project generators (waflib/extras/)
  • Documentation: the application is based on a robust model documented in The Waf Book and in the API docs
  • Python compatibility: cPython 2.5 to 3.4, Jython 2.5, IronPython, and Pypy

Waf is used in particular by innovative companies such as Avalanche Studios and by open-source projects such as RTEMS. Learn more about Waf by reading The Waf Book.

For researchers and build system writers, Waf also provides a framework for creating custom build systems and package distribution systems.

Download the project from our page on waf.io or from a mirror on freehackers.org, consult the manual, the API documentation and the showcases and experiments.

HOW TO CREATE THE WAF SCRIPT

Python >= 2.6 is required to generate the waf script, and the resulting file can then run on Python 2.5. Just execute:

$ ./waf-light configure build

Or, if you have several python versions installed:

$ python3 ./waf-light configure build

The Waf tools in waflib/extras are not added to the waf script. To add some of them, use the --tools switch:

$ ./waf-light --tools=compat15,swig

To add a tool that does not exist in the folder extras, pass an absolute path, and to customize the initialization, pass the parameter 'prelude'. Here is for example how to create a waf file using the compat15 module:

$ ./waf-light --tools=compat15 --prelude=$'\tfrom waflib.extras import compat15\n'

Any kind of initialization is possible, though one may prefer the build system kit (folder build_system_kit):

$ ./waf-light --make-waf --tools=compat15,/comp/waf/aba.py --prelude=$'\tfrom waflib.extras import compat15\n\tprint("ok")'

Or, to avoid regenerating the waf file all the time, just set the WAFDIR environment variable to the directory containing "waflib".

HOW TO RUN THE EXAMPLES

Try this:

cp waf demos/c/
cd demos/c/
./waf configure build