pardnchiu/go-scheduler

Last updated 2026-10-21

NoteThis README was generated by SKILL, get the ZH version from here.

SCHEDULE TASKS WITH DEPENDENCIES, TIMEOUTS, AND CRON EXPRESSIONS

A Go cron scheduler library with task dependency chains, execution timeouts, and graceful shutdown

Table of Contents

• Features
• Architecture
• License
• Author

Features

go get github.com/pardnchiu/go-scheduler@latest · Documentation

• Task Dependency Chains — Declare prerequisites with []Wait and choose Stop or Skip when a prerequisite fails.
• Timeouts and Callbacks — Cap each task's execution time; a timeout fires a callback and marks the task failed.
• Cron, Descriptors, and Intervals — Mix 5-field cron, descriptors such as @daily, and @every intervals.
• Min-Heap Event Loop — A min-heap tracks next fire times, so tasks can be added or removed while running.
• Graceful Shutdown — Stop returns a context that completes only after in-flight tasks finish.

Architecture

Full Architecture

graph TB

    App[Caller] --> Cron[Cron Scheduler]
    Cron --> Parser[Expression Parser]
    Cron --> Heap[Task Min-Heap]
    Heap --> Loop[Event Loop]
    Loop -->|no deps| Runner[Task Execution]
    Loop -->|has deps| Depend[Dependency Subsystem]
    Depend --> Workers[Worker Pool]
    Workers --> Runner
    Runner --> State[State Update]

graph TB
    App[Caller] --> Cron[Cron Scheduler]
    Cron --> Parser[Expression Parser]
    Cron --> Heap[Task Min-Heap]
    Heap --> Loop[Event Loop]
    Loop -->|no deps| Runner[Task Execution]
    Loop -->|has deps| Depend[Dependency Subsystem]
    Depend --> Workers[Worker Pool]
    Workers --> Runner
    Runner --> State[State Update]

License

Author