suspenders 1.51.0 → 1.55.0

data/templates/descriptions/advisories.md

@@ -0,0 +1,5 @@
+Show security advisories during development.
+
+Uses the `bundler-audit` gem and rake task to update the local security
+database and show any relevant issues with the app's dependencies. This happens
+on every test run and interaction with `bin/rake` and `bin/rails`.

data/templates/descriptions/analytics.md

@@ -0,0 +1,4 @@
+Work with a user analytics service.
+
+Add the JavaScript for connecting to Segment to a partial and, if possible,
+include that partial on every page.

data/templates/descriptions/ci.md

@@ -0,0 +1,4 @@
+Prepare the app for running tests on a continuous integration service.
+
+Sets up a CircleCI configuration using `bin/setup` to initialize the app and
+`rake` to run the tests. Use SimpleCov for code coverage metrics on CI.

data/templates/descriptions/compression.md

@@ -0,0 +1,4 @@
+Compress HTTP requests at the Rails layer.
+
+This uses `Rack::Deflater`, and is done at the app layer instead of at the Web
+server layer.

data/templates/descriptions/db_optimizations.md

@@ -0,0 +1,2 @@
+Get database performance insights as you develop. This installs and configures
+Bullet.

data/templates/descriptions/deployment.md

@@ -0,0 +1,5 @@
+Script and document the deployment.
+
+This adds a `bin/deploy` script, to be called like `deploy staging` or
+`deploy production`, along with updates to the README.md describing how to use
+it.

data/templates/descriptions/email.md

@@ -0,0 +1,9 @@
+Configure the app for email.
+
+Set the app up with SMTP in production. This expects the following environment
+variables to be set:
+
+- `SMTP_ADDRESS`
+- `SMTP_DOMAIN`
+- `SMTP_PASSWORD`
+- `SMTP_USERNAME`

data/templates/descriptions/factories.md

@@ -0,0 +1,12 @@
+Build test data with clarity and ease.
+
+This uses FactoryBot to help you define dummy and test data for your test
+suite. The `create`, `build`, and `build_stubbed` class methods are directly
+available to all tests.
+
+We recommend putting FactoryBot definitions in one `spec/factories.rb` file, at
+least until it grows unwieldy. This helps reduce confusion around circular
+dependencies and makes it easy to jump between definitions.
+
+Outside of the tests, the `dev:prime` rake task can be used to insert initial
+development data into the database. You can use FactoryBot here, too.

data/templates/descriptions/force_tls.md

@@ -0,0 +1 @@
+Redirect users to the HTTPS URL on the production Web site.

data/templates/descriptions/forms.md

@@ -0,0 +1 @@
+Make forms easier to make with form helpers. This mostly involves SimpleForm.

data/templates/descriptions/inline_svg.md

@@ -0,0 +1,2 @@
+Render SVG images inline, as a potential performance improvement for the
+viewer.

data/templates/descriptions/jobs.md

@@ -0,0 +1,3 @@
+Set up our favorite job runner.
+
+Currently we like DelayedJob. Run all tests inline by default.

data/templates/descriptions/js_driver.md

@@ -0,0 +1,4 @@
+Set up the test suite for running JavaScript tests.
+
+This uses the latest and greatest JavaScript test runner -- currently,
+chromedriver. It comes with a headless mode and a headful/debugging mode.

data/templates/descriptions/json.md

@@ -0,0 +1 @@
+Use the fastest JSON parser available.

data/templates/descriptions/lint.md

@@ -0,0 +1,3 @@
+Prepare the app for style linting.
+
+This sets up your app to use Hound with a default Hound configuration.

data/templates/descriptions/manifest.md

@@ -0,0 +1,2 @@
+Write the AppManifest (`app.json`) document with all the environment variables
+we require.

data/templates/descriptions/preloader.md

@@ -0,0 +1,3 @@
+Speed up your Rails development flow with a preloader.
+
+This installs Spring, including the Spring binstubs.

