DEVEL (1623B)
1 Waf 2.0 is on https://gitlab.com/ita1024/waf 2 ------------------------------------------------ 3 4 waflib the core library 5 waflib/Tools essential waf tools 6 waflib/extras contributed tools which are not included in the waf file by default 7 build_system_kit examples of build systems that can be created from Waf 8 tests various unit tests, most are unused anymore 9 playground experimental examples and test, most tools lie in the folder waflib/extras 10 demos integration tests - the folder can be configured as a standalone project 11 demos/* integration tests and examples used as documentation 12 docs documentation 13 docs/sphinx project extracting the docstrings from the source code to create the API documentation 14 15 Documentation 16 ------------------------------------------------- 17 18 API documentation https://waf.io/apidocs/ 19 The Waf Book https://waf.io/book/ 20 21 General coding guidelines 22 ------------------------- 23 24 * The code must run in both Python 2.6 to Python 3 25 * Use tabs for Python file indentation 26 * Use x.splitlines() instead of x.split('\n') 27 * Avoid "except:" and "except Exception:" 28 * Use Node.readf/Node.writef/Utils.readf/Utils.writef 29 30 Pull requests 31 ------------- 32 33 See https://gitlab.com/ita1024/waf 34 35 When implementing complex features, please add examples in the showcase folder demos/ 36 for modules under waflib/Tools, under tests/ for platform-independent unit tests, 37 or in playground/ for modules under waflib/extras. 38 39 The files under waflib/Tools/ are kept API-compatible for the duration 40 of a middle version (currently 2.0). 41