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
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
|
package store
import "lindenii.org/go/furgit/object/id"
// Batch stages reference operations for one non-atomic apply.
//
// Unlike Transaction,
// Batch may reject some queued operations
// while still applying others successfully when Apply runs.
//
// Labels: MT-Unsafe.
type Batch interface {
// Create creates one direct reference,
// requiring that the logical reference does not already exist.
Create(name string, newID id.ObjectID) error
// Update updates one direct reference,
// requiring that the current logical reference value matches oldID.
Update(name string, newID, oldID id.ObjectID) error
// Delete deletes one direct reference,
// requiring that the current logical reference value matches oldID.
Delete(name string, oldID id.ObjectID) error
// Verify verifies that the current logical reference value matches oldID.
Verify(name string, oldID id.ObjectID) error
// CreateSymbolic creates one symbolic reference,
// requiring that the named reference does not already exist.
CreateSymbolic(name, newTarget string) error
// UpdateSymbolic updates one symbolic reference directly,
// requiring that its current target matches oldTarget.
UpdateSymbolic(name, newTarget, oldTarget string) error
// DeleteSymbolic deletes one symbolic reference directly,
// requiring that its current target matches oldTarget.
DeleteSymbolic(name, oldTarget string) error
// VerifySymbolic verifies that the named symbolic reference
// currently points at oldTarget.
VerifySymbolic(name, oldTarget string) error
// Apply validates and applies queued operations,
// returning one result per queued operation in order.
// Fatal backend failures are returned separately.
//
// Malformed operations are rejected by the queueing methods above
// and do not enter the batch.
//
// Apply invalidates the receiver.
Apply() ([]BatchResult, error)
// Abort abandons the batch and releases any resources it holds.
//
// Abort invalidates the receiver.
Abort() error
}
// BatchStatus reports the outcome for one queued batch operation.
type BatchStatus uint8
const (
// BatchStatusApplied indicates that the operation was applied.
BatchStatusApplied BatchStatus = iota
// BatchStatusRejected indicates that the operation was rejected
// without aborting the rest of the batch.
BatchStatusRejected
// BatchStatusFatal indicates that the operation triggered a fatal failure.
BatchStatusFatal
// BatchStatusNotAttempted indicates that the operation was not attempted
// because an earlier operation failed fatally.
BatchStatusNotAttempted
)
// BatchResult reports the outcome for one queued batch operation.
type BatchResult struct {
Name string
Status BatchStatus
Error error //exhaustruct:optional
}
|