data/templates/descriptions/profiler.md

@@ -0,0 +1,7 @@
+Show runtime profiling for your Rails app as you develop it.
+
+This uses the `rack-mini-profiler` gem to show a speed badge on every page.
+This is controlled by the `RACK_MINI_PROFILER` environment variable which
+defaults to `0` in the `.sample.env`. Set it to `1` to enable profiling.
+
+Updates your README.md to explain this environment variable.

data/templates/descriptions/pull_requests.md

@@ -0,0 +1,4 @@
+Create a staging environment for each pull request.
+
+This glues Heroku review apps to GitHub pull requests, populating the database
+from the generic staging environment on a low-scale review app.

data/templates/descriptions/runner.md

@@ -0,0 +1,10 @@
+Set up the app to run locally with ease.
+
+Use Puma and the Rails jobs runner to run the app. This can be done via either
+`heroku local` or any Foreman-compatible project runner (e.g. `foreman start`).
+
+Configure your app using `.env`. Installs a basic `.sample.env` that is meant
+to be checked into git and used as a template for your `.env`. The `bin/setup`
+script is modified to safely copy `.sample.env` to `.env` for you.
+
+Document all of this in the README.

data/templates/descriptions/single_redirect.md

@@ -0,0 +1 @@
+Canonicalize the URL by configuring the `Rack::CanonicalHost` middleware.

data/templates/descriptions/static.md

@@ -0,0 +1,5 @@
+Easily add static pages to your dynamic Rails app.
+
+Files placed in the `app/views/pages` directory are rendered using the standard
+Rails view renderer and accessible at `/pages/:view_name`, via the
+`high_voltage` gem.

data/templates/descriptions/stylelint.md

@@ -0,0 +1,3 @@
+Enable stylesheet linting.
+
+This configures the stylelint tool to work locally and integrated with Hound.

data/templates/descriptions/stylesheet_base.md

@@ -0,0 +1,4 @@
+Set up the basic tools needed for the thoughtbot design system.
+
+This integrates the Bourbon library of Scss mixins with Normalize.css as a
+reset, then re-styles it by bringing Bitters into your project.

data/templates/descriptions/testing.md

@@ -0,0 +1,9 @@
+Set up the project for an in-depth test-driven development workflow.
+
+- Maintain the test DB schema.
+- Clear mail deliveries between tests.
+- Import i18n helpers for use in tests.
+- Prepare for system tests in `spec/system`.
+- Integrate Formulaic for easier form testing.
+- RSpec infers the file type based on the directory name.
+- Install and configure RSpec and shoulda-matchers, with Spring integration.

data/templates/descriptions/timeout.md

@@ -0,0 +1,4 @@
+Kill Rack requests that last too long.
+
+This adds the `rack-timeout` gem and configures it to kill the connection after
+10 seconds.

data/templates/descriptions/views.md

@@ -0,0 +1,8 @@
+View templates for flash, JavaScript, and CSS.
+
+- Disable CSS animations in tests.
+- Run JavaScript when the page has loaded.
+- Use the `title` gem for controlling the page title via i18n.
+- Insert one-off JavaScript into a `:javascript` content block.
+- Creates the directory for storing generic, application-level partials.
+- Render user-facing partials (alert, error, notice, success) on all pages.

data/templates/errors.rb

