Skip to content

wind-c/bqueue

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

bqueue Go Report Card Build Status GoDoc Reference

A high-performance batch queue to process items at time intervals or when a batching limit is met.
It is implemented using the go standard library and does not import any third-party libraries.

Features

  • Non-blocking enqueue
    Queue up incoming items without blocking processing.

  • Dispatching by periodic time intervals
    Set a time interval and get batched items after time expires.

  • Dispatching as soon as a batch limit is met
    If a batch is filled before the time interval is up, dispatching is handled immediately.

  • Supports channel and callback
    You can read the OutQueue channel to get batch items, or you can use callback function. See Examples for details.

  • Plain old Go channels
    Implementation relies heavily on channels and is free of mutexes and other bookkeeping techniques.

Install

$ go get -u github.com/wind-c/bqueue

Sample Usage

Dispatch a batch at 1 second intervals or as soon as a batching limit of 64 items is met, if the number of messages is large, increase MaxQueueSize. See examples/ for working code.

import ( "fmt" "log" "time" "github.com/wind-c/bqueue" ) // initialize b := bqueue.NewBatchQueue(&bqueue.Options{ Interval: time.Duration(1) * time.Second, MaxBatchItems: 64, MaxQueueSize: 1024, }) defer b.Stop() go b.Start() // produce some messages go func() { for i:= 0; i < 100; i++ { m := fmt.Sprintf("message #%d", i) b.Enqueue(m) } }() // consume the batch for { select { case batch := <-b.OutQueue: for _, item := range batch { s := item.(string) // do whatever. log.Print(s) } } }

Contribute

Improvements, fixes, and feedback are welcome.

Legal

MIT license.

About

Time driven non-blocking and high-performance batch queue

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages