welaika-suspenders 1.2.3

data/lib/suspenders/app_builder.rb

@@ -0,0 +1,295 @@
+module Suspenders
+  class AppBuilder < Rails::AppBuilder
+    include Suspenders::Actions
+
+    def readme
+      template 'README.md.erb', 'README.md'
+    end
+
+    def remove_public_index
+      remove_file 'public/index.html'
+    end
+
+    def remove_rails_logo_image
+      remove_file 'app/assets/images/rails.png'
+    end
+
+    def raise_delivery_errors
+      replace_in_file 'config/environments/development.rb',
+        'raise_delivery_errors = false', 'raise_delivery_errors = true'
+    end
+
+    def provide_setup_script
+      copy_file 'bin_setup', 'bin/setup'
+      run 'chmod a+x bin/setup'
+    end
+
+    def enable_factory_girl_syntax
+      copy_file 'factory_girl_syntax_rspec.rb', 'spec/support/factory_girl.rb'
+    end
+
+    def test_factories_first
+      copy_file 'factories_spec.rb', 'spec/models/factories_spec.rb'
+      append_file 'Rakefile', factories_spec_rake_task
+    end
+
+    def configure_smtp
+      copy_file 'smtp.rb', 'config/initializers/smtp.rb'
+
+      prepend_file 'config/environments/production.rb',
+        "require Rails.root.join('config/initializers/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 setup_staging_environment
+      run 'cp config/environments/production.rb config/environments/staging.rb'
+
+      prepend_file 'config/environments/staging.rb',
+        "Mail.register_interceptor RecipientInterceptor.new(ENV['EMAIL_RECIPIENTS'])\n"
+    end
+
+    def initialize_on_precompile
+      inject_into_file 'config/application.rb',
+        "\n    config.assets.initialize_on_precompile = false",
+        :after => 'config.assets.enabled = true'
+    end
+
+    def create_partials_directory
+      empty_directory 'app/views/application'
+    end
+
+    def create_shared_flashes
+      copy_file '_flashes.html.slim', 'app/views/application/_flashes.html.slim'
+    end
+
+    def create_shared_javascripts
+      copy_file '_javascript.html.slim', 'app/views/application/_javascript.html.slim'
+    end
+
+    def create_application_layout
+      remove_file 'app/views/layouts/application.html.erb'
+      template 'suspenders_layout.html.slim.erb',
+        'app/views/layouts/application.html.slim',
+        :force => true
+    end
+
+    def setup_javascripts
+      remove_file 'app/assets/javascripts/application.js'
+      copy_file 'import_common_javascripts', 'app/assets/javascripts/application.js.coffee'
+    end
+
+    def setup_presenters
+      copy_file 'presenters.rb', 'config/initializers/basic_presenter.rb'
+    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'
+    end
+
+    def replace_gemfile
+      remove_file 'Gemfile'
+      copy_file 'Gemfile_clean', 'Gemfile'
+    end
+
+    def set_ruby_to_version_being_used
+      inject_into_file 'Gemfile', "\n\nruby '#{RUBY_VERSION}'",
+        after: /source 'https:\/\/rubygems.org'/
+    end
+
+    def enable_database_cleaner
+      copy_file 'database_cleaner_rspec.rb', 'spec/support/database_cleaner.rb'
+    end
+
+    def configure_rspec
+      remove_file '.rspec'
+      copy_file 'rspec', '.rspec'
+      prepend_file 'spec/spec_helper.rb', simplecov_init
+
+      config = <<-RUBY
+    config.generators do |generate|
+      generate.test_framework :rspec
+      generate.helper false
+      generate.stylesheets false
+      generate.javascript_engine false
+      generate.view_specs false
+    end
+
+      RUBY
+
+      inject_into_class 'config/application.rb', 'Application', config
+      replace_in_file 'spec/spec_helper.rb', /RSpec.configure do.*end\n/m, ""
+
+      copy_file 'rspec_config.rb', 'spec/support/rspec_config.rb'
+      copy_file 'unit_spec_helper.rb', 'spec/unit_spec_helper.rb'
+      copy_file 'model_spec_helper.rb', 'spec/model_spec_helper.rb'
+    end
+
+    def blacklist_active_record_attributes
+      replace_in_file 'config/application.rb',
+        'config.active_record.whitelist_attributes = true',
+        'config.active_record.whitelist_attributes = false'
+    end
+
+    def configure_strong_parameters
+      copy_file 'strong_parameters.rb', 'config/initializers/strong_parameters.rb'
+    end
+
+    def configure_time_zone
+      config = <<-RUBY
+    config.active_record.default_timezone = :utc
+
+      RUBY
+      inject_into_class 'config/application.rb', 'Application', config
+    end
+
+    def configure_time_formats
+      remove_file 'config/locales/en.yml'
+      copy_file 'config_locales_en.yml', 'config/locales/en.yml'
+    end
+
+    def configure_rack_timeout
+      copy_file 'rack_timeout.rb', 'config/initializers/rack_timeout.rb'
+    end
+
+    def configure_action_mailer
+      action_mailer_host 'development', "#{app_name}.local"
+      action_mailer_host 'test', 'www.example.com'
+      action_mailer_host 'staging', "staging.#{app_name}.com"
+      action_mailer_host 'production', "#{app_name}.com"
+    end
+
+    def generate_rspec
+      generate 'rspec:install'
+    end
+
+    def configure_capybara_webkit
+      append_file 'spec/spec_helper.rb' do
+        "\nCapybara.javascript_driver = :webkit"
+      end
+    end
+
+    def generate_clearance
+      generate 'clearance:install'
+    end
+
+    def setup_foreman
+      copy_file 'sample.env', '.sample.env'
+      copy_file 'sample.env', '.env'
+      copy_file 'Procfile', 'Procfile'
+    end
+
+    def setup_stylesheets
+      remove_file 'app/assets/stylesheets/application.css'
+      copy_file 'import_sass_styles', 'app/assets/stylesheets/application.css.sass'
+    end
+
+    def gitignore_files
+      concat_file 'suspenders_gitignore', '.gitignore'
+      [
+        'app/models',
+        'app/presenters',
+        'app/assets/images',
+        'db/migrate',
+        'log',
+        'spec/support',
+        'spec/lib',
+        'spec/models',
+        'spec/views',
+        'spec/controllers',
+        'spec/features',
+        'spec/helpers',
+        'spec/presenters',
+        'spec/support/matchers',
+        'spec/support/mixins',
+        'spec/support/shared_examples'
+      ].each do |dir|
+        empty_directory_with_gitkeep dir
+      end
+    end
+
+    def init_git
+      run 'git init'
+    end
+
+    def create_heroku_apps
+      path_addition = override_path_for_tests
+      run "#{path_addition} heroku create #{app_name}-production --remote=production"
+      run "#{path_addition} heroku create #{app_name}-staging --remote=staging"
+      run "#{path_addition} heroku config:add RACK_ENV=staging RAILS_ENV=staging --remote=staging"
+    end
+
+    def create_github_repo(repo_name)
+      path_addition = override_path_for_tests
+      run "#{path_addition} hub create #{repo_name}"
+    end
+
+    def copy_miscellaneous_files
+      copy_file 'errors.rb', 'config/initializers/errors.rb'
+    end
+
+    def customize_error_pages
+      meta_tags =<<-EOS
+  <meta charset='utf-8' />
+  <meta name='ROBOTS' content='NOODP' />
+      EOS
+      style_tags =<<-EOS
+<link href='/assets/application.css' media='all' rel='stylesheet' type='text/css' />
+      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", /<style.+>.+<\/style>/mi, style_tags.strip
+        replace_in_file "public/#{page}.html", /<!--.+-->\n/, ''
+      end
+    end
+
+    def remove_routes_comment_lines
+      replace_in_file 'config/routes.rb',
+        /Application\.routes\.draw do.*end/m,
+        "Application.routes.draw do\nend"
+    end
+
+    def add_email_validator
+      copy_file 'email_validator.rb', 'app/validators/email_validator.rb'
+    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
+        "task(:default).clear\ntask :default => [:spec]"
+      end
+    end
+
+    private
+
+    def override_path_for_tests
+      if ENV['TESTING']
+        support_bin = File.expand_path(File.join('..', '..', '..', 'features', 'support', 'bin'))
+        "PATH=#{support_bin}:$PATH"
+      end
+    end
+
+    def factories_spec_rake_task
+      IO.read find_in_source_paths('factories_spec_rake_task.rb')
+    end
+
+    def simplecov_init
+      IO.read find_in_source_paths('simplecov_init.rb')
+    end
+  end
+end

data/lib/suspenders/generators/app_generator.rb

@@ -0,0 +1,197 @@
+require 'rails/generators'
+require 'rails/generators/rails/app/app_generator'
+
+module Suspenders
+  class AppGenerator < Rails::Generators::AppGenerator
+    class_option :database, :type => :string, :aliases => '-d', :default => 'postgresql',
+      :desc => "Preconfigure for selected database (options: #{DATABASES.join('/')})"
+
+    class_option :heroku, :type => :boolean, :aliases => '-H', :default => false,
+      :desc => 'Create staging and production Heroku apps'
+
+    class_option :github, :type => :string, :aliases => '-G', :default => nil,
+      :desc => 'Create Github repository and add remote origin pointed to repo'
+
+    class_option :skip_test_unit, :type => :boolean, :aliases => '-T', :default => true,
+      :desc => 'Skip Test::Unit files'
+
+    def finish_template
+      invoke :suspenders_customization
+      super
+    end
+
+    def suspenders_customization
+      invoke :remove_files_we_dont_need
+      invoke :customize_gemfile
+      invoke :setup_database
+      invoke :setup_development_environment
+      invoke :setup_test_environment
+      invoke :setup_production_environment
+      invoke :setup_staging_environment
+      invoke :create_suspenders_views
+      invoke :setup_javascripts
+      invoke :setup_presenters
+      invoke :configure_app
+      invoke :setup_stylesheets
+      invoke :copy_miscellaneous_files
+      invoke :customize_error_pages
+      invoke :remove_routes_comment_lines
+      invoke :setup_git
+      invoke :create_heroku_apps
+      invoke :create_github_repo
+      invoke :outro
+    end
+
+    def remove_files_we_dont_need
+      build :remove_public_index
+      build :remove_rails_logo_image
+    end
+
+    def setup_development_environment
+      say 'Setting up the development environment'
+      build :raise_delivery_errors
+      build :provide_setup_script
+    end
+
+    def setup_test_environment
+      say 'Setting up the test environment'
+      build :enable_factory_girl_syntax
+      build :test_factories_first
+      build :generate_rspec
+      build :configure_rspec
+      build :enable_database_cleaner
+      build :configure_capybara_webkit
+      build :setup_guard_spork
+    end
+
+    def setup_production_environment
+      say 'Setting up the production environment'
+      build :configure_smtp
+    end
+
+    def setup_staging_environment
+      say 'Setting up the staging environment'
+      build :setup_staging_environment
+      build :initialize_on_precompile
+    end
+
+    def create_suspenders_views
+      say 'Creating suspenders views'
+      build :create_partials_directory
+      build :create_shared_flashes
+      build :create_shared_javascripts
+      build :create_application_layout
+    end
+
+    def setup_javascripts
+      say 'Setting up javascripts'
+      build :setup_javascripts
+    end
+
+    def setup_presenters
+      say 'Setting up presenters'
+      build :setup_presenters
+    end
+
+    def customize_gemfile
+      build :replace_gemfile
+      build :set_ruby_to_version_being_used
+      bundle_command 'install --binstubs=bin/stubs'
+    end
+
+    def setup_database
+      say 'Setting up database'
+
+      if 'postgresql' == options[:database]
+        build :use_postgres_config_template
+      end
+
+      build :create_database
+    end
+
+    def configure_app
+      say 'Configuring app'
+      build :configure_action_mailer
+      build :blacklist_active_record_attributes
+      build :configure_strong_parameters
+      build :configure_time_zone
+      build :configure_time_formats
+      build :configure_rack_timeout
+      build :disable_xml_params
+      build :add_email_validator
+      build :setup_default_rake_task
+      build :setup_foreman
+    end
+
+    def setup_stylesheets
+      say 'Set up stylesheets'
+      build :setup_stylesheets
+    end
+
+    def setup_git
+      say 'Initializing git'
+      invoke :setup_gitignore
+      invoke :init_git
+    end
+
+    def create_heroku_apps
+      if options[:heroku]
+        say 'Creating Heroku apps'
+        build :create_heroku_apps
+      end
+    end
+
+    def create_github_repo
+      if options[:github]
+        say 'Creating Github repo'
+        build :create_github_repo, options[:github]
+      end
+    end
+
+    def setup_gitignore
+      build :gitignore_files
+    end
+
+    def init_git
+      build :init_git
+    end
+
+    def copy_libraries
+      say 'Copying libraries'
+      build :copy_libraries
+    end
+
+    def copy_miscellaneous_files
+      say 'Copying miscellaneous support files'
+      build :copy_miscellaneous_files
+    end
+
+    def customize_error_pages
+      say 'Customizing the 500/404/422 pages'
+      build :customize_error_pages
+    end
+
+    def remove_routes_comment_lines
+      build :remove_routes_comment_lines
+    end
+
+    def outro
+      say 'Congratulations! You just pulled our suspenders.'
+      say "Remember to run 'rails generate airbrake' with your API key."
+    end
+
+    def run_bundle
+      # Let's not: We'll bundle manually at the right spot
+    end
+
+    protected
+
+    def get_builder_class
+      Suspenders::AppBuilder
+    end
+
+    def using_active_record?
+      !options[:skip_active_record]
+    end
+  end
+end

