Messenger

Messenger makes it easy to send messages using a variety of services (e.g. email, web, campfire, jabber). It is designed to be used via the command-line or invoked directly with in a Ruby application. One of the guiding principles behind the library is to specify as much as possible through a single URL.

Services

Email

Email messages are sent using the Pony gem.

messenger mailto:[email protected] "Message" --email-from [email protected] --email-subject "Hi"

Web

Web posts are send using the HTTParty gem. The message is sent as the request body, not the query.

messenger http://example.com "Message"

Campfire

Campfire messages are sent using the HTTParty gem against the Campfire API.

messenger campfire://api-key:[email protected] "Message"

Slack

Slack messages are sent using the HTTParty gem against the incoming webhooks API. If the message sent is a string, the message will be delivered as such. If it's an object or an array of objects, those will be sent as attachments.

messenger slack://[email protected]/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX/#room "Message"
messenger slack://[email protected]/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX/#room { fallback: 'Important notice', color: '#0000ff', text: 'Man this is some super important text' }

You can also specify a custom user image by passing icon_url or icon_emoji in the options block.

messenger slack://[email protected]/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX/#room "Message" { icon_emoji: ':ghost:' }

Jabber

Jabber messages are sent using the xmppr4-simple gem. It's important to note that the jabber server can be sent in the URL if it can't be inferred from the jabber ID (as is the case for Google Apps ids).

messenger jabber://[email protected]/jabber_server "Message" --jabber-id [email protected] --jabber-password #######

Config

Messenger will also read in ~/.messenger (a YAML file) for default config information, such as:

jabber_id: [email protected]
jabber_password: ########

License

Messenger is licensed under the MIT License. View the license file