rubocop-discourse 2.1.0 → 2.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6655fa53ae9c2bd93548aae8db88b78294303626031e03896131ca120c083021
-  data.tar.gz: f21f3ab9e4b3b184f7e26ab16e917ad77598c076fa3a4e0bc9a4280517b9bbcf
+  metadata.gz: ab3bab04445e93feec2c095fbd6f2c39c4a2df8e304727bd61138205fe32aa6f
+  data.tar.gz: 0b5727aa611459b01ccc2f5c664c8944f97682079dd698434b6b90468c99929e
 SHA512:
-  metadata.gz: df675e48cb73e337f4256161d8e16da66ca0c2b00c7402b983f221cc979b1594d0b8636d71672b8d16b7ea74b8be0d4d2ca94accb4dd49c2a3f7810ea13bde11
-  data.tar.gz: a2a12b9f318aa4fcb2f18adac55efc2bc8c05ffbb151085d9d1f607b0abaf623c13960fcbd18074efc92540b7feff7f1285efc3215dc8cf50615a437192b5a03
+  metadata.gz: c4b717bce864cf92b1e3340f826e6671df6bc1fe3d1eecb5488ce1775c42fd8e321e345f728ef8c5852136e43d97f8a0605656b8b22b14b30637791b8666866b
+  data.tar.gz: 445c4334c24ee08db442ac0dd7f6b24908f206797d60613b8a22cce5f672753da955d8f084928f9cd8556aca5e3e4e853fbc23f7db1e90008a2914ee306ee496

data/.github/workflows/ci.yml

@@ -29,6 +29,9 @@ jobs:
 
       - name: Rubocop
         run: bundle exec rubocop
+      
+      - name: Rspec
+        run: bundle exec rspec spec
 
   publish:
     if: contains(github.ref, 'refs/tags/v')

data/.gitignore

@@ -1,2 +1,3 @@
 .rubocop-http*
 Gemfile.lock
+.byebug_history

data/.rubocop.yml

@@ -1,20 +1,2 @@
-require:
-  - rubocop-discourse
-
 inherit_from:
-  - ./rubocop-core.yml
-  - ./rubocop-rspec.yml
-
-AllCops:
-  TargetRubyVersion: 2.6
-  DisabledByDefault: true
-  Exclude:
-    - "db/schema.rb"
-    - "bundle/**/*"
-    - "vendor/**/*"
-    - "node_modules/**/*"
-    - "public/**/*"
-    - "plugins/**/gems/**/*"
-
-Discourse:
-  Enabled: true
+  - default.yml

data/Gemfile

@@ -4,3 +4,7 @@ source "https://rubygems.org"
 
 # Specify dependencies in gemspec
 gemspec
+
+group :development, :test do
+  gem 'byebug'
+end

data/README.md

@@ -7,5 +7,5 @@ Then add the following to `.rubocop.yml`:
 
 ```yml
 inherit_gem:
-  rubocop-discourse: .rubocop.yml
+  rubocop-discourse: default.yml
 ```

data/config/default.yml

@@ -4,14 +4,49 @@ Discourse/NoChdir:
     - 'spec/**/*' # Specs are run sequentially, so chdir can be used
     - 'plugins/*/spec/**/*'
 
-Discourse/NoDirectMultisiteManipulation:
+Discourse/NoTimeNewWithoutArgs:
   Enabled: true
 
-Discourse/NoTimeNewWithoutArgs:
+Discourse/NoURIEscapeEncode:
   Enabled: true
 
-Discourse/NoUriEscapeEncode:
+Discourse/NoAddReferenceOrAliasesActiveRecordMigration:
   Enabled: true
+  Include:
+  - "**/db/migrate/*"
+  - "**/db/post_migrate/*"
+
+Discourse/NoNokogiriHtmlFragment:
+  Enabled: true
+
+Discourse/NoResetColumnInformationInMigrations:
+  Enabled: false
+  Include:
+  - "**/db/migrate/*"
+  - "**/db/post_migrate/*"
+
+# Specs
+
+Discourse/NoDirectMultisiteManipulation:
+  Enabled: true
+  Patterns:
+  - _spec.rb
+  - "(?:^|/)spec/"
 
 Discourse/TimeEqMatcher:
   Enabled: true
+  Patterns:
+  - _spec.rb
+  - "(?:^|/)spec/"
+
+Discourse/NoJsonParseResponse:
+  Enabled: false
+  Patterns:
+  - _spec.rb
+  - "(?:^|/)spec/"
+
+Discourse/NoMockingJobs:
+  Enabled: true
+  Patterns:
+  - _spec.rb
+  - "(?:^|/)spec/"

