heroku-env 0.0.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7b36ac2535c255cbde68f7d3748f7eb90bd99440
+  data.tar.gz: ba93cb44537b0ab9498e5a9b78b81add53e88c43
+SHA512:
+  metadata.gz: 2bd0101624c4d2a1a210b4a9ce25726e0d40320a5188fa520be388890de585477f347aa0f58db06bc8d5bf0f6a83247b6a0f7d62080ce1e5c3002d1afac2f2b5
+  data.tar.gz: ddc464c2e1a7f32675bf14ed265a03aed10b6c769594ebbb9261eef5e3d69698be90e339ac8ca734e2b3c048ed4ba7e4729f81f666ec41f870b622a6e2765c10

data/.gitignore

@@ -0,0 +1,5 @@
+/pkg
+*.gem
+Thumbs.db
+.DS_Store
+*.swp

data/Gemfile

@@ -0,0 +1,2 @@
+source "https://rubygems.org"
+gemspec

data/Gemfile.lock

@@ -0,0 +1,16 @@
+PATH
+  remote: .
+  specs:
+    heroku-env (0.0.2)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    rake (10.4.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  heroku-env!
+  rake (= 10.4.2)

data/README.md

@@ -0,0 +1,77 @@
+# heroku-env
+
+> Don't worry about the environment.
+
+This simple gem makes it easier for you to use different Heroku addons in a plug-and-play fashion. Normally, if you decide to add a Redis provider, you have to customize your code to use that addon's environment variables. The problem with this, however, is that if you want to switch provider, you have to update your code.
+
+What I usually ended up doing was:
+
+```ruby
+ENV["REDIS_URL"] ||= ENV["REDISCLOUD_URL"] || ENV["REDISTOGO_URL"]
+$redis = Redis.new
+```
+
+Doing this in every project started to become a little annoying, so I decided to make a gem. The goal is to handle all kinds of addons, but for now it only handles Redis and SMTP. Suggest more types by filing an issue.
+
+I only add addons that I can test myself, so this gem will only support addons with a free plan. The order that the addons are selected depends on how stable and easy I perceive them to be. So if you are deciding what provider you want to use, a good choice if probably the first one on the lists of supported addons I list below.
+
+The gem uses `||=` in all the assignments, so you can easily override any variable by manually setting it.
+
+
+## Installing
+
+Add to your Gemfile:
+
+```ruby
+gem "heroku-env"
+```
+
+Then run:
+
+```ruby
+HerokuEnv.run
+```
+
+
+### Redis
+
+Supports [Redis Cloud](https://addons.heroku.com/rediscloud) and [Redis To Go](https://addons.heroku.com/redistogo).
+
+```ruby
+$redis = Redis.new
+```
+
+
+### SMTP
+
+Supports [Mandrill](https://addons.heroku.com/mandrill), [SendGrid](https://addons.heroku.com/sendgrid), [Mailgun](https://addons.heroku.com/mailgun) and [Postmark](https://addons.heroku.com/postmark).
+
+```ruby
+Mail.defaults do
+  delivery_method :smtp,
+    address:              ENV["SMTP_HOST"],
+    port:                 ENV["SMTP_PORT"],
+    user_name:            ENV["SMTP_USERNAME"],
+    password:             ENV["SMTP_PASSWORD"],
+    authentication:       "plain",
+    enable_starttls_auto: true
+end
+```
+
+Then send an email with:
+
+```ruby
+Mail.deliver do
+     from "Sender <#{ENV["MAIL_FROM"]}>"
+       to "receiver@example.com"
+  subject "Test email"
+     body "Just testing heroku-env"
+end
+```
+
+If you use Postmark, you have to manually set `MAIL_FROM`.
+
+
+## Misc notes
+
+- Postmark sends you some unwanted emails if you add the addon.

data/Rakefile

@@ -0,0 +1,3 @@
+require "rubygems"
+require "bundler"
+Bundler::GemHelper.install_tasks

data/heroku-env.gemspec

@@ -0,0 +1,20 @@
+require File.expand_path("../lib/heroku-env/version", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name        = "heroku-env"
+  s.version     = HerokuEnv::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Stefan Sundin"]
+  s.email       = ["stefan@stefansundin.com"]
+  s.homepage    = "https://github.com/stefansundin/heroku-env"
+  s.summary     = "Don't worry about the environment."
+  s.description = "This gem automatically promotes Heroku addons' environment settings."
+
+  s.required_rubygems_version = ">= 1.3.6"
+
+  s.add_development_dependency "rake", "10.4.2"
+
+  s.files        = `git ls-files`.split("\n")
+  s.executables  = `git ls-files`.split("\n").map{|f| f =~ /^bin\/(.*)/ ? $1 : nil}.compact
+  s.require_path = 'lib'
+end

data/lib/heroku-env.rb

@@ -0,0 +1,19 @@
+module HerokuEnv
+  module_function
+  def run
+    # Redis
+    ENV["REDIS_URL"] ||= ENV["REDISCLOUD_URL"] || ENV["REDISTOGO_URL"]
+
+    # SMTP
+    ENV["MANDRILL_SMTP_SERVER"] ||= "smtp.mandrillapp.com" if ENV["MANDRILL_USERNAME"]
+    ENV["SENDGRID_SMTP_SERVER"] ||= "smtp.sendgrid.net" if ENV["SENDGRID_USERNAME"]
+
+    ENV["SMTP_HOST"] ||= ENV["MANDRILL_SMTP_SERVER"] || ENV["SENDGRID_SMTP_SERVER"] || ENV["MAILGUN_SMTP_SERVER"] || ENV["POSTMARK_SMTP_SERVER"]
+    ENV["SMTP_PORT"] ||= ENV["MAILGUN_SMTP_PORT"] || "587"
+    ENV["SMTP_USERNAME"] ||= ENV["MANDRILL_USERNAME"] || ENV["SENDGRID_USERNAME"] || ENV["MAILGUN_SMTP_LOGIN"] || ENV["POSTMARK_API_KEY"]
+    ENV["SMTP_PASSWORD"] ||= ENV["MANDRILL_APIKEY"] || ENV["SENDGRID_PASSWORD"] || ENV["MAILGUN_SMTP_PASSWORD"] || ENV["POSTMARK_API_KEY"]
+
+    # If you use Postmark, you need to configure MAIL_FROM manually
+    ENV["MAIL_FROM"] ||= ENV["MANDRILL_USERNAME"] || ENV["SENDGRID_USERNAME"] || ENV["MAILGUN_SMTP_LOGIN"]
+  end
+end

data/lib/heroku-env/version.rb

@@ -0,0 +1,3 @@
+module HerokuEnv
+  VERSION = "0.0.2"
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification
+name: heroku-env
+version: !ruby/object:Gem::Version
+  version: 0.0.2
+platform: ruby
+authors:
+- Stefan Sundin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-03-30 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '='
+      - !ruby/object:Gem::Version
+        version: 10.4.2
+description: This gem automatically promotes Heroku addons' environment settings.
+email:
+- stefan@stefansundin.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- Gemfile
+- Gemfile.lock
+- README.md
+- Rakefile
+- heroku-env.gemspec
+- lib/heroku-env.rb
+- lib/heroku-env/version.rb
+homepage: https://github.com/stefansundin/heroku-env
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 1.3.6
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Don't worry about the environment.
+test_files: []