@@ -15,7 +15,7 @@ HTTP_ERRORS = [
   Net::HTTPBadResponse,
   Net::HTTPHeaderSyntaxError,
   Net::ProtocolError,
-  Timeout::Error,
+  Timeout::Error
 ]
 
 SMTP_SERVER_ERRORS = [
@@ -23,12 +23,12 @@ SMTP_SERVER_ERRORS = [
   Net::SMTPAuthenticationError,
   Net::SMTPServerBusy,
   Net::SMTPUnknownError,
-  Timeout::Error,
+  Timeout::Error
 ]
 
 SMTP_CLIENT_ERRORS = [
   Net::SMTPFatalError,
-  Net::SMTPSyntaxError,
+  Net::SMTPSyntaxError
 ]
 
 SMTP_ERRORS = SMTP_SERVER_ERRORS + SMTP_CLIENT_ERRORS

data/templates/hound.yml

@@ -7,8 +7,7 @@ javascript:
   enabled: true
   # ignore_file: .javascript_ignore
 ruby:
-  # config_file: .ruby-style.yml
-  enabled: true
+  enabled: false
 scss:
   enabled: false
 stylelint:

data/templates/inline_svg.rb

@@ -0,0 +1,3 @@
+InlineSvg.configure do |config|
+  config.raise_on_file_not_found = true
+end

data/templates/partials/ci_simplecov.rb

@@ -0,0 +1,14 @@
+if ENV.fetch("COVERAGE", false)
+  require "simplecov"
+
+  if ENV["CIRCLE_ARTIFACTS"]
+    dir = File.join(ENV["CIRCLE_ARTIFACTS"], "coverage")
+    SimpleCov.coverage_dir(dir)
+  end
+
+  SimpleCov.start "rails"
+
+  if defined?(Spring) && ENV["DISABLE_SPRING"].to_i == 1
+    Rails.application.eager_load!
+  end
+end

data/templates/partials/db_optimizations_configuration.rb

@@ -0,0 +1,5 @@
+config.after_initialize do
+  Bullet.enable = true
+  Bullet.bullet_logger = true
+  Bullet.rails_logger = true
+end

data/templates/partials/deployment_readme.md

@@ -0,0 +1,8 @@
+
+## Deploying
+
+If you have previously run the `./bin/setup` script,
+you can deploy to staging and production with:
+
+    % ./bin/deploy staging
+    % ./bin/deploy production

data/templates/partials/email_smtp.rb

@@ -0,0 +1,2 @@
+config.action_mailer.delivery_method = :smtp
+config.action_mailer.smtp_settings = SMTP_SETTINGS

data/templates/partials/profiler_readme.md

@@ -0,0 +1,8 @@
+
+## Profiler
+
+The [rack-mini-profiler] gem can be enabled by setting
+`RACK_MINI_PROFILER=1` in the environment. This will display a speed
+badge on every page.
+
+[rack-mini-profiler]: https://github.com/MiniProfiler/rack-mini-profiler

data/templates/partials/pull_requests_config.rb

@@ -0,0 +1,4 @@
+if ENV.fetch("HEROKU_APP_NAME", "").include?("staging-pr-")
+  ENV["APPLICATION_HOST"] = ENV["HEROKU_APP_NAME"] + ".herokuapp.com"
+  ENV["ASSET_HOST"] = ENV["HEROKU_APP_NAME"] + ".herokuapp.com"
+end

data/templates/partials/runner_readme.md

@@ -0,0 +1,31 @@
+## Configuration
+
+Environment variables during local development are handled by the node-foreman
+project runner. To provide environment variables, create a `.env` file at the
+root of the project. In that file provide the environment variables listed in
+`.sample.env`. The `bin/setup` script does this for you, but be careful about
+overwriting your existing `.env` file.
+
+`app.json` also contains a list of environment variables that are required for
+the application. The `.sample.env` file provides either non-secret vars that
+can be copied directly into your own `.env` file or instructions on where to
+obtain secret values.
+
+During development add any new environment variables needed by the application
+to both `.sample.env` and `app.json`, providing either **public** default
+values or brief instructions on where secret values may be found.
+
+Do not commit the `.env` file to the git repo.
+
+## Running the Application
+
+Use the `heroku local` runner to run the app locally as it would run on Heroku.
+This uses the node-forman runner, which reads from the `Procfile` file.
+
+```sh
+heroku local
+```
+
+Once the server is started the application is reachable at
+`http://localhost:3000`.
+

data/templates/partials/runner_setup.rb

@@ -0,0 +1,2 @@
+puts "\n== Copying sample env =="
+system! "cp -i .sample.env .env"

data/templates/rack_mini_profiler.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 if ENV["RACK_MINI_PROFILER"].to_i > 0
   require "rack-mini-profiler"
 

data/templates/rails_helper.rb

@@ -1,19 +1,22 @@
 ENV["RACK_ENV"] = "test"
 
 require File.expand_path("../../config/environment", __FILE__)
-abort("DATABASE_URL environment variable is set") if ENV["DATABASE_URL"]
+
+if Rails.env.production?
+  abort("The Rails environment is running in production mode!")
+end
 
 require "rspec/rails"
 
 Dir[Rails.root.join("spec/support/**/*.rb")].sort.each { |file| require file }
 
-module Features
-  # Extend this module in spec/support/features/*.rb
+module SystemTestHelper
+  # Extend this module in spec/support/system/*.rb
   include Formulaic::Dsl
 end
 
 RSpec.configure do |config|
-  config.include Features, type: :feature
+  config.include SystemTestHelper, type: :system
   config.infer_base_class_for_anonymous_controllers = false
   config.infer_spec_type_from_file_location!
   config.use_transactional_fixtures = true

data/templates/{dotfiles/.env → sample_env}

@@ -3,9 +3,7 @@ ASSET_HOST=localhost:3000
 APPLICATION_HOST=localhost:3000
 PORT=3000
 RACK_ENV=development
-RACK_MINI_PROFILER=0
 SECRET_KEY_BASE=development_secret
-EXECJS_RUNTIME=Node
 SMTP_ADDRESS=smtp.example.com
 SMTP_DOMAIN=example.com
 SMTP_PASSWORD=password

data/templates/spec_helper.rb

@@ -1,9 +1,3 @@
-if ENV.fetch("COVERAGE", false)
-  require "simplecov"
-
-  SimpleCov.start "rails"
-end
-
 require "webmock/rspec"
 require "timecop"
 
@@ -22,7 +16,10 @@ RSpec.configure do |config|
   config.order = :random
 end
 
-WebMock.disable_net_connect!(allow_localhost: true)
+WebMock.disable_net_connect!(
+  allow_localhost: true,
+  allow: "chromedriver.storage.googleapis.com"
+)
 
 # Only allow Timecop with block syntax
 Timecop.safe_mode = true

data/templates/spring.rb

@@ -0,0 +1,6 @@
+Spring.watch(
+  ".ruby-version",
+  ".rbenv-vars",
+  "tmp/restart.txt",
+  "tmp/caching-dev.txt"
+)

data/templates/suspenders_gitignore

@@ -4,7 +4,7 @@
 *.swp
 .byebug_history
 /.bundle
-/.env.local
+/.env
 /coverage/*
 /db/*.sqlite3
 /db/*.sqlite3-journal

metadata

@@ -1,43 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: suspenders
 version: !ruby/object:Gem::Version
-  version: 1.51.0
+  version: 1.55.0
 platform: ruby
 authors:
 - thoughtbot
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-04-26 00:00:00.000000000 Z
+date: 2020-07-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bitters
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: 2.0.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.7'
+        version: 2.0.4
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.2.0
+        version: 6.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 5.2.0
+        version: 6.0.0
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: |
   Suspenders is a base Rails project that you can upgrade. It is used by
   thoughtbot to get a jump start on a working app. Use Suspenders if you're in a
@@ -68,6 +82,7 @@ files:
 - ".ruby-version"
 - ".travis.yml"
 - CONTRIBUTING.md
+- GOALS.md
 - Gemfile
 - LICENSE
 - NEWS.md
@@ -79,10 +94,12 @@ files:
 - bin/rspec
 - bin/setup
 - bin/suspenders
+- docs/heroku_deploy.md
 - lib/suspenders.rb
 - lib/suspenders/actions.rb
 - lib/suspenders/adapters/heroku.rb
 - lib/suspenders/app_builder.rb
+- lib/suspenders/generators/advisories_generator.rb
 - lib/suspenders/generators/analytics_generator.rb
 - lib/suspenders/generators/app_generator.rb
 - lib/suspenders/generators/base.rb
@@ -90,15 +107,21 @@ files:
 - lib/suspenders/generators/db_optimizations_generator.rb
 - lib/suspenders/generators/factories_generator.rb
 - lib/suspenders/generators/forms_generator.rb
+- lib/suspenders/generators/inline_svg_generator.rb
 - lib/suspenders/generators/jobs_generator.rb
 - lib/suspenders/generators/js_driver_generator.rb
 - lib/suspenders/generators/json_generator.rb
 - lib/suspenders/generators/lint_generator.rb
+- lib/suspenders/generators/preloader_generator.rb
+- lib/suspenders/generators/production/compression_generator.rb
 - lib/suspenders/generators/production/deployment_generator.rb
 - lib/suspenders/generators/production/email_generator.rb
 - lib/suspenders/generators/production/force_tls_generator.rb
 - lib/suspenders/generators/production/manifest_generator.rb
+- lib/suspenders/generators/production/single_redirect.rb
 - lib/suspenders/generators/production/timeout_generator.rb
+- lib/suspenders/generators/profiler_generator.rb
+- lib/suspenders/generators/runner_generator.rb
 - lib/suspenders/generators/staging/pull_requests_generator.rb
 - lib/suspenders/generators/static_generator.rb
 - lib/suspenders/generators/stylelint_generator.rb
@@ -107,18 +130,30 @@ files:
 - lib/suspenders/generators/views_generator.rb
 - lib/suspenders/version.rb
 - spec/adapters/heroku_spec.rb
+- spec/expand_json_spec.rb
 - spec/fakes/bin/heroku
 - spec/fakes/bin/hub
+- spec/features/advisories_spec.rb
 - spec/features/api_spec.rb
+- spec/features/ci_spec.rb
 - spec/features/cli_help_spec.rb
+- spec/features/db_optimizations_spec.rb
 - spec/features/github_spec.rb
 - spec/features/heroku_spec.rb
+- spec/features/inline_svg_spec.rb
 - spec/features/json_spec.rb
+- spec/features/lint_spec.rb
 - spec/features/new_project_spec.rb
+- spec/features/preloader_spec.rb
+- spec/features/production/compression_spec.rb
 - spec/features/production/deployment_spec.rb
 - spec/features/production/email_spec.rb
 - spec/features/production/manifest_spec.rb
+- spec/features/production/single_redirect_spec.rb
+- spec/features/profiler_spec.rb
+- spec/features/runner_spec.rb
 - spec/features/staging/pull_requests_spec.rb
+- spec/features/static_spec.rb
 - spec/features/stylelint_spec.rb
 - spec/spec_helper.rb
 - spec/support/be_executable_matcher.rb
@@ -129,6 +164,7 @@ files:
 - spec/support/generators.rb
 - spec/support/match_contents_matcher.rb
 - spec/support/project_files.rb
+- spec/support/rails_template.rb
 - spec/support/suspenders.rb
 - suspenders.gemspec
 - templates/Gemfile.erb
@@ -141,17 +177,43 @@ files:
 - templates/action_mailer.rb
 - templates/active_job.rb
 - templates/application.scss
+- templates/bin_auto_migrate
 - templates/bin_deploy
 - templates/bin_setup
 - templates/bin_setup_review_app.erb
-- templates/browserslist
 - templates/bundler_audit.rake
+- templates/capybara_silence_puma.rb
 - templates/chromedriver.rb
 - templates/circle.yml.erb
 - templates/config_locales_en.yml.erb
+- templates/descriptions/advisories.md
+- templates/descriptions/analytics.md
+- templates/descriptions/ci.md
+- templates/descriptions/compression.md
+- templates/descriptions/db_optimizations.md
+- templates/descriptions/deployment.md
+- templates/descriptions/email.md
+- templates/descriptions/factories.md
+- templates/descriptions/force_tls.md
+- templates/descriptions/forms.md
+- templates/descriptions/inline_svg.md
+- templates/descriptions/jobs.md
+- templates/descriptions/js_driver.md
+- templates/descriptions/json.md
+- templates/descriptions/lint.md
+- templates/descriptions/manifest.md
+- templates/descriptions/preloader.md
+- templates/descriptions/profiler.md
+- templates/descriptions/pull_requests.md
+- templates/descriptions/runner.md
+- templates/descriptions/single_redirect.md
+- templates/descriptions/static.md
+- templates/descriptions/stylelint.md
+- templates/descriptions/stylesheet_base.md
+- templates/descriptions/testing.md
+- templates/descriptions/timeout.md
+- templates/descriptions/views.md
 - templates/dev.rake
-- templates/dotfiles/.ctags
-- templates/dotfiles/.env
 - templates/email.rb
 - templates/errors.rb
 - templates/factories.rb
@@ -159,15 +221,25 @@ files:
 - templates/flashes_helper.rb
 - templates/hound.yml
 - templates/i18n.rb
+- templates/inline_svg.rb
 - templates/json_encoding.rb
+- templates/partials/ci_simplecov.rb
+- templates/partials/db_optimizations_configuration.rb
+- templates/partials/deployment_readme.md
+- templates/partials/email_smtp.rb
+- templates/partials/profiler_readme.md
+- templates/partials/pull_requests_config.rb
+- templates/partials/runner_readme.md
+- templates/partials/runner_setup.rb
 - templates/postgresql_database.yml.erb
-- templates/puma.rb
 - templates/rack_mini_profiler.rb
 - templates/rails_helper.rb
+- templates/sample_env
 - templates/secrets.yml
 - templates/shoulda_matchers_config_rspec.rb
 - templates/smtp.rb
 - templates/spec_helper.rb
+- templates/spring.rb
 - templates/stylelintrc.json
 - templates/suspenders_gitignore
 - templates/suspenders_layout.html.erb.erb
@@ -184,31 +256,43 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.6.3
+      version: 2.6.6
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: 2.7.4
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Generate a Rails app using thoughtbot's best practices.
 test_files:
 - spec/adapters/heroku_spec.rb
+- spec/expand_json_spec.rb
 - spec/fakes/bin/heroku
 - spec/fakes/bin/hub
+- spec/features/advisories_spec.rb
 - spec/features/api_spec.rb
+- spec/features/ci_spec.rb
 - spec/features/cli_help_spec.rb
+- spec/features/db_optimizations_spec.rb
 - spec/features/github_spec.rb
 - spec/features/heroku_spec.rb
+- spec/features/inline_svg_spec.rb
 - spec/features/json_spec.rb
+- spec/features/lint_spec.rb
 - spec/features/new_project_spec.rb
+- spec/features/preloader_spec.rb
+- spec/features/production/compression_spec.rb
 - spec/features/production/deployment_spec.rb
 - spec/features/production/email_spec.rb
 - spec/features/production/manifest_spec.rb
+- spec/features/production/single_redirect_spec.rb
+- spec/features/profiler_spec.rb
+- spec/features/runner_spec.rb
 - spec/features/staging/pull_requests_spec.rb
+- spec/features/static_spec.rb
 - spec/features/stylelint_spec.rb
 - spec/spec_helper.rb
 - spec/support/be_executable_matcher.rb
@@ -219,4 +303,5 @@ test_files:
 - spec/support/generators.rb
 - spec/support/match_contents_matcher.rb
 - spec/support/project_files.rb
+- spec/support/rails_template.rb
 - spec/support/suspenders.rb