hoboken 0.9.0 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d42754fed3189d3de171e54745f49f492b0ff0581aafa53493f0d7f15efbb8b0
-  data.tar.gz: 1cd847b097a929db83a36932d959b2b8d0d94273b408231f06f47c6ae6c6e13d
+  metadata.gz: 2fcb30215523759b04d0249c6ced1c702ece948178682820867f7fb9bc8a84cd
+  data.tar.gz: 80e5100fc0a2e7aa1fd319b7fc6b1555633ab936b1fa487845a5010dcf149153
 SHA512:
-  metadata.gz: 501df84e547ff6ace6e5b987f8f8723f349767647b9fdb532a949b6c8fe65b72502b349309948f7a8a92d09c9091c89b5f05745d288d363893c6fe5647930f4a
-  data.tar.gz: 168647168f6a62fdc1410d63994de32706710eff8017a91bedd31ce961ac6d2379d9494671d0d6154d1ff7a113140ec21b477eb809215bbed9b90e4b84366177
+  metadata.gz: 4752cce9842dcedc3f9163c11d0470fb9ce21a049a08b3086a7955c492503dc573a97f6bdf548a9532b9853721ee5e079a0ebb0e49fe6e5b90121a7efa3b24d5
+  data.tar.gz: 8b186dbe7ee60e1a50445fa787abe02333eb23960034685b394a14d46014a946f1f0de9122169fb1e9fec750b68c451d98ea3b10db8d7b745473521faa37afdb

data/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,33 @@
+---
+name: Bug report
+about: Create a report to help us improve
+title: ''
+labels: bug?
+assignees: bnadlerjr
+
+---
+
+<!--- The GitHub Issue tracker is **ONLY** used for reporting bugs and tracking code changes. Please use StackOverflow or GitHub Discussions for questions or support issues. New features should be discussed on GitHub Discussions **before** creating an issue. For a roadmap of upcoming features, check the GitHub Projects page. --->
+
+<!--- Make sure to add **all the information needed to understand the bug** so that someone can help. If the info is missing we'll add the 'Needs more information' label and close the issue until there is enough information. --->
+
+**Describe the bug**
+<!--- A clear and concise description of what the bug is. --->
+
+**To Reproduce**
+<!--- Provide a link to a live example, or an unambiguous set of steps to reproduce this bug. Include code to reproduce, if relevant. --->
+
+**Expected behavior**
+<!--- A clear and concise description of what you expected to happen. --->
+
+**Screenshots**
+<!--- If applicable, add screenshots to help explain your problem. --->
+
+**Environment (please complete the following information):**
+ - Hoboken Version: [e.g. 0.8.0]
+ - Ruby Version: [e.g. 2.7]
+ - OS and Version: [e.g. macOS Big Sur, Windows 10]
+ - Browser and Version (if applicable): [e.g. chrome, safari]
+
+**Additional context**
+<!--- Add any other context about the problem here. --->

data/.github/ISSUE_TEMPLATE/code_change.md

@@ -0,0 +1,11 @@
+---
+name: Code change
+about: Feature work, refactoring or any other code changes
+title: ''
+assignees: bnadlerjr
+
+---
+
+<!--- The GitHub Issue tracker is **ONLY** used for reporting bugs and tracking code changes. Please use StackOverflow or GitHub Discussions for questions or support issues. New features should be discussed on GitHub Discussions **before** creating an issue. For a roadmap of upcoming features, check the GitHub Projects page. --->
+
+<!--- Describe the requested code change. --->

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,25 @@
+**Description**
+<!--- Describe your changes. Why is this change required? What problem does it solve? Does this PR introduce a breaking change to the public API? --->
+
+**Related Issue**
+<!--- Link to related issue --->
+
+**Screenshots**
+<!--- Optional screenshots --->
+
+**Type of Change**
+<!--- Place an `x` in each box that applies: --->
+[ ] Bug fix (non-breaking change which fixes an issue)
+[ ] New feature (non-breaking change which adds functionality)
+[ ] Code change (non-breaking change which changes existing non-public API)
+[ ] Breaking change (fix or feature that would cause existing functionality to change)
+
+**Checklist**
+<!--- Place an `x` in each box if you have performed the indicated task. --->
+[ ] I have followed the guidelines in the `CONTRIBUTING.md` document.
+[ ] I have ensured that my code follows the code style of this project.
+[ ] I have checked to ensure there aren't other open [Pull Requests](../../../pulls) for the same update / change.
+[ ] I have checked that the CI build passes all tests and linters.
+[ ] I have added tests to cover my changes.
+[ ] I have made any necessary changes to the documentation.
+[ ] I have updated the `Unreleased` section of the `CHANGELOG.md` with a brief description of my change along with my GitHub username.

