heroku-rails 0.0.1

data/CHANGELOG

@@ -0,0 +1,22 @@
+Heroku Rails
+v0.0.1
+============================================
+Initial fork and reorganization
+
+
+Heroku Sans
+v0.2.0
+============================================
+
+Elijah Miller
+  Fix newline error in gem manifest
+  Improve instructions
+
+Glenn Roberts
+  Gem-ify it
+  Improve generation of gems manifest
+
+
+v0.0.1.
+============================================
+Initial release.

data/Gemfile

@@ -0,0 +1,8 @@
+source :rubygems
+gemspec
+
+gem "ruby-debug", :platforms => :mri_18
+gem "ruby-debug19", :platforms => :mri_19
+
+gem "autotest", ">= 0"
+gem "growl-glue", ">= 0"

data/Gemfile.lock

@@ -0,0 +1,67 @@
+PATH
+  remote: .
+  specs:
+    heroku-rails (0.0.1)
+      heroku
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    archive-tar-minitar (0.5.2)
+    autotest (4.4.1)
+    columnize (0.3.1)
+    configuration (1.1.0)
+    diff-lcs (1.1.2)
+    growl-glue (1.0.7)
+    heroku (1.11.0)
+      json_pure (>= 1.2.0, < 1.5.0)
+      launchy (~> 0.3.2)
+      rest-client (>= 1.4.0, < 1.7.0)
+    json_pure (1.4.6)
+    launchy (0.3.7)
+      configuration (>= 0.0.5)
+      rake (>= 0.8.1)
+    linecache (0.43)
+    linecache19 (0.5.11)
+      ruby_core_source (>= 0.1.4)
+    mime-types (1.16)
+    rake (0.8.7)
+    rest-client (1.6.1)
+      mime-types (>= 1.16)
+    rspec (2.0.1)
+      rspec-core (~> 2.0.1)
+      rspec-expectations (~> 2.0.1)
+      rspec-mocks (~> 2.0.1)
+    rspec-core (2.0.1)
+    rspec-expectations (2.0.1)
+      diff-lcs (>= 1.1.2)
+    rspec-mocks (2.0.1)
+      rspec-core (~> 2.0.1)
+      rspec-expectations (~> 2.0.1)
+    ruby-debug (0.10.3)
+      columnize (>= 0.1)
+      ruby-debug-base (~> 0.10.3.0)
+    ruby-debug-base (0.10.3)
+      linecache (>= 0.3)
+    ruby-debug-base19 (0.11.24)
+      columnize (>= 0.3.1)
+      linecache19 (>= 0.5.11)
+      ruby_core_source (>= 0.1.4)
+    ruby-debug19 (0.11.6)
+      columnize (>= 0.3.1)
+      linecache19 (>= 0.5.11)
+      ruby-debug-base19 (>= 0.11.19)
+    ruby_core_source (0.1.4)
+      archive-tar-minitar (>= 0.5.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  autotest
+  growl-glue
+  heroku
+  heroku-rails!
+  rspec (~> 2.0)
+  ruby-debug
+  ruby-debug19

data/LICENSE

@@ -0,0 +1,43 @@
+Heroku Rails License:
+  Copyright (c) 2010 Jacques Crocker
+
+  Permission is hereby granted, free of charge, to any person obtaining
+  a copy of this software and associated documentation files (the
+  "Software"), to deal in the Software without restriction, including
+  without limitation the rights to use, copy, modify, merge, publish,
+  distribute, sublicense, and/or sell copies of the Software, and to
+  permit persons to whom the Software is furnished to do so, subject to
+  the following conditions:
+
+  The above copyright notice and this permission notice shall be
+  included in all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+  OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+  WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+Heroku Sans License:
+  Copyright (c) 2008 Elijah Miller
+
+  Permission is hereby granted, free of charge, to any person obtaining
+  a copy of this software and associated documentation files (the
+  "Software"), to deal in the Software without restriction, including
+  without limitation the rights to use, copy, modify, merge, publish,
+  distribute, sublicense, and/or sell copies of the Software, and to
+  permit persons to whom the Software is furnished to do so, subject to
+  the following conditions:
+
+  The above copyright notice and this permission notice shall be
+  included in all copies or substantial portions of the Software.
+
+  THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+  EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+  MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+  NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+  LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+  OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+  WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.md

@@ -0,0 +1,117 @@
+Heroku Rails
+=============
+
+Easier configuration and deployment of Rails apps on Heroku
+
+Configure your Heroku environment via a YML file (config/heroku.yml) that defines all your environments, addons, and environment variables.
+
+Heroku Rails also handles asset packaging (via jammit), deployment of assets to s3 (via jammit-s3).
+
+## Install
+
+### Rails 3
+
+Add this to your Gemfile:
+
+    group :development do
+      gem 'heroku-rails'
+    end
+
+### Rails 2
+
+To install add the following to config/environment.rb:
+
+    config.gem 'heroku-rails'
+
+Rake tasks are not automatically loaded from gems, so you’ll need to add the following to your Rakefile:
+
+    begin
+      require 'heroku/rails/tasks'
+    rescue LoadError
+      STDERR.puts "Run `rake gems:install` to install heroku-rails"
+    end
+
+## Configure
+
+In config/heroku.yml you will need add the Heroku apps that you would like to attach to this project. You can generate this file and edit it by running:
+
+    rake heroku:create_config
+
+If this is a fresh project, heroku_san can create all the applications for
+you, and set the RACK_ENV.
+
+    rake all heroku:create heroku:rack_env
+
+## Usage
+
+After configuring your Heroku apps you can use rake tasks to control the
+apps.
+
+    rake production deploy
+
+A rake task with the shorthand name of each app is now available and adds that
+server to the list that subsequent commands will execute on. Because this list
+is additive, you can easily select which servers to run a command on.
+
+    rake demo staging restart
+
+A special rake task 'all' is created that causes any further commands to
+execute on all heroku apps.
+
+Manipulate collaborators on all this project's apps (prompts for email
+address):
+
+    rake all heroku:share
+    rake all heroku:unshare
+
+Need to add remotes for each app?
+
+    rake all heroku:remotes
+
+A full list of tasks provided:
+
+    rake all                   # Select all Heroku apps for later command
+    rake console               # Opens a remote console
+    rake deploy                # Deploys, migrates and restarts latest code.
+    rake after_deploy          # Callback run after the overall deploy
+    rake after_each_deploy     # Callback run after each environment's deploy
+    rake before_deploy         # Callback run before the overall deploy
+    rake before_each_deploy    # Callback run before each environment's deploy
+    rake capture               # Captures a bundle on Heroku
+    rake heroku:apps           # Lists configured apps
+    rake heroku:create         # Creates the Heroku app
+    rake heroku:create_config  # Creates an example configuration file
+    rake heroku:gems           # Generate the Heroku gems manifest from gem dependencies
+    rake heroku:remotes        # Add git remotes for all apps in this project
+    rake heroku:rack_env       # Add proper RACK_ENV to each application
+    rake heroku:share          # Adds a collaborator
+    rake heroku:unshare        # Removes a collaborator
+    rake migrate               # Migrates and restarts remote servers
+    rake restart               # Restarts remote servers
+
+Frequently used tasks are not namespaced, everything else lives under heroku.
+
+## About Heroku Rails
+
+### Links
+
+Homepage:: http://github.com/railsjedi/heroku-rails
+Issue Tracker:: http://github.com/railsjedi/heroku-rails/issues
+
+### License
+
+License:: Copyright (c) 2010 [Jacques Crocker](mailto:railsjedi@gmail.com), released under the MIT license.
+
+## Forked from Heroku Sans
+
+Heroku Rails is a fork and rewrite/reorganiziation of Heroku Sans, and a nice simple set of Rake tasks for managing Heroku environments. Check out that project here: http://github.com/fastestforward/heroku_san
+
+### Heroku Sans Contributors
+
+* Elijah Miller (elijah.miller@gmail.com)
+* Glenn Roberts (glenn.roberts@siyelo.com)
+* Damien Mathieu (42@dmathieu.com)
+
+### Heroku Sans License
+
+License:: Copyright (c) 2009 Elijah Miller <mailto:elijah.miller@gmail.com>, released under the MIT license.

