1
0
mirror of https://github.com/nikoksr/notify.git synced 2024-12-04 09:43:04 +02:00
A dead simple Go library for sending notifications to various messaging services.
Go to file
2022-08-04 17:09:36 +02:00
.github ci(github): update go mod version 2022-08-04 16:27:33 +02:00
assets [ImgBot] Optimize images 2021-04-27 05:47:17 +00:00
service Merge branch 'main' into feat/lark 2022-08-04 16:58:45 +02:00
.codacy.yml ci(codacy): reintroduce config for readme badge 2021-11-18 19:26:19 +01:00
.editorconfig feat: init project 2021-01-25 00:14:21 +01:00
.gitignore chore(git): ignore test coverage file 2022-04-26 01:04:01 +02:00
.golangci.yml chore(lint): remove redundant fmt linter 2022-08-04 15:29:50 +02:00
CODE_OF_CONDUCT.md docs(contrib): update contribution guidelines 2022-04-25 15:38:39 +02:00
CONTRIBUTING.md docs(contrib): update contribution guidelines 2022-04-25 15:38:39 +02:00
go.mod fix(deps): go get -u and go mod tidy 2022-08-04 17:09:36 +02:00
go.sum fix(deps): go get -u and go mod tidy 2022-08-04 17:09:36 +02:00
LICENSE feat: init project 2021-01-25 00:14:21 +01:00
Makefile build(make): merge setup commands 2022-08-04 15:31:11 +02:00
notifier.go style(fmt): make fmt 2022-08-04 15:58:38 +02:00
notify_test.go test: fill gaps in library root 2022-04-26 01:17:52 +02:00
notify.go feat(notify): Add NewWithServices() constructor function 2022-04-25 23:53:28 +02:00
README.md docs(readme): add lark service support 2022-06-05 23:30:00 +08:00
renovate.json ci(deps): remove dependabot and extend renovate config 2021-08-14 00:42:14 +02:00
SECURITY.md feat(service): add syslog (#211) 2022-02-13 18:18:03 +01:00
send_test.go test: fill gaps in library root 2022-04-26 01:17:52 +02:00
send.go style: remove unecessary new-line 2022-04-22 20:45:49 +02:00
use_test.go test(notify): add tests for Notify's core functions 2022-04-22 20:33:52 +02:00
use.go chore(naming): change list parameter names to plural 2022-04-25 23:52:39 +02:00

notify logo

GitHub tag (latest SemVer) Go Report Card Codacy Badge Maintainability go.dev reference

A dead simple Go library for sending notifications to various messaging services.

About

Notify was born out of my own need to have my API servers running in production be able to notify me when critical errors occur. Of course, Notify can be used for any other purpose as well. The library is kept as simple as possible for quick integration and ease of use.

Disclaimer

Any misuse of this library is your own liability and responsibility and cannot be attributed to the authors of this library. See license for more.

Spamming through the use of this library may get you permanently banned on most supported platforms.

Since Notify is highly dependent on the consistency of the supported external services and the corresponding latest client libraries, we cannot guarantee its reliability nor its consistency, and therefore you should probably not use or rely on Notify in critical scenarios.

Install

go get -u github.com/nikoksr/notify

Example usage

// Create a telegram service. Ignoring error for demo simplicity.
telegramService, _ := telegram.New("your_telegram_api_token")

// Passing a telegram chat id as receiver for our messages.
// Basically where should our message be sent?
telegramService.AddReceivers(-1234567890)

// Tell our notifier to use the telegram service. You can repeat the above process
// for as many services as you like and just tell the notifier to use them.
// Inspired by http middlewares used in higher level libraries.
notify.UseServices(telegramService)

// Send a test message.
_ = notify.Send(
	context.Background(),
	"Subject/Title",
	"The actual message - Hello, you awesome gophers! :)",
)

Recommendation

In this example, we use the global Send() function. Similar to most logging libraries such as zap, we provide global functions for convenience. However, as with most logging libraries, we also recommend avoiding the use of global functions as much as possible. Instead, use one of our versatile constructor functions to create a new local Notify instance and pass it down the stream.

Read the library docs for more information.

Contributing

Yes, please! Contributions of all kinds are very welcome! Feel free to check our open issues. Please also take a look at the contribution guidelines.

Psst, don't forget to check the list of missing services waiting to be added by you or create a new issue if you want a new service to be added.

Supported services

Click here to request a missing service.

Service Path Credits
Amazon SES service/amazonses aws/aws-sdk-go-v2
Amazon SNS service/amazonsns aws/aws-sdk-go-v2
Bark service/bark -
DingTalk service/dinding blinkbean/dingtalk
Discord service/discord bwmarrin/discordgo
Email service/mail jordan-wright/email
Firebase Cloud Messaging service/fcm appleboy/go-fcm
Lark service/lark go-lark/lark
Line service/line line/line-bot-sdk-go
Line Notify service/line utahta/go-linenotify
Mailgun service/mailgun mailgun/mailgun-go
Microsoft Teams service/msteams atc0005/go-teams-notify
Plivo service/plivo plivo/plivo-go
Pushbullet service/pushbullet cschomburg/go-pushbullet
RocketChat service/rocketchat RocketChat/Rocket.Chat.Go.SDK
SendGrid service/sendgrid sendgrid/sendgrid-go
Slack service/slack slack-go/slack
Syslog service/syslog log/syslog
Telegram service/telegram go-telegram-bot-api/telegram-bot-api
TextMagic service/textmagic textmagic/textmagic-rest-go-v2
Twitter service/twitter dghubble/go-twitter
WeChat service/wechat silenceper/wechat
WhatsApp service/whatsapp Rhymen/go-whatsapp

Logo

The logo was made by the amazing MariaLetta.

Similar projects

Just to clarify, Notify was not inspired by any other project. I created it as a tiny subpackage of a larger project and only later decided to make it a standalone project. In this section I just want to mention other great projects.

Show your support

Give a ️ if you like this project!