reek 6.0.1 → 6.0.5

data/docs/defaults.reek.yml

@@ -1,129 +0,0 @@
----
-detectors:
-  Attribute:
-    enabled: true
-    exclude: []
-  BooleanParameter:
-    enabled: true
-    exclude: []
-  ClassVariable:
-    enabled: true
-    exclude: []
-  ControlParameter:
-    enabled: true
-    exclude: []
-  DataClump:
-    enabled: true
-    exclude: []
-    max_copies: 2
-    min_clump_size: 2
-  DuplicateMethodCall:
-    enabled: true
-    exclude: []
-    max_calls: 1
-    allow_calls: []
-  FeatureEnvy:
-    enabled: true
-    exclude: []
-  InstanceVariableAssumption:
-    enabled: true
-    exclude: []
-  IrresponsibleModule:
-    enabled: true
-    exclude: []
-  LongParameterList:
-    enabled: true
-    exclude: []
-    max_params: 3
-    overrides:
-      initialize:
-        max_params: 5
-  LongYieldList:
-    enabled: true
-    exclude: []
-    max_params: 3
-  ManualDispatch:
-    enabled: true
-    exclude: []
-  MissingSafeMethod:
-    enabled: true
-    exclude: []
-  ModuleInitialize:
-    enabled: true
-    exclude: []
-  NestedIterators:
-    enabled: true
-    exclude: []
-    max_allowed_nesting: 1
-    ignore_iterators:
-    - tap
-  NilCheck:
-    enabled: true
-    exclude: []
-  RepeatedConditional:
-    enabled: true
-    exclude: []
-    max_ifs: 2
-  SubclassedFromCoreClass:
-    enabled: true
-    exclude: []
-  TooManyConstants:
-    enabled: true
-    exclude: []
-    max_constants: 5
-  TooManyInstanceVariables:
-    enabled: true
-    exclude: []
-    max_instance_variables: 4
-  TooManyMethods:
-    enabled: true
-    exclude: []
-    max_methods: 15
-  TooManyStatements:
-    enabled: true
-    exclude:
-    - initialize
-    max_statements: 5
-  UncommunicativeMethodName:
-    enabled: true
-    exclude: []
-    reject:
-    - "/^[a-z]$/"
-    - "/[0-9]$/"
-    - "/[A-Z]/"
-    accept: []
-  UncommunicativeModuleName:
-    enabled: true
-    exclude: []
-    reject:
-    - "/^.$/"
-    - "/[0-9]$/"
-    accept: []
-  UncommunicativeParameterName:
-    enabled: true
-    exclude: []
-    reject:
-    - "/^.$/"
-    - "/[0-9]$/"
-    - "/[A-Z]/"
-    - "/^_/"
-    accept: []
-  UncommunicativeVariableName:
-    enabled: true
-    exclude: []
-    reject:
-    - "/^.$/"
-    - "/[0-9]$/"
-    - "/[A-Z]/"
-    accept:
-    - "/^_$/"
-  UnusedParameters:
-    enabled: true
-    exclude: []
-  UnusedPrivateMethod:
-    enabled: false
-    exclude: []
-  UtilityFunction:
-    enabled: true
-    exclude: []
-    public_methods_only: false

data/docs/templates/default/docstring/html/public_api_marker.erb

@@ -1,3 +0,0 @@
-<div class="note public">
-  <div class="inline"><p>This <%= object.type %> is part of Reek's public API.</p></div>
-</div>

data/docs/templates/default/docstring/setup.rb

@@ -1,37 +0,0 @@
-def init
-  super
-  return unless show_api_marker_section?
-
-  if sections.first
-    sections.first.place(:api_marker).before(:private)
-  else
-    sections :index, [:api_marker]
-  end
-end
-
-def api_marker
-  return if object.type == :root
-
-  erb(:private) unless ['public', 'private'].include? api_text
-end
-
-private
-
-def api_text
-  api_text = object.has_tag?(:api) && object.tag(:api).text
-  api_text = 'public' if object.has_tag?(:public)
-  api_text
-end
-
-def show_api_marker_section?
-  return false if object.type == :root
-
-  case api_text
-  when 'public'
-    false
-  when 'private'
-    false
-  else
-    true
-  end
-end

