boring_generators 0.12.0 → 0.14.0

data/lib/generators/boring/dotenv/install/install_generator.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require "boring_generators/generator_helper"
+
+module Boring
+  module Dotenv
+    class InstallGenerator < Rails::Generators::Base
+      include BoringGenerators::GeneratorHelper
+
+      desc "Adds dotenv gem to the application"
+      source_root File.expand_path("templates", __dir__)
+
+      def add_dotenv_gem
+        return if gem_installed?("dotenv-rails")
+
+        say "Adding dotenv gem", :green
+
+        check_and_install_gem "dotenv-rails", group: :development
+      end
+
+      def configure_dotenv_gem
+        say "Configuring dotenv gem", :green
+
+        template ".env", ".env"
+
+        create_file ".gitignore" unless File.exist?(".gitignore")
+
+        FileUtils.cp(".env", ".env.sample")
+
+        add_env_files_to_gitignore
+      end
+
+      private
+
+      def add_env_files_to_gitignore
+        if File.readlines(".gitignore").any? { |line| line.include?(".env") }
+          return
+        end
+
+        ignore_content = <<~ENV_FILE_NAMES
+          \n
+          # Ignore all environment files (except templates).
+          /.env
+          !/.env.*
+        ENV_FILE_NAMES
+
+        insert_into_file(".gitignore", ignore_content)
+      end
+    end
+  end
+end

data/lib/generators/boring/dotenv/install/templates/.env

@@ -0,0 +1,3 @@
+# Add your environment variables here
+# Example:
+# SECRET_KEY_BASE=your_secret_key

data/lib/generators/boring/factory_bot/install/install_generator.rb

@@ -14,7 +14,7 @@ module Boring
       def add_factory_bot_gem
         log :adding, "FactoryBot"
         Bundler.with_unbundled_env do
-          run "bundle add factory_bot_rails --group='developement,test'"
+          run "bundle add factory_bot_rails --group='development,test'"
         end
       end
 

data/lib/generators/boring/faker/install/install_generator.rb

@@ -9,7 +9,7 @@ module Boring
       def add_faker_gem
         log :adding, "faker"
         Bundler.with_unbundled_env do
-          run "bundle add faker --group='developement,test'"
+          run "bundle add faker --group='development,test'"
         end
       end
     end

data/lib/generators/boring/favicon/build/build_generator.rb

@@ -39,7 +39,7 @@ module Boring
       end
 
       def create_favicon_directory
-        unless File.exists?(FILE_FAVICO_DIR)
+        unless File.exist?(FILE_FAVICO_DIR)
           Dir.mkdir FILE_FAVICO_DIR
         end
       end

data/lib/generators/boring/figjam/install/install_generator.rb

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+module Boring
+  module Figjam
+    class InstallGenerator < Rails::Generators::Base
+      desc 'Adds figjam gem to the app'
+
+      def add_figjam_gem
+        say 'Adding figjam gem', :green
+
+        Bundler.with_unbundled_env do
+          run 'bundle add figjam'
+        end
+      end
+
+      def configure_figjam
+        say 'Configuring figjam', :green
+
+        Bundler.with_unbundled_env do
+          run 'bundle exec figjam install'
+        end
+
+        FileUtils.cp('config/application.yml', 'config/application.yml.sample')
+
+        unless File.exist?('.gitignore')
+          create_file '.gitignore'
+        end
+
+        insert_into_file('.gitignore', "\n/config/application.yml\n")
+      end
+    end
+  end
+end

data/lib/generators/boring/honeybadger/install/install_generator.rb