data/default.yml

@@ -0,0 +1,20 @@
+require:
+  - rubocop-discourse
+
+inherit_from:
+  - ./rubocop-core.yml
+  - ./rubocop-rspec.yml
+
+AllCops:
+  TargetRubyVersion: 2.6
+  DisabledByDefault: true
+  Exclude:
+    - "db/schema.rb"
+    - "bundle/**/*"
+    - "vendor/**/*"
+    - "**/node_modules/**/*"
+    - "public/**/*"
+    - "plugins/**/gems/**/*"
+
+Discourse:
+  Enabled: true

data/lib/rubocop/cop/discourse/no_add_reference_active_record_migrations.rb

@@ -0,0 +1,84 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Discourse
+      # The methods:
+      #
+      # * add_reference
+      # * add_belongs_to
+      # * t.references
+      # * t.belongs_to
+      #
+      # in ActiveRecord migrations are magic, and they all do
+      # some unexpected things in the background. For example, by default
+      # add_reference adds an index at the same time, but not concurrently,
+      # which is a nightmare for large tables.
+      #
+      # Instead, inside a disable_ddl_transaction! migration we should create
+      # the new column (with any defaults and options required) and the index
+      # concurrently using hand-written SQL. This also allows us to handle
+      # IF NOT EXISTS cases, which enable re-runnable migrations. Also we
+      # can pick a better name for the index at the same time.
+      #
+      # @example
+      #
+      # # bad
+      # def up
+      #   add_reference :posts, :image_upload
+      #   # or add_belongs_to :posts, :image_upload
+      #   # or t.references :image_upload when doing create_table do |t|
+      #   # or t.belongs_to :image_upload when doing create_table do |t|
+      # end
+      #
+      # # good
+      # disable_ddl_transaction!
+      # def up
+      #   execute <<~SQL
+      #     ALTER TABLE posts
+      #     ADD COLUMN IF NOT EXISTS image_upload_id bigint
+      #   SQL
+      #
+      #   execute <<~SQL
+      #     CREATE INDEX CONCURRENTLY IF NOT EXISTS
+      #     index_posts_on_image_upload_id ON posts USING btree (image_upload_id)
+      #   SQL
+      # end
+      class NoAddReferenceOrAliasesActiveRecordMigration < Cop
+        MSG = <<~MSG
+          AR methods add_reference, add_belongs_to, t.references, and t.belongs_to are
+          high-risk for large tables and have too many background magic operations.
+          Instead, write a disable_ddl_transactions! migration and write custom SQL to
+          add the new column and CREATE INDEX CONCURRENTLY. Use the IF NOT EXISTS clause
+          to make the migration re-runnable if it fails partway through.
+        MSG
+
+        def_node_matcher :using_add_reference?, <<-MATCHER
+          (send nil? :add_reference ...)
+        MATCHER
+
+        def_node_matcher :using_add_belongs_to?, <<-MATCHER
+          (send nil? :add_belongs_to ...)
+        MATCHER
+
+        def_node_matcher :using_t_references?, <<-MATCHER
+          (send (lvar _) :references ...)
+        MATCHER
+
+        def_node_matcher :using_t_belongs_to?, <<-MATCHER
+          (send (lvar _) :belongs_to ...)
+        MATCHER
+
+        def on_send(node)
+          return if [
+            using_add_reference?(node),
+            using_add_belongs_to?(node),
+            using_t_references?(node),
+            using_t_belongs_to?(node)
+          ].none?
+          add_offense(node, message: MSG)
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/discourse/no_json_parse_response.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Discourse
+      # Use `response.parsed_body` instead of `JSON.parse(response.body)` in specs.
+      #
+      # @example
+      #   # bad
+      #   expect(::JSON.parse(response.body)).to eq({})
+      #
+      #   # good
+      #   expect(response.parsed_body).to eq({})
+      class NoJsonParseResponse < Cop
+        MSG = "Use `response.parsed_body` instead of `JSON.parse(response.body)` in specs."
+
+        def_node_matcher :json_parse_body?, <<-MATCHER
+          (send
+            (const {cbase nil?} :JSON) :parse
+            (send
+              (send nil? :response) :body))
+        MATCHER
+
+        def on_send(node)
+          return unless json_parse_body?(node)
+
+          add_offense(node, message: MSG)
+        end
+
+        def autocorrect(node)
+          lambda do |corrector|
+            corrector.replace(node.loc.expression, "response.parsed_body")
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/discourse/no_mocking_jobs.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Discourse
+      class NoMockingJobs < Cop
+        MSG = "Use the test helpers provided by Sidekiq instead of mocking `Jobs.expects(:enqueue)`."
+
+        def_node_matcher :mocking_jobs_enqueue?, <<~MATCHER
+        (send (const nil? :Jobs) :expects (:sym :enqueue))
+        MATCHER
+
+        def_node_matcher :mocking_jobs_enqueue_in?, <<~MATCHER
+        (send (const nil? :Jobs) :expects (:sym :enqueue_in))
+        MATCHER
+
+        def on_send(node)
+          if mocking_jobs_enqueue?(node) || mocking_jobs_enqueue_in?(node)
+            add_offense(node, message: MSG)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/discourse/no_nokogiri_html_fragment.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Discourse
+      # Do not use Nokogiri::HTML.fragment
+      # Instead use Nokogiri::HTML5.fragment, which is using Nokogumbo parser
+      #
+      # @example
+      #   # bad
+      #   Nokogiri::HTML.fragment("<p>test</p>")
+      #
+      #   # good
+      #   Nokogiri::HTML5.fragment("<p>test</p>")
+      class NoNokogiriHtmlFragment < Cop
+        MSG = "Nokogiri::HTML.fragment is deprecated and should not be used."
+
+        def_node_matcher :using_nokogiri_html_fragment?, <<-MATCHER
+          (send
+            (const
+              (const nil? :Nokogiri) :HTML) :fragment ...)
+        MATCHER
+
+        def on_send(node)
+          return if !using_nokogiri_html_fragment?(node)
+          add_offense(node, message: MSG)
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/discourse/no_reset_column_information_in_migrations.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Discourse
+      # Do not use `ActiveRecord::ModelSchema.reset_column_information` in
+      # migrations. The method is not thread safe and we run migrations
+      # concurrently for multisites. Also, we don't encourage the use of
+      # ActiveRecord methods in migrations and prefer to write SQL directly.
+      class NoResetColumnInformationInMigrations < Cop
+        MSG = "ActiveRecord::ModelSchema.reset_column_information is not thread-safe " \
+          "and we run migrations concurrently on multisite clusters. Using this " \
+          "method also means ActiveRecord methods are being used in migration "\
+          "which is discouraged at Discourse. Instead, you should write SQL in your migrations instead."
+
+        def on_send(node)
+          return if node.method_name != :reset_column_information
+          add_offense(node, message: MSG)
+        end
+      end
+    end
+  end
+end

