chore: add a helper method for string conversion

Author: jstrachan

scm/const.go

@@ -6,6 +6,7 @@ package scm
 
 import (
 	"encoding/json"
+	"strings"
 )
 
 // State represents the commit state.
@@ -47,6 +48,28 @@ func (s State) String() string {
 	}
 }
 
+// ToState converts the given text to a state
+func ToState(s string) State {
+	switch strings.ToLower(s) {
+	case "pending":
+		return StatePending
+	case "running":
+		return StateRunning
+	case "success":
+		return StateSuccess
+	case "failure":
+		return StateFailure
+	case "cancelled":
+		return StateCanceled
+	case "expected":
+		return StateExpected
+	case "error":
+		return StateError
+	default:
+		return StateUnknown
+	}
+}
+
 // Action identifies webhook actions.
 type Action int