summaryrefslogtreecommitdiff
path: root/internal/worker/workers.go
blob: d3d6197eddcfc609fa91532e438cedb7a1f391a4 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
package worker

import (
	"context"
	"errors"
	"runtime"

	"codeberg.org/gruf/go-runners"
	"github.com/sirupsen/logrus"
)

// Worker represents a proccessor for MsgType objects, using a worker pool to allocate resources.
type Worker[MsgType any] struct {
	workers runners.WorkerPool
	process func(context.Context, MsgType) error
}

// New returns a new Worker[MsgType] with given number of workers and queue size
// (see runners.WorkerPool for more information on args). If args < 1 then suitable
// defaults are determined from the runtime's GOMAXPROCS variable.
func New[MsgType any](workers int, queue int) *Worker[MsgType] {
	if workers < 1 {
		workers = runtime.GOMAXPROCS(0)
	}
	if queue < 1 {
		queue = workers * 100
	}
	return &Worker[MsgType]{
		workers: runners.NewWorkerPool(workers, queue),
		process: nil,
	}
}

// Start will attempt to start the underlying worker pool, or return error.
func (w *Worker[MsgType]) Start() error {
	if w.process == nil {
		return errors.New("nil Worker.process function")
	}
	if !w.workers.Start() {
		return errors.New("failed to start Worker pool")
	}
	return nil
}

// Stop will attempt to stop the underlying worker pool, or return error.
func (w *Worker[MsgType]) Stop() error {
	if !w.workers.Stop() {
		return errors.New("failed to stop Worker pool")
	}
	return nil
}

// SetProcessor will set the Worker's processor function, which is called for each queued message.
func (w *Worker[MsgType]) SetProcessor(fn func(context.Context, MsgType) error) {
	if w.process != nil {
		logrus.Panic("Worker.process is already set")
	}
	w.process = fn
}

// Queue will queue provided message to be processed with there's a free worker.
func (w *Worker[MsgType]) Queue(msg MsgType) {
	logrus.Tracef("queueing %[1]T message; %+[1]v", msg)
	w.workers.Enqueue(func(ctx context.Context) {
		if err := w.process(ctx, msg); err != nil {
			logrus.Error(err)
		}
	})
}