kettle-test 1.0.10 → 2.0.0

data/exe/kettle-test.sh

@@ -0,0 +1,191 @@
+#!/usr/bin/env bash
+# exe/kettle-test — Run specs and emit a structured highlight summary.
+#
+# Provided by the kettle-test gem.
+#
+# Usage:
+#   bundle exec kettle-test [SPEC_ARGS...]
+#
+# By default this runs `bundle exec turbo_tests2`, so projects get parallel
+# RSpec execution with the same command used by CI and Rake tasks. Set
+# KETTLE_TEST_RUNNER=rspec to force direct `bundle exec rspec`.
+#
+# All arguments are forwarded to the selected runner.
+# Output is captured, written to tmp/kettle-test/rspec-TIMESTAMP.log,
+# and then key sections are printed to STDOUT in a compact summary block.
+#
+# Exit code mirrors RSpec's exit code (including coverage hard-failure).
+#
+# Environment variables (from kettle-soup-cover):
+#   K_SOUP_COV_DO        - set to "true" to enable coverage (default: off locally)
+#   K_SOUP_COV_MIN_HARD  - set to "true" to hard-fail on coverage (default: CI only)
+#   KETTLE_TEST_RUNNER   - turbo_tests2 (default) or rspec
+#   KETTLE_TEST_TURBO_PROCESSES    - passed to turbo_tests2 -n
+#   KETTLE_TEST_TURBO_RUNTIME_LOG  - passed to turbo_tests2 --runtime-log
+#   KETTLE_TEST_TURBO_NICE         - set true to pass turbo_tests2 --nice
+#
+# Examples:
+#   bundle exec kettle-test
+#   bundle exec kettle-test spec/my_spec.rb
+#   K_SOUP_COV_DO=true bundle exec kettle-test
+#
+set -euo pipefail
+
+# ── Helpers ──────────────────────────────────────────────────────────────────
+
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+CYAN='\033[0;36m'
+BOLD='\033[1m'
+RESET='\033[0m'
+
+hr() { printf '%s\n' "────────────────────────────────────────────────────────────────"; }
+
+# ── Project root ──────────────────────────────────────────────────────────────
+# When run via `bundle exec`, BUNDLE_GEMFILE points to the project's Gemfile.
+# Fall back to the current working directory.
+
+if [ -n "${BUNDLE_GEMFILE:-}" ]; then
+  PROJECT_ROOT="$(cd "$(dirname "$BUNDLE_GEMFILE")" && pwd)"
+else
+  PROJECT_ROOT="$(pwd)"
+fi
+
+LOG_DIR="$PROJECT_ROOT/tmp/kettle-test"
+mkdir -p "$LOG_DIR"
+TIMESTAMP="$(date -u +%Y%m%d-%H%M%S)"
+RUNNER="${KETTLE_TEST_RUNNER:-turbo_tests2}"
+LOG_FILE="$LOG_DIR/${RUNNER}-${TIMESTAMP}-$$.log"
+
+# ── Run specs ─────────────────────────────────────────────────────────────────
+# Run via Bundler so the project's own Gemfile is always used.
+# We tee to the log so the full output is preserved even if the user interrupts.
+
+rspec_exit=0
+cd "$PROJECT_ROOT"
+
+case "$RUNNER" in
+  turbo|turbo_tests2)
+    export PARALLEL_TEST_FIRST_IS_1="${PARALLEL_TEST_FIRST_IS_1:-true}"
+    command=(bundle exec turbo_tests2)
+    if [ -n "${KETTLE_TEST_TURBO_PROCESSES:-}" ]; then
+      command+=(-n "$KETTLE_TEST_TURBO_PROCESSES")
+    fi
+    if [ -n "${KETTLE_TEST_TURBO_RUNTIME_LOG:-}" ]; then
+      command+=(--runtime-log "$KETTLE_TEST_TURBO_RUNTIME_LOG")
+    fi
+    if [ "${KETTLE_TEST_TURBO_NICE:-false}" = "true" ]; then
+      command+=(--nice)
+    fi
+    command+=("$@")
+    ;;
+  rspec)
+    command=(bundle exec rspec "$@")
+    ;;
+  *)
+    printf 'Unknown KETTLE_TEST_RUNNER: %s\n' "$RUNNER" >&2
+    printf 'Supported values: turbo_tests2, turbo, rspec\n' >&2
+    exit 64
+    ;;
+esac
+
+"${command[@]}" 2>&1 | tee "$LOG_FILE" || rspec_exit=$?
+
+# ── Parse output ──────────────────────────────────────────────────────────────
+
+LOG="$LOG_FILE"
+
+# Strip ANSI escape codes for parsing
+clean_log() { sed 's/\x1b\[[0-9;]*[mK]//g' "$LOG"; }
+
+# Summary line: "N examples, N failures" or "N examples, N failures, N pending"
+summary_line=$(clean_log | grep -E '^[0-9]+ example' | tail -1 || true)
+
+# Finished timing line
+finished_line=$(clean_log | grep -E '^Finished in' | tail -1 || true)
+
+# Seed line
+seed_line=$(clean_log | grep -E '^Randomized with seed' | tail -1 || true)
+
+# Failed examples block (rspec ./path:N # description)
+failed_block=$(clean_log | grep -E '^rspec \./.*#' || true)
+failed_count=$(printf '%s\n' "$failed_block" | grep -c 'rspec \.' || true)
+failed_count=${failed_count:-0}
+
+# Coverage lines (simplecov-console output)
+cov_line=$(clean_log | grep -E '^Line Coverage:' | tail -1 || true)
+cov_branch=$(clean_log | grep -E '^Branch Coverage:' | tail -1 || true)
+cov_summary=$(clean_log | grep -E '^(COVERAGE|BRANCH COVERAGE):' || true)
+cov_hard_fail=$(clean_log | grep -iE '(minimum coverage|coverage requirement|failed.*coverage)' | tail -3 || true)
+
+# ── Emit summary ──────────────────────────────────────────────────────────────
+
+echo
+hr
+printf '%b\n' "${BOLD}[rspec_summary] Spec Run Highlights${RESET}"
+hr
+
+# Timing
+if [ -n "$finished_line" ]; then
+  printf '%b\n' "${CYAN}⏱  ${finished_line}${RESET}"
+fi
+
+# Seed
+if [ -n "$seed_line" ]; then
+  printf '%b\n' "${CYAN}🎲  ${seed_line}${RESET}"
+fi
+
+# Examples / failures / pending
+if [ -n "$summary_line" ]; then
+  if echo "$summary_line" | grep -qE ',\s*[1-9][0-9]* failure'; then
+    printf '%b\n' "${RED}❌  ${summary_line}${RESET}"
+  else
+    printf '%b\n' "${GREEN}✅  ${summary_line}${RESET}"
+  fi
+else
+  printf '%b\n' "${YELLOW}⚠️  No summary line found — check log: ${LOG_FILE}${RESET}"
+fi
+
+# Failed examples
+if [ "$failed_count" -gt 0 ] 2>/dev/null; then
+  echo
+  printf '%b\n' "${RED}${BOLD}Failed examples (${failed_count}):${RESET}"
+  echo "$failed_block" | while IFS= read -r line; do
+    [ -n "$line" ] && printf '  %b\n' "${RED}${line}${RESET}"
+  done
+fi
+
+# Coverage
+if [ -n "$cov_line" ] || [ -n "$cov_summary" ]; then
+  echo
+  printf '%b\n' "${BOLD}Coverage:${RESET}"
+  [ -n "$cov_line" ]    && printf '  %b\n' "${cov_line}"
+  [ -n "$cov_branch" ]  && printf '  %b\n' "${cov_branch}"
+  if [ -n "$cov_summary" ]; then
+    echo "$cov_summary" | while IFS= read -r line; do
+      [ -n "$line" ] && printf '  %b\n' "${CYAN}${line}${RESET}"
+    done
+  fi
+  if [ -n "$cov_hard_fail" ]; then
+    echo
+    printf '%b\n' "${RED}${BOLD}Coverage hard-failure:${RESET}"
+    echo "$cov_hard_fail" | while IFS= read -r line; do
+      [ -n "$line" ] && printf '  %b\n' "${RED}${line}${RESET}"
+    done
+  fi
+fi
+
+# Exit code
+echo
+if [ "$rspec_exit" -eq 0 ]; then
+  printf '%b\n' "${GREEN}${BOLD}Exit: 0 (PASSED)${RESET}"
+else
+  printf '%b\n' "${RED}${BOLD}Exit: ${rspec_exit} (FAILED)${RESET}"
+fi
+
+printf '%b\n' "${CYAN}📄  Full log: ${LOG_FILE}${RESET}"
+hr
+echo
+
+exit "$rspec_exit"

