mirror of
https://github.com/nikoksr/notify.git
synced 2025-01-10 00:28:36 +02:00
67b2d011b8
Added support for Plivo as a backend service with unit tests and documentation. Signed-off-by: Prashanth Pai <mail@ppai.me>
107 lines
4.4 KiB
Markdown
107 lines
4.4 KiB
Markdown
<div align="center">
|
|
<img
|
|
width=40%
|
|
src="assets/gopher-letter.svg"
|
|
alt="notify logo"
|
|
/>
|
|
|
|
|
|
[](https://goreportcard.com/report/github.com/nikoksr/notify)
|
|
[](https://www.codacy.com/gh/nikoksr/notify/dashboard?utm_source=github.com&utm_medium=referral&utm_content=nikoksr/notify&utm_campaign=Badge_Grade)
|
|
[](https://codeclimate.com/github/nikoksr/notify/maintainability)
|
|
[](https://app.fossa.com/projects/git%2Bgithub.com%2Fnikoksr%2Fnotify?ref=badge_shield)
|
|
[](https://pkg.go.dev/github.com/nikoksr/notify)
|
|
|
|
</div>
|
|
|
|
> <p align="center">A dead simple Go library for sending notifications to various messaging services.</p>
|
|
|
|
<h1></h1>
|
|
|
|
## About <a id="about"></a>
|
|
|
|
*Notify* arose from my own need for one of my api server running in production to be able to notify me when, for example, an error occurred. The library is kept as simple as possible to allow a quick integration and easy usage.
|
|
|
|
## Disclaimer <a id="disclaimer"></a>
|
|
|
|
Any misuse of this library is your own liability and responsibility and cannot be attributed to the authors of this library. See [license](LICENSE) for more.
|
|
|
|
Spamming through the use of this library **may get you permanently banned** on most supported platforms.
|
|
|
|
## Install <a id="install"></a>
|
|
|
|
```sh
|
|
go get -u github.com/nikoksr/notify
|
|
```
|
|
|
|
## Example usage <a id="usage"></a>
|
|
|
|
```go
|
|
// The notifier we're gonna send our messages to
|
|
notifier := notify.New()
|
|
|
|
// 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 to?
|
|
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.
|
|
// Its kinda like using middlewares for api servers.
|
|
notifier.UseServices(telegramService)
|
|
|
|
// Send a test message
|
|
_ = notifier.Send(
|
|
"Message Subject/Title",
|
|
"The actual message. Hello, you awesome gophers! :)",
|
|
)
|
|
```
|
|
|
|
## Supported services <a id="supported_services"></a>
|
|
|
|
- *Discord*
|
|
- *Email*
|
|
- *Microsoft Teams*
|
|
- *Plivo*
|
|
- *Pushbullet*
|
|
- *Slack*
|
|
- *Telegram*
|
|
- *Twitter*
|
|
|
|
## Roadmap <a id="roadmap"></a>
|
|
|
|
- [ ] Add tests (see [#1](https://github.com/nikoksr/notify/issues/1))
|
|
- [ ] Add more notification services
|
|
|
|
## Credits <a id="credits"></a>
|
|
|
|
- Discord support: [bwmarrin/discordgo](https://github.com/bwmarrin/discordgo)
|
|
- Email support: [jordan-wright/email](https://github.com/jordan-wright/email)
|
|
- Microsoft Teams support: [atc0005/go-teams-notify](https://github.com/atc0005/go-teams-notify)
|
|
- Slack support: [slack-go/slack](https://github.com/slack-go/slack)
|
|
- Telegram support: [go-telegram-bot-api/telegram-bot-api](https://github.com/go-telegram-bot-api/telegram-bot-api)
|
|
- Pushbullet support: [cschomburg/go-pushbullet](https://github.com/cschomburg/go-pushbullet)
|
|
- Logo: [MariaLetta/free-gophers-pack](https://github.com/MariaLetta/free-gophers-pack)
|
|
- Twitter: [dghubble/go-twitter/twitter](https://github.com/dghubble/go-twitter/twitter)
|
|
|
|
## Author <a id="author"></a>
|
|
|
|
**Niko Köser**
|
|
|
|
* Twitter: [@nikoksr](https://twitter.com/nikoksr)
|
|
* Github: [@nikoksr](https://github.com/nikoksr)
|
|
|
|
## Contributing <a id="contributing"></a>
|
|
|
|
Contributions, issues and feature requests are welcome!<br />Feel free to check [issues page](https://github.com/nikoksr/notify/issues). You can also take a look at the [contributing guide](https://github.com/nikoksr/notify/blob/main/CONTRIBUTING.md).
|
|
|
|
## Show your support <a id="support"></a>
|
|
|
|
Give a ⭐️ if this project helped you!
|
|
|
|
## License <a id="license"></a>
|
|
|
|
[](https://app.fossa.com/projects/git%2Bgithub.com%2Fnikoksr%2Fnotify?ref=badge_large)
|