Skip to content

jrallison/go-workers

Folders and files

NameName
Last commit message
Last commit date
Nov 28, 2016
Aug 28, 2013
Dec 2, 2016
Feb 12, 2016
May 3, 2015
May 3, 2015
May 12, 2015
May 6, 2015
Sep 24, 2014
Jan 12, 2018
Feb 16, 2016
Mar 13, 2014
Feb 12, 2016
Jan 12, 2018
Mar 13, 2014
Dec 2, 2016
May 6, 2015
Sep 6, 2014
Sep 6, 2014
Sep 6, 2014
Mar 13, 2014
Jul 20, 2013
Jul 19, 2013
Jun 13, 2015
May 12, 2015
May 9, 2014
May 9, 2014
Dec 2, 2016
Feb 28, 2016
Mar 13, 2014
Feb 16, 2016
Nov 3, 2014
Feb 16, 2016

Repository files navigation

Build Status GoDoc

Sidekiq compatible background workers in golang.

  • reliable queueing for all queues using brpoplpush
  • handles retries
  • support custom middleware
  • customize concurrency per queue
  • responds to Unix signals to safely wait for jobs to finish before exiting.
  • provides stats on what jobs are currently running
  • well tested

Example usage:

package main

import (
	"github.com/jrallison/go-workers"
)

func myJob(message *workers.Msg) {
  // do something with your message
  // message.Jid()
  // message.Args() is a wrapper around go-simplejson (http://godoc.org/github.com/bitly/go-simplejson)
}

type myMiddleware struct{}

func (r *myMiddleware) Call(queue string, message *workers.Msg, next func() bool) (acknowledge bool) {
  // do something before each message is processed
  acknowledge = next()
  // do something after each message is processed
  return
} 

func main() {
  workers.Configure(map[string]string{
    // location of redis instance
    "server":  "localhost:6379",
    // instance of the database
    "database":  "0",
    // number of connections to keep open with redis
    "pool":    "30",
    // unique process id for this instance of workers (for proper recovery of inprogress jobs on crash)
    "process": "1",
  })

  workers.Middleware.Append(&myMiddleware{})

  // pull messages from "myqueue" with concurrency of 10
  workers.Process("myqueue", myJob, 10)

  // pull messages from "myqueue2" with concurrency of 20
  workers.Process("myqueue2", myJob, 20)

  // Add a job to a queue
  workers.Enqueue("myqueue3", "Add", []int{1, 2})

  // Add a job to a queue with retry
  workers.EnqueueWithOptions("myqueue3", "Add", []int{1, 2}, workers.EnqueueOptions{Retry: true})

  // stats will be available at http://localhost:8080/stats
  go workers.StatsServer(8080)

  // Blocks until process is told to exit via unix signal
  workers.Run()
}

Initial development sponsored by Customer.io

About

Sidekiq compatible background workers in golang

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages