summaryrefslogtreecommitdiff
path: root/internal/media/ffmpeg/runner.go
blob: 64ff6008cf4d5565066f89be28b3ed5774f725b7 (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
// GoToSocial
// Copyright (C) GoToSocial Authors admin@gotosocial.org
// SPDX-License-Identifier: AGPL-3.0-or-later
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with this program.  If not, see <http://www.gnu.org/licenses/>.

package ffmpeg

import (
	"context"
)

// runner simply abstracts away the complexities
// of limiting the number of concurrent running
// instances of a particular WebAssembly module.
type runner struct{ pool chan struct{} }

// Init initializes the runner to
// only allow 'n' concurrently running
// instances. Special cases include 0
// which clamps to 1, and < 0 which
// disables the limit alltogether.
func (r *runner) Init(n int) {

	// Reset pool.
	r.pool = nil

	// Clamp to 1.
	if n <= 0 {
		n = 1
	}

	// Allocate new pool channel.
	r.pool = make(chan struct{}, n)
	for i := 0; i < n; i++ {
		r.pool <- struct{}{}
	}
}

// Run will attempt to pass the given compiled WebAssembly module with args to run(), waiting on
// the receiving runner until a free slot is available to run an instance, (if a limit is enabled).
func (r *runner) Run(ctx context.Context, run func() (uint32, error)) (uint32, error) {
	select {
	// Context canceled.
	case <-ctx.Done():
		return 0, ctx.Err()

	// Slot acquired.
	case <-r.pool:
	}

	// Release slot back to pool on end.
	defer func() { r.pool <- struct{}{} }()

	// Call run.
	return run()
}