syncutil Package¶
import "github.com/Educentr/go-iproto/syncutil"
Full API reference: pkg.go.dev
TaskGroup¶
Execute up to N concurrent tasks. Reuses slots as tasks complete.
type TaskGroup struct {
N int // Max concurrent tasks (default 1)
Goer GoerFn // Custom goroutine launcher (optional)
}
Methods:
| Method | Description |
|---|---|
Do(ctx, n, task) []<-chan error |
Start up to n tasks; returns result channels |
Cancel() |
Cancel all running tasks |
Example¶
tg := &syncutil.TaskGroup{N: 4}
results := tg.Do(ctx, 4, func(ctx context.Context, i int) error {
// task i runs concurrently
return nil
})
for _, ch := range results {
if err := <-ch; err != nil {
log.Fatal(err)
}
}
TaskRunner¶
Run exactly one task at a time. Multiple callers subscribe to the same result.
Methods:
| Method | Description |
|---|---|
Do(ctx, task) <-chan error |
Start task (or subscribe if already running) |
Cancel() |
Cancel current task |
Example¶
var runner syncutil.TaskRunner
// Both goroutines receive the same result.
ch1 := runner.Do(ctx, func(ctx context.Context) error {
return expensiveOperation(ctx)
})
ch2 := runner.Do(ctx, func(ctx context.Context) error {
return expensiveOperation(ctx) // not started — subscribes to existing
})
err1 := <-ch1
err2 := <-ch2 // same value as err1
Throttle¶
Limit function execution to at most once per time period.
Methods:
| Method | Description |
|---|---|
Next() bool |
Returns true if the period has elapsed |
Reset() |
Clear the throttle |
Set(time.Time) |
Set specific throttle time |
Multitask¶
Run N tasks in parallel with cancellation support.
type Multitask struct {
ContinueOnError bool // Don't cancel others on Goer failure
Goer GoerFn // Custom goroutine launcher
}
Methods:
| Method | Description |
|---|---|
Do(ctx, n, actor) error |
Run actor n times in parallel |