data/lib/suspenders/version.rb

@@ -0,0 +1,3 @@
+module Suspenders
+  VERSION = '1.2.3'
+end

data/templates/Gemfile_clean

@@ -0,0 +1,46 @@
+source 'https://rubygems.org'
+
+gem 'airbrake'
+gem 'basic_presenter'
+gem 'bourbon'
+gem 'flutie'
+gem 'jquery-rails'
+gem 'pg'
+gem 'rack-timeout'
+gem 'rails', '>= 3.2.11'
+gem 'recipient_interceptor'
+gem 'simple_form'
+gem 'slim-rails'
+gem 'strong_parameters'
+gem 'thin'
+
+group :assets do
+  gem 'coffee-rails'
+  gem 'sass-rails'
+  gem 'uglifier'
+end
+
+group :development do
+  gem 'foreman'
+  gem 'better_errors'
+  gem 'binding_of_caller'
+end
+
+group :development, :test do
+  gem 'factory_girl_rails'
+  gem 'rspec-rails'
+end
+
+group :test do
+  gem 'bourne', require: false
+  gem 'capybara-webkit', '>= 0.14.1'
+  gem 'database_cleaner'
+  gem 'launchy'
+  gem 'shoulda-matchers'
+  gem 'simplecov', require: false
+  gem 'timecop'
+end
+
+group :staging, :production do
+  gem 'newrelic_rpm'
+end

