rubocop-cobra 0.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1ed15eb1f676621c8de867b79b277b407fb36c862ef88291a732d84859799dda
+  data.tar.gz: 9e9de6b0bcc5c13b049b86ac861d5986fe0b79d016b7b14cf3d3dc14ea098a17
+SHA512:
+  metadata.gz: bea53660dadb8c6518e1bfd9da50655db656aa0780aac9c0414fc28d54da82484726cd4934ee9d293c618ea1043a5e2a762922873319fcefd946abc76847a2f2
+  data.tar.gz: edd88e7a7d8224e3c2bb968fbeb5fa519c21971978d97e92adb901f955e1526b159c348cbf93d1875627f752f1371ac5f194ffe891edb6ce60287b11278190bb

data/.rubocop.yml

@@ -0,0 +1,11 @@
+inherit_from: .rubocop_todo.yml
+
+require:
+  - rubocop-powerhome
+
+Naming/FileName:
+ Exclude:
+   - lib/rubocop-cobra.rb
+
+Rails:
+  Enabled: false

data/.rubocop_todo.yml

@@ -0,0 +1,23 @@
+# This configuration was generated by
+# `rubocop --auto-gen-config`
+# on 2022-05-18 20:49:51 UTC using RuboCop version 1.29.1.
+# The point is for the user to remove these configuration records
+# one by one as the offenses are removed from the code base.
+# Note that changes in the inspected code, or installation of new
+# versions of RuboCop, may require this file to be generated again.
+
+# Offense count: 2
+# Configuration parameters: IgnoredMethods, CountRepeatedAttributes.
+Metrics/AbcSize:
+  Max: 19
+
+# Offense count: 14
+# Configuration parameters: CountComments, CountAsOne, ExcludedMethods, IgnoredMethods.
+# IgnoredMethods: refine
+Metrics/BlockLength:
+  Max: 97
+
+# Offense count: 2
+# Configuration parameters: CountComments, CountAsOne, ExcludedMethods, IgnoredMethods.
+Metrics/MethodLength:
+  Max: 11

data/CHANGELOG.md

@@ -0,0 +1,5 @@
+## [Unreleased]
+
+## [0.1.0] - 2022-05-18
+
+- Initial release

data/Gemfile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+source "https://rubygems.org"
+
+# Specify your gem's dependencies in rubocop-cobra.gemspec
+gemspec
+
+gem "rake", "~> 13.0"
+gem "rspec", "~> 3.0"
+gem "rubocop", "~> 1.29.1"
+
+gem "rubocop-powerhome", path: "../rubocop-powerhome"

data/Gemfile.lock

