Awesome

Cloud Plugins for Play! Framework

Cloud Plugins project delivers 3 (for now) cloud plugins:

• Cloudinary - cloud-based image management and manipulation
• Mailgun - cloud-based mail services over HTTPS
• Twilio - telecommunication cloud - currently supports sending SMS messages

Configuration

Environment variables

Configuration is pretty straight forward. All you have to do is set proper environment variables:

export CLOUDINARY_URL="cloudinary://AAA:BBB@CCC"
export MAILGUN_API_KEY="key-ABC"
export MAILGUN_SMTP_LOGIN="postmaster@ABC.mailgun.org"
export TWILIO_APPLICATION_SID=SID
export TWILIO_AUTH_TOKEN=TOKEN

If you use Heroku, Cloudinary and Mailgun environment variables are provided out of the box after you install proper add-ons. Twilio is not (yet) supported by Heroku so you have to create these environment variables yourself.

play.plugins

Next you have to configure Play! plugins. Create conf/play.plugins file and paste:

20000:plugins.cloudimage.CloudinaryCloudImagePlugin
20001:plugins.emailnotifier.MailgunEmailNotifierPlugin
20002:plugins.smsnotifier.TwilioSmsNotifierPlugin

That's all.

Usage

Each Plugin has a service property which you should use. Please see specs for full source code examples.

Cloudinary

val cloudImageService = use[CloudImagePlugin].cloudImageService
val uploadResponse = cloudImageService.upload(fileName, contents)
val publicId = uploadResponse.asInstanceOf[CloudImageSuccessResponse].publicId
val destroyResponse = cloudImageService.destroy(publicId)
val transformationUrl = cloudImageService.getTransformationUrl(url, transformationProperties)

Mailgun

val emailNotifierService = use[EmailNotifierPlugin].emailNotifierService
val response = emailNotifierService.send(from, to, subject, textMessage, htmlMessage)

Twilio

val smsNotifierService = use[SmsNotifierPlugin].smsNotifierService
val response = smsNotifierService.send(from, to, text)

Behavioural Tests

You can run Spec2 tests by executing play test command. Behavioural tests also show you how to use these plugins. In addition play-cloud-plugins project uses Travis CI. Current status is