data/docs/templates/default/fulldoc/html/css/common.css

@@ -1 +0,0 @@
-.note.public { background: #c5ffc5; border-color: #aaecaa; }

data/docs/yard_plugin.rb

@@ -1,17 +0,0 @@
-require 'yard'
-
-# Template helper to modify processing of links in HTML generated from our
-# markdown files.
-module LocalLinkHelper
-  # Rewrites links to (assumed local) markdown files so they're processed as
-  # {file: } directives.
-  def resolve_links(text)
-    text = text.gsub(%r{<a href="([^"]*.md)">([^<]*)</a>}, '{file:\1 \2}')
-    super text
-  end
-end
-
-YARD::Templates::Template.extra_includes << LocalLinkHelper
-YARD::Tags::Library.define_tag('Guaranteed public API', :public)
-YARD::Tags::Library.define_tag('Code quality configuration', :quality)
-YARD::Templates::Engine.register_template_path File.join(File.dirname(__FILE__), 'templates')

data/features/command_line_interface/basic_usage.feature

@@ -1,15 +0,0 @@
-Feature: The Reek CLI maintains backwards compatibility
-  In order to use Reek without fuss
-  As a developer
-  I want to have a stable basic command line interface
-
-  Scenario: the example from README reports as expected
-    Given the smelly file 'smelly.rb'
-    When I run reek smelly.rb
-    Then the exit status indicates smells
-    And it reports:
-    """
-    smelly.rb -- 2 warnings:
-      [4]:UncommunicativeMethodName: Smelly#x has the name 'x'
-      [5]:UncommunicativeVariableName: Smelly#x has the variable name 'y'
-    """

data/features/command_line_interface/options.feature

@@ -1,123 +0,0 @@
-Feature: Reek can be controlled using command-line options
-  In order to change Reek's default behaviour
-  As a developer
-  I want to supply options on the command line
-
-  Scenario: return non-zero status on bad option
-    When I run reek --no-such-option
-    Then the exit status indicates an error
-    And it reports the error "Error: invalid option: --no-such-option"
-    And there is no output on stdout
-
-  Scenario: display the current version number
-    When I run reek --version
-    Then it succeeds
-    And it reports the current version
-
-  Scenario: return given status code when using --failure-exit-code
-    Given the smelly file 'smelly.rb'
-    When I run reek smelly.rb --failure-exit-code 23
-    Then the exit status is 23
-
-  Scenario: return given status code when using --success-exit-code
-    Given the clean file "clean.rb"
-    When I run reek clean.rb --success-exit-code 42
-    Then the exit status is 42
-
-  Scenario: display the help information
-    When I run reek --help
-    Then it succeeds
-    And it reports:
-      """
-      Usage: reek [options] [files]
-
-      Examples:
-
-      reek lib/*.rb
-      reek -s lib
-      cat my_class.rb | reek
-
-      See https://github.com/troessner/reek for detailed help.
-
-      Configuration:
-          -c, --config FILE                Read configuration options from FILE
-              --smell SMELL                Only look for a specific smell.
-                                           Call it like this: reek --smell MissingSafeMethod source.rb
-                                           Check out https://github.com/troessner/reek/blob/v6.0.1/docs/Code-Smells.md for a list of smells
-              --stdin-filename FILE        When passing code in via pipe, assume this filename when checking file or directory rules in the config.
-
-      Generate a todo list:
-          -t, --todo                       Generate a todo list
-
-      Report format:
-          -f, --format FORMAT              Report smells in the given format:
-                                             html
-                                             text (default)
-                                             yaml
-                                             json
-                                             xml
-
-      Text format options:
-              --[no-]color                 Use colors for the output (default: true)
-          -V, --[no-]empty-headings        Show headings for smell-free source files (default: false)
-          -U, --[no-]documentation         Show link to related documentation page for each smell (default: true)
-              --[no-]show-configuration-path
-                                           Show which configuration file Reek is using (default: false)
-          -n, --[no-]line-numbers          Show line numbers in the output (default: true)
-          -s, --single-line                Show location in editor-compatible single-line-per-smell format
-          -P, --[no-]progress              Show progress of each source as it is examined (default: true)
-              --sort-by SORTING            Sort reported files by the given criterium:
-                                             smelliness ("smelliest" files first)
-                                             none (default - output in processing order)
-              --force-exclusion            Force excluding files specified in the configuration `exclude_paths`
-                                             even if they are explicitly passed as arguments
-
-     Exit codes:
-              --success-exit-code CODE     The exit code when no smells are found (default: 0)
-              --failure-exit-code CODE     The exit code when smells are found (default: 2)
-
-      Utility options:
-          -h, --help                       Show this message
-          -l, --list                       List all available smell detectors
-          -v, --version                    Show version
-      """
-
-  Scenario: List all available smell detectors
-    When I run reek --list
-    Then it succeeds
-    And it reports:
-      """
-      All available smell detectors:
-
-      Attribute
-      BooleanParameter
-      ClassVariable
-      ControlParameter
-      DataClump
-      DuplicateMethodCall
-      FeatureEnvy
-      InstanceVariableAssumption
-      IrresponsibleModule
-      LongParameterList
-      LongYieldList
-      ManualDispatch
-      MissingSafeMethod
-      ModuleInitialize
-      NestedIterators
-      NilCheck
-      RepeatedConditional
-      SubclassedFromCoreClass
-      TooManyConstants
-      TooManyInstanceVariables
-      TooManyMethods
-      TooManyStatements
-      UncommunicativeMethodName
-      UncommunicativeModuleName
-      UncommunicativeParameterName
-      UncommunicativeVariableName
-      UnusedParameters
-      UnusedPrivateMethod
-      UtilityFunction
-
-      Check out https://github.com/troessner/reek/blob/v6.0.1/docs/Code-Smells.md for a details on each detector
-      """

data/features/command_line_interface/show_progress.feature

@@ -1,33 +0,0 @@
-Feature: Show progress
-  In order to see the progress of the examiners
-  As a developer
-  I want to be able to selectively activate progress reporting
-
-  # Note that --progress is the default on TTYs, but needs to be explicitely
-  # enabled here because output in the cucumber scenarios does not go to a TTY.
-  Scenario: shows progress output on mixed files by default
-    Given a directory called 'mixed_files' containing some clean and smelly files
-    When I run reek --progress mixed_files
-    Then the exit status indicates smells
-    And it reports:
-      """
-      Inspecting 2 file(s):
-      .S
-
-      mixed_files/dirty.rb -- 2 warnings:
-        [4]:UncommunicativeMethodName: Smelly#x has the name 'x'
-        [5]:UncommunicativeVariableName: Smelly#x has the variable name 'y'
-      2 total warnings
-      """
-
-  Scenario: --no-progress disables progress output
-    Given a directory called 'mixed_files' containing some clean and smelly files
-    When I run reek --no-progress mixed_files
-    Then the exit status indicates smells
-    And it reports:
-      """
-      mixed_files/dirty.rb -- 2 warnings:
-        [4]:UncommunicativeMethodName: Smelly#x has the name 'x'
-        [5]:UncommunicativeVariableName: Smelly#x has the variable name 'y'
-      2 total warnings
-      """

data/features/command_line_interface/smell_selection.feature

@@ -1,15 +0,0 @@
-Feature: Smell selection
-  In order to focus on particular code smells
-  As a developer
-  I want to be able to selectively activate smell detectors
-
-  Scenario: --smell selects a smell to detect
-    Given the smelly file 'smelly.rb'
-    And a configuration file 'partial_mask.reek'
-    When I run reek --no-line-numbers --smell UncommunicativeVariableName smelly.rb
-    Then the exit status indicates smells
-    And it reports:
-      """
-      smelly.rb -- 1 warning:
-        UncommunicativeVariableName: Smelly#x has the variable name 'y'
-      """

data/features/command_line_interface/smells_count.feature

@@ -1,38 +0,0 @@
-Feature: Reports total number of code smells
-  In order to monitor the total number of smells
-  Reek outputs the total number of smells among all files inspected.
-
-  Scenario: Does not output total number of smells when inspecting single file
-    Given the smelly file 'smelly.rb'
-    When I run reek smelly.rb
-    Then the exit status indicates smells
-    And it reports:
-      """
-      smelly.rb -- 2 warnings:
-        [4]:UncommunicativeMethodName: Smelly#x has the name 'x'
-        [5]:UncommunicativeVariableName: Smelly#x has the variable name 'y'
-      """
-
-  Scenario: Output total number of smells when inspecting multiple files
-    Given a directory called 'smelly' containing two smelly files
-    When I run reek smelly
-    Then the exit status indicates smells
-    And it reports:
-      """
-      smelly/dirty_one.rb -- 2 warnings:
-        [4]:UncommunicativeMethodName: Smelly#x has the name 'x'
-        [5]:UncommunicativeVariableName: Smelly#x has the variable name 'y'
-      smelly/dirty_two.rb -- 2 warnings:
-        [4]:UncommunicativeMethodName: Smelly#x has the name 'x'
-        [5]:UncommunicativeVariableName: Smelly#x has the variable name 'y'
-      4 total warnings
-      """
-
-  Scenario: Output total number of smells even if total equals 0
-    Given a directory called 'clean' containing two clean files
-    When I run reek clean
-    Then it succeeds
-    And it reports:
-      """
-      0 total warnings
-      """

data/features/command_line_interface/stdin.feature

@@ -1,65 +0,0 @@
-Feature: Reek reads from $stdin when no files are given
-  In order to use reek with pipelines
-  As a developer
-  I want to pipe source code on stdin
-
-  Scenario: return zero status with no smells
-    When I pass "def simple() @fred = 3 end" to reek
-    Then it succeeds
-    And it reports nothing
-
-  Scenario: outputs nothing on empty stdin
-    When I pass "" to reek
-    Then it succeeds
-    And it reports nothing
-
-  Scenario: outputs header only on empty stdin in verbose mode
-    When I pass "" to reek -V
-    Then it succeeds
-    And it reports:
-      """
-      STDIN -- 0 warnings
-      """
-
-  Scenario: return non-zero status when there are smells
-    When I pass "class Turn; def y() @x = 3; end end" to reek
-    Then the exit status indicates smells
-    And it reports:
-      """
-      STDIN -- 3 warnings:
-        [1]:IrresponsibleModule: Turn has no descriptive comment
-        [1]:UncommunicativeMethodName: Turn#y has the name 'y'
-        [1]:UncommunicativeVariableName: Turn has the variable name '@x'
-      """
-
-  Scenario: syntax error causes the source to be ignored
-    When I pass "= invalid syntax =" to reek
-    Then it succeeds
-    And it reports the error "Parser::SyntaxError: unexpected token tEQL"
-
-  Scenario: providing a filename to use for the config to match against
-    Given a file named "web_app/config.reek" with:
-      """
-      ---
-      directories:
-        "web_app/app/controllers":
-          IrresponsibleModule:
-            enabled: false
-          NestedIterators:
-            enabled: false
-          InstanceVariableAssumption:
-            enabled: false
-      """
-    When I pass a stdin to reek --config web_app/config.reek --stdin-filename web_app/app/controllers/users_controller with:
-      """
-      class UsersController < ApplicationController
-        def show
-          respond_with do |format|
-            format.json { |json| @user.to_custom_json }
-            format.xml { |xml| @user.to_fancy_xml }
-          end
-        end
-      end
-      """
-    Then it succeeds
-    And it reports nothing