bumpy 0.4.3

任务

为了把你可爱的功能转变成一项艰巨的任务， 简单地应用 @task decorator:

import bumpy as b

@b.task
def build():
    '''Builds ALL THE CODE.'''
    print 'Building'

函数名将用作任务名。文档字符串将是 保存并用于内置帮助。任何参数或关键字参数 将被解析并注册为cli标志。

先决条件任务/文件可以用可选的reqs指定 任务的关键字参数

@b.task(reqs=build)
def run():
    print 'Running'

需求可以是单个需求，也可以是一组需求。一 依赖项只在第一次需要时执行，尽管 它可以通过命令行显式执行多次：

$ bump run
Building
Running
$ bump build run
Building
Running
$ bump build build run
Building
Building
Running

str 需求将解释为文件/路径。

生成的文件可以用可选的 gens 关键字指定 参数：

@b.task(gens='docs')
def docs():
    print 'Documenting'

生成的文件将被保存，并可以使用 bumpy的 clean（） 帮助函数。生成的文件也将被使用 查找基于文件的依赖关系链。

任务别名可以用可选的 alias 关键字指定 参数：

@b.task(alias='pkg', reqs=(build, docs))
def package():
    print 'Packaging'

别名 可以是单个别名或一组别名。

任务可以设为"默认"任务. 如果未提供参数，则调用，方法是将 'default' 作为 可选参数：

@b.task('default'):
def build():
    print 'Building'

任务可以设置为"设置"任务 在执行任何其他任务之前调用，方法是提供 'setup' 作为可选 参数：

@b.task('setup')
def setup():
    print 'Setting stuff up'

安装任务也可以接受参数。以后再说！

类似于"安装"任务，"拆卸"任务在每一个任务之后调用 任务，就在退出之前：

import bumpy as b

@b.task
def build():
    '''Builds ALL THE CODE.'''
    print 'Building'

通过添加 'private' 可选参数或在其名称前加下划线：

import bumpy as b

@b.task
def build():
    '''Builds ALL THE CODE.'''
    print 'Building'

私有任务仍然可以是必需的和执行的，但不能被调用 在命令行中，并且不会包含在内置帮助中。

任务可以通过添加可选的 参数：

import bumpy as b

@b.task
def build():
    '''Builds ALL THE CODE.'''
    print 'Building'

函数参数/关键字参数将转换为 命令行标志和选项。

import bumpy as b

@b.task
def build():
    '''Builds ALL THE CODE.'''
    print 'Building'

然后可以这样调用：

import bumpy as b

@b.task
def build():
    '''Builds ALL THE CODE.'''
    print 'Building'

关键字参数 必须在标准参数之前，与 巨蟒的标准。