data/Rakefile

@@ -0,0 +1,43 @@
+require "bundler"
+Bundler.setup
+
+require 'rake'
+require 'rake/gempackagetask'
+
+gemspec = eval(File.read('heroku-rails.gemspec'))
+Rake::GemPackageTask.new(gemspec) do |pkg|
+  pkg.gem_spec = gemspec
+end
+
+desc "build the gem and release it to rubygems.org"
+task :release => :gem do
+  puts "Tagging #{gemspec.version}..."
+  system "git tag -a #{gemspec.version} -m 'Tagging #{gemspec.version}'"
+  puts "Pushing to Github..."
+  system "git push --tags"
+  puts "Pushing to rubygems.org..."
+  system "gem push pkg/#{gemspec.name}-#{gemspec.version}.gem"
+end
+
+require "rspec"
+require "rspec/core/rake_task"
+
+Rspec::Core::RakeTask.new(:spec) do |spec|
+  spec.pattern = "spec/**/*_spec.rb"
+end
+
+Rspec::Core::RakeTask.new('spec:progress') do |spec|
+  spec.rspec_opts = %w(--format progress)
+  spec.pattern = "spec/**/*_spec.rb"
+end
+
+require "rake/rdoctask"
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = "rdoc"
+  rdoc.title = "Heroku Rails #{gemspec.version}"
+  rdoc.rdoc_files.include("README*")
+  rdoc.rdoc_files.include("lib/**/*.rb")
+end
+
+
+task :default => :spec

