waf python build 工具使用流程
waf python build 工具使用流程
waf 的 build 理念
build 了之后，可以跟踪到 ${SRC} 和 ${TGT} 有关联的文件，只有 ${SRC} 被修改过，在下次build的时候才会重新 build 这个文件，想想如果一个 project 非常大，在测试过程中或者发布都要 build 一次，每次都要全部 build 一遍，尽管你只修改了一个文件，当然如果你知道你改了哪个文件，可以单独 build 那个文件，但是谁能记得清自己修改了哪些文件，waf 可以解决这个问题，不过 waf 虽然可以用相对路径，但是最终还是绝对路径，如果移动了 project 文件夹，那么 SRC 和 TGT 的关系就丢失了，如果 build 关系也能用相对路径，那就更完美了。
设置运行 waf 的 alias
注意，以下使用的是 Git bash 控制台
waf是python写的，所以用python来运行
alias waf='[python-path]/python.exe [waf-path]/waf'
基本的 wscript
1 #!//usr/bin/python 2 # -*- coding: utf-8 -*- 3 4 top = '.' 5 out = 'build' #这个是默认的out文件夹，可以设其它名 6 7 def configure(cfg): 8 for f in cfg.path.ant_glob('folder/**/*.py'): #通过ant.glob来获取某个文件夹下面的所有py文件，f 是 waf 的某个类对象，所以有以下的方法 9 print(f.abspath()) #绝对路径 10 print(f.srcpath()) #相对路径，f 是 waf 中的类对象，所以绝对路径是 wscript 所在的路径 11 12 def build(bld): 13 bld(rule='"python.exe -OO -c "import py_compile;py_compile.compile(\'${SRC}\', cfile=\'${TGT}\', doraise=True)"', 14 source='test/foo.py', #注意：source的路径是相对路径(wscript所在的路径)，不然build的过程会说source找不到 15 target='D:/foo.pyc', #注意：target可以是绝对路径，也可以是相对路径，如果是相对路径，build后会在wscript所在文件夹下的 build(out文件夹) 文件夹中找到 16 )
代码解析：
top：一般默认是'.'，代表源代码所在的工程目录
out：是执行 waf build 后在 wscript 所在路径自动生成的 build 文件夹，target 中如果使用相对路径，都会存放在 out 中，这也是默认的 waf build command 运行的路径，build 的时候可以看到 entering directory 'xxx'，如果结合其它非 waf 命令，就要注意这点。
cfg.path：代表 wscript 的所在路径
cfg.path.ant_glob()：正则匹配cfg.path下的文件
configure(cfg) 和 build(bld) 函数：waf 内置的函数，我们通过重写它们来实现我们的功能，它们的第一个参数也是内置的 waf 类，有定义好的各种功能
bld()中的 rule 参数，${SRC} 和 ${TGT} 是内置的变量，分别代表 source 和 target 参数，注意：source 和 target 最后传递到 rule 里是一个waf node list []，source 的路径是以 wscript 所在路径为前缀的，而且在win系统中 f 中的路径使用的是'\'，既然 rule 是 str，使用 f 就要注意转义。另外可以这样：
"${SRC[0].abspath().replace(\'\\\\\', \'/\')}"
如果是win系统，直接加r：
'r\'%s\''%"${SRC[0].abspath()}"
bld() rule 中执行多行命令
bld(rule = 'set PYTHONPATH=%%%%PYTHONPATH%%%%;D:/myPath && python.exe myPython.py')
代码解释：
用 && 来区别多行执行，这应该是 bat 的多行命令符号
注意%的格式化，'%%'才是代表一个'%'，而在str中当命令，如果前面不带r，就要四个%%%%
build bld() task 任务强制执行
waf 会对 source 跟踪，如果编译过的文件没有被修改，那么再次编译的时候就不会去处理那个文件，但是有这样一种情况，我们只是在 bld 中去运行其他的编译工具，那么 source 是不会经常被改变的，而且跟踪的事是其他的编译工具的事情，waf 要强制这个bld运行，只要加 always 参数即可，具体如下：
def build(bld): bld( rule = '', always = True )
wscript 使用基本流程
waf configure 在build之前必须 configure 过
waf build build
waf distclean 清理所有 waf 的动作所生成的中间文件，执行后，如果想 build，需要重新 configure
waf install
waf 提供了非常方便的安装方式。
假如在 wscript 中的 build 方法内
def build(bld): start_dir = bld.path.find_dir('src/bar') bld.install_files('D:/installPath', start_dir.ant_glob('**/*.py[cod]'), cwd = start_dir, relative_trick = True)
注意：waf build 并不会执行 bld.install_files() 方法，正确执行的方法是：
waf install
waf uninstall #这是卸载
代码解释：
install_files()
参数1：安装路径
参数2：安装的文件
cwd 和 relative_trick：两者结合，安装到 'D:/installPath' 后，就会保留 cwd 后面的目录结构(就是把cwd的部分去掉)，例如 [cwd]/myFolder/* -> [参数1 路径]/myFolder/*
cwd = [waf node]
start_dir.ant_glob('**/*.py[cod]')：在 start_dir 下找到所有的 pyc，pyo，pyd，注意：**/* 是waf的正则表达式，表示所有子目录下的文件
更多waf install 函数，请参考：waf 文档 5.2.2. Installing files
cmd 判断
如 waf install，它其实执行的是 build(bld)，尤其是一些 bld(always = True) 的情况，我们需要根据不同的 cmd 来判断是否需要执行一些函数
bld.cmd == 'build'
bld.cmd == 'install'
等等
waf node
The Waf nodes inherit the class waflib.Node.Node and provide a tree structure to represent the file system
waf node 继承于 waflib.Node.Node，和提供了一个代表文件系统的树结构
一些路径处理方式：
ctx.root：系统的根目录，linux为/，win系统为包含了所有磁盘的文件夹，这个 node 可以用来获得与 wscript 无关的一些路径的node，例如 ctx.root.find_dir("D:/")，在处理一些其它路径的时候非常有用
ctx.srcnode：top 路径，ctx是 wscript 方法的第一个参数
ctx.bldnode：out 路径，ctx是 wscript 方法的第一个参数
node.abspath()：返回 node 的绝对路径，类型是str，注意这里的绝对路径是是以top路径为前缀的
node.srcpath()：返回 node 的相对路径，类型是str，注意这里是top的相对路径
node.from_path(node)：去掉 node 的部分
node.find_dir('')：在 node 的路径下找相应路径，返回一个 node
node.search_node("")：找一个node（文件或者文件夹），如果找不到，返回 None
ctx.path：wscript所在路径
node.parent：父路径
node.children：子目录
node.ant_glob()：正则匹配 node 下的文件，默认返回的都是文件，ant_glob() 参数说明：
参数1：str 或者 str list，如果是 list，表示匹配里面多个可能
excl = []：不包含[]中匹配到的内容
dir = False：如果是 True，则返回的是匹配到的文件夹
scr = False：暂时不知道有何作用，可以忽略，不过按照字面的意思，可能是返回的是相对了的路径
常用的正则表达式：
node.ant_glob('*')：node 下的所有文件，不包括子文件夹里面的文件
node.ant_glob('**')：node 下的所有文件，包括子文件夹里面的文件
node.ant_glob('**/folder/')：node folder文件夹（包括子文件夹）下的所有文件
node.ant_glob('**/file')：node folder文件夹（包括子文件夹）下的所有的 file
node.ant_glob('**/*.py[cod]')：node 文件夹（包括子文件夹）下的所有 pyc pyo pyd 文件
提醒：当out 和 top 与 wscript 不在同一个目录，就要注意路径处理
env 环境设置
1 #!//usr/bin/python 2 # -*- coding: utf-8 -*- 3 4 top = '.' 5 out = 'build' 6 7 def configure(cfg): 8 cfg.env.TESTENV = 0 9 #or 10 #cfg.env[TESTENV] = 0 11 12 def build(bld): 13 print(bld.env.TESTENV)