data/rubocop-discourse.gemspec

@@ -2,7 +2,7 @@
 
 Gem::Specification.new do |s|
   s.name        = "rubocop-discourse"
-  s.version     = "2.1.0"
+  s.version     = "2.3.1"
   s.summary     = "Custom rubocop cops used by Discourse"
   s.authors     = ["David Taylor"]
   s.files       = `git ls-files`.split($/)
@@ -13,4 +13,5 @@ Gem::Specification.new do |s|
   s.add_runtime_dependency "rubocop-rspec", ">= 1.39.0"
 
   s.add_development_dependency "rake", "~> 13.0"
+  s.add_development_dependency "rspec"
 end

data/spec/lib/rubocop/cop/no_add_reference_active_record_migrations_spec.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe RuboCop::Cop::Discourse::NoAddReferenceOrAliasesActiveRecordMigration, :config do
+  subject(:cop) { described_class.new(config) }
+  let(:config) do
+    RuboCop::Config.new
+  end
+
+  it "raises an offense if add_reference is used, with or without arguments" do
+    inspect_source(<<~RUBY)
+      add_reference :posts, :users, foreign_key: true, null: false
+    RUBY
+    expect(cop.offenses.first.message).to eq(described_class::MSG)
+  end
+
+  it "raises an offense if add_belongs_to is used, with or without arguments" do
+    inspect_source(<<~RUBY)
+      add_belongs_to :posts, :users, foreign_key: true, null: false
+    RUBY
+    expect(cop.offenses.first.message).to eq(described_class::MSG)
+  end
+
+  it "raises an offense if t.references, or any variable.references is used, with or without arguments" do
+    inspect_source(<<~RUBY)
+      create_table do |t|
+        t.references :topic, null: false
+      end
+      create_table do |mytable|
+        mytable.references :topic, null: false
+      end
+    RUBY
+    expect(cop.offenses.count).to eq(2)
+    expect(cop.offenses.first.message).to eq(described_class::MSG)
+  end
+
+  it "raises an offense if t.belongs_to, or any variable.belongs_to is used, with or without arguments" do
+    inspect_source(<<~RUBY)
+      create_table do |t|
+        t.belongs_to :topic, null: false
+      end
+      create_table do |mytable|
+        mytable.belongs_to :topic, null: false
+      end
+    RUBY
+    expect(cop.offenses.count).to eq(2)
+    expect(cop.offenses.first.message).to eq(described_class::MSG)
+  end
+end

