pico-scheduling 0.1.0

Scheduled method execution for the Pico ecosystem: @scheduled(every=...) and @scheduled(cron=...) on components.

pico-scheduling

Scheduled method execution for the pico ecosystem: @scheduled on component methods, powered by APScheduler.

Installation

pip install pico-scheduling

Auto-discovered by pico-boot; with plain pico-ioc add "pico_scheduling" to init(modules=[...]).

Quick start

from pico_ioc import component
from pico_scheduling import scheduled

@component
class Reports:
    @scheduled(every=300)          # every 5 minutes
    def refresh_cache(self): ...

    @scheduled(cron="0 3 * * *")   # 03:00 daily
    async def nightly_rollup(self): ...

Jobs start when the container starts and stop on container.shutdown(). Each run resolves the component through the container (prototype scope gives a fresh instance per run). A failing job is logged and does not stop the schedule. Sync and async methods both work.

Disable everything with config:

scheduling:
  enabled: false

Documentation

Full documentation: https://dperezcabrera.github.io/pico-scheduling/

License

MIT