Skip to content

Think-iT-Labs/notifyme

Repository files navigation

NotifyMe

Get notified when your command finished executing

Contents

Installation

Build from the source

NotifyMe client is written in Golang, to build it from the source you need to have go installed and your GOPATH configured (default to ~/go in go 1.9)

Once done, get the code by running:

go get github.com/think-it-labs/notifyme/cmd

NOTE: the command above will download the repo into your GOPATH and build it for you. The resulting binary can be found in $GOPATH/bin, we recommend adding $GOPATH/bin to your $PATH.

Carriers

A carrier is a plugin that can deliver a notification. Currently only Slack is implemented as a carrier, others will be be implemented in the near future. Feel free to hack into the project and implement other notifiers.

Slack

By using the Slack carrier you will get notified via slack.

First you need to get your token by visiting this page Slack Token.

Now that you have your token, edit your ~/.notifyme config file and add the slack carrier.

Example:

carriers:
  - type: slack
    token: "xoxp-XXXXXX"
    channels: "@user, #general"

Usage

First you need to configure your carriers by setting the right values (mainly tokens) in your ~/.notifyme config file.

Second prepend notifyme to your command to get notified when it is finished executing.

$ notifyme COMMAND ARG1 ARG2 ...

For example to get notified when a Make build is finished, the command will look like:

$ notifyme make -j 4

Use Cases

Use cases for NotifyMe are numerous, and here are some tasks that developers regulary want to receive status notifications from.

  • Cron jobs,
  • Long running builds,
  • Backups,
  • Result of long running commands,
  • etc.

Is NotifyMe making your life simpler? tell us how are you using it 😄 !

Todo

[ ] Add flags through environment variables [ ] Enrich the configuration and add filters (e.g: only send erroned commands) [ ] Support other notifiers [X] Slack [X] Email [ ] File

License

This repository has been released under the MIT License


Made with ♥ by Think.iT.

About

Get notified when your command finish executing

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published