data/TODO

@@ -0,0 +1,2 @@
+  - refactor config/helpers out of tasks.rb into own file(s)
+  - 

data/heroku-rails.gemspec

@@ -0,0 +1,37 @@
+Gem::Specification.new do |s|
+  s.name = "heroku-rails"
+  s.version = "0.0.1"
+
+  s.authors = ["Elijah Miller", "Glenn Roberts", "Jacques Crocker"]
+  s.summary = "A bunch of useful Rake tasks for managing your Heroku apps"
+  s.description = "Manage multiple Heroku instances/apps for a single Rails app using Rake"
+
+  s.email = "railsjedi@gmail.com"
+  s.homepage = "http://github.com/railsjedi/heroku-rails"
+  s.rubyforge_project = "none"
+
+  s.require_paths = ["lib"]
+  s.files = Dir['lib/**/*',
+                'spec/**/*',
+                'heroku-rails.gemspec',
+                'Gemfile',
+                'Gemfile.lock',
+                'CHANGELOG',
+                'LICENSE',
+                'Rakefile',
+                'README.md',
+                'TODO']
+
+  s.test_files = Dir['spec/**/*']
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.extra_rdoc_files = [
+    "LICENSE",
+    "README.md",
+    "TODO",
+    "CHANGELOG"
+  ]
+
+  s.add_runtime_dependency("heroku")
+  s.add_development_dependency "rspec", "~> 2.0"
+end
+

data/lib/heroku-rails.rb

@@ -0,0 +1,9 @@
+module Heroku
+  module Rails
+    class Railtie < ::Rails::Railtie
+      rake_tasks do
+        load 'heroku/rails/tasks.rb'
+      end
+    end
+  end
+end

data/lib/heroku/rails/config.rb

@@ -0,0 +1,42 @@
+module Heroku
+  module Rails
+    class Config
+
+      attr_accessor :settings
+
+      def initialize(config_filepath)
+        if File.exists?(config_filepath)
+          self.settings = YAML.load_file(HEROKU_CONFIG_FILE)
+        else
+          self.settings = {}
+        end
+      end
+
+      # pull out the stack setting for a particular app environment
+      def stack(app = 'all')
+        # TODO
+      end
+
+      # pull out the config setting hash for a particular app environment
+      def config(app = 'all')
+        # TODO
+      end
+
+      # return a list of collaborators for a particular app environment
+      def collaborators(app = 'all')
+        # TODO
+      end
+
+      # return a list of domains for a particular app environment
+      def domains(app = 'all')
+        # TODO
+      end
+
+      # return a list of addons for a particular app environment
+      def addons(app = 'addons')
+        # TODO
+      end
+
+    end
+  end
+end

data/lib/heroku/rails/tasks.rb

