rubocop-discourse 2.1.1 → 2.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d87c5bc1d76fa5c4d785017af0f514bfd836d0a35a5b3ecb35d34c3c08f311b1
-  data.tar.gz: 9469659b2155d8acb12d82ce1a7bca26771862cd16975c520f8e86028f96918d
+  metadata.gz: 77712b97cde68ea4417a03ea56b6fccff3678c96ca97d3a6e518534efd65b7ab
+  data.tar.gz: 284be7e29c7278afac20f0d7edf73a3cfb08cd662c7d4d2f2ae1377d0584be8d
 SHA512:
-  metadata.gz: cf4d58947738c5c37cc396579058bab0241cbd5dc7d3c654be92c74fca0b4fe51fcb892f8f590738aaa4f93a76fc431632fefa50bd1994eb82b5cab989decd83
-  data.tar.gz: 291d805bc86a3bca91c6e32d547c8ae27bcce4335a00922ed9da22bd3d0c4cbaa2df991b8ff7c2f17a222c9fea41452c5cc9ba9f736f7d910b1c677d44978b92
+  metadata.gz: 4d40d329945599d5b41d2f00383a63e75c0e2a57e4860295003bbcb345255bddfe0bf95784ca1e071e83e0fd1cb6f5ea61f7e5b8edcc2f94aa0f37145c77f0d3
+  data.tar.gz: f83f42a4e2805b15f713eb7b45b7517340bd458e8ae1ad05c046f9677e7b1a8b215e3cc768010e4458fc32698cca3871bfca185d6d97269cc42a522f8f5cebf7

data/.github/workflows/ci.yml

@@ -19,7 +19,6 @@ jobs:
         uses: actions/setup-ruby@v1
         with:
           ruby-version: 2.6
-          architecture: 'x64'
 
       - name: Setup bundler
         run: gem install bundler
@@ -29,6 +28,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/Gemfile

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

data/config/default.yml

@@ -7,9 +7,24 @@ Discourse/NoChdir:
 Discourse/NoTimeNewWithoutArgs:
   Enabled: true
 
-Discourse/NoUriEscapeEncode:
+Discourse/NoURIEscapeEncode:
   Enabled: true
 
+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:
@@ -25,6 +40,12 @@ Discourse/TimeEqMatcher:
   - "(?:^|/)spec/"
 
 Discourse/NoJsonParseResponse:
+  Enabled: false
+  Patterns:
+  - _spec.rb
+  - "(?:^|/)spec/"
+
+Discourse/NoMockingJobs:
   Enabled: true
   Patterns:
   - _spec.rb

data/default.yml

@@ -12,7 +12,7 @@ AllCops:
     - "db/schema.rb"
     - "bundle/**/*"
     - "vendor/**/*"
-    - "node_modules/**/*"
+    - "**/node_modules/**/*"
     - "public/**/*"
     - "plugins/**/gems/**/*"
 

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_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/lib/rubocop/cop/discourse/time_eq_matcher.rb

@@ -3,7 +3,7 @@
 module RuboCop
   module Cop
     module Discourse
-      # Use `time_eq` matcher with timestamps in specs.
+      # Use `eq_time` matcher with timestamps in specs.
       #
       # @example
       #   # bad
@@ -12,7 +12,7 @@ module RuboCop
       #   # good
       #   expect(user.created_at).to eq_time(Time.zone.now)
       class TimeEqMatcher < Cop
-        MSG = "Use time_eq when testing timestamps"
+        MSG = "Use eq_time when testing timestamps"
 
         def_node_matcher :using_eq_matcher_with_timestamp?, <<-MATCHER
           (send

data/rubocop-discourse.gemspec

@@ -2,15 +2,18 @@
 
 Gem::Specification.new do |s|
   s.name        = "rubocop-discourse"
-  s.version     = "2.1.1"
+  s.version     = "2.3.2"
   s.summary     = "Custom rubocop cops used by Discourse"
   s.authors     = ["David Taylor"]
-  s.files       = `git ls-files`.split($/)
-  s.license       = "MIT"
+  s.license     = "MIT"
+  s.homepage    = "https://github.com/discourse/rubocop-discourse"
+
+  s.files = `git ls-files`.split($/)
   s.require_paths = ["lib"]
 
   s.add_runtime_dependency "rubocop", ">= 0.69.0"
   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.1
+  version: 2.3.2
 platform: ruby
 authors:
 - David Taylor
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-02 00:00:00.000000000 Z
+date: 2020-09-03 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: []
@@ -68,9 +82,13 @@ files:
 - 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
@@ -80,7 +98,11 @@ files:
 - rubocop-core.yml
 - rubocop-discourse.gemspec
 - rubocop-rspec.yml
-homepage: 
+- 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: https://github.com/discourse/rubocop-discourse
 licenses:
 - MIT
 metadata: {}