https://github.com/kanmu/qg

Yet Another Ruby Que implementation in Go
https://github.com/kanmu/qg

Last synced: 2 months ago
JSON representation

Yet Another Ruby Que implementation in Go

• Host: GitHub
• URL: https://github.com/kanmu/qg
• Owner: kanmu
• License: mit
• Created: 2016-05-27T01:25:02.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2024-10-03T11:45:47.000Z (3 months ago)
• Last Synced: 2024-10-04T06:41:27.152Z (3 months ago)
• Language: Go
• Homepage:
• Size: 110 KB
• Stars: 2
• Watchers: 19
• Forks: 4
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# qg

[![test](https://github.com/kanmu/qg/actions/workflows/test.yml/badge.svg)](https://github.com/kanmu/qg/actions/workflows/test.yml)

[![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)](https://raw.githubusercontent.com/achiku/qg/master/LICENSE)

[![Go Report Card](https://goreportcard.com/badge/github.com/kanmu/qg)](https://goreportcard.com/report/github.com/kanmu/qg)

Ruby [Que](https://github.com/chanks/que) implementation in Go. This library is almost a fork of [que-go](https://github.com/bgentry/que-go), the great work of [bgentry](https://github.com/bgentry).

## Why created

First of all, [Que](https://github.com/chanks/que), and it's Go port [que-go](https://github.com/bgentry/que-go) are really great libraries, which can simplify small to mid scale application with some sort of asynchronous tasks/jobs by avoiding to add another moving part if you are already using PostgreSQL as main RDBMS. However, as I use `que-go` to develop my application written in Go, there are some functionalities that `que-go` doesn't provide. The following is an list of functionalities I'm going to add to `qg`.

- `database/sql` compatible version of enqueue functions so that many other database libraries can work with it.

- Transaction can be injected to a `Job` to make `WorkFunc` tests much easier.

- Customizable `Job.Delete()`, `Job.Error()` to give more flexibility.

- Synchronous execution option in `Client.Enqueue` and `Client.EnqueueInTx` for easy development.

- Better logger interface to be able to switch whatever loggers developers want.

This library is still under heavy development, and might significantly change APIs.

## Test

```

docker compose up -d

make db

make table

make test

```

## Great Resources

- https://github.com/chanks/que/tree/master/docs

- https://brandur.org/postgres-queues