sleeping_king_studios-tasks 0.1.0.rc.1 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 33faea0f72569a5035c8dc78a50cc0b3390aafee
-  data.tar.gz: b116e99e9f2dbae198a46a16567b622e3b34184a
+SHA256:
+  metadata.gz: 6b22e56277e42bd23403ac607dd21057d5c6c6e870655a326e16524d1c1eb051
+  data.tar.gz: 4ab2e01510d48601888a8239a85b928ab610a111ea57aa6abce24c418cd7d85d
 SHA512:
-  metadata.gz: 1e4968cf1e1b30d3d65e7df61617f90de197a53cc076cf09bc8efe3b3d88c750103911bf9c048fa7d7df4d728aa7ef674089dbf50609de1d040d4b4e29230187
-  data.tar.gz: '048cf59da7de0f337caec2dc4ee2a5a417629c34b38e6485a792470921f265bfca57cf549967419575bd7532e944a60e2e8d8cda9b9b9a64ece6ceb1e3bd6c0b'
+  metadata.gz: a5f679f0abaa9b54de43b0eff521b9ea0a4275f82925bf9a4821f2d97260a0b29beccc49bc115067585c91ba1fd90800f07d580bfc49df3742536ae2e2cb9524
+  data.tar.gz: 8978756f73cfff58d8ab49809ddfd3ca6eed68868f48124d524280f2e008bfec3c42615e6a9f97a2c9fe1a653c65c4ebb2f13174464d300e332f954de0c02dc2

data/CHANGELOG.md

@@ -1,5 +1,22 @@
 # Changelog
 
+## 0.4.0
+
+- Fix deprecations from SleepingKingStudios::Tools.
+- Add support for Ruby 3.0.
+
+## 0.3.0
+
+- Fix deprecation warnings in Ruby 2.7.
+- Add support for Thor 1.0.
+
+## 0.2.0
+
+### Ci
+
+- Implement tasks for Jest.js, ESLint.
+- Add --format option, configuration value for RSpec, RSpec (Each) tasks.
+
 ## 0.1.0
 
 Initial commit.

data/DEVELOPMENT.md

@@ -1,5 +1,9 @@
 ## Tasks
 
+### Version 0.2.1
+
+- add --retry option to Cucumber task.
+
 ### Future Tasks
 
 - add documentation for "ci" option in applications.yml
@@ -17,6 +21,12 @@
 
 #### CI
 
+- configurable --format options for CI steps
+
+- task ci:rspec_each: |
+
+  Default to displaying --format=progress.
+
 - task ci:steps: |
 
   Add --diff option

data/README.md

@@ -1,5 +1,7 @@
 # SleepingKingStudios::Tasks [![Build Status](https://travis-ci.org/sleepingkingstudios/sleeping_king_studios-tasks.svg?branch=master)](https://travis-ci.org/sleepingkingstudios/sleeping_king_studios-tasks)
 
