invoke-toolkit

A set of extensions for rich output, more options in collection/config discovery through entry-points.

This extends the Collection from Invoke so it can create automatically collections.

invoke-toolkit

Features

Task discovery by namespace for extendable/composable CLIs
Discovery to plain old tasks.py (or any other name)
Local tasks discovery from local_tasks.py in the current directory
Integration with stand alone binaries for specific tasks
Task result caching with TTL support via diskcache (optional)
Future Download binaries

Do I need this package

If you have...

Used invoke for a while and...
Have a large tasks.py that needs to be modularized
Have a lot of copy/pasted code in multiple tasks.py across multiple repos.
Have exceeded the approach of a repository cloned as ~/tasks/ with more .py files that you want to manage.
Or you want to combine various tasks defined in multiple directories
You want to create a zipped (shiv) redistribute script for container environments like Kubernetes based CI environments with only requiring the Python interpreter.

Installation

pip install invoke-toolkit

Quick Start

Using Local Tasks

Create a local_tasks.py file in your project directory with your tasks:

from invoke_toolkit import task

@task()
def my_task(ctx):
    """Do something useful"""
    print("Hello from local tasks!")

Then run it with:

intk local.my-task

Local tasks are automatically discovered and added to the local namespace, allowing you to keep project-specific tasks separate from your main task collection.

Using Task Caching

Cache expensive task results with the cache parameter:

from invoke_toolkit import task

# Simple caching (no expiration)
@task(cache=True)
def expensive_task(ctx, param: str) -> str:
    """Results are cached across invocations."""
    return do_expensive_computation(param)

# Caching with TTL (1 hour)
@task(cache={"ttl": 3600})
def cached_task(ctx, name: str) -> dict:
    """Results cached for 1 hour."""
    return fetch_data(name)

# Caching with ignored arguments
@task(cache={"ttl": 600, "ignore_args": ["verbose"]})
def cached_with_options(ctx, query: str, verbose: bool = False) -> list:
    """Cache key ignores verbose flag."""
    return search(query, verbose=verbose)

Cache features:

Cache location is computed from git repository root + platformdirs
Debug logging (-d flag) shows cache hits/misses
Graceful degradation when diskcache is not installed

To enable caching, install with the cache extra:

pip install invoke-toolkit[cache]

Development

This project utilizes the pre-commit framework, make sure you run:

pre-commit install

With uvx:

uvx --with pre-commit-uv pre-commit install

License

invoke-toolkit is distributed under the terms of the MIT license.

Download files

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

Source Distribution

invoke_toolkit-0.0.62.tar.gz (158.7 kB view details)

Uploaded Jul 7, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

invoke_toolkit-0.0.62-py3-none-any.whl (102.1 kB view details)

Uploaded Jul 7, 2026 Python 3

File details

Details for the file invoke_toolkit-0.0.62.tar.gz.

File metadata

Download URL: invoke_toolkit-0.0.62.tar.gz
Upload date: Jul 7, 2026
Size: 158.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for invoke_toolkit-0.0.62.tar.gz
Algorithm	Hash digest
SHA256	`e67ce3e33709aa1d2376ccbbb62dff45902ef5adf8029075562070aa867fa26e`
MD5	`1825321452e740110797648e1e78f561`
BLAKE2b-256	`d91cd2e03be99ebf4b9be757d7ff97fae24dccc7433be501bd9339172b07166b`

See more details on using hashes here.

Provenance

The following attestation bundles were made for invoke_toolkit-0.0.62.tar.gz:

Publisher: publish-releases.yaml on D3f0/invoke-toolkit

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: invoke_toolkit-0.0.62.tar.gz
- Subject digest: e67ce3e33709aa1d2376ccbbb62dff45902ef5adf8029075562070aa867fa26e
- Sigstore transparency entry: 2102916960
- Sigstore integration time: Jul 7, 2026
Source repository:
- Permalink: D3f0/invoke-toolkit@67bd300ada893fe7c6484a15a7a97976bdaf52e0
- Branch / Tag: refs/tags/v0.0.62
- Owner: https://github.com/D3f0
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-releases.yaml@67bd300ada893fe7c6484a15a7a97976bdaf52e0
- Trigger Event: release