@@ -0,0 +1,92 @@
+PATH
+  remote: ../rubocop-powerhome
+  specs:
+    rubocop-powerhome (0.3.0)
+      rubocop
+      rubocop-performance
+      rubocop-rails
+      rubocop-rake
+      rubocop-rspec
+
+PATH
+  remote: .
+  specs:
+    rubocop-cobra (0.3.0)
+      rubocop
+      rubocop-powerhome
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (7.0.3)
+      concurrent-ruby (~> 1.0, >= 1.0.2)
+      i18n (>= 1.6, < 2)
+      minitest (>= 5.1)
+      tzinfo (~> 2.0)
+    ast (2.4.2)
+    concurrent-ruby (1.1.10)
+    diff-lcs (1.5.0)
+    i18n (1.10.0)
+      concurrent-ruby (~> 1.0)
+    minitest (5.15.0)
+    parallel (1.22.1)
+    parser (3.1.2.0)
+      ast (~> 2.4.1)
+    rack (2.2.3)
+    rainbow (3.1.1)
+    rake (13.0.6)
+    regexp_parser (2.4.0)
+    rexml (3.2.5)
+    rspec (3.11.0)
+      rspec-core (~> 3.11.0)
+      rspec-expectations (~> 3.11.0)
+      rspec-mocks (~> 3.11.0)
+    rspec-core (3.11.0)
+      rspec-support (~> 3.11.0)
+    rspec-expectations (3.11.0)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-mocks (3.11.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.11.0)
+    rspec-support (3.11.0)
+    rubocop (1.29.1)
+      parallel (~> 1.10)
+      parser (>= 3.1.0.0)
+      rainbow (>= 2.2.2, < 4.0)
+      regexp_parser (>= 1.8, < 3.0)
+      rexml (>= 3.2.5, < 4.0)
+      rubocop-ast (>= 1.17.0, < 2.0)
+      ruby-progressbar (~> 1.7)
+      unicode-display_width (>= 1.4.0, < 3.0)
+    rubocop-ast (1.18.0)
+      parser (>= 3.1.1.0)
+    rubocop-performance (1.13.3)
+      rubocop (>= 1.7.0, < 2.0)
+      rubocop-ast (>= 0.4.0)
+    rubocop-rails (2.14.2)
+      activesupport (>= 4.2.0)
+      rack (>= 1.1)
+      rubocop (>= 1.7.0, < 2.0)
+    rubocop-rake (0.6.0)
+      rubocop (~> 1.0)
+    rubocop-rspec (2.11.1)
+      rubocop (~> 1.19)
+    ruby-progressbar (1.11.0)
+    tzinfo (2.0.4)
+      concurrent-ruby (~> 1.0)
+    unicode-display_width (2.1.0)
+
+PLATFORMS
+  arm64-darwin-21
+  x86_64-linux
+
+DEPENDENCIES
+  rake (~> 13.0)
+  rspec (~> 3.0)
+  rubocop (~> 1.29.1)
+  rubocop-cobra!
+  rubocop-powerhome!
+
+BUNDLED WITH
+   2.3.7

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright Power Home Remodeling Group, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,40 @@
+# Rubocop::Cobra
+
+This gem is focused on providing Cops to support a healthy cobra app development (see https://cbra.info and https://github.com/powerhome/cobra_commander).
+
+## Installation
+
+Add this line to your application's Gemfile under development:
+
+```ruby
+gem "rubocop-cobra", require: false
+```
+
+And then execute:
+
+    $ bundle install
+
+## Usage
+
+Add a `require` line to your `.rubocop.yml`:
+
+```yml
+require:
+  - rubocop-cobra
+```
+
+That's it! You can override the standard configuration after that.
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake spec` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/powerhome/power_linting/rubocop-cobra.
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/Rakefile

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+
+require "rspec/core/rake_task"
+RSpec::Core::RakeTask.new(:spec)
+
+require "rubocop/rake_task"
+RuboCop::RakeTask.new(:rubocop)
+
+task default: %i[spec rubocop]
+
+desc "Generate a new cop with a template"
+task :new_cop, [:cop] do |_task, args|
+  require "rubocop"
+
+  cop_name = args.fetch(:cop) do
+    warn "usage: bundle exec rake new_cop[Department/Name]"
+    exit!
+  end
+
+  generator = RuboCop::Cop::Generator.new(cop_name)
+
+  generator.write_source
+  generator.write_spec
+  generator.inject_require(root_file_path: "lib/rubocop/cop/cobra_cops.rb")
+  generator.inject_config(config_file_path: "config/default.yml")
+
+  puts generator.todo
+end

data/config/default.yml

@@ -0,0 +1,57 @@
+Cobra:
+  Enabled: true
+
+Cobra/CommandFilePlacement:
+  Description: 'This cop disallows adding global helpers to the `app/commands` directory.'
+  Enabled: true
+  VersionAdded: '0.1.0'
+
+Cobra/ControllerFilePlacement:
+  Description: 'This cop disallows adding global controllers to the `app/controllers` directory.'
+  Enabled: true
+  VersionAdded: '0.1.0'
+
+Cobra/DependencyVersion:
+  Description: 'External component dependencies should be declared with a version'
+  Enabled: true
+  VersionAdded: '0.1.0'
+
+Cobra/GemRequirement:
+  Description: 'Component Gemfile dependencies must specify "require: nil"'
+  Enabled: true
+  VersionAdded: '0.1.0'
+
+Cobra/HelperFilePlacement:
+  Description: 'This cop disallows adding global helpers to the `app/helpers` directory.'
+  Enabled: true
+  VersionAdded: '0.1.0'
+
+Cobra/Inheritance:
+  Description: 'Enforce classes inherit from their own modularized parent classes'
+  Enabled: true
+  VersionAdded: '0.1.0'
+
+Cobra/JobFilePlacement:
+  Description: 'This cop disallows adding global jobs to the `app/jobs` directory.'
+  Enabled: true
+  VersionAdded: '0.1.0'
+
+Cobra/LibFilePlacement:
+  Description: 'This cop disallows adding library files directly into the `lib/` directory.'
+  Enabled: true
+  VersionAdded: '0.1.0'
+
+Cobra/MailerFilePlacement:
+  Description: 'This cop disallows adding global helpers to the `app/mailers` directory.'
+  Enabled: true
+  VersionAdded: '0.1.0'
+
+Cobra/ModelFilePlacement:
+  Description: 'This cop disallows adding global models to the `app/models` directory.'
+  Enabled: true
+  VersionAdded: '0.1.0'
+
+Cobra/PresenterFilePlacement:
+  Description: 'This cop disallows adding global presenters to the `app/presenters` directory.'
+  Enabled: true
+  VersionAdded: '0.1.0'

data/lib/rubocop/cobra/inject.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+# The original code is from https://github.com/rubocop/rubocop-rspec/blob/master/lib/rubocop/rspec/inject.rb
+# See https://github.com/rubocop/rubocop-rspec/blob/master/MIT-LICENSE.md
+module RuboCop
+  module Cobra
+    # Because RuboCop doesn't yet support plugins, we have to monkey patch in a
+    # bit of our configuration.
+    module Inject
+      def self.defaults!
+        path = CONFIG_DEFAULT.to_s
+        hash = ConfigLoader.send(:load_yaml_configuration, path)
+        config = Config.new(hash, path).tap(&:make_excludes_absolute)
+        Rails.logger.debug { "configuration from #{path}" } if ConfigLoader.debug?
+        config = ConfigLoader.merge_with_default(config, path)
+        ConfigLoader.instance_variable_set(:@default_configuration, config)
+      end
+    end
+  end
+end

data/lib/rubocop/cobra/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cobra
+    VERSION = "0.3.0"
+  end
+end

data/lib/rubocop/cobra.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module RuboCop
+  # @private
+  module Cobra
+    class Error < StandardError; end
+
+    PROJECT_ROOT   = Pathname.new(__dir__).parent.parent.expand_path.freeze
+    CONFIG_DEFAULT = PROJECT_ROOT.join("config", "default.yml").freeze
+    CONFIG         = YAML.safe_load(CONFIG_DEFAULT.read).freeze
+
+    private_constant(:CONFIG_DEFAULT, :PROJECT_ROOT)
+
+    require_relative "cobra/inject"
+    require_relative "cobra/version"
+  end
+end

data/lib/rubocop/cop/cobra/command_file_placement.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Cobra
+      # This cop disallows adding global helpers to the `app/commands` directory.
+      #
+      # The goal is to encourage developers to put new command files inside the correct
+      # namespace, where they can be more modularly isolated and ownership is clear.
+      #
+      # @example
+      #   # bad
+      #   # path: components/my_component/app/commands/foo.rb
+      #   class Foo
+      #     # ...
+      #   end
+      #
+      #   # good
+      #   # path: components/my_component/app/commands/my_component/foo.rb
+      #   module MyComponent
+      #     class Foo
+      #       # ...
+      #     end
+      #   end
+      #
+      class CommandFilePlacement < RuboCop::Cop::Cop
+        include FilePlacementHelp
+
+        def investigate(processed_source)
+          return if processed_source.blank?
+
+          path = processed_source.file_path
+          return unless applicable_component_path?(path, commands_path)
+          return if namespaced_correctly?(path, commands_path)
+
+          add_offense(processed_source.ast,
+                      message: file_placement_msg(path, commands_path))
+        end
+
+      private
+
+        def commands_path
+          "app/commands/"
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/cobra/controller_file_placement.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Cobra
+      # This cop disallows adding global controllers to the `app/controllers` directory.
+      #
+      # The goal is to encourage developers to put new controllers inside the correct
+      # namespace, where they can be more modularly isolated and ownership is clear.
+      #
+      # @example
+      #   # bad
+      #   # path: components/my_component/app/controllers/foo_controller.rb
+      #   class FooController < ApplicationController
+      #     # ...
+      #   end
+      #
+      #   # good
+      #   # path: components/my_component/app/controllers/my_component/foo_controller.rb
+      #   module MyComponent
+      #     class FooController < MyComponent::ApplicationController
+      #       # ...
+      #     end
+      #   end
+      #
+      class ControllerFilePlacement < RuboCop::Cop::Cop
+        include FilePlacementHelp
+
+        def investigate(processed_source)
+          return if processed_source.blank?
+
+          path = processed_source.file_path
+          return unless applicable_component_path?(path, controllers_path)
+
+          if path.include?(controller_concerns_path)
+            return if namespaced_correctly?(path, controller_concerns_path)
+
+            add_offense(processed_source.ast,
+                        message: file_placement_msg(path, controller_concerns_path))
+          end
+          return if namespaced_correctly?(path, controllers_path)
+
+          add_offense(processed_source.ast,
+                      message: file_placement_msg(path, controllers_path))
+        end
+
+      private
+
+        def controllers_path
+          "app/controllers/"
+        end
+
+        def controller_concerns_path
+          "app/controllers/concerns/"
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/cobra/dependency_version.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Cobra
+      class DependencyVersion < RuboCop::Cop::Cop
+        extend NodePattern::Macros
+
+        MSG = "External component dependencies should be declared with a version"
+
+        def investigate(processed_source)
+          return if processed_source.blank?
+
+          path = processed_source.file_path
+          return unless path.end_with?(".gemspec")
+
+          dependency_declarations(processed_source.ast).each do |dep|
+            next if declares_version?(dep)
+
+            add_offense(dep, message: MSG)
+          end
+        end
+
+      private
+
+        def_node_search :dependency_declarations, <<~PATTERN
+          (send (lvar _) {:add_dependency :add_runtime_dependency :add_development_dependency} (str _) ...)
+        PATTERN
+
+        def declares_version?(node)
+          node.first_argument != node.last_argument
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/cobra/file_placement_help.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    # Methods that help analyzing file placement within Nitro components
+    module FilePlacementHelp
+      FILE_PLACEMENT_MSG =
+        "Do not add top-level files into `%<matcher_path>s`. " \
+        "Namespace them like `%<correct_path>s`"
+
+      def applicable_component_path?(path, matcher)
+        in_a_component?(path) && path_contains_matcher?(path, matcher)
+      end
+
+      def namespaced_correctly?(path, matcher)
+        potential_component_name = component_name(path, matcher)
+        component_path = File.join(
+          potential_component_name,
+          matcher,
+          potential_component_name
+        )
+        path.include?("#{component_path}/") || path.include?("#{component_path}.rb")
+      end
+
+      def file_placement_msg(path, matcher)
+        format(FILE_PLACEMENT_MSG,
+               matcher_path: matcher,
+               correct_path: correct_path(path, matcher))
+      end
+
+    private
+
+      def correct_path(path, matcher)
+        file = path.split(matcher).last
+        "#{matcher}#{component_name(path, matcher)}/#{file}"
+      end
+
+      def component_name(path, matcher)
+        path.split(matcher).first.split("/").last
+      end
+
+      def in_a_component?(path)
+        path.include?("components/")
+      end
+
+      def path_contains_matcher?(path, matcher)
+        path.include?(matcher)
+      end
+    end
+  end
+end

data/lib/rubocop/cop/cobra/gem_requirement.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Cobra
+      class GemRequirement < RuboCop::Cop::Cop
+        MSG = "Component Gemfile dependencies must specify " \
+              "'require: nil'."
+
+        def investigate(processed_source)
+          return if processed_source.blank?
+
+          gem_block = component_gem_block(processed_source.ast)&.first
+          return unless gem_block
+
+          process_component_declarations(gem_block)
+        end
+
+      private
+
+        def process_component_declarations(gem_block)
+          if gem_block.send_type?
+            add_gem_offenses(gem_block)
+          else
+            gem_listings(gem_block).each do |gem_node|
+              add_gem_offenses(gem_node)
+            end
+          end
+        end
+
+        def add_gem_offenses(gem_node)
+          component_options = gem_options(gem_node).first
+          return if component_options && not_required?(component_options)
+
+          add_offense(gem_node, message: MSG)
+        end
+
+        def_node_matcher :component_gem_block, <<~PATTERN
+          (:begin ...
+            (:block
+              (:send nil? :path (:str ".."))
+              (:args)
+              $...
+            )
+          )
+        PATTERN
+
+        def_node_matcher :gem_options, "(:send nil? :gem _ $...)"
+        def_node_matcher :gem_listings, "(:begin $...)"
+
+        def_node_matcher :not_required?, <<~PATTERN
+          (:hash
+            (:pair
+              (:sym :require)
+              (${nil false})
+            )
+          )
+        PATTERN
+      end
+    end
+  end
+end

data/lib/rubocop/cop/cobra/helper_file_placement.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Cobra
+      # This cop disallows adding global helpers to the `app/helpers` directory.
+      #
+      # The goal is to encourage developers to put new helpers inside the correct
+      # namespace, where they can be more modularly isolated and ownership is clear.
+      #
+      # @example
+      #   # bad
+      #   # path: components/my_component/app/helpers/foo.rb
+      #   class Foo
+      #     # ...
+      #   end
+      #
+      #   # good
+      #   # path: components/my_component/app/helpers/my_component/foo.rb
+      #   module MyComponent
+      #     class Foo
+      #       # ...
+      #     end
+      #   end
+      #
+      class HelperFilePlacement < RuboCop::Cop::Cop
+        include FilePlacementHelp
+
+        def investigate(processed_source)
+          return if processed_source.blank?
+
+          path = processed_source.file_path
+          return unless applicable_component_path?(path, helpers_path)
+          return if namespaced_correctly?(path, helpers_path)
+
+          add_offense(processed_source.ast,
+                      message: file_placement_msg(path, helpers_path))
+        end
+
+      private
+
+        def helpers_path
+          "app/helpers/"
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/cobra/inheritance.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Cobra
+      class Inheritance < RuboCop::Cop::Cop
+        PROTECTED_GLOBAL_CONSTANTS = %w[
+          ApplicationController
+          ApplicationRecord
+          ApiController
+        ].freeze
+
+        MSG = "Do not directly inherit from a global %<class>s. " \
+              "Instead, inherit from your component's modularized " \
+              "%<class>s, such as MyComponent::%<class>s."
+
+        def on_class(node)
+          inheritance_constant = node.node_parts[1]
+          inheritance_class = inheritance_constant&.source
+          return unless PROTECTED_GLOBAL_CONSTANTS.include?(inheritance_class)
+
+          add_offense(inheritance_constant,
+                      message: format(MSG, class: inheritance_class))
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/cobra/job_file_placement.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Cobra
+      # This cop disallows adding global jobs to the `app/jobs` directory.
+      #
+      # The goal is to encourage developers to put new jobs inside the correct
+      # namespace, where they can be more modularly isolated and ownership is clear.
+      #
+      # @example
+      #   # bad
+      #   # path: components/my_component/app/jobs/foo_job.rb
+      #   class FooJob
+      #     # ...
+      #   end
+      #
+      #   # good
+      #   # path: components/my_component/app/jobs/my_component/foo_job.rb
+      #   module MyComponent
+      #     class FooJob
+      #       # ...
+      #     end
+      #   end
+      #
+      class JobFilePlacement < RuboCop::Cop::Cop
+        include FilePlacementHelp
+
+        def investigate(processed_source)
+          return if processed_source.blank?
+
+          path = processed_source.file_path
+          return unless applicable_component_path?(path, jobs_path)
+          return if namespaced_correctly?(path, jobs_path)
+
+          add_offense(processed_source.ast,
+                      message: file_placement_msg(path, jobs_path))
+        end
+
+      private
+
+        def jobs_path
+          "app/jobs/"
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/cobra/lib_file_placement.rb

@@ -0,0 +1,54 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Cobra
+      # This cop disallows adding library files directly into the `lib/` directory.
+      #
+      # The goal is to encourage developers to put new library files inside the correct
+      # namespace, where they can be more modularly isolated and ownership is clear.
+      #
+      # Exceptions to this rule are `spec/lib/*` and `lib/tasks/*` file patterns.
+      #
+      # @example
+      #   # bad
+      #   # path: components/my_component/lib/foo.rb
+      #   class Foo
+      #     # ...
+      #   end
+      #
+      #   # good
+      #   # path: components/my_component/lib/my_component/foo.rb
+      #   module MyComponent
+      #     class Foo
+      #       # ...
+      #     end
+      #   end
+      #
+      class LibFilePlacement < RuboCop::Cop::Cop
+        include FilePlacementHelp
+
+        def investigate(processed_source)
+          return if processed_source.blank?
+
+          path = processed_source.file_path
+          return unless applicable_component_path?(path, lib_path)
+          return if acceptable_lib_path?(path) || namespaced_correctly?(path, lib_path)
+
+          add_offense(processed_source.ast,
+                      message: file_placement_msg(path, lib_path))
+        end
+
+      private
+
+        def acceptable_lib_path?(path)
+          path.include?("lib/tasks/") || path.include?("spec/lib/")
+        end
+
+        def lib_path
+          "lib/"
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/cobra/mailer_file_placement.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Cobra
+      # This cop disallows adding global helpers to the `app/mailers` directory.
+      #
+      # The goal is to encourage developers to put new mailer files inside the correct
+      # namespace, where they can be more modularly isolated and ownership is clear.
+      #
+      # @example
+      #   # bad
+      #   # path: components/my_component/app/mailers/foo.rb
+      #   class Foo
+      #     # ...
+      #   end
+      #
+      #   # good
+      #   # path: components/my_component/app/mailers/my_component/foo.rb
+      #   module MyComponent
+      #     class Foo
+      #       # ...
+      #     end
+      #   end
+      #
+      class MailerFilePlacement < RuboCop::Cop::Cop
+        include FilePlacementHelp
+
+        def investigate(processed_source)
+          return if processed_source.blank?
+
+          path = processed_source.file_path
+          return unless applicable_component_path?(path, mailers_path)
+          return if namespaced_correctly?(path, mailers_path)
+
+          add_offense(processed_source.ast,
+                      message: file_placement_msg(path, mailers_path))
+        end
+
+      private
+
+        def mailers_path
+          "app/mailers/"
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/cobra/model_file_placement.rb

@@ -0,0 +1,59 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Cobra
+      # This cop disallows adding global models to the `app/models` directory.
+      #
+      # The goal is to encourage developers to put new models inside the correct
+      # namespace, where they can be more modularly isolated and ownership is clear.
+      #
+      # @example
+      #   # bad
+      #   # path: components/my_component/app/models/foo.rb
+      #   class Foo < ApplicationRecord
+      #     # ...
+      #   end
+      #
+      #   # good
+      #   # path: components/my_component/app/models/my_component/foo.rb
+      #   module MyComponent
+      #     class Foo < MyComponent::ApplicationRecord
+      #       # ...
+      #     end
+      #   end
+      #
+      class ModelFilePlacement < RuboCop::Cop::Cop
+        include FilePlacementHelp
+
+        def investigate(processed_source)
+          return if processed_source.blank?
+
+          path = processed_source.file_path
+          return unless applicable_component_path?(path, models_path)
+
+          if path.include?(model_concerns_path)
+            return if namespaced_correctly?(path, model_concerns_path)
+
+            add_offense(processed_source.ast,
+                        message: file_placement_msg(path, model_concerns_path))
+          end
+          return if namespaced_correctly?(path, models_path)
+
+          add_offense(processed_source.ast,
+                      message: file_placement_msg(path, models_path))
+        end
+
+      private
+
+        def models_path
+          "app/models/"
+        end
+
+        def model_concerns_path
+          "app/models/concerns/"
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/cobra/presenter_file_placement.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Cobra
+      # This cop disallows adding global presenters to the `app/presenters` directory.
+      #
+      # The goal is to encourage developers to put new presenters inside the correct
+      # namespace, where they can be more modularly isolated and ownership is clear.
+      #
+      # @example
+      #   # bad
+      #   # path: components/my_component/app/presenters/foo_presenter.rb
+      #   class FooPresenter
+      #     # ...
+      #   end
+      #
+      #   # good
+      #   # path: components/my_component/app/presenters/my_component/foo_presenter.rb
+      #   module MyComponent
+      #     class FooPresenter
+      #       # ...
+      #     end
+      #   end
+      #
+      class PresenterFilePlacement < RuboCop::Cop::Cop
+        include FilePlacementHelp
+
+        def investigate(processed_source)
+          return if processed_source.blank?
+
+          path = processed_source.file_path
+          return unless applicable_component_path?(path, presenters_path)
+          return if namespaced_correctly?(path, presenters_path)
+
+          add_offense(processed_source.ast,
+                      message: file_placement_msg(path, presenters_path))
+        end
+
+      private
+
+        def presenters_path
+          "app/presenters/"
+        end
+      end
+    end
+  end
+end

data/lib/rubocop/cop/cobra_cops.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module RuboCop
+  module Cop
+    module Cobra
+      require_relative "cobra/file_placement_help"
+
+      require_relative "cobra/command_file_placement"
+      require_relative "cobra/controller_file_placement"
+      require_relative "cobra/dependency_version"
+      require_relative "cobra/gem_requirement"
+      require_relative "cobra/helper_file_placement"
+      require_relative "cobra/inheritance"
+      require_relative "cobra/job_file_placement"
+      require_relative "cobra/lib_file_placement"
+      require_relative "cobra/mailer_file_placement"
+      require_relative "cobra/model_file_placement"
+      require_relative "cobra/presenter_file_placement"
+    end
+  end
+end

data/lib/rubocop-cobra.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require "rubocop"
+
+require_relative "rubocop/cobra"
+
+RuboCop::Cobra::Inject.defaults!
+
+require_relative "rubocop/cop/cobra_cops"

data/rubocop-cobra.gemspec

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative "lib/rubocop/cobra/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "rubocop-cobra"
+  spec.version = RuboCop::Cobra::VERSION
+  spec.authors = ["Carlos Palhares"]
+  spec.email = ["chjunior@gmail.com"]
+
+  spec.summary = "Cobra rubocop linters"
+  spec.description = "Cobra rubocop linters"
+  spec.homepage = "https://github.com/powerhome/power_linting"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 2.7.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/CHANGELOG.md"
+
+  # Specify which files should be added to the gem when it is released.
+  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
+  spec.files = Dir.chdir(File.expand_path(__dir__)) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (f == __FILE__) || f.match(%r{\A(?:(?:bin|test|spec|features)/|\.(?:git|travis|circleci)|appveyor)})
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  # Uncomment to register a new dependency of your gem
+  # spec.add_dependency "example-gem", "~> 1.0"
+
+  # For more information and examples about making a new gem, check out our
+  # guide at: https://bundler.io/guides/creating_gem.html
+
+  spec.add_runtime_dependency "rubocop"
+  spec.add_runtime_dependency "rubocop-powerhome"
+  spec.metadata["rubygems_mfa_required"] = "true"
+end

data/sig/rubocop/cobra.rbs

@@ -0,0 +1,6 @@
+module Rubocop
+  module Cobra
+    VERSION: String
+    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+  end
+end

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification
+name: rubocop-cobra
+version: !ruby/object:Gem::Version
+  version: 0.3.0
+platform: ruby
+authors:
+- Carlos Palhares
+autorequire: 
+bindir: exe
+cert_chain: []
+date: 2022-05-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop-powerhome
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Cobra rubocop linters
+email:
+- chjunior@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rubocop.yml"
+- ".rubocop_todo.yml"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- config/default.yml
+- lib/rubocop-cobra.rb
+- lib/rubocop/cobra.rb
+- lib/rubocop/cobra/inject.rb
+- lib/rubocop/cobra/version.rb
+- lib/rubocop/cop/cobra/command_file_placement.rb
+- lib/rubocop/cop/cobra/controller_file_placement.rb
+- lib/rubocop/cop/cobra/dependency_version.rb
+- lib/rubocop/cop/cobra/file_placement_help.rb
+- lib/rubocop/cop/cobra/gem_requirement.rb
+- lib/rubocop/cop/cobra/helper_file_placement.rb
+- lib/rubocop/cop/cobra/inheritance.rb
+- lib/rubocop/cop/cobra/job_file_placement.rb
+- lib/rubocop/cop/cobra/lib_file_placement.rb
+- lib/rubocop/cop/cobra/mailer_file_placement.rb
+- lib/rubocop/cop/cobra/model_file_placement.rb
+- lib/rubocop/cop/cobra/presenter_file_placement.rb
+- lib/rubocop/cop/cobra_cops.rb
+- rubocop-cobra.gemspec
+- sig/rubocop/cobra.rbs
+homepage: https://github.com/powerhome/power_linting
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/powerhome/power_linting
+  source_code_uri: https://github.com/powerhome/power_linting
+  changelog_uri: https://github.com/powerhome/power_linting/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.7.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.3.7
+signing_key: 
+specification_version: 4
+summary: Cobra rubocop linters
+test_files: []