data/templates/Procfile

@@ -0,0 +1 @@
+web: bundle exec rails server thin -p $PORT -e $RACK_ENV

data/templates/README.md.erb

@@ -0,0 +1,9 @@
+You look great in Suspenders
+============================
+
+Use the following guides for getting things done, programming well, and
+programming in style.
+
+* [Protocol](http://github.com/thoughtbot/guides/blob/master/protocol)
+* [Best Practices](http://github.com/thoughtbot/guides/blob/master/best-practices)
+* [Style](http://github.com/thoughtbot/guides/blob/master/style)

data/templates/_flashes.html.slim

@@ -0,0 +1,3 @@
+#flash
+  - flash.each do |key, value|
+    div id="flash_#{key}"= value

data/templates/_javascript.html.slim

@@ -0,0 +1,5 @@
+= javascript_include_tag :application
+= yield :javascript
+- if Rails.env.test?
+  javascript:
+    $.ajaxSetup({ async: false });

data/templates/bin_setup

@@ -0,0 +1,11 @@
+#!/usr/bin/env sh
+
+# Set up Rails app. Run this script immediately after cloning the codebase.
+# https://github.com/thoughtbot/guides/tree/master/protocol
+
+bundle install --binstubs=bin/stubs
+bundle exec rake db:setup
+
+if [ ! -f .env ]; then
+  cp .sample.env .env
+fi

data/templates/config_locales_en.yml

@@ -0,0 +1,11 @@
+en:
+  date:
+    formats:
+      default: '%m/%d/%Y'
+      with_weekday: '%a %m/%d/%y'
+
+  time:
+    formats:
+      default: '%a, %b %-d, %Y at %r'
+      date: '%b %-d, %Y'
+      short: '%B %d'

data/templates/database_cleaner_rspec.rb

@@ -0,0 +1,21 @@
+RSpec.configure do |config|
+  config.before(:suite) do
+    DatabaseCleaner.clean_with(:deletion)
+  end
+
+  config.before(:each) do
+    DatabaseCleaner.strategy = :transaction
+  end
+
+  config.before(:each, :js => true) do
+    DatabaseCleaner.strategy = :deletion
+  end
+
+  config.before(:each) do
+    DatabaseCleaner.start
+  end
+
+  config.after(:each) do
+    DatabaseCleaner.clean
+  end
+end

data/templates/disable_xml_params.rb

@@ -0,0 +1,3 @@
+# Protect against injection attacks
+# http://www.kb.cert.org/vuls/id/380039
+ActionDispatch::ParamsParser::DEFAULT_PARSERS.delete(Mime::XML)

data/templates/email_validator.rb

@@ -0,0 +1,7 @@
+class EmailValidator < ActiveModel::EachValidator
+  def validate_each(record, attribute, value)
+    unless value =~ /\A([^@\s]+)@((?:[-a-z0-9]+\.)+[a-z]{2,})\z/i
+      record.errors[attribute] << (options[:message] || "is not an email")
+    end
+  end
+end

data/templates/errors.rb

@@ -0,0 +1,28 @@
+require 'net/http'
+require 'net/smtp'
+
+# Example:
+#   begin
+#     some http call
+#   rescue *HTTP_ERRORS => error
+#     notify_hoptoad error
+#   end
+
+HTTP_ERRORS = [Timeout::Error,
+               Errno::EINVAL,
+               Errno::ECONNRESET,
+               EOFError,
+               Net::HTTPBadResponse,
+               Net::HTTPHeaderSyntaxError,
+               Net::ProtocolError]
+
+SMTP_SERVER_ERRORS = [TimeoutError,
+                      IOError,
+                      Net::SMTPUnknownError,
+                      Net::SMTPServerBusy,
+                      Net::SMTPAuthenticationError]
+
+SMTP_CLIENT_ERRORS = [Net::SMTPFatalError,
+                      Net::SMTPSyntaxError]
+
+SMTP_ERRORS = SMTP_SERVER_ERRORS + SMTP_CLIENT_ERRORS

data/templates/factories_spec.rb

@@ -0,0 +1,14 @@
+require 'spec_helper'
+
+describe 'validate FactoryGirl factories' do
+  FactoryGirl.factories.each do |factory|
+    context "with factory for :#{factory.name}" do
+      subject { FactoryGirl.build(factory.name) }
+
+      it 'is valid' do
+        is_valid = subject.valid?
+        expect(is_valid).to be_true, subject.errors.full_messages.join(',')
+      end
+    end
+  end
+end

data/templates/factories_spec_rake_task.rb

@@ -0,0 +1,9 @@
+
+if defined?(RSpec)
+  desc 'Run factory specs.'
+  RSpec::Core::RakeTask.new(:factory_specs) do |t|
+    t.pattern = './spec/models/factories_spec.rb'
+  end
+
+  task spec: :factory_specs
+end

data/templates/factory_girl_syntax_rspec.rb

@@ -0,0 +1,3 @@
+RSpec.configure do |config|
+  config.include FactoryGirl::Syntax::Methods
+end

data/templates/import_common_javascripts

@@ -0,0 +1,4 @@
+#= require jquery
+#= require jquery_ujs
+
+$ ->