Script

Script tasks are similar to command tasks, but they will run the script in the shell, instead of running a subprocess. This allows for more complex scripts, and for the use of shell features such as pipes, redirections, etc, if the shell supports them.

The shell used to run the script is platform dependent by default, but can be changed by setting the executable attribute of the task.

Default shells per platform:

• Windows: cmd.exe

• Linux: /bin/sh

• MacOS: /bin/sh

Warning

Passing arguments to scripts can be dangerous, as they can be used to inject code. Be careful when using them.

Tip

Python supports many of the features of shell scripts, and is usually cross platform and safer. If you can, try to use Python code instead of shell scripts.

from quickie import script

@script
def hello_script():
    return "echo 'Hello, World!'"

This will return a quickie.tasks.Script instance, equivalent to:

from quickie import Script

class HelloScript(Script):
    def get_script(self):
        return "echo 'Hello, World!'"

To pass arguments you can simply use string formatting:

from quickie import script, Arg

@script(args=[
    Arg("name"),
])
def hello_script(name):
    return f"echo 'Hello, {name}!'"

Setting the executable attribute of the task will change the shell used to run the script:

from quickie import script

@script(executable="python")
def hello_script():
    return "print('Hello, World!')"