https://github.com/roylee0704/gron
gron, Cron Jobs in Go.
https://github.com/roylee0704/gron
cron-jobs golang scheduling
Last synced: 6 months ago
JSON representation
gron, Cron Jobs in Go.
- Host: GitHub
- URL: https://github.com/roylee0704/gron
- Owner: roylee0704
- License: mit
- Created: 2016-06-04T08:02:22.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2023-05-05T07:44:19.000Z (over 2 years ago)
- Last Synced: 2025-04-08T19:25:42.798Z (8 months ago)
- Topics: cron-jobs, golang, scheduling
- Language: Go
- Homepage:
- Size: 49.8 KB
- Stars: 1,036
- Watchers: 15
- Forks: 64
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-golang - gron
- awesome-go-cn - gron
- awesome-go - gron - gron, Cron Jobs in Go. - ★ 530 (Utilities)
- awesome-go-cn - gron - based tasks using a simple Go API and Gron’s scheduler will run them accordingly.) (实用工具 / Advanced Console UIs)
- awesome-go-plus - gron - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly.  (Job Scheduler / Search and Analytic Databases)
- awesome-go - gron - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly. - :arrow_down:7 - :star:442 (Job Scheduler / Advanced Console UIs)
- awesome-go - gron - based tasks using a simple Go API and Gron’s scheduler will run them accordingly. | - | - | - | (Job Scheduler / Advanced Console UIs)
- awesome-go - gron - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly. (Job Scheduler / Search and Analytic Databases)
- awesome-go-zh - gron
- awesome-go - gron - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly. Stars:`1.0K`. (Job Scheduler / Search and Analytic Databases)
- awesome-go - gron - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly. (Job Scheduler / Search and Analytic Databases)
- awesome-go - gron - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly. (Job Scheduler / Search and Analytic Databases)
- awesome-go-with-stars - gron - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly. (Job Scheduler / Search and Analytic Databases)
- awesome-go - gron - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly. (Job Scheduler / Search and Analytic Databases)
- fucking-awesome-go - gron - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly. (Job Scheduler / Search and Analytic Databases)
- awesome-Char - gron - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly. (Job Scheduler / Advanced Console UIs)
- awesome-go-cn - gron
- awesome-go - gron - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly. (Job Scheduler / Advanced Console UIs)
- awesome-go-cn - gron
- awesome-go-extra - gron - 06-04T08:02:22Z|2021-01-14T08:44:12Z| (Job Scheduler / Advanced Console UIs)
- awesome-go - gron - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly. (Job Scheduler / Search and Analytic Databases)
- awesome-go - gron - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly. (Utilities / <span id="高级控制台用户界面-advanced-console-uis">高级控制台用户界面 Advanced Console UIs</span>)
- awesome-go - gron - Define time-based tasks using a simple Go API and Gron’s scheduler will run them accordingly. (Utilities / Advanced Console UIs)
README
# gron
[](https://semaphoreci.com/roylee0704/gron)
[](https://goreportcard.com/report/github.com/roylee0704/gron)
[](https://godoc.org/github.com/roylee0704/gron)
Gron provides a clear syntax for writing and deploying cron jobs.
## Goals
- Minimalist APIs for scheduling jobs.
- Thread safety.
- Customizable Job Type.
- Customizable Schedule.
## Installation
```sh
$ go get github.com/roylee0704/gron
```
## Usage
Create `schedule.go`
```go
package main
import (
"fmt"
"time"
"github.com/roylee0704/gron"
)
func main() {
c := gron.New()
c.AddFunc(gron.Every(1*time.Hour), func() {
fmt.Println("runs every hour.")
})
c.Start()
}
```
#### Schedule Parameters
All scheduling is done in the machine's local time zone (as provided by the Go [time package](http://www.golang.org/pkg/time)).
Setup basic periodic schedule with `gron.Every()`.
```go
gron.Every(1*time.Second)
gron.Every(1*time.Minute)
gron.Every(1*time.Hour)
```
Also support `Day`, `Week` by importing `gron/xtime`:
```go
import "github.com/roylee0704/gron/xtime"
gron.Every(1 * xtime.Day)
gron.Every(1 * xtime.Week)
```
Schedule to run at specific time with `.At(hh:mm)`
```go
gron.Every(30 * xtime.Day).At("00:00")
gron.Every(1 * xtime.Week).At("23:59")
```
#### Custom Job Type
You may define custom job types by implementing `gron.Job` interface: `Run()`.
For example:
```go
type Reminder struct {
Msg string
}
func (r Reminder) Run() {
fmt.Println(r.Msg)
}
```
After job has defined, instantiate it and schedule to run in Gron.
```go
c := gron.New()
r := Reminder{ "Feed the baby!" }
c.Add(gron.Every(8*time.Hour), r)
c.Start()
```
#### Custom Job Func
You may register `Funcs` to be executed on a given schedule. Gron will run them in their own goroutines, asynchronously.
```go
c := gron.New()
c.AddFunc(gron.Every(1*time.Second), func() {
fmt.Println("runs every second")
})
c.Start()
```
#### Custom Schedule
Schedule is the interface that wraps the basic `Next` method: `Next(p time.Duration) time.Time`
In `gron`, the interface value `Schedule` has the following concrete types:
- **periodicSchedule**. adds time instant t to underlying period p.
- **atSchedule**. reoccurs every period p, at time components(hh:mm).
For more info, checkout `schedule.go`.
### Full Example
```go
package main
import (
"fmt"
"github.com/roylee0704/gron"
"github.com/roylee0704/gron/xtime"
)
type PrintJob struct{ Msg string }
func (p PrintJob) Run() {
fmt.Println(p.Msg)
}
func main() {
var (
// schedules
daily = gron.Every(1 * xtime.Day)
weekly = gron.Every(1 * xtime.Week)
monthly = gron.Every(30 * xtime.Day)
yearly = gron.Every(365 * xtime.Day)
// contrived jobs
purgeTask = func() { fmt.Println("purge aged records") }
printFoo = printJob{"Foo"}
printBar = printJob{"Bar"}
)
c := gron.New()
c.Add(daily.At("12:30"), printFoo)
c.AddFunc(weekly, func() { fmt.Println("Every week") })
c.Start()
// Jobs may also be added to a running Gron
c.Add(monthly, printBar)
c.AddFunc(yearly, purgeTask)
// Stop Gron (running jobs are not halted).
c.Stop()
}
```