data/.gitignore

@@ -3,6 +3,9 @@
 .bundle
 .config
 .yardoc
+/www/.cache
+/www/.sass-cache
+/www/build
 Gemfile.lock
 InstalledFiles
 _yardoc

data/.rubocop.yml

@@ -1,5 +1,6 @@
 require:
     - rubocop-rake
+    - rubocop-performance
     - rubocop-rspec # for generated projects
 
 AllCops:
@@ -7,24 +8,31 @@ AllCops:
         - 'test/tmp/*/sample/Gemfile'
         - 'test/fixtures/**/*'
         - 'vendor/bundle/**/*'
+        - 'www/**/*'
     NewCops: enable
     TargetRubyVersion: 2.6
 
-Metrics/BlockLength:
-      IgnoredMethods:
-        - run_hoboken
+Layout/LineLength:
+    Max: 90
 
 Layout/SpaceAroundEqualsInParameterDefault:
     EnforcedStyle: no_space
 
+Metrics/BlockLength:
+      IgnoredMethods:
+        - run_hoboken
+
 Metrics/ClassLength:
     Max: 150
 
 Metrics/MethodLength:
     Max: 15
 
-Layout/LineLength:
-    Max: 90
+RSpec/DescribeClass:
+    Enabled: false
+
+RSpec/MultipleDescribes:
+    Enabled: false
 
 Style/BlockDelimiters:
     EnforcedStyle: braces_for_chaining

data/.tool-versions

@@ -0,0 +1 @@
+ruby 2.7.3

data/CHANGELOG.md