@@ -0,0 +1,224 @@
+HEROKU_CONFIG_FILE = Rails.root.join('config', 'heroku.yml')
+
+require 'heroku/rails/config'
+HEROKU_CONFIG = Heroku::Rails::Config.new(HEROKU_CONFIG_FILE)
+
+(HEROKU_CONFIG.settings['apps'] || []).each do |name, app|
+  desc "Select #{name} Heroku app for later commands"
+  task name do
+    @heroku_apps ||= []
+    @heroku_apps << name
+  end
+end
+
+desc 'Select all Heroku apps for later command'
+task :all do
+  @heroku_apps = HEROKU_CONFIG.settings['apps'].keys
+end
+
+namespace :heroku do
+  desc "Creates the Heroku app"
+  task :create do
+    each_heroku_app do |name, app, repo|
+      system_with_echo "heroku create #{app}"
+    end
+  end
+
+  desc "Generate the Heroku gems manifest from gem dependencies"
+  task :gems => 'gems:base' do
+    RAILS_ENV='production'
+    Rake::Task[:environment].invoke
+    gems = Rails.configuration.gems.reject { |g| g.frozen? && !g.framework_gem? }
+    list = gems.collect do |g|
+      command, *options = g.send(:install_command)
+      options.join(" ")
+    end
+
+    list.unshift(%Q{rails --version "= #{Rails.version}"})
+
+    File.open(Rails.root.join('.gems'), 'w') do |f|
+      f.write(list.join("\n"))
+    end
+  end
+
+  desc 'Add git remotes for all apps in this project'
+  task :remotes do
+    each_heroku_app do |name, app, repo|
+      system("git remote add #{name} #{repo}")
+    end
+  end
+
+  desc 'Adds a collaborator'
+  task :share do
+    print "Email address of collaborator to add: "
+    $stdout.flush
+    email = $stdin.gets
+    each_heroku_app do |name, app, repo|
+      system_with_echo "heroku sharing:add --app #{app} #{email}"
+    end
+  end
+
+  desc 'Adds a collaborator'
+  task :unshare do
+    print "Email address of collaborator to remove: "
+    $stdout.flush
+    email = $stdin.gets
+    each_heroku_app do |name, app, repo|
+      system_with_echo "heroku sharing:remove --app #{app} #{email}"
+    end
+  end
+
+  desc 'Lists configured apps'
+  task :apps => :all do
+    each_heroku_app do |name, app, repo|
+      puts "#{name} is shorthand for the Heroku app #{app} located at:"
+      puts "  #{repo}"
+      puts
+    end
+  end
+
+  desc 'Add proper RACK_ENV to each application'
+  task :rack_env => :all do
+    each_heroku_app do |name, app, repo|
+      command = "heroku config --app #{app}"
+      puts command
+      config = Hash[`#{command}`.scan(/^(.+?)\s*=>\s*(.+)$/)]
+      if config['RACK_ENV'] != name
+        system_with_echo "heroku config:add --app #{app} RACK_ENV=#{name}"
+      end
+    end
+  end
+
+  desc 'Creates an example configuration file'
+  task :create_config do
+    example = File.join(File.dirname(__FILE__), '..', 'templates', 'heroku.example.yml')
+    if File.exists?(HEROKU_CONFIG_FILE)
+      puts "config/heroku.yml already exists"
+    else
+      puts "Copied example config to config/heroku.yml"
+      FileUtils.cp(example, HEROKU_CONFIG_FILE)
+      system_with_echo("#{ENV['EDITOR']} #{HEROKU_CONFIG_FILE}")
+    end
+  end
+
+  namespace :setup do
+    # TODO
+  end
+
+end
+
+desc "Deploys, migrates and restarts latest code"
+task :deploy => :before_deploy do
+  each_heroku_app do |name, app, repo|
+    @heroku_app = {:name => name, :app => app, :repo => repo}
+    Rake::Task[:before_each_deploy].invoke
+    branch = `git branch`.scan(/^\* (.*)\n/).flatten.first.to_s
+    if branch.present?
+      @git_push_arguments ||= []
+      system_with_echo "git push #{repo} #{@git_push_arguments.join(' ')} #{branch}:master && heroku rake --app #{app} db:migrate && heroku restart --app #{app}"
+    else
+      puts "Unable to determine the current git branch, please checkout the branch you'd like to deploy"
+      exit(1)
+    end
+    Rake::Task[:after_each_deploy].invoke
+  end
+  Rake::Task[:after_deploy].execute
+end
+
+desc "Callback before all deploys"
+task :before_deploy do
+end
+
+desc "Callback after all deploys"
+task :after_deploy do
+end
+
+desc "Callback before each deploy"
+task :before_each_deploy do
+end
+
+desc "Callback after each deploy"
+task :after_each_deploy do
+end
+
+
+desc "Force deploys, migrates and restarts latest code"
+task :force_deploy do
+  @git_push_arguments ||= []
+  @git_push_arguments << '--force'
+  Rake::Task[:deploy].execute
+end
+
+desc "Captures a bundle on Heroku"
+task :capture do
+  each_heroku_app do |name, app, repo|
+    system_with_echo "heroku bundles:capture --app #{app}"
+  end
+end
+
+desc "Opens a remote console"
+task :console do
+  each_heroku_app do |name, app, repo|
+    system_with_echo "heroku console --app #{app}"
+  end
+end
+
+desc "Restarts remote servers"
+task :restart do
+  each_heroku_app do |name, app, repo|
+    system_with_echo "heroku restart --app #{app}"
+  end
+end
+
+desc "Migrates and restarts remote servers"
+task :migrate do
+  each_heroku_app do |name, app, repo|
+    system_with_echo "heroku rake --app #{app} db:migrate && heroku restart --app #{app}"
+  end
+end
+
+namespace :db do
+  task :pull do
+    each_heroku_app do |name, app, repo|
+      system_with_echo "heroku pgdumps:capture --app #{app}"
+      dump = `heroku pgdumps --app #{app}`.split("\n").last.split(" ").first
+      system_with_echo "mkdir -p #{Rails.root}/db/dumps"
+      file = "#{Rails.root}/db/dumps/#{dump}.sql.gz"
+      url = `heroku pgdumps:url --app #{app} #{dump}`.chomp
+      system_with_echo "wget", url, "-O", file
+      system_with_echo "rake db:drop db:create"
+      system_with_echo "gunzip -c #{file} | #{Rails.root}/script/dbconsole"
+      system_with_echo "rake jobs:clear"
+    end
+  end
+end
+
+def system_with_echo(*args)
+  puts args.join(' ')
+  system(*args)
+end
+
+def each_heroku_app
+  if @heroku_apps.blank? && HEROKU_CONFIG.settings['apps'].size == 1
+    app = HEROKU_CONFIG.settings['apps'].keys.first
+    puts "Defaulting to #{app} app since only one app is defined"
+    @heroku_apps = [app]
+  end
+  if @heroku_apps.present?
+    @heroku_apps.each do |name|
+      app = HEROKU_CONFIG.settings['apps'][name]
+      yield(name, app, "git@heroku.com:#{app}.git")
+    end
+    puts
+  else
+    puts "You must first specify at least one Heroku app:
+      rake <app> [<app>] <command>
+      rake production restart
+      rake demo staging deploy"
+
+    puts "\nYou can use also command all Heroku apps for this project:
+      rake all heroku:share"
+
+    exit(1)
+  end
+end

