Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
- API
  
  Reference documentation for the pkg.go.dev API
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

scheduler

package module

Go to main page

Versions in this module

v1

v1.0.2

May 4, 2026

v1.0.1

Apr 24, 2026

Changes in this version

+ type FileJobStore struct

+ func NewFileJobStore(path string) (*FileJobStore, error)

+ func (s *FileJobStore) Delete(_ context.Context, id string) error

+ func (s *FileJobStore) Get(_ context.Context, id string) (*Job, error)

+ func (s *FileJobStore) List(_ context.Context) ([]Job, error)

+ func (s *FileJobStore) Save(_ context.Context, job *Job) error

+ func (s *FileJobStore) UpdateState(_ context.Context, id string, state JobState) error

type Job

+ ScheduleExpression string

v1.0.0

Apr 22, 2026

Changes in this version

+ var ErrJobNotFound = errors.New("job not found")

+ func RetryBackoff(base time.Duration, attempt int) time.Duration

+ type Config struct

+ Executors map[string]JobExecutor

+ Logger *slog.Logger

+ MaxConcurrent int

+ PollInterval time.Duration

+ Store JobStore

+ type DeliveryService interface

+ Close func() error

+ Deliver func(ctx context.Context, result *JobResult) error

+ type InMemoryJobStore struct

+ func NewInMemoryJobStore() *InMemoryJobStore

+ func (s *InMemoryJobStore) Delete(_ context.Context, id string) error

+ func (s *InMemoryJobStore) Get(_ context.Context, id string) (*Job, error)

+ func (s *InMemoryJobStore) List(_ context.Context) ([]Job, error)

+ func (s *InMemoryJobStore) Save(_ context.Context, job *Job) error

+ func (s *InMemoryJobStore) UpdateState(_ context.Context, id string, state JobState) error

+ type Job struct

+ ChannelKey string

+ Config JobConfig

+ DeleteAfterRun bool

+ Enabled bool

+ ExecutorType string

+ ID string

+ Name string

+ Payload any

+ Prompt string

+ Schedule Schedule

+ ScheduleType string

+ Script string

+ State JobState

+ type JobConfig struct

+ MaxRetries int

+ RetryBackoff time.Duration

+ Timeout time.Duration

+ type JobExecutor interface

+ Execute func(ctx context.Context, job *Job) (*JobResult, error)

+ type JobResult struct

+ ChannelKey string

+ Duration time.Duration

+ Error string

+ Output string

+ Silent bool

+ Status JobStatus

+ type JobState struct

+ LastOutput string

+ LastRun time.Time

+ LastStatus JobStatus

+ NextRun time.Time

+ RunCount int

+ type JobStatus string

+ const StatusFailed

+ const StatusRetrying

+ const StatusSkipped

+ const StatusSuccess

+ type JobStore interface

+ Delete func(ctx context.Context, id string) error

+ Get func(ctx context.Context, id string) (*Job, error)

+ List func(ctx context.Context) ([]Job, error)

+ Save func(ctx context.Context, job *Job) error

+ UpdateState func(ctx context.Context, id string, state JobState) error

+ type MessageSender interface

+ Name func() string

+ Send func(ctx context.Context, target, text string) error

+ type Option func(*Scheduler)

+ func WithDelivery(svc DeliveryService) Option

+ func WithNowFunc(f func() time.Time) Option

+ type RouterDelivery struct

+ func NewRouterDelivery(senders map[string]MessageSender, scanner func(string) string) *RouterDelivery

+ func (r *RouterDelivery) Close() error

+ func (r *RouterDelivery) Deliver(ctx context.Context, result *JobResult) error

+ type Schedule interface

+ NextTick func(now time.Time) time.Time

+ Type func() string

+ func At(t time.Time) Schedule

+ func Cron(expr string) (Schedule, error)

+ func Every(interval time.Duration) Schedule

+ type Scheduler struct

+ func New(cfg Config, opts ...Option) *Scheduler

+ func (s *Scheduler) Start(ctx context.Context)

+ func (s *Scheduler) Stop()

+ func (s *Scheduler) Wake()