@@ -0,0 +1,47 @@
+# frozen_string_literal: true
+
+module Boring
+  module Honeybadger
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+      desc 'Adds honeybadger to the app'
+
+      class_option :use_env_variable, type: :boolean, aliases: "-ev",
+                   desc: 'Use ENV variable for devise_jwt_secret_key. By default Rails credentials will be used.'
+
+      def add_honeybadger_gem
+        say 'Adding Honeybadger gem', :green
+
+        Bundler.with_unbundled_env do
+          run 'bundle add honeybadger'
+        end
+      end
+
+      def configure_honeybadger_gem
+        say 'Setting up Honeybadger', :green
+
+        @api_key = honeybadger_api_key
+
+        template 'honeybadger.yml', 'config/honeybadger.yml'
+
+        show_readme
+      end
+
+      private
+
+      def show_readme
+        readme_template = File.read(File.join(self.class.source_root, 'README'))
+        readme_content = ERB.new(readme_template).result(binding)
+        say readme_content
+      end
+
+      def honeybadger_api_key
+        if options[:use_env_variable]
+          "ENV['HONEYBADGER_API_KEY']"
+        else
+          "Rails.application.credentials.dig(:honeybadger, :api_key)"
+        end
+      end
+    end
+  end
+end

data/lib/generators/boring/honeybadger/install/templates/README

@@ -0,0 +1,6 @@
+===============================================================================
+
+The API key for Honeybadger will be used from <%= @api_key %>.
+You can change these values if they don't match with your app.
+
+===============================================================================

data/lib/generators/boring/honeybadger/install/templates/honeybadger.yml.tt

@@ -0,0 +1,26 @@
+---
+# For more options, see https://docs.honeybadger.io/lib/ruby/gem-reference/configuration
+
+api_key: <%= @api_key %>
+
+# The environment your app is running in.
+env: "<%= Rails.env %>"
+
+# The absolute path to your project folder.
+root: "<%= Rails.root.to_s %>"
+
+# Honeybadger won't report errors in these environments.
+development_environments:
+- test
+- development
+- cucumber
+
+# By default, Honeybadger won't report errors in the development_environments.
+# You can override this by explicitly setting report_data to true or false.
+# report_data: true
+
+# The current Git revision of your project. Defaults to the last commit hash.
+# revision: null
+
+# Enable verbose debug logging (useful for troubleshooting).
+debug: false

data/lib/generators/boring/letter_opener/install/install_generator.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Boring
+  module LetterOpener
+    class InstallGenerator < Rails::Generators::Base
+      desc "Adds letter_opener gem for previewing email in development environment"
+
+      def add_letter_opener_gem
+        say "Adding letter_opener gem", :green
+
+        gem_content = <<~RUBY.indent(2)
+          \n# Preview email in the default browser instead of sending it to real mailbox
+          gem "letter_opener"
+        RUBY
+
+        insert_into_file "Gemfile", gem_content, after: /group :development do/
+
+        Bundler.with_unbundled_env do
+          run "bundle install"
+        end
+      end
+
+      def configure_letter_opener
+        say "Configuring letter_opener", :green
+
+        configuration_content = <<~RUBY.chomp.indent(2)
+          \n# Preview email in the browser instead of sending it
+          config.action_mailer.delivery_method = :letter_opener
+          config.action_mailer.perform_deliveries = true
+        RUBY
+
+        gsub_file "config/environments/development.rb",
+                  /end\Z/,
+                  "#{configuration_content}\nend"
+      end
+    end
+  end
+end

data/lib/generators/boring/oauth/google/install/install_generator.rb

@@ -14,8 +14,8 @@ module Boring
         desc "Adds Google OmniAuth to the application"
         source_root File.expand_path("templates", __dir__)
 
-        def add_github_omniauth_gem
-          say "Adding GitHub OmniAuth gem", :green
+        def add_google_omniauth_gem
+          say "Adding Google OmniAuth gem", :green
           Bundler.with_unbundled_env do
             run "bundle add omniauth-google-oauth2"
           end

data/lib/generators/boring/pronto/base_generator.rb

