106 lines
2.9 KiB
Go
106 lines
2.9 KiB
Go
package workintake
|
|
|
|
import (
|
|
"errors"
|
|
"fmt"
|
|
"strings"
|
|
)
|
|
|
|
// Task subjects. Each encodes the routing kind so a multi-daemon deployment
|
|
// can filter by the work it wants.
|
|
const (
|
|
SubjectTaskBug = "archie.task.bug"
|
|
SubjectTaskFeature = "archie.task.feature"
|
|
SubjectTaskBootstrap = "archie.task.bootstrap"
|
|
SubjectTaskDefault = "archie.task.default"
|
|
|
|
// SubjectTaskWildcard matches every task subject.
|
|
SubjectTaskWildcard = "archie.task.>"
|
|
)
|
|
|
|
// SubjectReactionWildcard matches every reaction subject.
|
|
const SubjectReactionWildcard = "archie.reaction.>"
|
|
|
|
// ErrUnknownKind reports a kind with no subject. Routing it to the default
|
|
// queue instead would silently misdeliver work.
|
|
var ErrUnknownKind = errors.New("workintake: unknown task kind")
|
|
|
|
// Kind is the routing category an issue's labels select.
|
|
type Kind string
|
|
|
|
const (
|
|
KindBug Kind = "bug"
|
|
KindFeature Kind = "feature"
|
|
KindBootstrap Kind = "bootstrap"
|
|
|
|
// KindDefault routes issues carrying no recognised label.
|
|
KindDefault Kind = "default"
|
|
)
|
|
|
|
// labelKinds maps a forge issue label to its routing kind. This is the one
|
|
// place the label vocabulary is defined.
|
|
var labelKinds = map[string]Kind{
|
|
"bug": KindBug,
|
|
"feature": KindFeature,
|
|
"bootstrap": KindBootstrap,
|
|
}
|
|
|
|
// kindSubjects is the closed set of routable kinds.
|
|
var kindSubjects = map[Kind]string{
|
|
KindBug: SubjectTaskBug,
|
|
KindFeature: SubjectTaskFeature,
|
|
KindBootstrap: SubjectTaskBootstrap,
|
|
KindDefault: SubjectTaskDefault,
|
|
}
|
|
|
|
// Validate reports whether the kind is routable. The zero kind is accepted
|
|
// and means KindDefault, so a caller that does not classify still publishes.
|
|
func (k Kind) Validate() error {
|
|
if k == "" {
|
|
return nil
|
|
}
|
|
if _, ok := kindSubjects[k]; !ok {
|
|
return fmt.Errorf("%w: %q", ErrUnknownKind, string(k))
|
|
}
|
|
return nil
|
|
}
|
|
|
|
// SubjectForKind renders a kind as its task subject. The zero and any
|
|
// unrecognised kind render as SubjectTaskDefault so a message is never
|
|
// addressed to an unroutable subject; publishers validate first.
|
|
func SubjectForKind(kind Kind) string {
|
|
if subject, ok := kindSubjects[kind]; ok {
|
|
return subject
|
|
}
|
|
return SubjectTaskDefault
|
|
}
|
|
|
|
// KindForLabels returns the routing kind for a set of issue labels. The first
|
|
// recognised label wins; an empty or unrecognised set is KindDefault.
|
|
func KindForLabels(labels []string) Kind {
|
|
for _, kind := range KindsForLabels(labels) {
|
|
return kind
|
|
}
|
|
return KindDefault
|
|
}
|
|
|
|
// KindsForLabels returns every recognised kind, in label order.
|
|
func KindsForLabels(labels []string) []Kind {
|
|
var kinds []Kind
|
|
for _, label := range labels {
|
|
if kind, ok := labelKinds[labelValue(label)]; ok {
|
|
kinds = append(kinds, kind)
|
|
}
|
|
}
|
|
return kinds
|
|
}
|
|
|
|
// labelValue returns the part of a label after its last "::".
|
|
func labelValue(label string) string {
|
|
trimmed := strings.TrimSpace(label)
|
|
if i := strings.LastIndex(trimmed, "::"); i >= 0 {
|
|
return strings.TrimSpace(trimmed[i+len("::"):])
|
|
}
|
|
return trimmed
|
|
}
|