pyxcute 0.5.2

基本

创建一个cute.py文件：

fromxcuteimportcutecute(hello='echo hello xcute!')

然后运行：

$ cute hello
> Task: hello
> Cmd: echo hello xcute!
hello xcute!

If you got a “not a command” error, see How do I make Python scripts executable?)

“hello”是应该执行的任务的名称。如果cute.py在没有任务名的情况下执行，它将运行“默认”任务。

提供其他参数：

$ cute hello 123
> Task: hello
> Cmd: echo hello xcute! 123
hello xcute! 123

参数将传递给执行器，在本例中是xcute.Cmd.__call__。

任务

它可以是str:

fromxcuteimportcutecute(hello='echo hello')

如果与另一个任务的名称匹配，pyxcute将执行该任务：

fromxcuteimportcutecute(hello='world',# execute "world" task when "hello" task is executedworld='echo I am world task')

使用列表：

fromxcuteimportcutecute(hello=['echo task1','echo task2'])

使用异常将使任务失败：

fromxcuteimportcutecute(hello=Exception("error message"))

使用任何可调用的内容：

fromxcuteimportcutecute(hello=lambda:print('say hello'))

实际上，当您将不可调用的值指定为任务时，pyxcute会根据其类型将其转换为可调用的值。

任务链

用_pre，_err，_post，_fin后缀定义工作流：

fromxcuteimportcutecute(hello_pre='echo _pre runs before the task',hello='echo say hello',hello_err='echo _err runs if there is an error in task, i.e, an uncaught exception or non-zero return code',hello_post='echo _post runs after the task if task successfully returned',hello_fin='echo _fin always runs after _post, _err just like finally')

当任务执行时，任务运行器首先尝试执行_pre任务，然后是任务本身，然后是_post任务。如果任务引发异常，则它将转到_err任务。_fin无论任务是否失败，都将执行任务。

伪代码：

run(name+"_pre")try:run(name,args)exceptException:run(name+"_err")else:run(name+"_post")finally:run(name+"_fin")

格式字符串

pyxcute使用xcute.conf字典扩展命令字符串。扩展在运行时发生：

fromxcuteimportconf,cuteconf["my_name"]="world"defchange_my_name():conf["my_name"]="bad world"cute(hello=["echo hello {my_name}",change_my_name,"echo hello {my_name}"])

$ cute hello
> Task: hello
> Cmd: echo hello world
hello world
> Cmd: echo hello bad world
hello bad world