@@ -0,0 +1,78 @@
+# frozen_string_literal: true
+
+require "boring_generators/generator_helper"
+
+module Boring
+  module Pronto
+    class BaseGenerator < Rails::Generators::Base
+      desc "Adds Pronto gem with various extensions"
+
+      class_option :skip_extensions,
+                   type: :array,
+                   aliases: "-se",
+                   desc:
+                     "List of extensions to skip. Available options: brakeman, flay, reek, rubocop",
+                   enum: %w[brakeman flay reek rubocop],
+                   default: []
+
+      include BoringGenerators::GeneratorHelper
+
+      def add_pronto_gems
+        say "Adding pronto gems", :green
+
+        gem_content = <<~RUBY.strip
+          #{pronto_gem_content}
+          #{pronto_brakemen_gem_content}
+          #{pronto_flay_gem_content}
+          #{pronto_reek_gem_content}
+          #{pronto_rubocop_gem_content}
+        RUBY
+
+        return if gem_content.blank?
+
+        insert_into_file "Gemfile", "\n#{gem_content}\n"
+
+        Bundler.with_unbundled_env { run "bundle install" }
+      end
+
+      private
+
+      def pronto_gem_content
+        return if gem_installed?("pronto")
+
+        <<~RUBY.strip
+          # Pronto is a code linter runner that can be used with git and GitHub pull requests
+          gem "pronto"
+        RUBY
+      end
+
+      def pronto_brakemen_gem_content
+        return if options[:skip_extensions].include?("brakeman")
+        return if gem_installed?("pronto-brakeman")
+
+        "gem \"pronto-brakeman\", require: false"
+      end
+
+      def pronto_flay_gem_content
+        return if options[:skip_extensions].include?("flay")
+        return if gem_installed?("pronto-flay")
+
+        "gem \"pronto-flay\", require: false"
+      end
+
+      def pronto_reek_gem_content
+        return if options[:skip_extensions].include?("reek")
+        return if gem_installed?("pronto-reek")
+
+        "gem \"pronto-reek\", require: false"
+      end
+
+      def pronto_rubocop_gem_content
+        return if options[:skip_extensions].include?("rubocop")
+        return if gem_installed?("pronto-rubocop")
+
+        "gem \"pronto-rubocop\", require: false"
+      end
+    end
+  end
+end

data/lib/generators/boring/pronto/github_action/install/install_generator.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "generators/boring/pronto/base_generator"
+require "boring_generators/generator_helper"
+
+module Boring
+  module Pronto
+    module GithubAction
+      class InstallGenerator < Boring::Pronto::BaseGenerator
+        desc "Adds Pronto configurations to Github Action"
+        source_root File.expand_path("templates", __dir__)
+
+        class_option :ruby_version, type: :string, aliases: "-rv"
+
+        include BoringGenerators::GeneratorHelper
+
+        def add_pronto_configuration_for_github_action
+          say "Adding Pronto configurations to .github/workflows/pronto.yml", :green
+
+          @ruby_version = options.ruby_version || app_ruby_version
+          
+          template("pronto.yml", ".github/workflows/pronto.yml")
+        end
+      end
+    end
+  end
+end

data/lib/generators/boring/pronto/github_action/install/templates/pronto.yml.tt