data/lib/kettle/test/rspec.rb

@@ -4,6 +4,14 @@ require_relative "external"
 # Requires external helpers, this library, then wires internal configuration.
 require "kettle/test"
 
+module Kettle
+  module Test
+    # Namespace for the RSpec integration entrypoint.
+    module RSpec
+    end
+  end
+end
+
 require_relative "internal"
 
 # A gem's test harness should do require "rake" if it is their dependency,

data/lib/kettle/test/version.rb

@@ -2,12 +2,9 @@
 
 module Kettle
   module Test
-    # Version namespace
     module Version
-      # The current version of kettle-test.
-      # @return [String]
-      VERSION = "1.0.10"
+      VERSION = "2.0.0"
     end
-    VERSION = Version::VERSION # Traditional constant at module level
+    VERSION = Version::VERSION # Traditional Constant Location
   end
 end

data/lib/kettle/test.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "date"
+require "version_gem"
 require_relative "test/version"
 
 # Kettle namespace for the kettle-rb ecosystem of gems.
@@ -17,7 +19,7 @@ module Kettle
 
     # String#casecmp? was added in Ruby 2.4, so fallback to String#casecmp
     # @return [Boolean] whether debug mode is enabled (disables silencing)
-    DEBUG = ENV.fetch("KETTLE_TEST_DEBUG", ENV.fetch("DEBUG", "false")).casecmp("true").zero?
+    DEBUG = ENV.fetch("KETTLE_TEST_DEBUG", ENV.fetch("KETTLE_DEV_DEBUG", "false")).casecmp("true").zero?
     # @return [Boolean] whether running in a CI environment (CI=true)
     IS_CI = ENV.fetch("CI", "").casecmp("true").zero?
     # @return [Boolean] when true, enables full backtraces in RSpec