@@ -0,0 +1,131 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+### Added
+### Changed
+### Removed
+### Fixed
+
+## [0.10.0] - 2022-01-17
+### Added
+* Add-on for Sidekiq.
+
+* Add-on for Turnip.
+
+* Add-on for VCR.
+
+* Add-on for Airbrake.
+
+* Add-on for `sinatra-activerecord`.
+
+* Sinatra configuration block for test environment.
+
+* More response codes for RSpec matchers / test unit assertions.
+
+### Changed
+* Define `SESSION_SECRET` in `.env` file so that it is defined only once and
+  can be re-used by other things (like the Sidekiq UI).
+
+* Switch `bin` scripts from bash to Ruby for consistency. Also fixes foreman
+  errors w/ rerun gem by installing them separately from the bundle.
+
+* Force https in production.
+
+* Switch to `sinatra-asset-pipeline`. Remove Sprockets add-on. All non-API
+  generated projects use `sinatra-asset-pipeline`.
+
+* Various generated `README` improvements.
+
+* `--api-only` apps don't get CSRF or cookie support.
+
+* Sequel add-on now installs `rubocop-sequel` if Rubocop is detected.
+
+* Simplecov from metrics add-on ignores `db/migrate` directory.
+
+* RSpec and Rubocop Rake tasks are not loaded in production.
+
+* Don't require a CSRF token when running in a test environment.
+
+* Allow Rake in all environments.
+
+* Enable performance plugin for Rubocop add-on by default.
+
+* Database rollbacks now occur for all Rack-enabled test unit tests. For RSpec
+  specs, they are enabled for all specs.
+
+### Fixed
+* Set proper application root for BetterErrors gem.
+
+* CI task for RSpec projects.
+
+* Rerun install in `setup` script needs `fs-event` gem.
+
+## [0.9.0] - 2021-05-06
+### Added
+* `--api-only` option for core generator.
+
+* Add-on for Twitter Bootstrap.
+
+* Add-on for GitHub Action.
+
+* Add-on for Rubocop.
+
+* Added `pry-byebug` gem as part of the core generator.
+
+* RSpec support. Add RSpec as an available `--test-framework` option.
+
+* Console support via the `racksh` gem along with a Rake task for starting the
+  console.
+
+* BetterErrors gem as part of the core generator.
+
+* `sinatra-flash` for all non-API projects.
+
+* Rakefile gets a `ci` task that runs the installed test runner. If the Rubocop
+  add-on is also detected, Rubocop will run after the tests.
+
+### Changed
+* Switch to Puma as default server instead of Thin. Add an explicit Puma
+  config (`config/puma.rb`).
+
+* Switched from sinatra-reloader to [rerun](https://github.com/alexch/rerun).
+
+* Update all dependencies.
+
+* Silence warnings from transitive gem dependencies in test output.
+
+* Move generated Sequel DB setup out of `config.ru` and into its own
+  file (`config/db.rb`).
+
+* Dev server updates: always include a Procfile; create scripts for `setup`,
+  `console`, `server`; server script uses foreman if it's available,
+  otherwise rackup; remove Rake tasks for console, server.
+
+* Use `sinatra-json` gem from `sinatra-contrib` instead of default JSON gem.
+
+* Switch default templates to Erubi; escape HTML by default.
+
+* Switch to `test-unit` gem.
+
+* Generated `README` overhaul. Show environment variables in a table, bullet
+  points showing default options and libraries installed, table of contents,
+  etc.
+
+### Fixed
+* Don't attempt to add metrics snippets to non-existent files.
+
+* `assert_redirected_to helper` argument.
+
+* Hardcoded Omniauth route in generated tests.
+
+## [0.1.0] - 2014-09-05
+* Initial version
+
+[Unreleased]: https://github.com/bnadlerjr/hoboken/compare/v0.10.0...HEAD
+[0.10.0]: https://github.com/bnadlerjr/hoboken/compare/v0.9.0...v0.10.0
+[0.9.0]: https://github.com/bnadlerjr/hoboken/compare/v0.0.1...v0.9.0
+[0.0.1]: https://github.com/bnadlerjr/hoboken/releases/tag/v0.0.1

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,8 @@
+## Code of Conduct
+This code of conduct applies to all of the project's "collaborative space", which is defined as community communications channels, including GitHub Issues, GitHub project, and source code repository.
+
+1. Participants must ensure that their language and actions are free of personal attacks and remarks disparaging to people or groups.
+1. Behaviour which can be reasonably considered harassment will not be tolerated.
+1. Discussion should be limited to the project and related technologies.
+
+You can report a violation of this code of conduct to the project maintainer, who will take appropriate action.

data/CONTRIBUTING.md

@@ -0,0 +1,16 @@
+## How to contribute to Hoboken
+
+#### Issue Guidelines
+1. Issues should only be created for things that are definitely bugs. If you are not sure that the behavior is a bug, ask about it on [GitHub Discussions](https://github.com/bnadlerjr/hoboken/discussions). GitHub Issues should not be used as a help forum.
+1. **Ensure the bug was not already reported** by searching on GitHub under [Issues](https://github.com/bnadlerjr/hoboken/issues).
+1. If you are sure it is a bug, then post a complete description of the issue, the simplest possible self-contained example showing the problem, and the full backtrace of any exception.
+1. Issues are generally closed as soon as the problem is considered fixed. However, discussion can still happen after the issue is closed, and the issue will be reopened if additional evidence is provided showing the issue still exists.
+
+#### Pull Request Guidelines
+1. Ensure the PR description clearly describes the problem and solution. Include the relevant issue number if applicable.
+1. Try to include tests for all new features and substantial bug fixes.
+1. Try to include documentation for all new features. In most cases this should include RDoc method documentation, but updates to the [documentation site](https://github.com/bnadlerjr/hoboken-docs) are also appropriate in some cases.
+1. Follow the style conventions of the surrounding code. In most cases, this is standard ruby style.
+1. All code in pull requests is assumed to be MIT licensed. Do not submit a pull request if that isn't the case.
+1. Please do not submit pull requests for code that is not ready to be merged. Pull requests should not be used to "start a conversation" about a possible code change. If the pull request requires a conversation, that conversation should take place on [GitHub Discussions](https://github.com/bnadlerjr/hoboken/discussions).
+1. Pull requests are generally closed as soon as it appears that the branch will not be merged. However, discussion about the code can still happen after the pull request is closed, and the pull request can be reopened if additional commits to the branch or other changes make it likely that it will be merged.

data/README.md

@@ -2,7 +2,7 @@
 
 [![Gem Version](https://badge.fury.io/rb/hoboken.png)](http://badge.fury.io/rb/hoboken)
 ![Build Status](https://github.com/bnadlerjr/hoboken/actions/workflows/ruby.yml/badge.svg)
-[![Dependabot Status](https://api.dependabot.com/badges/status?host=github&repo=bnadlerjr/hoboken)](https://dependabot.com)
+[![Maintainability](https://api.codeclimate.com/v1/badges/75e09f25ee70d6858519/maintainability)](https://codeclimate.com/github/bnadlerjr/hoboken/maintainability)
 
 Sinatra project generator and templates.
 
@@ -49,20 +49,16 @@ Additional generators are available for existing projects generated using Hoboke
     $ hoboken add:omniauth         # OmniAuth authentication (allows you to select a provider)
     $ hoboken add:rubocop          # Basic Rubocop configuration and Rake task.
     $ hoboken add:sequel           # Database access via Sequel gem
-    $ hoboken add:sprockets        # Rack-based asset packaging system
+    $ hoboken add:sidekiq          # Background processing with the Sidekiq gem
     $ hoboken add:travis           # Basic Travis-CI YAML config
+    $ hoboken add:turnip           # Gherkin extension for RSpec
     $ hoboken add:twbs             # Twitter Bootstrap (requires Sprockets add-on)
+    $ hoboken add:vcr              # Record HTTP interactions and replay them during test runs
 
-### Documentation
+## Resources
 
-Visit the project [website](http://bobnadler.com/hoboken).
-
-## Contributing
-
-1. Fork it
-2. Create your feature branch (`git checkout -b my-new-feature`)
-3. Commit your changes (`git commit -am 'Add some feature'`)
-4. Push to the branch (`git push origin my-new-feature`)
-5. Create new Pull Request
-
-If your contribution requires a change to the documentation, please also make a pull request to the [documentation project](https://github.com/bnadlerjr/hoboken-docs).
+* [Website](https://bobnadler.com/hoboken/)
+* [Source Code](https://github.com/bnadlerjr/hoboken)
+* [Bug Tracking](https://github.com/bnadlerjr/hoboken/issues)
+* [Discussion Forum](https://github.com/bnadlerjr/hoboken/discussions)
+* [Contribution Guidelines](https://github.com/bnadlerjr/hoboken/blob/main/CONTRIBUTING.md)

data/Rakefile

@@ -6,21 +6,12 @@ require 'rubocop/rake_task'
 
 RuboCop::RakeTask.new
 
-task default: 'test:all'
-
-desc 'Run CI checks'
-task ci: ['test:all', 'rubocop']
-
-namespace :test do
-  types = %w[unit integration]
+Rake::TestTask.new do |t|
+  t.libs << 'test'
+  t.test_files = Dir['test/**/*_test.rb']
+end
 
-  types.each do |type|
-    Rake::TestTask.new(type.to_sym) do |t|
-      t.libs << "test/#{type}"
-      t.test_files = Dir["test/#{type}/**/*_test.rb"]
-    end
-  end
+task default: 'test'
 
-  desc 'Run all tests'
-  task all: types.map { |s| "test:#{s}" }
-end
+desc 'Run CI checks'
+task ci: %w[test rubocop]

data/hoboken.gemspec

@@ -13,6 +13,7 @@ Gem::Specification.new do |spec|
   spec.homepage      = 'https://github.com/bnadlerjr/hoboken'
   spec.license       = 'MIT'
 
+  spec.metadata['rubygems_mfa_required'] = 'true'
   spec.required_ruby_version = '>= 2.6'
 
   spec.files         = `git ls-files`.split($INPUT_RECORD_SEPARATOR)
@@ -20,9 +21,11 @@ Gem::Specification.new do |spec|
   spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
   spec.require_paths = ['lib']
 
+  spec.add_dependency 'thor', '~> 1.1'
+
   spec.add_development_dependency 'bundler', '~> 2.2'
   spec.add_development_dependency 'pry-byebug', '~> 3.9'
-  spec.add_development_dependency 'rake', '~> 13.0'
+  spec.add_development_dependency 'rake', '~> 12.3'
   spec.add_development_dependency 'rubocop', '~> 1.12'
   spec.add_development_dependency 'rubocop-rake', '~> 0.5'
   spec.add_development_dependency 'test-unit', '~> 3.4'
@@ -33,30 +36,37 @@ Gem::Specification.new do |spec|
   #
   # a) We can get Dependabot notifications for them
   # b) We can run tests for generated projects
+  spec.add_development_dependency 'airbrake', '~> 12.0'
   spec.add_development_dependency 'better_errors', '~> 2.9'
   spec.add_development_dependency 'binding_of_caller', '~> 1.0'
-  spec.add_development_dependency 'bootstrap', '~> 5.0.0.beta3'
+  spec.add_development_dependency 'bootstrap', '~> 5.1.0'
   spec.add_development_dependency 'contest', '~> 0.1'
   spec.add_development_dependency 'dotenv', '~> 2.7'
   spec.add_development_dependency 'erubi', '~> 1.10'
+  spec.add_development_dependency 'flay', '~> 2.12'
+  spec.add_development_dependency 'flog', '~> 4.6'
   spec.add_development_dependency 'omniauth-twitter', '~> 1.4'
   spec.add_development_dependency 'puma', '~> 5.2'
   spec.add_development_dependency 'rack_csrf', '~> 2.6'
   spec.add_development_dependency 'racksh', '~> 1.0'
   spec.add_development_dependency 'rack-test', '~> 1.1'
-  spec.add_development_dependency 'rb-fsevent', '~> 0.10'
-  spec.add_development_dependency 'rerun', '~> 0.13'
   spec.add_development_dependency 'rspec', '~> 3.10'
+  spec.add_development_dependency 'rubocop-performance', '~> 1.13'
   spec.add_development_dependency 'rubocop-rspec', '~> 2.2'
+  spec.add_development_dependency 'rubocop-sequel', '~> 0.2'
   spec.add_development_dependency 'sassc', '~> 2.4'
   spec.add_development_dependency 'sequel', '~> 5.43'
+  spec.add_development_dependency 'sidekiq', '~> 6.2'
+  spec.add_development_dependency 'simplecov', '~> 0.21'
   spec.add_development_dependency 'sinatra', '~> 2.1'
+  spec.add_development_dependency 'sinatra-activerecord', '~> 2.0'
+  spec.add_development_dependency 'sinatra-asset-pipeline', '~> 2.2'
   spec.add_development_dependency 'sinatra-contrib', '~> 2.1'
   spec.add_development_dependency 'sinatra-flash', '~> 0.3'
-  spec.add_development_dependency 'sprockets', '~> 4.0'
+  spec.add_development_dependency 'sinatra-r18n', '~> 5.0'
   spec.add_development_dependency 'sqlite3', '~> 1.4'
+  spec.add_development_dependency 'turnip', '~> 4.3'
   spec.add_development_dependency 'uglifier', '~> 4.2'
-  spec.add_development_dependency 'yui-compressor', '~> 0.12'
-
-  spec.add_dependency 'thor', '~> 1.1'
+  spec.add_development_dependency 'vcr', '~> 6.0'
+  spec.add_development_dependency 'webmock', '~> 3.13'
 end

data/lib/hoboken/add_ons/active_record.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+module Hoboken
+  module AddOns
+    # ActiveRecord database access via sinatra-activerecord gem.
+    #
+    class ActiveRecord < Hoboken::Group
+      def add_gems
+        gem 'sinatra-activerecord', version: '2.0'
+        gem 'sqlite3', version: '1.4', group: %i[development test]
+      end
+
+      def setup_directories
+        empty_directory('db/migrate')
+        empty_directory('tasks')
+      end
+
+      def copy_example_seeds_file
+        copy_file('hoboken/templates/seeds.rb', 'db/seeds.rb')
+      end
+
+      def copy_rake_task
+        copy_file('hoboken/templates/active_record.rake', 'tasks/active_record.rake')
+      end
+
+      def require_sinatra_activerecord
+        location = %r{require_relative '\.\./app'}
+        insert_into_file('config/environment.rb', before: location) do
+          "require 'sinatra/activerecord'\n\n"
+        end
+      end
+
+      def set_database_variable
+        snippet = "set :database, ENV['DATABASE_URL']"
+        snippet = "register Sinatra::ActiveRecordExtension\n#{snippet}" if modular?
+        indentation = classic? ? 2 : 6
+        location = /set :erb.+\n/
+        insert_into_file('config/environment.rb', after: location) do
+          "\n#{indent(snippet, indentation)}\n"
+        end
+      end
+
+      def setup_puma_config
+        insert_into_file('config/puma.rb', after: 'on_worker_boot do') do
+          "\n    ActiveRecord::Base.establish_connection"
+        end
+      end
+
+      # rubocop:disable Metrics/MethodLength
+      def add_database_test_helper_class
+        return if rspec?
+
+        insert_into_file('test/test_helper.rb', before: /ENV\['RACK_ENV'\] = 'test'/) do
+          "ENV['DATABASE_URL'] = 'sqlite3:db/test.db'\n"
+        end
+
+        snippet = <<~CODE
+          def run(*args, &block)
+            result = nil
+            ActiveRecord::Base.connection.transaction do
+              result = super
+              raise ActiveRecord::Rollback
+            end
+            result
+          end
+        CODE
+
+        insert_into_file('test/test_helper.rb', after: /include RackHelpers\n/) do
+          "\n#{indent(snippet, 6)}"
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      # rubocop:disable Metrics/MethodLength
+      def add_database_spec_helper
+        return unless rspec?
+
+        insert_into_file('spec/spec_helper.rb', before: /ENV\['RACK_ENV'\] = 'test'/) do
+          "ENV['DATABASE_URL'] = 'sqlite3:db/test.db'\n"
+        end
+
+        snippet = <<~CODE
+          config.around do |example|
+            ActiveRecord::Base.transaction do
+              example.run
+              ActiveRecord::Rollback
+            end
+          end
+        CODE
+
+        location = /RSpec\.configure do \|config\|\n/
+        insert_into_file('spec/spec_helper.rb', after: location) do
+          "#{indent(snippet, 2)}\n"
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      # rubocop:disable Metrics/MethodLength
+      def update_readme
+        snippet = <<~CODE
+          <tr>
+              <td>DATABASE_URL</td>
+              <td>Yes</td>
+              <td>
+                `sqlite3:db/test.db` (for the test environment <em>only</em>)
+              </td>
+              <td>
+                Connection URL to the database. The format varies according
+                database adapter. Refer to the documentation for the adapter
+                you're using for more information. Some examples:
+                <dl>
+                  <dt>Sqlite3</dt>
+                  <dd>`sqlite3:db/development.db`</dd>
+                  <dt>PostgreSQL</dt>
+                  <dd>`postgresql://localhost/myapp_development?pool=5`</dd>
+                </dl>
+              </td>
+          </tr>
+        CODE
+
+        insert_into_file('README.md', after: /<tbody>\n/) do
+          indent(snippet, 8)
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      def reminders
+        say "\nGemfile updated... don't forget to 'bundle install'"
+        say <<~TEXT
+
+          Notes:
+            * The sqlite3 gem has been installed for dev and test environments
+              only. You will need to specify a gem to use for production.
+
+            * You will need to specify an environment variable 'DATABASE_URL'
+              (either add it to .env or export it). For example, in your .env
+              file add: `DATABASE_URL=sqlite3:db/development.db`.
+        TEXT
+      end
+    end
+  end
+end

data/lib/hoboken/add_ons/airbrake.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+module Hoboken
+  module AddOns
+    # Support for official Airbrake library for Ruby applications.
+    #
+    class Airbrake < ::Hoboken::Group
+      def add_gem
+        gem 'airbrake', version: '11.0'
+      end
+
+      def setup_config
+        template('hoboken/templates/airbrake.rb.tt', 'config/airbrake.rb')
+      end
+
+      def add_middleware
+        indentation = classic? ? 2 : 6
+        require_snippet = indent("require_relative 'airbrake'\n", indentation)
+        middleware_snippet = indent("use Airbrake::Rack::Middleware\n", indentation)
+        location = /configure :production do\n/
+
+        insert_into_file('config/environment.rb', after: location) do
+          "#{require_snippet}#{middleware_snippet}\n"
+        end
+      end
+
+      # rubocop:disable Metrics/MethodLength
+      def update_readme
+        snippet = <<~CODE
+          <tr>
+              <td>AIRBRAKE_PROJECT_ID</td>
+              <td>Production Only</td>
+              <td>None</td>
+              <td>Airbrake project ID. Refer to the project's settings page in Airbrake</td>
+          </tr>
+          <tr>
+              <td>AIRBRAKE_PROJECT_KEY</td>
+              <td>Production Only</td>
+              <td>None</td>
+              <td>Airbrake project key. Refer to the project's settings page in Airbrake</td>
+          </tr>
+        CODE
+
+        insert_into_file('README.md', after: /<tbody>\n/) do
+          indent(snippet, 8)
+        end
+      end
+      # rubocop:enable Metrics/MethodLength
+
+      def reminders
+        text = <<~TEXT
+
+          Gemfile updated... don't forget to 'bundle install'
+
+          You can configure a Airbrake settings in `config/airbrake.rb`. By
+          default Airbrake is set to only be used in production environments.
+          Don't forget to set your `AIRBRAKE_PROJECT_ID` and `AIRBRAKE_PROJECT_KEY`.
+        TEXT
+
+        say text, :green
+      end
+    end
+  end
+end

data/lib/hoboken/add_ons/heroku.rb

@@ -18,7 +18,11 @@ module Hoboken
       end
 
       def reminders
-        say "\nGemfile updated... don't forget to 'bundle install'"
+        say <<~TEXT
+          Ready to deploy to Heroku. See the Heroku docs[1] for details.
+
+          [1]: https://devcenter.heroku.com/articles/rack
+        TEXT
       end
     end
   end