feat: add Pushover notification support

Add Pushover alert integration to enable task status notifications through the Pushover service. This includes configuration options in the interactive setup, alert sending functionality, and template support for customized alert messages. The implementation follows the existing pattern used for other notification providers like Gotify and Microsoft Teams

Author: dguerri

cli/setup/setup.go

@@ -170,6 +170,12 @@ func InteractiveSetup(conf *util.ConfigType) {
 		askValue("Microsoft Teams Webhook URL", "", &conf.MicrosoftTeamsUrl)
 	}
 
+	askConfirmation("Enable Pushover alerts?", false, &conf.PushoverAlert)
+	if conf.PushoverAlert {
+		askValue("Pushover User KEY", "", &conf.PushoverUserKey)
+		askValue("Pushover Token", "", &conf.PushoverToken)
+	}
+
 	askConfirmation("Enable LDAP authentication?", false, &conf.LdapEnable)
 	if conf.LdapEnable {
 		conf.LdapMappings = &util.LdapMappings{}

services/tasks/TaskRunner_logging.go

@@ -128,6 +128,7 @@ func (t *TaskRunner) SetStatus(status task_logger.TaskStatus) {
 		t.sendMicrosoftTeamsAlert()
 		t.sendDingTalkAlert()
 		t.sendGotifyAlert()
+		t.sendPushoverAlert()
 	}
 
 	for _, l := range t.statusListeners {

services/tasks/alert.go

@@ -32,6 +32,7 @@ type alertTask struct {
 	Result  string
 	Desc    string
 	Version string
+	Status  string
 }
 
 type alertChat struct {
@@ -504,6 +505,73 @@ func (t *TaskRunner) sendGotifyAlert() {
 	}
 }
 
+func (t *TaskRunner) sendPushoverAlert() {
+	if !util.Config.PushoverAlert || !t.alert {
+		return
+	}
+
+	if t.Template.SuppressSuccessAlerts && t.Task.Status == task_logger.TaskSuccessStatus {
+		return
+	}
+
+	body := bytes.NewBufferString("")
+	author, version := t.alertInfos()
+
+	alert := Alert{
+		Name:   t.Template.Name,
+		Author: author,
+		Color:  t.alertColor("pushover"),
+		Task: alertTask{
+			ID:      strconv.Itoa(t.Task.ID),
+			URL:     t.taskLink(),
+			Result:  t.Task.Status.Format(),
+			Version: version,
+			Desc:    t.Task.Message,
+			Status:  string(t.Task.Status),
+		},
+	}
+
+	tpl, err := template.ParseFS(templates, "templates/pushover.tmpl")
+
+	if err != nil {
+		t.Log("Can't parse pushover alert template!")
+		panic(err)
+	}
+
+	if err := tpl.Execute(body, alert); err != nil {
+		t.Log("Can't generate pushover alert template!")
+		panic(err)
+	}
+
+	if body.Len() == 0 {
+		t.Log("Buffer for pushover alert is empty")
+		return
+	}
+
+	t.Log("Attempting to send pushover alert")
+
+	resp, err := http.Post(
+		fmt.Sprintf(
+			"https://api.pushover.net/1/messages.json?user=%s&token=%s",
+			util.Config.PushoverUserKey,
+			util.Config.PushoverToken),
+		"application/json",
+		body,
+	)
+
+	if err != nil {
+		t.Log("Can't send pushover alert! Error: " + err.Error())
+	} else if resp.StatusCode != 200 {
+		t.Log("Can't send pushover alert! Response code: " + strconv.Itoa(resp.StatusCode))
+	} else {
+		t.Log("Sent successfully pushover alert")
+	}
+
+	if resp != nil {
+		defer resp.Body.Close() //nolint:errcheck
+	}
+}
+
 func (t *TaskRunner) alertInfos() (string, string) {
 	version := ""
 
@@ -552,7 +620,7 @@ func (t *TaskRunner) alertColor(kind string) string {
 		case task_logger.TaskStoppedStatus:
 			return "#5B5B5B"
 		}
-	case "rocketchat":
+	case "rocketchat", "pushover":
 		switch t.Task.Status {
 		case task_logger.TaskSuccessStatus:
 			return "#00EE00"

services/tasks/alert_test_sender.go

@@ -46,6 +46,7 @@ func SendProjectTestAlerts(project db.Project, store db.Store) (err error) {
 	tr.sendMicrosoftTeamsAlert()
 	tr.sendDingTalkAlert()
 	tr.sendGotifyAlert()
+	tr.sendPushoverAlert()
 	tr.sendMailAlert()
 
 	return

services/tasks/templates/pushover.tmpl

@@ -0,0 +1,8 @@
+{
+  "html": 1,
+  "priority": {{ if eq .Task.Status "error" }}1{{ else }}0{{ end }},
+  "title": "Task: {{ .Name }}",
+  "message": "Execution #: {{ .Task.ID }}\n<font color=\"{{ .Color }}\"><b>{{ .Task.Result }}</b></font>\n{{ if .Task.Version }}Version: {{ .Task.Version }}\n{{ end }}\nDescription: {{ .Task.Desc }}\nAuthor: {{ .Author }}",
+  "url": "{{ .Task.URL }}",
+  "url_title": "Task URL"
+}

util/config.go

@@ -287,6 +287,9 @@ type ConfigType struct {
 	GotifyAlert         bool   `json:"gotify_alert,omitempty" env:"SEMAPHORE_GOTIFY_ALERT"`
 	GotifyUrl           string `json:"gotify_url,omitempty" env:"SEMAPHORE_GOTIFY_URL"`
 	GotifyToken         string `json:"gotify_token,omitempty" env:"SEMAPHORE_GOTIFY_TOKEN"`
+	PushoverAlert       bool   `json:"pushover_alert,omitempty" env:"SEMAPHORE_PUSHOVER_ALERT"`
+	PushoverUserKey     string `json:"pushover_user_key,omitempty" env:"SEMAPHORE_PUSHOVER_USER_KEY"`
+	PushoverToken       string `json:"pushover_token,omitempty" env:"SEMAPHORE_PUSHOVER_TOKEN"`
 
 	// oidc settings
 	OidcProviders map[string]OidcProvider `json:"oidc_providers,omitempty" env:"SEMAPHORE_OIDC_PROVIDERS"`