Conjuring

Reusable global Invoke tasks that can be merged with local project tasks.

Features

• Merge any local tasks.py file with global Conjuring tasks
• Use all global Conjuring tasks provided by this package
• Only include the global Conjuring tasks you want (opt-in mode)
• Use all Conjuring tasks excluding some (opt-out mode)
• Add your own custom tasks from Python modules or packages to global tasks
• Display your custom task modules conditionally
• Display your custom individual tasks conditionally
• Merge your project tasks with the global reusable tasks
• Prefix task names of your custom module

More details on the features documentation.

Tasks

Each module under the conjuring/spells directory is a collection of Invoke tasks.

Read more in Spells (API reference).

Quick setup

Install Conjuring in an isolated virtualenv with pipx:

pipx install --include-deps conjuring

The --include-deps flag is needed to install Invoke's apps (invoke and inv).

Run the command to configure files on your home directory:

# For more options:
# conjuring init --help
conjuring init

You should see the list of Conjuring tasks from any directory where you type this:

invoke --list

For more configuration options, read the detailed documentation.