Class: RuboCop::Cop::PackageProtections::NamespacedUnderPackageName

Inherits:
Packs::RootNamespaceIsPackName
  • Object
show all
Extended by:
T::Sig
Includes:
PackageProtections::RubocopProtectionInterface
Defined in:
lib/rubocop/cop/package_protections/namespaced_under_package_name.rb

Constant Summary collapse

IDENTIFIER = 
T.let('prevent_this_package_from_creating_other_namespaces'.freeze, String)

Instance Method Summary collapse

Methods included from PackageProtections::RubocopProtectionInterface

#cop_configs, #custom_cop_config, #get_offenses_for_existing_violations, #get_offenses_for_new_violations

Methods included from PackageProtections::ProtectionInterface

#default_behavior, #get_offenses, #get_offenses_for_existing_violations, #get_offenses_for_new_violations, #supports_violation_behavior?

Instance Method Details

#cop_name ⇒ Object 



54
55
56
 
# File 'lib/rubocop/cop/package_protections/namespaced_under_package_name.rb', line 54

def cop_name
  'PackageProtections/NamespacedUnderPackageName'
end

#humanized_protection_description ⇒ Object 



64
65
66
67
68
69
70
71
72
73
 
# File 'lib/rubocop/cop/package_protections/namespaced_under_package_name.rb', line 64

def humanized_protection_description
  <<~MESSAGE
    These files cannot have ANY modules/classes that are not submodules of the package's allowed namespaces.
    This is failing because these files are in `.rubocop_todo.yml` under `#{cop_name}`.
    If you want to be able to ignore these files, you'll need to open the file's package's `package.yml` file and
    change `#{IDENTIFIER}` to `#{::PackageProtections::ViolationBehavior::FailOnNew.serialize}`

    See https://go/packwerk_cheatsheet_namespaces for more info.
  MESSAGE
end

#humanized_protection_name ⇒ Object 



59
60
61
 
# File 'lib/rubocop/cop/package_protections/namespaced_under_package_name.rb', line 59

def humanized_protection_name
  'Multiple Namespaces Violations'
end

#identifier ⇒ Object 



24
25
26
 
# File 'lib/rubocop/cop/package_protections/namespaced_under_package_name.rb', line 24

def identifier
  IDENTIFIER
end

#included_globs_for_pack ⇒ Object 



14
15
16
17
18
19
 
# File 'lib/rubocop/cop/package_protections/namespaced_under_package_name.rb', line 14

def included_globs_for_pack
  [
    'app/**/*',
    'lib/**/*'
  ]
end

#message_for_fail_on_any(file) ⇒ Object 



49
50
51
 
# File 'lib/rubocop/cop/package_protections/namespaced_under_package_name.rb', line 49

def message_for_fail_on_any(file)
  "`#{file}` should be namespaced under the package namespace"
end

#unmet_preconditions_for_behavior(behavior, package) ⇒ Object 



29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
 
# File 'lib/rubocop/cop/package_protections/namespaced_under_package_name.rb', line 29

def unmet_preconditions_for_behavior(behavior, package)
  # We don't need to validate if the behavior is currentely fail_never
  return if behavior.fail_never?

  # The reason for this is precondition is the `MultipleNamespacesProtection` assumes this to work properly.
  # To remove this precondition, we need to modify `MultipleNamespacesProtection` to be more generalized!
  is_root_package = package.name == ParsePackwerk::ROOT_PACKAGE_NAME
  in_allowed_directory = ::PackageProtections::EXPECTED_PACK_DIRECTORIES.any? do |expected_package_directory|
    package.directory.to_s.start_with?(expected_package_directory)
  end
  if in_allowed_directory || is_root_package
    nil
  else
    "Package #{package.name} must be located in one of #{::PackageProtections::EXPECTED_PACK_DIRECTORIES.join(', ')} (or be the root) to use this protection"
  end
end