https://github.com/ef2k/tempo

The time driven batch queue
https://github.com/ef2k/tempo

batch-processing go golang queue

Last synced: 11 months ago
JSON representation

The time driven batch queue

• Host: GitHub
• URL: https://github.com/ef2k/tempo
• Owner: ef2k
• License: mit
• Created: 2018-05-02T21:09:25.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2018-05-06T18:22:16.000Z (about 8 years ago)
• Last Synced: 2025-06-01T07:52:18.582Z (about 1 year ago)
• Topics: batch-processing, go, golang, queue
• Language: Go
• Homepage:
• Size: 743 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
`tempo` [![Go Report Card](https://goreportcard.com/badge/github.com/ef2k/tempo)](https://goreportcard.com/report/github.com/ef2k/tempo) [![Build Status](https://travis-ci.org/ef2k/tempo.svg?branch=master)](https://travis-ci.org/ef2k/tempo) [![GoDoc Reference](https://img.shields.io/badge/godoc-reference-blue.svg)](https://godoc.org/github.com/ef2k/tempo)

=======

A dispatched batch queue to process items at time intervals or when a batching limit is met.

## 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.

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

![3s demo](./examples/basic-3s-interval/tempo-3s.gif)

## Install

```sh

$ dep ensure -add github.com/ef2k/tempo

```

## Documentation

https://godoc.org/github.com/ef2k/tempo

## Sample Usage

Dispatch a batch at 10 second intervals or as soon as a batching limit of 50 items is met.

See `examples/` for working code.

```go

// initialize

d := tempo.NewDispatcher(&tempo.Config{

  Interval:      time.Duration(10) * time.Second,

  MaxBatchItems: 50,

})

defer d.Stop()

go d.Start()

// produce some messages

go func() {

  for i:= 0; i < 100; i++ {

    m := fmt.Sprintf("message #%d", i)

    d.Q<-m

  }

}()

// consume the batch

for {

  select {

    case batch := <-d.Batch:

      for _, b := range batch {

        s := b.(string)

        // do whatever.

        log.Print(s)

      }

  }

}

```

## Contribute

Improvements, fixes, and feedback are welcome.

## Legal

MIT license.