Skip to main content

Run functions as scripts

Project description

Tasker is a way to organize your scripts. If you have dozens of small scripts and you keep forgetting what they do and what parameters they take, tasker is for you. Instead of scripts you write functions, put them in a file or a couple of them, and then run the main tasker script giving them the task name and the parameters of the task like this:

run_task <task-name> [<task-parameter>]...

The help task will scan your tasks package and give you the signatures and docstrings of your tasks.

To be considered as a task, the function name should end with _task. The task name is the function name less the suffix. Suppose we have the following file stucture:


def one_task(p1):
    print 'in one_task, parameters:', p1

def two_task(p1, p2):
    print 'in two_task, parameters:', p1, p2


def t1_task(p1):
    print 'in t1_task, parameters:', p1

def t2_task(p1, p2=None):
    print 'in t2_task, parameters:', p1, p2

Then we can run the following examples:

run_task one foo
run_task two foo baz
run_task two foo               # fails, not enough parameters
run_task moretasks.t1 spam
run_task moretasks.t2 spam ham
run_task moretasks.t2 spam     # works too because of default value of the second parameter

To generate the run_task script in the current directory run:

python -m tasker <fully-qualified-name-of-tasks-package>  # default = "tasks"

IMPORTANT: All task parameters are strings.

You can include tasks with distribution of your project and run them all with a single installed script. Suppose your project looks like this:


Then you can include the following snippet in

def run_task():
    import tasker

then include the following in your setuptools-based

    'console_scripts': [
        'someproject_task = someproject:run_task',

This setup will create script someproject_task, which will know about your tasks.


pip install tasker


This was inspired by the Ruby’s rake utility. I used for some time the shovel python clone of rake until I got dissatisfied with it. The important difference of tasker (apart from simplicity) is that it does not depend on current working directory.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for tasker, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size tasker-0.1.2-py2.py3-none-any.whl (5.9 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size (8.3 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page