philosophies-suspenders 2.0.0

data/README.md

@@ -0,0 +1,194 @@
+# Suspenders
+
+This is Philosophie's fork of Suspenders, a Rails application template
+originally created by thoughtbot. This repo has strayed significantly from
+thoughtbot's and is not intended to go back upstream.
+
+## Installation
+
+First install the gem:
+
+    gem install philosophies-suspenders
+
+Then run:
+
+    philosophies-suspenders projectname
+
+This will create a Rails app in `projectname` using the latest version of Rails.
+
+## Gemfile
+
+To see the latest and greatest gems, look at Suspenders'
+[Gemfile](templates/Gemfile.erb), which will be appended to the default
+generated projectname/Gemfile. After the first bundle install, Suspenders will
+apply pessimistic version-locking on the Gemfile to only allow patch-level
+updates.
+
+It includes application gems like:
+
+* [Airbrake](https://github.com/airbrake/airbrake) for exception notification,
+  set your API key in the environment with `AIRBRAKE_API_KEY`
+* [Autoprefixer Rails](https://github.com/ai/autoprefixer-rails) for CSS vendor prefixes
+* [Sidekiq](https://github.com/mperham/sidekiq) for background processing
+* [Flutie](https://github.com/thoughtbot/flutie) for `page_title` and `body_class` view
+  helpers
+* [High Voltage](https://github.com/thoughtbot/high_voltage) for static pages
+* [Rails Assets](https://rails-assets.org/) for managing frontend dependencies,
+  including by default:
+  * jquery
+  * jquery-ujs
+* [New Relic RPM](https://github.com/newrelic/rpm) for monitoring performance
+* [Postgres](https://github.com/ged/ruby-pg) for access to the Postgres database
+* [Rack Canonical Host](https://github.com/tylerhunt/rack-canonical-host) to
+  ensure all requests are served from the same domain
+* [Rack Timeout](https://github.com/kch/rack-timeout) to abort requests that are
+  taking too long
+* [Simple Form](https://github.com/plataformatec/simple_form) for form markup
+  and style
+* [Title](https://github.com/calebthompson/title) for storing titles in
+  translations
+* [Unicorn](https://github.com/defunkt/unicorn) to serve HTTP requests
+
+And development gems like:
+
+* [Dotenv](https://github.com/bkeepers/dotenv) for loading environment variables
+* [Pry Rails](https://github.com/rweng/pry-rails) for interactively exploring
+  objects
+* [Pry ByeBug](https://github.com/deivid-rodriguez/pry-byebug) for interactively
+  debugging behavior
+* [Bundler Audit](https://github.com/rubysec/bundler-audit) for scanning the
+  Gemfile for insecure dependencies based on published CVEs
+* [Spring](https://github.com/rails/spring) for fast Rails actions via
+  pre-loading
+* [Better Errors](https://github.com/charliesome/better_errors) for better
+  debugging via in-browser IRB consoles.
+* [RuboCop](https://github.com/bbatsov/rubocop) with Philosophie's default
+  configuration to enforce Ruby Community Styleguide.
+
+And testing gems like:
+
+* [Capybara](https://github.com/jnicklas/capybara) and
+  [Capybara Webkit](https://github.com/thoughtbot/capybara-webkit) for
+  integration testing
+* [Factory Girl](https://github.com/thoughtbot/factory_girl) for test data
+* [RSpec](https://github.com/rspec/rspec) for unit testing
+* [RSpec Mocks](https://github.com/rspec/rspec-mocks) for stubbing and spying
+* [Shoulda Matchers](https://github.com/thoughtbot/shoulda-matchers) for common
+  RSpec matchers
+* [Timecop](https://github.com/jtrupiano/timecop-console) for testing time
+
+## Other goodies
+
+Suspenders also comes with:
+
+* [Stairs][stairs] for new developer setup
+* Rails' flashes set up and in application layout
+* A few nice time formats set up for localization
+* `Rack::Deflater` to [compress responses with Gzip][compress]
+* A [low database connection pool limit][pool]
+* [Safe binstubs][binstub]
+* [t() and l() in specs without prefixing with I18n][i18n]
+* An automatically-created `SECRET_KEY_BASE` environment variable in all
+  environments
+* The analytics adapter [Segment][segment] (and therefore config for Google
+  Analytics, Intercom, Facebook Ads, Twitter Ads, etc.)
+
+[stairs]: https://github.com/philosophie/stairs
+[compress]: http://robots.thoughtbot.com/content-compression-with-rack-deflater/
+[pool]: https://devcenter.heroku.com/articles/concurrency-and-database-connections
+[binstub]: https://github.com/thoughtbot/suspenders/pull/282
+[i18n]: https://github.com/thoughtbot/suspenders/pull/304
+[segment]: https://segment.com
+
+## Heroku
+
+By default, suspenders will:
+
+* Creates a staging and production Heroku app
+* Sets them as `staging` and `production` Git remotes
+* Configures staging with `RACK_ENV` and `RAILS_ENV` environment variables set
+  to `staging`
+* Adds the [Rails 12factor][rails-12factor] gem
+* Adds free Mandrill add-on and configure SMTP settings to use it
+* Adds free Airbrake add-on
+* Adds free Papertrail add-on
+
+[rails-12factor]: https://github.com/heroku/rails_12factor
+
+You can optionally specify alternate Heroku flags:
+
+    suspenders app \
+      --heroku-flags "--region eu --addons newrelic,pgbackups,ssl"
+
+See all possible Heroku flags:
+
+    heroku help create
+
+You can bypass all Heroku functionality with the `--skip-heroku` option:
+
+    suspenders app --skip-heroku true
+
+## Git
+
+By default, suspenders will:
+
+* Initialize a new git repository
+* Create `staging` and `production` branches for deployment
+* Make an initial commit
+
+You can optionally provide a remote URL via the `--origin` option and suspenders
+will push all branches to that remote.
+
+    suspenders app --origin git@github.com:philosopie/app.git
+
+You can bypass all git functionality with the `--skip-git` option:
+
+    suspenders app --skip-git true
+
+## GitHub
+
+You can optionally create a GitHub repository for the suspended Rails app. It
+requires that you have [Hub](https://github.com/github/hub) on your system:
+
+    curl http://hub.github.com/standalone -sLo ~/bin/hub && chmod +x ~/bin/hub
+    suspenders app --github organization/project
+
+This has the same effect as running:
+
+    hub create organization/project
+
+## Spring
+
+Suspenders uses [spring](https://github.com/rails/spring) by default.
+It makes Rails applications load faster, but it might introduce confusing issues
+around stale code not being refreshed.
+If you think your application is running old code, run `spring stop`.
+And if you'd rather not use spring, add `DISABLE_SPRING=1` to your login file.
+
+## Dependencies
+
+Suspenders requires the latest version of Ruby.
+
+Some gems included in Suspenders have native extensions. You should have GCC
+installed on your machine before generating an app with Suspenders.
+
+Use [OS X GCC Installer](https://github.com/kennethreitz/osx-gcc-installer/) for
+Snow Leopard (OS X 10.6).
+
+Use [Command Line Tools for XCode](https://developer.apple.com/downloads/index.action)
+for Lion (OS X 10.7) or Mountain Lion (OS X 10.8).
+
+We use [Capybara Webkit](https://github.com/thoughtbot/capybara-webkit) for
+full-stack JavaScript integration testing. It requires QT. Instructions for
+installing QT are
+[here](https://github.com/thoughtbot/capybara-webkit/wiki/Installing-Qt-and-compiling-capybara-webkit).
+
+PostgreSQL needs to be installed and running for the `db:create` rake task.
+
+## License
+
+Suspenders is Copyright © 2008-2015 thoughtbot.
+It is free software,
+and may be redistributed under the terms specified in the [LICENSE] file.
+
+[LICENSE]: LICENSE

data/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler/setup'
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:rspec)
+
+desc 'Run the test suite'
+task :default => :rspec

data/bin/philosophies-suspenders

@@ -0,0 +1,18 @@
+#!/usr/bin/env ruby
+require 'pathname'
+
+source_path = (Pathname.new(__FILE__).dirname + '../lib').expand_path
+$LOAD_PATH << source_path
+
+require 'suspenders'
+
+if ['create', '--create'].include? ARGV[0]
+  ARGV.shift
+  puts "[WARNING] the suspenders create argument is deprecated. Just use `suspenders #{ARGV.join}` instead"
+end
+
+templates_root = File.expand_path(File.join("..", "templates"), File.dirname(__FILE__))
+Suspenders::AppGenerator.source_root templates_root
+Suspenders::AppGenerator.source_paths << Rails::Generators::AppGenerator.source_root << templates_root
+
+Suspenders::AppGenerator.start

data/bin/rake

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rake' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rake', 'rake')

data/bin/rspec

@@ -0,0 +1,16 @@
+#!/usr/bin/env ruby
+#
+# This file was generated by Bundler.
+#
+# The application 'rspec' is installed as part of a gem, and
+# this file is here to facilitate running it.
+#
+
+require 'pathname'
+ENV['BUNDLE_GEMFILE'] ||= File.expand_path("../../Gemfile",
+  Pathname.new(__FILE__).realpath)
+
+require 'rubygems'
+require 'bundler/setup'
+
+load Gem.bin_path('rspec-core', 'rspec')

data/lib/suspenders/actions.rb

@@ -0,0 +1,33 @@
+module Suspenders
+  module Actions
+    def replace_in_file(relative_path, find, replace)
+      path = File.join(destination_root, relative_path)
+      contents = IO.read(path)
+      unless contents.gsub!(find, replace)
+        raise "#{find.inspect} not found in #{relative_path}"
+      end
+      File.open(path, "w") { |file| file.write(contents) }
+    end
+
+    def action_mailer_host(rails_env, host)
+      config = "config.action_mailer.default_url_options = { host: #{host} }"
+      configure_environment(rails_env, config)
+    end
+
+    def configure_application_file(config)
+      inject_into_file(
+        "config/application.rb",
+        "\n\n    #{config}",
+        before: "\n  end"
+      )
+    end
+
+    def configure_environment(rails_env, config)
+      inject_into_file(
+        "config/environments/#{rails_env}.rb",
+        "\n\n  #{config}",
+        before: "\nend"
+      )
+    end
+  end
+end

data/lib/suspenders/app_builder.rb

@@ -0,0 +1,512 @@
+module Suspenders
+  class AppBuilder < Rails::AppBuilder
+    include Suspenders::Actions
+
+    def readme
+      template 'README.md.erb', 'README.md'
+    end
+
+    def raise_on_delivery_errors
+      replace_in_file 'config/environments/development.rb',
+        'raise_delivery_errors = false', 'raise_delivery_errors = true'
+    end
+
+    def set_test_delivery_method
+      inject_into_file(
+        "config/environments/development.rb",
+        "\n  config.action_mailer.delivery_method = :test",
+        after: "config.action_mailer.raise_delivery_errors = true",
+      )
+    end
+
+    def raise_on_unpermitted_parameters
+      config = <<-RUBY
+    config.action_controller.action_on_unpermitted_parameters = :raise
+      RUBY
+
+      inject_into_class "config/application.rb", "Application", config
+    end
+
+    def provide_setup_script
+      template "setup.rb", "setup.rb"
+    end
+
+    def configure_generators
+      config = <<-RUBY
+
+    config.generators do |generate|
+      generate.helper false
+      generate.javascript_engine false
+      generate.request_specs false
+      generate.routing_specs false
+      generate.stylesheets false
+      generate.test_framework :rspec
+      generate.view_specs false
+    end
+
+      RUBY
+
+      inject_into_class 'config/application.rb', 'Application', config
+    end
+
+    def set_up_factory_girl_for_rspec
+      copy_file 'factory_girl_rspec.rb', 'spec/support/factory_girl.rb'
+    end
+
+    def configure_newrelic
+      template 'newrelic.yml.erb', 'config/newrelic.yml'
+    end
+
+    def configure_smtp
+      copy_file 'smtp.rb', 'config/smtp.rb'
+
+      prepend_file 'config/environments/production.rb',
+        %{require Rails.root.join("config/smtp")\n}
+
+      config = <<-RUBY
+
+  config.action_mailer.delivery_method = :smtp
+  config.action_mailer.smtp_settings = SMTP_SETTINGS
+      RUBY
+
+      inject_into_file 'config/environments/production.rb', config,
+        :after => 'config.action_mailer.raise_delivery_errors = false'
+    end
+
+    def enable_rack_canonical_host
+      config = <<-RUBY
+
+  # Ensure requests are only served from one, canonical host name
+  config.middleware.use Rack::CanonicalHost, ENV.fetch("HOST")
+      RUBY
+
+      inject_into_file(
+        "config/environments/production.rb",
+        config,
+        after: serve_static_files_line
+      )
+    end
+
+    def enable_rack_deflater
+      config = <<-RUBY
+
+  # Enable deflate / gzip compression of controller-generated responses
+  config.middleware.use Rack::Deflater
+      RUBY
+
+      inject_into_file(
+        "config/environments/production.rb",
+        config,
+        after: serve_static_files_line
+      )
+    end
+
+    def setup_asset_host
+      replace_in_file 'config/environments/production.rb',
+        "# config.action_controller.asset_host = 'http://assets.example.com'",
+        'config.action_controller.asset_host = ENV.fetch("ASSET_HOST", ENV.fetch("HOST"))'
+
+      replace_in_file 'config/initializers/assets.rb',
+        "config.assets.version = '1.0'",
+        'config.assets.version = (ENV["ASSETS_VERSION"] || "1.0")'
+
+      inject_into_file(
+        "config/environments/production.rb",
+        '  config.static_cache_control = "public, max-age=#{1.year.to_i}"',
+        after: serve_static_files_line
+      )
+    end
+
+    def setup_staging_environment
+      staging_file = 'config/environments/staging.rb'
+      copy_file 'staging.rb', staging_file
+
+      config = <<-RUBY
+
+Rails.application.configure do
+  # ...
+end
+      RUBY
+
+      append_file staging_file, config
+    end
+
+    def setup_secret_token
+      template 'secrets.yml', 'config/secrets.yml', force: true
+    end
+
+    def disallow_wrapping_parameters
+      remove_file "config/initializers/wrap_parameters.rb"
+    end
+
+    def create_partials_directory
+      empty_directory 'app/views/application'
+    end
+
+    def create_shared_flashes
+      copy_file "_flashes.html.erb", "app/views/application/_flashes.html.erb"
+      copy_file "flashes_helper.rb", "app/helpers/flashes_helper.rb"
+    end
+
+    def create_shared_javascripts
+      copy_file '_javascript.html.erb', 'app/views/application/_javascript.html.erb'
+    end
+
+    def create_application_layout
+      template 'suspenders_layout.html.erb.erb',
+        'app/views/layouts/application.html.erb',
+        force: true
+    end
+
+    def use_postgres_config_template
+      template 'postgresql_database.yml.erb', 'config/database.yml',
+        force: true
+    end
+
+    def create_database
+      bundle_command 'exec rake db:create db:migrate'
+    end
+
+    def replace_gemfile
+      remove_file 'Gemfile'
+      template 'Gemfile.erb', 'Gemfile'
+    end
+
+    def version_gems_in_gemfile
+      gemfile = File.read('Gemfile')
+
+      require 'bundler'
+      locks = Bundler.locked_gems
+      specs = locks.specs
+
+      # Naively convert to single quotes
+      gemfile.gsub! '"', "'"
+
+      specs.each do |gem|
+        name, version = gem.name, gem.version
+
+        # Don't try to set version if:
+        # * source is git or github
+        # * version is already set
+        gemfile.gsub! /^(?!.*, (git:|github:|'))( *gem '#{name}')/, "\\2, '~> #{version}'"
+      end
+
+      File.open 'Gemfile', 'w+' do |file|
+        file.puts gemfile
+      end
+    end
+
+    def set_ruby_to_version_being_used
+      create_file '.ruby-version', "#{Suspenders::RUBY_VERSION}\n"
+    end
+
+    def setup_heroku_specific_gems
+      inject_into_file(
+        "Gemfile",
+        %{\n\s\sgem "rails_12factor"},
+        after: /group :staging, :production do/
+      )
+    end
+
+    def enable_database_cleaner
+      copy_file 'database_cleaner_rspec.rb', 'spec/support/database_cleaner.rb'
+    end
+
+    def configure_spec_support_features
+      empty_directory_with_keep_file 'spec/features'
+      empty_directory_with_keep_file 'spec/support/features'
+    end
+
+    def configure_rspec
+      remove_file "spec/rails_helper.rb"
+      remove_file "spec/spec_helper.rb"
+      copy_file "rails_helper.rb", "spec/rails_helper.rb"
+      copy_file "spec_helper.rb", "spec/spec_helper.rb"
+    end
+
+    def configure_i18n_for_test_environment
+      copy_file "i18n.rb", "spec/support/i18n.rb"
+    end
+
+    def configure_i18n_for_missing_translations
+      raise_on_missing_translations_in("development")
+      raise_on_missing_translations_in("test")
+    end
+
+    def configure_i18n_tasks
+      run "cp $(i18n-tasks gem-path)/templates/rspec/i18n_spec.rb spec/"
+      copy_file "config_i18n_tasks.yml", "config/i18n-tasks.yml"
+    end
+
+    def configure_action_mailer_in_specs
+      copy_file 'action_mailer.rb', 'spec/support/action_mailer.rb'
+    end
+
+    def configure_time_formats
+      remove_file "config/locales/en.yml"
+      template "config_locales_en.yml.erb", "config/locales/en.yml"
+    end
+
+    def configure_rack_timeout
+      rack_timeout_config = <<-RUBY
+Rack::Timeout.timeout = (ENV["RACK_TIMEOUT"] || 10).to_i
+      RUBY
+
+      append_file "config/environments/production.rb", rack_timeout_config
+    end
+
+    def configure_simple_form
+      bundle_command "exec rails generate simple_form:install"
+    end
+
+    def configure_action_mailer
+      action_mailer_host "development", %{"localhost:#{port}"}
+      action_mailer_host "test", %{"www.example.com"}
+      action_mailer_host "staging", %{ENV.fetch("HOST")}
+      action_mailer_host "production", %{ENV.fetch("HOST")}
+    end
+
+    def configure_active_job
+      configure_application_file(
+        "config.active_job.queue_adapter = :sidekiq"
+      )
+      configure_environment "test", "config.active_job.queue_adapter = :inline"
+    end
+
+    def fix_i18n_deprecation_warning
+      config = <<-RUBY
+    config.i18n.enforce_available_locales = true
+      RUBY
+
+      inject_into_class 'config/application.rb', 'Application', config
+    end
+
+    def generate_rspec
+      generate 'rspec:install'
+    end
+
+    def configure_unicorn
+      copy_file 'unicorn.rb', 'config/unicorn.rb'
+    end
+
+    def setup_foreman
+      copy_file 'Procfile', 'Procfile'
+    end
+
+    def setup_stylesheets
+      remove_file "app/assets/stylesheets/application.css"
+      copy_file "application.scss",
+                "app/assets/stylesheets/application.scss"
+    end
+
+    def setup_javascripts
+      remove_file "app/assets/javascripts/application.js"
+      copy_file "application.js", "app/assets/javascripts/application.js"
+      create_empty_directory('app/assets/javascripts/application')
+    end
+
+    def gitignore_files
+      remove_file '.gitignore'
+      copy_file 'suspenders_gitignore', '.gitignore'
+      [
+        'app/views/pages',
+        'app/workers',
+        'spec/lib',
+        'spec/controllers',
+        'spec/helpers',
+        'spec/support/matchers',
+        'spec/support/mixins',
+        'spec/support/shared_examples'
+      ].each do |dir|
+        create_empty_directory(dir)
+      end
+    end
+
+    def init_git
+      run 'git init'
+    end
+
+    def setup_deployment_environment_branches
+      run 'git branch staging'
+      run 'git branch production'
+    end
+
+    def create_initial_commit
+      run 'git add -A'
+      run 'git commit -m "Initial app setup."'
+    end
+
+    def setup_and_push_to_origin_remote(remote_url)
+      run "git remote add origin #{remote_url}"
+      run 'git push --all origin'
+    end
+
+    def create_staging_heroku_app(flags)
+      rack_env = "RACK_ENV=staging RAILS_ENV=staging"
+      app_name = heroku_app_name_for("staging")
+
+      run_heroku "create #{app_name} --ssh-git #{flags}", "staging"
+      run_heroku "config:add #{rack_env}", "staging"
+      configure_heroku_app("staging")
+    end
+
+    def create_production_heroku_app(flags)
+      app_name = heroku_app_name_for("production")
+
+      run_heroku "create #{app_name} --ssh-git #{flags}", "production"
+      configure_heroku_app("production")
+    end
+
+    def create_heroku_apps(flags)
+      create_staging_heroku_app(flags)
+      create_production_heroku_app(flags)
+    end
+
+    def configure_heroku_app(environment)
+      run_heroku "addons:create mandrill", environment
+      run_heroku "addons:create airbrake:free_heroku", environment
+      run_heroku "addons:create papertrail", environment
+
+      domain = "#{heroku_app_name_for(environment)}.herokuapp.com"
+
+      env_vars = [
+        'SMTP_DOMAIN=heroku.com',
+        'SMTP_ADDRESS=smtp.mandrillapp.com',
+        'SMTP_PROVIDER=mandrill',
+        "HOST=#{domain}",
+        "ASSET_HOST=#{domain}"
+      ]
+
+      run_heroku "config:add #{env_vars.join(' ')}", environment
+    end
+
+    def set_heroku_rails_secrets
+      %w(staging production).each do |environment|
+        run_heroku "config:add SECRET_KEY_BASE=#{generate_secret}", environment
+      end
+    end
+
+    def set_heroku_serve_static_files
+      %w(staging production).each do |environment|
+        run_heroku "config:add RAILS_SERVE_STATIC_FILES=true", environment
+      end
+    end
+
+    def create_github_repo(repo_name)
+      path_addition = override_path_for_tests
+      run "#{path_addition} hub create #{repo_name} -p"
+    end
+
+    def setup_segment
+      copy_file '_analytics.html.erb',
+        'app/views/application/_analytics.html.erb'
+    end
+
+    def setup_bundler_audit
+      copy_file "bundler_audit.rake", "lib/tasks/bundler_audit.rake"
+    end
+
+    def setup_spring
+      bundle_command "exec spring binstub --all"
+    end
+
+    def copy_miscellaneous_files
+      copy_file "errors.rb", "config/initializers/errors.rb"
+      copy_file "json_encoding.rb", "config/initializers/json_encoding.rb"
+    end
+
+    def customize_error_pages
+      meta_tags =<<-EOS
+  <meta charset="utf-8" />
+  <meta name="ROBOTS" content="NOODP" />
+  <meta name="viewport" content="initial-scale=1" />
+      EOS
+
+      %w(500 404 422).each do |page|
+        inject_into_file "public/#{page}.html", meta_tags, :after => "<head>\n"
+        replace_in_file "public/#{page}.html", /<!--.+-->\n/, ''
+      end
+    end
+
+    def remove_routes_comment_lines
+      replace_in_file 'config/routes.rb',
+        /Rails\.application\.routes\.draw do.*end/m,
+        "Rails.application.routes.draw do\nend"
+    end
+
+    def disable_xml_params
+      copy_file 'disable_xml_params.rb', 'config/initializers/disable_xml_params.rb'
+    end
+
+    def setup_default_rake_task
+      append_file 'Rakefile' do
+        <<-EOS
+task(:default).clear
+
+if defined?(RSpec) && defined?(RuboCop)
+  require 'rubocop/rake_task'
+  require 'rspec/core/rake_task'
+
+  RuboCop::RakeTask.new
+
+  task default: [:spec, :rubocop]
+end
+        EOS
+      end
+    end
+
+    def configure_rubocop
+      template '.rubocop.yml', '.rubocop.yml'
+    end
+
+    def configure_airbrake
+      template 'airbrake.rb', 'config/initializers/airbrake.rb'
+    end
+
+    def run_stairs
+      bundle_command 'install'
+      bundle_command 'exec stairs --use-defaults'
+    end
+
+    private
+
+    def raise_on_missing_translations_in(environment)
+      config = 'config.action_view.raise_on_missing_translations = true'
+
+      uncomment_lines("config/environments/#{environment}.rb", config)
+    end
+
+    def override_path_for_tests
+      if ENV['TESTING']
+        support_bin = File.expand_path(File.join('..', '..', 'spec', 'fakes', 'bin'))
+        "PATH=#{support_bin}:$PATH"
+      end
+    end
+
+    def run_heroku(command, environment)
+      path_addition = override_path_for_tests
+      run "#{path_addition} heroku #{command} --remote #{environment}"
+    end
+
+    def generate_secret
+      SecureRandom.hex(64)
+    end
+
+    def port
+      @port ||= [3000, 4000, 5000, 7000, 8000, 9000].sample
+    end
+
+    def serve_static_files_line
+      "config.serve_static_files = ENV['RAILS_SERVE_STATIC_FILES'].present?\n"
+    end
+
+    def heroku_app_name_for(environment)
+      "#{app_name.dasherize}-#{environment}"
+    end
+
+    def create_empty_directory(name)
+      run "mkdir #{name}"
+      run "touch #{name}/.keep"
+    end
+  end
+end