data/spec/lib/rubocop/cop/no_mocking_jobs_enqueue_spec.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe RuboCop::Cop::Discourse::NoMockingJobs, :config do
+  subject(:cop) { described_class.new(config) }
+
+  let(:config) do
+    RuboCop::Config.new
+  end
+
+  it "raises an offense if Jobs is mocked with :enqueue" do
+    inspect_source(<<~RUBY)
+    Jobs.expects(:enqueue)
+    RUBY
+
+    expect(cop.offenses.first.message).to eq(described_class::MSG)
+  end
+
+  it "raises an offense if Jobs is mocked with :enqueue_in" do
+    inspect_source(<<~RUBY)
+    Jobs.expects(:enqueue_in)
+    RUBY
+
+    expect(cop.offenses.first.message).to eq(described_class::MSG)
+  end
+
+  it "does not raise an offense if Jobs is not mocked with :enqueue or :enqueue_in" do
+    inspect_source(<<~RUBY)
+    Jobs.enqueue(:some_job)
+    RUBY
+
+    expect(cop.offenses).to eq([])
+  end
+end

data/spec/lib/rubocop/cop/no_reset_column_information_migrations_spec.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require 'spec_helper'
+
+describe RuboCop::Cop::Discourse::NoResetColumnInformationInMigrations, :config do
+  subject(:cop) { described_class.new(config) }
+
+  let(:config) do
+    RuboCop::Config.new
+  end
+
+  it "raises an offense if reset_column_information is used" do
+    inspect_source(<<~RUBY)
+      class SomeMigration < ActiveRecord::Migration[6.0]
+        def up
+          Post.reset_column_information
+        end
+      end
+    RUBY
+
+    expect(cop.offenses.first.message).to eq(described_class::MSG)
+  end
+
+  it "raise an offense if reset_column_information is used without AR model" do
+    inspect_source(<<~RUBY)
+      class SomeMigration < ActiveRecord::Migration[6.0]
+        def up
+          "post".classify.constantize.reset_column_information
+        end
+      end
+    RUBY
+
+    expect(cop.offenses.first.message).to eq(described_class::MSG)
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+require 'bundler/setup'
+Bundler.setup
+
+# Require supporting files exposed for testing.
+require 'rubocop'
+require 'rubocop/rspec/support'
+
+require 'rubocop-discourse' # and any other gems you need
+
+RSpec.configure do |config|
+  config.include RuboCop::RSpec::ExpectOffense
+  # some (optional) config here
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rubocop-discourse
 version: !ruby/object:Gem::Version
-  version: 2.1.0
+  version: 2.3.1
 platform: ruby
 authors:
 - David Taylor
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-02 00:00:00.000000000 Z
+date: 2020-07-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rubocop
@@ -52,6 +52,20 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  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: 
 email: 
 executables: []
@@ -66,9 +80,15 @@ files:
 - README.md
 - Rakefile
 - config/default.yml
+- default.yml
 - lib/rubocop-discourse.rb
+- lib/rubocop/cop/discourse/no_add_reference_active_record_migrations.rb
 - lib/rubocop/cop/discourse/no_chdir.rb
 - lib/rubocop/cop/discourse/no_direct_multisite_manipulation.rb
+- lib/rubocop/cop/discourse/no_json_parse_response.rb
+- lib/rubocop/cop/discourse/no_mocking_jobs.rb
+- lib/rubocop/cop/discourse/no_nokogiri_html_fragment.rb
+- lib/rubocop/cop/discourse/no_reset_column_information_in_migrations.rb
 - lib/rubocop/cop/discourse/no_time_new_without_args.rb
 - lib/rubocop/cop/discourse/no_uri_escape_encode.rb
 - lib/rubocop/cop/discourse/time_eq_matcher.rb
@@ -78,6 +98,10 @@ files:
 - rubocop-core.yml
 - rubocop-discourse.gemspec
 - rubocop-rspec.yml
+- spec/lib/rubocop/cop/no_add_reference_active_record_migrations_spec.rb
+- spec/lib/rubocop/cop/no_mocking_jobs_enqueue_spec.rb
+- spec/lib/rubocop/cop/no_reset_column_information_migrations_spec.rb
+- spec/spec_helper.rb
 homepage: 
 licenses:
 - MIT