data/lib/templates/heroku.example.yml

@@ -0,0 +1,5 @@
+apps:
+  # shorthand: heroku app
+  production: awesomeapp
+  staging: awesomeapp-staging
+  demo: awesomeapp-demo

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification 
+name: heroku-rails
+version: !ruby/object:Gem::Version 
+  hash: 29
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Elijah Miller
+- Glenn Roberts
+- Jacques Crocker
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-11-01 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  type: :runtime
+  prerelease: false
+  name: heroku
+  version_requirements: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  requirement: *id001
+- !ruby/object:Gem::Dependency 
+  type: :development
+  prerelease: false
+  name: rspec
+  version_requirements: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 2
+        - 0
+        version: "2.0"
+  requirement: *id002
+description: Manage multiple Heroku instances/apps for a single Rails app using Rake
+email: railsjedi@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.md
+- TODO
+- CHANGELOG
+files: 
+- lib/heroku/rails/config.rb
+- lib/heroku/rails/tasks.rb
+- lib/heroku-rails.rb
+- lib/templates/heroku.example.yml
+- heroku-rails.gemspec
+- Gemfile
+- Gemfile.lock
+- CHANGELOG
+- LICENSE
+- Rakefile
+- README.md
+- TODO
+has_rdoc: true
+homepage: http://github.com/railsjedi/heroku-rails
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: none
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: A bunch of useful Rake tasks for managing your Heroku apps
+test_files: []
+