@@ -0,0 +1,53 @@
+on: [pull_request]
+
+name: Pronto
+
+jobs:
+  pronto:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      statuses: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v2
+        with:
+          fetch-depth: 0
+
+      - name: Setup Ruby
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: <%= @ruby_version %>
+      - name: Ruby gem cache
+        uses: actions/cache@v1
+        with:
+          path: vendor/bundle
+          key: ${{ runner.os }}-gems-${{ hashFiles('**/Gemfile.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-gems-
+      - name: Install gems
+        run: |
+          bundle config path vendor/bundle
+          bundle install --jobs 4 --retry 3
+
+      - name: Setup Node
+        uses: actions/setup-node@v1
+        with:
+          node-version: 10.13.0
+      - name: Find yarn cache location
+        id: yarn-cache
+        run: echo "::set-output name=dir::$(yarn cache dir)"
+      - name: JS package cache
+        uses: actions/cache@v1
+        with:
+          path: ${{ steps.yarn-cache.outputs.dir }}
+          key: ${{ runner.os }}-yarn-${{ hashFiles('**/yarn.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-yarn-
+      - name: Install packages
+        run: |
+          yarn install --pure-lockfile
+      - name: Run Pronto
+        run: |
+          PRONTO_PULL_REQUEST_ID="${{ github.event.pull_request.number }}" PRONTO_GITHUB_ACCESS_TOKEN="${{ github.token }}" bundle exec pronto run -f github_status github_pr -c origin/${{ github.base_ref }}

data/lib/generators/boring/pronto/gitlab_ci/install/install_generator.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+require "generators/boring/pronto/base_generator"
+require "boring_generators/generator_helper"
+
+module Boring
+  module Pronto
+    module GitlabCi
+      class InstallGenerator < Boring::Pronto::BaseGenerator
+        desc "Adds Pronto gem with various extensions and configures it for Gitlab CI"
+        source_root File.expand_path("templates", __dir__)
+
+        class_option :ruby_version, type: :string, aliases: "-rv"
+
+        include BoringGenerators::GeneratorHelper
+
+        def add_configuration
+          @ruby_version = options.ruby_version || app_ruby_version
+
+          if File.exist?(".gitlab-ci.yml")
+            add_pronto_configuration
+            add_lint_stage
+            show_readme
+          else
+            create_gitlab_ci_with_pronto
+          end
+        end
+
+        private
+
+        def create_gitlab_ci_with_pronto
+          say "Creating .gitlab-ci.yml with Pronto configurations", :yellow
+          template ".gitlab-ci.yml", ".gitlab-ci.yml"
+        end
+
+        def add_pronto_configuration
+          return if pronto_configuration_exists?
+
+          say "Adding Pronto configurations to .gitlab-ci.yml", :green
+          inject_into_file ".gitlab-ci.yml", pronto_ci_content, before: /\Z/
+        end
+
+        def add_lint_stage
+          return if lint_stage_exists?
+
+          if stages_exists?
+            inject_into_file ".gitlab-ci.yml",
+                             optimize_indentation("\n- lint", 2).chomp,
+                             after: /stages:/
+          else
+            inject_into_file ".gitlab-ci.yml",
+                             stages_configuration,
+                             before: /pronto:/
+          end
+        end
+
+        def show_readme
+          readme "README"
+        end
+
+        def pronto_configuration_exists?
+          gitlab_ci_file_content["pronto"]
+        end
+
+        def lint_stage_exists?
+          gitlab_ci_file_content["stages"] &&
+            gitlab_ci_file_content["stages"].include?("lint")
+        end
+
+        def stages_exists?
+          gitlab_ci_file_content["stages"]
+        end
+
+        def gitlab_ci_file_content
+          @gitlab_ci_file_content ||=
+            YAML.safe_load(File.open(".gitlab-ci.yml"), aliases: true) || {}
+        end
+
+        def pronto_ci_content
+          <<~RUBY
+              pronto:
+                image: ruby:#{@ruby_version}
+                stage: lint
+                only:
+                  # run pronto on merge requests and when new changes are pushed to it
+                  - merge_requests
+                variables:
+                  PRONTO_GITLAB_API_PRIVATE_TOKEN: $PRONTO_ACCESS_TOKEN
+                before_script:
+                    # Install cmake required for rugged gem (Pronto depends on it)
+                    - apt-get update && apt-get install -y cmake
+                    # use bundler version same as the one that bundled the Gemfile
+                    - gem install bundler -v "$(grep -A 1 "BUNDLED WITH" Gemfile.lock | tail -n 1)" --no-document
+                    - bundle install --jobs $(nproc)
+                script:
+                  # Pronto fails with the error "revspec 'origin/{target_branch}' because Gitlab fetches changes with git depth set to 20 by default. You can remove this line if you update Gitlab CI setting to clone the full project.
+                  - git fetch origin $CI_MERGE_REQUEST_TARGET_BRANCH_NAME
+                  # Run pronto on branch of current merge request
+                  - bundle exec pronto run -f gitlab_mr -c origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME
+            RUBY
+        end
+
+        def stages_configuration
+          <<~RUBY
+              stages:
+                - lint
+            RUBY
+        end
+      end
+    end
+  end
+end

data/lib/generators/boring/pronto/gitlab_ci/install/templates/.gitlab-ci.yml.tt

@@ -0,0 +1,22 @@
+stages:
+  - lint
+
+pronto:
+  image: ruby:<%= @ruby_version %>
+  stage: lint
+  only:
+    # run pronto on merge requests and when new changes are pushed to it
+    - merge_requests
+  variables:
+    PRONTO_GITLAB_API_PRIVATE_TOKEN: $PRONTO_ACCESS_TOKEN
+  before_script:
+    # Install cmake required for rugged gem (Pronto depends on it)
+    - apt-get update && apt-get install -y cmake
+    # use bundler version same as the one that bundled the Gemfile
+    - gem install bundler -v "$(grep -A 1 "BUNDLED WITH" Gemfile.lock | tail -n 1)" --no-document
+    - bundle install --jobs $(nproc)
+  script:
+    # Pronto fails with the error "revspec 'origin/{target_branch}' because Gitlab fetches changes with git depth set to 20 by default. You can remove this line if you update Gitlab CI setting to clone the full project.
+    - git fetch origin $CI_MERGE_REQUEST_TARGET_BRANCH_NAME
+    # Run pronto on branch of current merge request
+    - bundle exec pronto run -f gitlab_mr -c origin/$CI_MERGE_REQUEST_TARGET_BRANCH_NAME

data/lib/generators/boring/pronto/gitlab_ci/install/templates/README

@@ -0,0 +1,7 @@
+
+===============================================================================
+
+❗️❗️
+Pronto needs your Private Gitlab API token for posting comments in the merge request. It is configured as "PRONTO_ACCESS_TOKEN" inside .gitlab-ci.yml, don't forget to configure this variable in your Gitlab Project settings before pushing your new changes to git.
+
+===============================================================================

data/lib/generators/boring/rack_mini_profiler/install/install_generator.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+require 'boring_generators/generator_helper'
+
+module Boring
+  module RackMiniProfiler
+    class InstallGenerator < Rails::Generators::Base
+      include BoringGenerators::GeneratorHelper
+      
+      desc "Adds rack-mini-profiler to the application"
+
+      def add_rack_mini_profiler_gem
+        say "Adding rack-mini-profiler gem", :green
+        
+        return if gem_installed?("rack-mini-profiler")
+
+        rack_mini_profiler_gems_content = <<~RUBY
+        \t# Profiler for your Rails application
+        \tgem 'rack-mini-profiler', require: false\n
+        RUBY
+
+        insert_into_file "Gemfile",
+                         rack_mini_profiler_gems_content,
+                         after: /group :development do\n/
+
+        Bundler.with_unbundled_env { run "bundle install" }
+      end
+
+      def configure_rack_mini_profiler
+        say "Configuring rack mini profiler", :green
+
+        Bundler.with_unbundled_env do
+          run "bundle exec rails g rack_mini_profiler:install"
+        end
+      end
+    end
+  end
+end

data/lib/generators/boring/rails_erd/install/install_generator.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'boring_generators/generator_helper'
+
+module Boring
+  module RailsErd
+    class InstallGenerator < Rails::Generators::Base
+      include BoringGenerators::GeneratorHelper
+
+      desc 'Adds rails-erd gem to the  app for generating ERD diagrams'
+
+      def add_rails_erd_gem
+        if gem_installed?("rails-erd")
+          say "rails-erd is already in the Gemfile, skipping it ...", :yellow
+        else
+          say "Adding rails-erd gem", :green
+          gem_content = <<~RUBY
+            \n
+            \tgem "rails-erd"
+          RUBY
+          insert_into_file "Gemfile", gem_content, after: /group :development do/
+          bundle_install
+        end
+      end
+
+      def configure_rails_erd_gem
+        say 'Configuring rails-erd gem', :green
+
+        Bundler.with_unbundled_env do
+          run 'bundle exec rails g erd:install'
+        end
+      end
+    end
+  end
+end

data/lib/generators/boring/rspec/install/install_generator.rb

@@ -14,7 +14,7 @@ module Boring
       def add_rspec_gem
         log :adding, "rspec-rails"
         Bundler.with_unbundled_env do
-          run "bundle add rspec-rails --group='developement,test'"
+          run "bundle add rspec-rails --group='development,test'"
         end
       end