+**Note:** This project is deprecated, and will not receive further feature updates.
+
 A toolkit providing an encapsulation layer around the Thor CLI library, with predefined tasks for development and continuous integration.
 
 See also [https://github.com/erikhuda/thor](https://github.com/erikhuda/thor).
@@ -10,10 +12,6 @@ See also [https://github.com/erikhuda/thor](https://github.com/erikhuda/thor).
 
 The canonical repository for this gem is on [GitHub](https://github.com/sleepingkingstudios/sleeping_king_studios-tasks).
 
-### A Note From The Developer
-
-Hi, I'm Rob Smith, a Ruby Engineer and the developer of this library. I use these tools every day, but they're not just written for me. If you find this project helpful in your own work, or if you have any questions, suggestions or critiques, please feel free to get in touch! I can be reached on GitHub (see above, and feel encouraged to submit bug reports or merge requests there) or via email at `merlin@sleepingkingstudios.com`. I look forward to hearing from you!
-
 ## Task Classes
 
 SleepingKingStudios::Tasks defines a wrapper around the Thor CLI.
@@ -169,9 +167,11 @@ In addition, the cucumber step has the additional option:
 
 - `default_files [Array]`: Files that are always loaded when running Cucumber, such as step definitions or support files. By default, this includes 'step_definitions.rb' and the 'step_definitions' directory inside 'features'.
 
-`config.ci.rspec [Hash]`: Step configuration for the RSpec step. Has the same options as `config.ci.cucumber`, above, except for the aforementioned `default_files` option.
+`config.ci.rspec [Hash]`: Step configuration for the RSpec step. Has the same options as `config.ci.cucumber`, above, except for the aforementioned `default_files` option. In addition, the RSpec task has the following option:
+
+- `format [String]`: The RSpec formatter used to format the spec results. Defaults to 'documentation'.
 
-`config.ci.rspec_each [Hash]`: Step configuration for the RSpec Each step.
+`config.ci.rspec_each [Hash]`: Step configuration for the RSpec Each step. Has the same configuration options as the RSpec step.
 
 `config.ci.rubocop [Hash]`: Step configuration for the RuboCop step.
 

data/lib/sleeping_king_studios/tasks/apps.rb

@@ -23,7 +23,7 @@ module SleepingKingStudios::Tasks
 
           apps.each do |key, data|
             name = key.to_s
-            data = tools.hash.convert_keys_to_symbols(data)
+            data = tools.hsh.convert_keys_to_symbols(data)
 
             data[:name] ||= name
 

data/lib/sleeping_king_studios/tasks/apps/app_configuration.rb

@@ -49,7 +49,7 @@ module SleepingKingStudios::Tasks::Apps
 
     define_method :short_name do
       # rubocop:disable Style/RedundantSelf
-      tools.string.underscore(self.name.gsub(/\s+/, '_'))
+      tools.str.underscore(self.name.gsub(/\s+/, '_'))
       # rubocop:enable Style/RedundantSelf
     end # define_method
 

data/lib/sleeping_king_studios/tasks/apps/ci/results_reporter.rb

@@ -1,6 +1,6 @@
 # lib/sleeping_king_studios/tasks/apps/ci/results_reporter.rb
 
-require 'sleeping_king_studios/tools/toolbox/delegator'
+require 'forwardable'
 
 require 'sleeping_king_studios/tasks/apps/ci'
 require 'sleeping_king_studios/tasks/ci/results_helpers'
@@ -9,21 +9,23 @@ module SleepingKingStudios::Tasks::Apps::Ci
   # Reports on the results of a multi-application continuous integration
   # process, printing the step results grouped by application.
   class ResultsReporter
-    extend SleepingKingStudios::Tools::Toolbox::Delegator
+    extend Forwardable
 
     include SleepingKingStudios::Tasks::Ci::ResultsHelpers
 
-    delegate \
-      :applications,
+    def_delegators :@context,
       :print_table,
       :say,
-      :set_color,
-      :to => :@context
+      :set_color
 
     def initialize context
       @context = context
     end # method initialize
 
+    def applications
+      @context.send(:applications)
+    end
+
     def call results
       width = 1 + heading_width(results)
 

data/lib/sleeping_king_studios/tasks/apps/ci/rspec_task.rb

@@ -22,7 +22,7 @@ module SleepingKingStudios::Tasks::Apps::Ci
 
     def call *applications
       SleepingKingStudios::Tasks::Apps::Ci::StepsTask.
-        new(options.merge('only' => %w(rspec))).
+        new(options.merge('only' => %w[rspec])).
         call(*applications)
     end # method call
   end # class

data/lib/sleeping_king_studios/tasks/apps/ci/rubocop_task.rb

@@ -22,7 +22,7 @@ module SleepingKingStudios::Tasks::Apps::Ci
 
     def call *applications
       SleepingKingStudios::Tasks::Apps::Ci::StepsTask.
-        new(options.merge('only' => %w(rubocop))).
+        new(options.merge('only' => %w[rubocop])).
         call(*applications)
     end # method call
   end # class

data/lib/sleeping_king_studios/tasks/ci/cucumber_parser.rb

@@ -65,11 +65,12 @@ module SleepingKingStudios::Tasks::Ci
 
         status = step_status(step) || 'failed'
 
-        if status == 'failed'
+        case status
+        when 'failed'
           report['failing_step_count'] += 1
-        elsif status == 'pending' || status == 'skipped'
+        when 'pending', 'skipped'
           report['pending_step_count'] += 1
-        end # if
+        end
 
         status
       end # method parse_step

data/lib/sleeping_king_studios/tasks/ci/cucumber_results.rb

@@ -167,7 +167,7 @@ module SleepingKingStudios::Tasks::Ci
     end # method build_summary_details
 
     def keys
-      %w(
+      %w[
         duration
         step_count
         pending_step_count
@@ -175,11 +175,11 @@ module SleepingKingStudios::Tasks::Ci
         scenario_count
         pending_scenarios
         failing_scenarios
-      ) # end keys
+      ] # end keys
     end # method keys
 
     def pluralize count, singular, plural = nil
-      "#{count} #{tools.integer.pluralize count, singular, plural}"
+      "#{count} #{tools.int.pluralize count, singular, plural}"
     end # method pluralize
 
     def tools

data/lib/sleeping_king_studios/tasks/ci/cucumber_task.rb

@@ -33,7 +33,7 @@ module SleepingKingStudios::Tasks::Ci
     private
 
     def cucumber_runner
-      opts = %w(--color)
+      opts = %w[--color]
       opts << '--format=pretty' unless quiet?
 
       CucumberRunner.new(:options => opts)

data/lib/sleeping_king_studios/tasks/ci/eslint_results.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+require 'sleeping_king_studios/tasks/ci'
+
+module SleepingKingStudios::Tasks::Ci
+  # Encapsulates the results of an Eslint call.
+  class EslintResults
+    # @param results [Hash] The raw results of the Eslint call.
+    def initialize results
+      @results = results
+    end
+
+    # @param other [EslintResults] The other results object to compare.
+    #
+    # @return [Boolean] True if the results are equal, otherwise false.
+    def == other
+      if other.is_a?(Array)
+        empty? ? other.empty? : @results == other
+      elsif other.is_a?(EslintResults)
+        to_h == other.to_h
+      else
+        false
+      end
+    end
+
+    # @return [Boolean] True if there are no inspected files, otherwise false.
+    def empty?
+      inspected_file_count.zero?
+    end
+
+    # @return [Integer] The total number of error results across all files.
+    def error_count
+      @error_count ||= @results.map { |hsh| hsh['errorCount'] }.sum
+    end
+
+    # @return [Boolean] True if there are no errors or warnings, otherwise
+    #   false.
+    def failing?
+      !(error_count.zero? && warning_count.zero?)
+    end
+
+    # @return [Integer] The number of inspected files.
+    def inspected_file_count
+      @results.size
+    end
+
+    # @return [Boolean] Always false. Both warnings and errors trigger a failure
+    #   state.
+    def pending?
+      false
+    end
+
+    # @return [Hash] The hash representation of the results.
+    def to_h
+      {
+        'inspected_file_count' => inspected_file_count,
+        'error_count'          => error_count,
+        'warning_count'        => warning_count
+      }
+    end
+
+    # @return [String] The string representation of the results.
+    def to_s # rubocop:disable Metrics/AbcSize
+      str = +"#{pluralize inspected_file_count, 'file'} inspected"
+
+      str << ", #{pluralize error_count, 'error'}"
+
+      str << ", #{pluralize warning_count, 'warning'}"
+
+      str << "\n" unless non_empty_results.empty?
+
+      non_empty_results.each do |hsh|
+        str << "\n    #{format_result_item(hsh)}"
+      end
+
+      str
+    end
+
+    # @return [Integer] The total number of warning results across all files.
+    def warning_count
+      @warning_count ||= @results.map { |hsh| hsh['warningCount'] }.sum
+    end
+
+    private
+
+    def format_result_item hsh
+      str = +relative_path(hsh['filePath'])
+
+      str << ": #{pluralize hsh['errorCount'], 'error'}"
+
+      str << ", #{pluralize hsh['warningCount'], 'warning'}"
+    end
+
+    def non_empty_results
+      @results.reject do |hsh|
+        hsh['errorCount'].zero? && hsh['warningCount'].zero?
+      end
+    end
+
+    def pluralize count, singular, plural = nil
+      "#{count} #{tools.int.pluralize count, singular, plural}"
+    end
+
+    def relative_path path
+      path.sub(/\A#{Dir.getwd}#{File::SEPARATOR}?/, '')
+    end
+
+    def tools
+      SleepingKingStudios::Tools::Toolbelt.instance
+    end
+  end
+end

data/lib/sleeping_king_studios/tasks/ci/eslint_runner.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require 'sleeping_king_studios/tasks/ci'
+require 'sleeping_king_studios/tasks/process_runner'
+
+module SleepingKingStudios::Tasks::Ci
+  # Service object to run Eslint as an external process with the specified
+  # parameters.
+  class EslintRunner < SleepingKingStudios::Tasks::ProcessRunner
+    def call env: {}, files: [], options: [], report: true
+      report  = 'tmp/ci/eslint.json' if report && !report.is_a?(String)
+      command =
+        build_command(
+          :env     => env,
+          :files   => files,
+          :options => options,
+          :report  => report
+        )
+
+      stream_process(command)
+
+      report ? load_report(:report => report) : []
+    end
+
+    private
+
+    def base_command
+      'yarn eslint'
+    end
+
+    def build_options files:, options:, report:, **_kwargs
+      files = default_files if files.empty?
+      options += ['--format=json', "--output-file=#{report}"] if report
+
+      super :files => files, :options => options
+    end
+
+    def default_files
+      SleepingKingStudios::Tasks.configuration.ci.eslint.
+        fetch(:default_files, '"**/*.js"')
+    end
+
+    def load_report report:
+      raw = File.read report
+
+      JSON.parse raw
+    rescue
+      []
+    end
+  end
+end

data/lib/sleeping_king_studios/tasks/ci/eslint_task.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require 'sleeping_king_studios/tasks/ci'
+require 'sleeping_king_studios/tasks/ci/eslint_results'
+require 'sleeping_king_studios/tasks/ci/eslint_runner'
+
+module SleepingKingStudios::Tasks::Ci
+  # Defines a Thor task for running the Eslint linter.
+  class EslintTask < SleepingKingStudios::Tasks::Task
+    def self.description
+      'Runs the ESLint linter.'
+    end
+
+    def self.task_name
+      'eslint'
+    end
+
+    def call *files
+      results = eslint_runner.call(:files => files)
+
+      EslintResults.new(results)
+    end
+
+    private
+
+    def eslint_runner
+      opts = %w[--color]
+
+      EslintRunner.new(:options => opts)
+    end
+  end
+end

data/lib/sleeping_king_studios/tasks/ci/jest_results.rb

@@ -0,0 +1,106 @@
+# frozen_string_literal: true
+
+require 'sleeping_king_studios/tasks/ci'
+
+module SleepingKingStudios::Tasks::Ci
+  # Encapsulates the results of a Jest call.
+  class JestResults
+    # @param results [Hash] The raw results of the Jest call.
+    def initialize results
+      @results = results
+    end
+
+    # @param other [JestResults] The other results object to compare.
+    #
+    # @return [Boolean] True if the results are equal, otherwise false.
+    def == other
+      if other.is_a?(Hash)
+        empty? ? other.empty? : @results == other
+      elsif other.is_a?(JestResults)
+        to_h == other.to_h
+      else
+        false
+      end
+    end
+
+    # @return [Float] The duration value, in seconds.
+    def duration
+      (end_time - start_time).to_f / 1000
+    end
+
+    # @return [Boolean] True if there are no tests, otherwise false.
+    def empty?
+      test_count.zero?
+    end
+
+    # @return [Boolean] True if there are any failing tests, otherwise false.
+    def failing?
+      !failure_count.zero?
+    end
+
+    # @return [Integer] The number of failing tests.
+    def failure_count
+      @results.fetch('numFailedTests', 0)
+    end
+
+    # @return [Boolean] True if there are any pending tests, otherwise false.
+    def pending?
+      !pending_count.zero?
+    end
+
+    # @return [Intger] The number of pending tests.
+    def pending_count
+      @results.fetch('numPendingTests', 0)
+    end
+
+    # @return [Integer] The total number of tests.
+    def test_count
+      @results.fetch('numTotalTests', 0)
+    end
+
+    # @return [Hash] The hash representation of the results.
+    def to_h
+      {
+        'duration'      => duration,
+        'failure_count' => failure_count,
+        'pending_count' => pending_count,
+        'test_count'    => test_count
+      }
+    end
+
+    # @return [String] The string representation of the results.
+    def to_s # rubocop:disable Metrics/AbcSize
+      str = +pluralize(test_count, 'test')
+
+      str << ', ' << pluralize(failure_count, 'failure')
+
+      str << ', ' << pending_count.to_s << ' pending' if pending?
+
+      str << " in #{duration.round(2)} seconds"
+    end
+
+    private
+
+    def end_time
+      return 0 unless @results['testResults']
+
+      @results['testResults'].
+        map { |test_result| test_result['endTime'] }.
+        reduce do |memo, time|
+          [memo, time].max
+        end
+    end
+
+    def pluralize count, singular, plural = nil
+      "#{count} #{tools.int.pluralize count, singular, plural}"
+    end
+
+    def start_time
+      @results['startTime'] || 0
+    end
+
+    def tools
+      SleepingKingStudios::Tools::Toolbelt.instance
+    end
+  end
+end