Versions in this module Expand all Collapse all v0 v0.1.0 Aug 20, 2026 Changes in this version + const LogLevelError + const LogLevelInfo + const LogLevelWarn + var ErrDuplicateTask = errors.New("queue: duplicate task") + var ErrQueueClosed = errors.New("queue: closed") + var ErrQueueEmpty = errors.New("queue: empty") + var ErrTaskNotFound = errors.New("queue: task not found") + func DecodePayload[T any](task *Task) (T, error) + func EncodePayload(v any) (json.RawMessage, error) + type CapacityScheduler struct + func NewCapacityScheduler(cfg CapacitySchedulerConfig) (*CapacityScheduler, error) + func (s *CapacityScheduler) AppendLog(ctx context.Context, entry *TaskLogEntry) error + func (s *CapacityScheduler) ListLogs(ctx context.Context, taskID string, limit int) ([]*TaskLogEntry, error) + func (s *CapacityScheduler) Position(ctx context.Context, taskID string) (int, error) + func (s *CapacityScheduler) Start() error + func (s *CapacityScheduler) Stats() CapacitySchedulerStats + func (s *CapacityScheduler) Stop() error + func (s *CapacityScheduler) UpdateProgress(ctx context.Context, taskID string, progress int) error + type CapacitySchedulerConfig struct + AgingThreshold time.Duration + Capacity int + DequeueTimeout time.Duration + EnablePreemption bool + Handler Handler + OnPreempt func(task *Task) + OnRecover func(count int) + OnTaskComplete func(task *Task, err error) + OnTaskStart func(task *Task) + Queue Queue + RichHandler RichHandler + Strategy SchedulingStrategy + WorkerCount int + WorkerPool *pool.WorkerPool + type CapacitySchedulerMetrics struct + CapacityFull atomic.Int64 + Dispatched atomic.Int64 + Failed atomic.Int64 + Preempted atomic.Int64 + Recovered atomic.Int64 + Retried atomic.Int64 + Succeeded atomic.Int64 + type CapacitySchedulerStats struct + ActiveJobs int + Capacity int + CapacityFull int64 + Dispatched int64 + Failed int64 + Pending int + Preempted int64 + Recovered int64 + Retried int64 + Running int + Strategy string + Succeeded int64 + UsedWeight int + Workers int + type Handler func(ctx context.Context, task *Task) error + type Queue interface + Ack func(ctx context.Context, taskID string, status TaskStatus, errMsg string) error + AppendLog func(ctx context.Context, entry *TaskLogEntry) error + Cancel func(ctx context.Context, taskID string) error + Close func() error + Dequeue func(ctx context.Context, timeout time.Duration) (*Task, error) + Enqueue func(ctx context.Context, task *Task) error + Get func(ctx context.Context, taskID string) (*Task, error) + ListLogs func(ctx context.Context, taskID string, limit int) ([]*TaskLogEntry, error) + Name func() string + Position func(ctx context.Context, taskID string) (int, error) + Recover func(ctx context.Context) ([]*Task, error) + Requeue func(ctx context.Context, taskID string) error + Stats func(ctx context.Context) (QueueStats, error) + UpdateProgress func(ctx context.Context, taskID string, progress int) error + type QueueStats struct + Completed int64 + Failed int64 + Pending int64 + Queue string + Running int64 + Total int64 + type RichHandler func(tctx TaskContext, task *Task) error + type Scheduler struct + func NewScheduler(cfg SchedulerConfig) (*Scheduler, error) + func (s *Scheduler) Start() error + func (s *Scheduler) Stats() SchedulerStats + func (s *Scheduler) Stop() error + type SchedulerConfig struct + CPUCheckInterval time.Duration + CPUHighThreshold float64 + CPULowThreshold float64 + DequeueTimeout time.Duration + Handler Handler + MaxWorkers int + MinWorkers int + Mode SchedulingMode + OnRecover func(count int) + OnTaskComplete func(task *Task, err error) + OnTaskStart func(task *Task) + Queue Queue + WorkerCount int + WorkerPool *pool.WorkerPool + type SchedulerMetrics struct + Dequeued atomic.Int64 + Failed atomic.Int64 + Recovered atomic.Int64 + Retried atomic.Int64 + Succeeded atomic.Int64 + type SchedulerStats struct + CPUUsage float64 + Dequeued int64 + Failed int64 + Recovered int64 + Retried int64 + Running int + Succeeded int64 + Workers int + type SchedulingMode int + const ModeCPUAdaptive + const ModeFixedPool + type SchedulingStrategy int + const StrategyFIFO + const StrategyPreemptive + const StrategyPriority + const StrategyWeightedFair + func (s SchedulingStrategy) String() string + type Task struct + ErrorMsg string + FinishedAt *time.Time + ID string + JobID string + Kind string + MaxRetries int + Payload json.RawMessage + Preemptible bool + Priority int + Progress int + Queue string + RetryCount int + StartedAt *time.Time + Status TaskStatus + SubmitTime time.Time + Weight int + WorkerID string + type TaskContext interface + Log func(level string, message string) error + SetProgress func(progress int) error + Task func() *Task + type TaskLogEntry struct + Level string + Message string + TaskID string + Timestamp time.Time + type TaskResult struct + Elapsed time.Duration + Error error + Status TaskStatus + TaskID string + type TaskStatus string + const StatusCanceled + const StatusFailed + const StatusPending + const StatusRetry + const StatusRunning + const StatusSuccess + func (s TaskStatus) IsTerminal() bool + func (s TaskStatus) String() string