evoid-tasks

Background tasks with lifecycle — Intent Handler system

Quick Start • Intent Handler • Lifecycle • API

Quick Start

uv add evoid-tasks

Method 1: Intent Handler (Recommended)

from evoid_tasks import register_handlers

# Register task scheduler as Intent handlers
register_handlers(max_concurrent=10)

Method 2: Direct API

from evoid_tasks import scheduler

# Fire and forget
scheduler.run(send_email, to="alice@example.com")

# Periodic tasks
@scheduler.task(interval=60)
async def cleanup(ctx):
    await delete_old_sessions()

Intent Handler

evoid-tasks registers task scheduling as Intent handlers.

Lifecycle (Godot-inspired)

from evoid_tasks import scheduler, TaskContext

@scheduler.task(interval=10)
async def my_task(ctx: TaskContext):
    # on_start — called once
    print(f"Task {ctx.task_name} started")

    # on_tick — called every interval
    print(f"Tick {ctx.tick}, delta={ctx.delta}")

    # on_stop — called on cancellation
    # on_error — called on exception

Configuration

TOML

[engines]
tasks = "tasks"

[engines.options.tasks]
max_concurrent = 10

API

register_handlers(max_concurrent: int = 10)

Register task scheduler as Intent handlers.

Scheduler Methods

DI Integration

All plugins register with evoid-di for automatic service discovery and fault tolerance.

from evoid_di import di

# Resolve with fallback
storage = di.resolve_with_fallback("storage.postgresql")
# Tries: postgresql → sqlite → redis → cluster peers → None

Dependencies

• evoid>=0.4.0

Links

• EVOID Runtime
• Documentation
• Plugin Collection

License

MIT