data/sig/kettle/test/version.rbs

@@ -0,0 +1,9 @@
+module Kettle
+  module Test
+    module Version
+      VERSION: String
+    end
+    VERSION: String
+  end
+end
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-test
 version: !ruby/object:Gem::Version
-  version: 1.0.10
+  version: 2.0.0
 platform: ruby
 authors:
 - Peter H. Boling
@@ -37,26 +37,6 @@ cert_chain:
   -----END CERTIFICATE-----
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
-- !ruby/object:Gem::Dependency
-  name: version_gem
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.1.9
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.1'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 1.1.9
 - !ruby/object:Gem::Dependency
   name: appraisal2
   requirement: !ruby/object:Gem::Requirement
@@ -219,34 +199,68 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.3
+- !ruby/object:Gem::Dependency
+  name: turbo_tests2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+- !ruby/object:Gem::Dependency
+  name: version_gem
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.9
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.1.9
 - !ruby/object:Gem::Dependency
   name: kettle-dev
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.2.4
+        version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.2.4
+        version: '2.0'
 - !ruby/object:Gem::Dependency
   name: bundler-audit
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: 0.9.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: 0.9.3
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -281,6 +295,26 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 1.0.4
+- !ruby/object:Gem::Dependency
+  name: appraisal2
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.6
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.0.6
 - !ruby/object:Gem::Dependency
   name: ruby-progressbar
   requirement: !ruby/object:Gem::Requirement
@@ -304,7 +338,7 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.2
+        version: 1.0.3
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -314,7 +348,7 @@ dependencies:
         version: '1.0'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 1.0.2
+        version: 1.0.3
 - !ruby/object:Gem::Dependency
   name: gitmoji-regex
   requirement: !ruby/object:Gem::Requirement
@@ -343,7 +377,8 @@ description: "\U0001F372 Kettle::Test is a meta tool from kettle-rb to streamlin
   Fund overlooked open source projects - bottom of stack, dev/test dependencies: floss-funding.dev"
 email:
 - floss@galtzo.com
-executables: []
+executables:
+- kettle-test
 extensions: []
 extra_rdoc_files:
 - CHANGELOG.md
@@ -351,9 +386,8 @@ extra_rdoc_files:
 - CODE_OF_CONDUCT.md
 - CONTRIBUTING.md
 - FUNDING.md
-- LICENSE.txt
+- LICENSE.md
 - README.md
-- REEK
 - RUBOCOP.md
 - SECURITY.md
 files:
@@ -362,11 +396,13 @@ files:
 - CODE_OF_CONDUCT.md
 - CONTRIBUTING.md
 - FUNDING.md
-- LICENSE.txt
+- LICENSE.md
 - README.md
-- REEK
 - RUBOCOP.md
 - SECURITY.md
+- certs/pboling.pem
+- exe/kettle-test
+- exe/kettle-test.sh
 - lib/kettle/test.rb
 - lib/kettle/test/config/ext/backports.rb
 - lib/kettle/test/config/ext/rspec/rspec_stubbed_env.rb
@@ -385,15 +421,17 @@ files:
 - lib/kettle/test/support/shared_contexts/with_rake.rb
 - lib/kettle/test/version.rb
 - sig/kettle/test.rbs
+- sig/kettle/test/version.rbs
 homepage: https://github.com/kettle-rb/kettle-test
 licenses:
-- MIT
+- AGPL-3.0-only
+- PolyForm-Small-Business-1.0.0
 metadata:
-  homepage_uri: https://kettle-test.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/kettle-test/tree/v1.0.10
-  changelog_uri: https://github.com/kettle-rb/kettle-test/blob/v1.0.10/CHANGELOG.md
+  homepage_uri: https://kettle-test.galtzo.com
+  source_code_uri: https://github.com/kettle-rb/kettle-test/tree/v2.0.0
+  changelog_uri: https://github.com/kettle-rb/kettle-test/blob/v2.0.0/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/kettle-test/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-test/1.0.10
+  documentation_uri: https://www.rubydoc.info/gems/kettle-test/2.0.0
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-rb/kettle-test/wiki
   news_uri: https://www.railsbling.com/tags/kettle-test
@@ -415,14 +453,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 2.3.0
+      version: 2.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.5
+rubygems_version: 4.0.11
 specification_version: 4
 summary: "\U0001F372 A kettle-rb meta tool to streamline testing"
 test_files: []

data/LICENSE.txt

@@ -1,21 +0,0 @@
-The MIT License (MIT)
-
-Copyright (c) 2023, 2025 Peter Boling
-
-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.