cucumber 9.2.1 → 10.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f6b3938bfcfa22aba558e5ea44825ed2ee19e9c7d26c0a5613f7998095d5c287
-  data.tar.gz: edc19d118e96175085722756b873b48c2ec319663edeedd81de027a48ac7d66c
+  metadata.gz: 2c0b8e35a28f81c7641e8ec04c2831c8884df1bb505d275f9a809cce801848d6
+  data.tar.gz: e28e2cb4ab3a3a3683ebf7ceaa1ff6dcb96b9a785ecb8ceb7d16d43f529678a4
 SHA512:
-  metadata.gz: f1338b46610ebd6fff711400c0160294f451e3c98558ca155712d07040a06f9a55fcb99c6e9cd00e5df248a415928b2a7c70da76a7badcc461b832ec464b66a8
-  data.tar.gz: b1c00b91c1055daf161482ba19b4cfa60089140af3212f9a1d71ef9a692d4dabd43fdb5fa3fa0bfcbcce018053f0ebc5460f1449bfaa32fa6afb0f532156c9d1
+  metadata.gz: 9a734880b62afa6292433b3c553a6956c3bdb0520a9dc81653cc194fe6e878a94579638b1891dce864871902828d675dff08a726de690e7828eb018d12220878
+  data.tar.gz: 951dc39cd2b6dee12a3e4528d14ecffd041e0d13f6d2d247f1637376fd0b117180783ec3bdc2b03b1b998645440107a1001f01a83f48875b63cb43a4f54d4c0a

data/LICENSE

@@ -1,22 +1,21 @@
-The MIT License
+MIT License
 
-Copyright (c) Aslak Hellesøy
+Copyright (c) 2008 Aslak Hellesøy and contributors
 
-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:
+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 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.
+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

@@ -1,4 +1,4 @@
-<img src="docs/img/cucumber-open-logo.png" alt="Cucumber Open - Supported by Smartbear" width="428" />
+<img src="docs/img/logo.svg" alt="" width="75" />
 
 # Cucumber
 
@@ -45,11 +45,12 @@ Later in this document, bundler is considered being used so all commands are usi
 
 ### Supported platforms
 
+- Ruby 3.4
+- Ruby 3.3
 - Ruby 3.2
 - Ruby 3.1
 - Ruby 3.0
-- Ruby 2.7
-- TruffleRuby 22.0.0+
+- TruffleRuby 24.0.0+
 - JRuby 9.4+ (with [some limitations](https://github.com/cucumber/cucumber-ruby/blob/main/docs/jruby-limitations.md))
 
 ### Ruby on Rails
@@ -91,12 +92,11 @@ Feature: Rule Sample
       Given this will fail
       When I do an action
       Then some results should be there
-
 ```
 
 ### Automate your specification
 
-And a file named `steps.rb` in `features/step_definitions` with:
+And a file named `rule_steps.rb` in `features/step_definitions` with:
 
 ```ruby
 # features/step_definitions/steps.rb
@@ -144,9 +144,9 @@ You can also find documentation on the command line possibilities in [features/d
 
 - Getting started, writing features, step definitions, and more: https://cucumber.io/docs
 - Ruby API Documentation: http://www.rubydoc.info/github/cucumber/cucumber-ruby/
-- Community support forum: https://community.smartbear.com/t5/Cucumber-Open/bd-p/CucumberOS
-- Slack: [register for an account](https://cucumberbdd-slack-invite.herokuapp.com/) then head over to [#intro](https://cucumberbdd.slack.com/messages/C5WD8SA21/)
+- Community support forum: https://github.com/orgs/cucumber/discussions
+- Discord: [register for an account](https://cucumber.io/docs/community/get-in-touch#discord)
 
 ## Copyright
 
-Copyright (c) Cucumber Ltd. and Contributors. See LICENSE for details.
+Copyright (c) Cucumber and Contributors. See LICENSE for details.

data/VERSION

@@ -1 +1 @@
-9.2.1
+10.0.0

data/lib/cucumber/cli/main.rb

@@ -93,8 +93,7 @@ module Cucumber
       def runtime(existing_runtime)
         return Runtime.new(configuration) unless existing_runtime
 
-        existing_runtime.configure(configuration)
-        existing_runtime
+        existing_runtime.tap { |runtime| runtime.configure(configuration) }
       end
     end
   end

data/lib/cucumber/configuration.rb

@@ -254,7 +254,7 @@ module Cucumber
     end
 
     def id_generator
-      @id_generator ||= Cucumber::Messages::IdGenerator::UUID.new
+      @id_generator ||= Cucumber::Messages::Helpers::IdGenerator::UUID.new
     end
 
     private

data/lib/cucumber/deprecate.rb

@@ -6,7 +6,7 @@ require 'cucumber/gherkin/formatter/ansi_escapes'
 module Cucumber
   def self.deprecate(message, method, remove_after_version)
     $stderr.puts(
-      "\nWARNING: ##{method} is deprecated" \
+      "\nWARNING: #{method} is deprecated" \
         " and will be removed after version #{remove_after_version}. #{message}.\n" \
         "(Called from #{caller(3..3).first})"
     )

data/lib/cucumber/filters/broadcast_test_case_ready_event.rb

@@ -4,7 +4,7 @@ module Cucumber
   module Filters
     class BroadcastTestCaseReadyEvent < Core::Filter.new(:config)
       def test_case(test_case)
-        config.notify :test_case_ready, test_case
+        config.notify(:test_case_ready, test_case)
         test_case.describe_to(receiver)
       end
     end

data/lib/cucumber/formatter/backtrace_filter.rb

@@ -4,52 +4,79 @@ require 'cucumber/platform'
 
 module Cucumber
   module Formatter
-    @backtrace_filters = %w[
-      /vendor/rails
-      lib/cucumber
-      bin/cucumber:
-      lib/rspec
-      gems/
-      site_ruby/
-      minitest
-      test/unit
-      .gem/ruby
-      bin/bundle
-      rdebug-ide
-    ]
-
-    @backtrace_filters << RbConfig::CONFIG['rubyarchdir'] if RbConfig::CONFIG['rubyarchdir']
-    @backtrace_filters << RbConfig::CONFIG['rubylibdir'] if RbConfig::CONFIG['rubylibdir']
-
-    @backtrace_filters << 'org/jruby/' if ::Cucumber::JRUBY
-    @backtrace_filters << '<internal:' if RUBY_ENGINE == 'truffleruby'
-
-    BACKTRACE_FILTER_PATTERNS = Regexp.new(@backtrace_filters.join('|'))
-
     class BacktraceFilter
       def initialize(exception)
         @exception = exception
+        @backtrace_filters = standard_ruby_paths + dynamic_ruby_paths
       end
 
       def exception
         return @exception if ::Cucumber.use_full_backtrace
 
-        pwd_pattern = /#{::Regexp.escape(::Dir.pwd)}\//m
         backtrace = @exception.backtrace.map { |line| line.gsub(pwd_pattern, './') }
-
-        filtered = (backtrace || []).reject do |line|
-          line =~ BACKTRACE_FILTER_PATTERNS
-        end
+        filtered = backtrace.reject { |line| line.match?(backtrace_filter_patterns) }
 
         if ::ENV['CUCUMBER_TRUNCATE_OUTPUT']
-          # Strip off file locations
           filtered = filtered.map do |line|
-            line =~ /(.*):in `/ ? Regexp.last_match(1) : line
+            # Strip off file locations
+            match = regexp_filter.match(line)
+            match ? match[1] : line
           end
         end
 
-        @exception.set_backtrace(filtered)
-        @exception
+        @exception.tap { |error_object| error_object.set_backtrace(filtered) }
+      end
+
+      private
+
+      def backtrace_filter_patterns
+        Regexp.new(@backtrace_filters.join('|'))
+      end
+
+      def dynamic_ruby_paths
+        [].tap do |paths|
+          paths << RbConfig::CONFIG['rubyarchdir'] if RbConfig::CONFIG['rubyarchdir']
+          paths << RbConfig::CONFIG['rubylibdir'] if RbConfig::CONFIG['rubylibdir']
+
+          paths << 'org/jruby/' if ::Cucumber::JRUBY
+          paths << '<internal:' if RUBY_ENGINE == 'truffleruby'
+        end
+      end
+
+      def pwd_pattern
+        /#{::Regexp.escape(::Dir.pwd)}\//m
+      end
+
+      def regexp_filter
+        ruby_greater_than_three_four? ? three_four_filter : three_three_filter
+      end
+
+      def ruby_greater_than_three_four?
+        RUBY_VERSION.to_f >= 3.4
+      end
+
+      def standard_ruby_paths
+        %w[
+          /vendor/rails
+          lib/cucumber
+          bin/cucumber:
+          lib/rspec
+          gems/
+          site_ruby/
+          minitest
+          test/unit
+          .gem/ruby
+          bin/bundle
+          rdebug-ide
+        ]
+      end
+
+      def three_four_filter
+        /(.*):in '/
+      end
+
+      def three_three_filter
+        /(.*):in `/
       end
     end
   end

data/lib/cucumber/formatter/curl_option_parser.rb

@@ -31,7 +31,8 @@ module Cucumber
         [url, http_method, headers]
       end
 
-      # TODO: [LH] -> Switch below methods to private
+      private
+
       def self.remove_arg_for(args, arg)
         return args.shift unless args.empty?
 

data/lib/cucumber/formatter/message_builder.rb

@@ -7,11 +7,12 @@ require 'cucumber/formatter/query/pickle_by_test'
 require 'cucumber/formatter/query/pickle_step_by_test_step'
 require 'cucumber/formatter/query/step_definitions_by_test_step'
 require 'cucumber/formatter/query/test_case_started_by_test_case'
+require 'cucumber/formatter/query/test_run_started'
 
 module Cucumber
   module Formatter
     class MessageBuilder
-      include Cucumber::Messages::TimeConversion
+      include Cucumber::Messages::Helpers::TimeConversion
 
       def initialize(config)
         @config = config
@@ -21,6 +22,7 @@ module Cucumber
         @pickle_step_by_test_step = Query::PickleStepByTestStep.new(config)
         @step_definitions_by_test_step = Query::StepDefinitionsByTestStep.new(config)
         @test_case_started_by_test_case = Query::TestCaseStartedByTestCase.new(config)
+        @test_run_started = Query::TestRunStarted.new(config)
 
         config.on_event :envelope, &method(:on_envelope)
         config.on_event :gherkin_source_read, &method(:on_gherkin_source_read)
@@ -34,6 +36,7 @@ module Cucumber
         config.on_event :undefined_parameter_type, &method(:on_undefined_parameter_type)
 
         @test_case_by_step_id = {}
+        @current_test_run_started_id = nil
         @current_test_case_started_id = nil
         @current_test_step_id = nil
       end
@@ -94,7 +97,8 @@ module Cucumber
           test_case: Cucumber::Messages::TestCase.new(
             id: event.test_case.id,
             pickle_id: @pickle_by_test.pickle_id(event.test_case),
-            test_steps: event.test_case.test_steps.map { |step| test_step_to_message(step) }
+            test_steps: event.test_case.test_steps.map { |step| test_step_to_message(step) },
+            test_run_started_id: @current_test_run_started_id
           )
         )
 
@@ -150,9 +154,12 @@ module Cucumber
       end
 
       def on_test_run_started(*)
+        @current_test_run_started_id = @test_run_started.id
+
         message = Cucumber::Messages::Envelope.new(
           test_run_started: Cucumber::Messages::TestRunStarted.new(
-            timestamp: time_to_timestamp(Time.now)
+            timestamp: time_to_timestamp(Time.now),
+            id: @current_test_run_started_id
           )
         )
 
@@ -245,7 +252,8 @@ module Cucumber
         message = Cucumber::Messages::Envelope.new(
           test_run_finished: Cucumber::Messages::TestRunFinished.new(
             timestamp: time_to_timestamp(Time.now),
-            success: event.success
+            success: event.success,
+            test_run_started_id: @current_test_run_started_id
           )
         )
 

data/lib/cucumber/formatter/query/test_run_started.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Cucumber
+  module Formatter
+    module Query
+      class TestRunStarted
+        def initialize(config)
+          @config = config
+        end
+
+        def id
+          @id ||= @config.id_generator.new_id
+        end
+      end
+    end
+  end
+end

data/lib/cucumber/glue/dsl.rb

@@ -1,7 +1,6 @@
 # frozen_string_literal: true
 
 require 'cucumber/cucumber_expressions/parameter_type'
-require 'cucumber/deprecate'
 
 module Cucumber
   module Glue
@@ -19,8 +18,8 @@ module Cucumber
           @rb_language.build_rb_world_factory(world_modules, namespaced_world_modules, proc)
         end
 
-        def register_rb_hook(phase, tag_names, proc, name: nil)
-          @rb_language.register_rb_hook(phase, tag_names, proc, name: name)
+        def register_rb_hook(type, tag_names, proc, name: nil)
+          @rb_language.register_rb_hook(type, tag_names, proc, name: name)
         end
 
         def define_parameter_type(parameter_type)

data/lib/cucumber/glue/hook.rb

@@ -12,10 +12,9 @@ module Cucumber
         @id = id
         @registry = registry
         @name = name
-        @tag_expressions = sanitize_tag_expressions(tag_expressions)
+        @tag_expressions = tag_expressions
         @proc = proc
         @location = Cucumber::Core::Test::Location.from_source_location(*@proc.source_location)
-        fail_for_old_style_tag_expressions(@tag_expressions)
       end
 
       def invoke(pseudo_method, arguments, &block)
@@ -29,12 +28,13 @@ module Cucumber
         )
       end
 
-      def to_envelope
+      def to_envelope(type)
         Cucumber::Messages::Envelope.new(
           hook: Cucumber::Messages::Hook.new(
             id: id,
             name: name,
             tag_expression: tag_expressions.empty? ? nil : tag_expressions.join(' '),
+            type: hook_type_to_enum_value[type.to_sym],
             source_reference: Cucumber::Messages::SourceReference.new(
               uri: location.file,
               location: Cucumber::Messages::Location.new(
@@ -47,23 +47,16 @@ module Cucumber
 
       private
 
-      def sanitize_tag_expressions(tag_expressions)
-        # TODO: remove when '~@no-clobber' has been changed to 'not @no-clobber' in aruba
-        tag_expressions.map { |tag_expression| tag_expression == '~@no-clobber' ? 'not @no-clobber' : tag_expression }
-      end
-
-      def fail_for_old_style_tag_expressions(tag_expressions)
-        tag_expressions.each do |tag_expression|
-          if tag_expression.include?('~')
-            raise("Found tagged hook with '#{tag_expression}'." \
-            "'~@tag' is no longer supported, use 'not @tag' instead.")
-          end
-
-          next unless tag_expression.include?(',')
-
-          warn("Found tagged hook with '#{tag_expression}'." \
-            "'@tag1,@tag2' is no longer supported, use '@tag or @tag2' instead.")
-        end
+      def hook_type_to_enum_value
+        {
+          before: 'BEFORE_TEST_CASE',
+          after: 'AFTER_TEST_CASE',
+          around: nil, # This needs deleting and removing from cucumber-ruby in v11
+          after_step: 'AFTER_TEST_STEP',
+          install_plugin: 'BEFORE_TEST_RUN',
+          before_all: 'BEFORE_TEST_RUN',
+          after_all: 'AFTER_TEST_RUN'
+        }
       end
     end
   end

data/lib/cucumber/glue/invoke_in_world.rb

@@ -14,7 +14,10 @@ module Cucumber
         return unless instance_exec_pos
 
         replacement_line = instance_exec_pos + INSTANCE_EXEC_OFFSET
-        backtrace[replacement_line].gsub!(/`.*'/, "`#{pseudo_method}'") if pseudo_method
+        if pseudo_method
+          pattern = RUBY_VERSION >= '3.4' ? /'.*'/ : /`.*'/
+          backtrace[replacement_line].gsub!(pattern, "`#{pseudo_method}'")
+        end
 
         depth = backtrace.count { |line| line == instance_exec_invocation_line }
         end_pos = depth > 1 ? instance_exec_pos : -1
@@ -49,7 +52,13 @@ module Cucumber
       def self.cucumber_run_with_backtrace_filtering(pseudo_method)
         yield
       rescue Exception => e
-        instance_exec_invocation_line = "#{__FILE__}:#{__LINE__ - 2}:in `cucumber_run_with_backtrace_filtering'"
+        yield_line_number = __LINE__ - 2
+        instance_exec_invocation_line =
+          if RUBY_VERSION >= '3.4'
+            "#{__FILE__}:#{yield_line_number}:in '#{name}.#{__method__}'"
+          else
+            "#{__FILE__}:#{yield_line_number}:in `#{__method__}'"
+          end
         replace_instance_exec_invocation_line!((e.backtrace || []), instance_exec_invocation_line, pseudo_method)
         raise e
       end

data/lib/cucumber/glue/proto_world.rb

@@ -2,7 +2,6 @@
 
 require 'cucumber/gherkin/formatter/ansi_escapes'
 require 'cucumber/core/test/data_table'
-require 'cucumber/deprecate'
 require 'mini_mime'
 
 module Cucumber

data/lib/cucumber/glue/registry_and_more.rb

@@ -19,6 +19,11 @@ require 'cucumber/events/step_definition_registered'
 
 module Cucumber
   module Glue
+    def self.backtrace_line(proc, name)
+      location = Cucumber::Core::Test::Location.from_source_location(*proc.source_location)
+      "#{location}:in `#{name}'"
+    end
+
     # Raised if a World block returns Nil.
     class NilWorld < StandardError
       def initialize
@@ -43,8 +48,7 @@ module Cucumber
 
     # TODO: This class has too many responsibilities, split off
     class RegistryAndMore
-      attr_reader :current_world,
-                  :step_definitions
+      attr_reader :current_world, :step_definitions
 
       all_keywords = ::Gherkin::DIALECTS.keys.map do |dialect_name|
         dialect = ::Gherkin::Dialect.for(dialect_name)
@@ -54,6 +58,14 @@ module Cucumber
         Glue::Dsl.alias_adverb(adverb.strip)
       end
 
+      def self.cli_snippet_type_options
+        registry = CucumberExpressions::ParameterTypeRegistry.new
+        cucumber_expression_generator = CucumberExpressions::CucumberExpressionGenerator.new(registry)
+        Snippet::SNIPPET_TYPES.keys.sort_by(&:to_s).map do |type|
+          Snippet::SNIPPET_TYPES[type].cli_option_string(type, cucumber_expression_generator)
+        end
+      end
+
       def initialize(runtime, configuration)
         @runtime = runtime
         @configuration = configuration
@@ -73,9 +85,9 @@ module Cucumber
         end
       end
 
-      def register_rb_hook(phase, tag_expressions, proc, name: nil)
-        hook = add_hook(phase, Hook.new(@configuration.id_generator.new_id, self, tag_expressions, proc, name: name))
-        @configuration.notify :envelope, hook.to_envelope
+      def register_rb_hook(type, tag_expressions, proc, name: nil)
+        hook = add_hook(type, Hook.new(@configuration.id_generator.new_id, self, tag_expressions, proc, name: name))
+        @configuration.notify(:envelope, hook.to_envelope(type))
         hook
       end
 
@@ -129,8 +141,7 @@ module Cucumber
         @current_world = WorldFactory.new(@world_proc).create_world
         @current_world.extend(ProtoWorld.for(@runtime, test_case.language))
         MultiTest.extend_with_best_assertion_library(@current_world)
-        @current_world.add_modules!(@world_modules || [],
-                                    @namespaced_world_modules || {})
+        @current_world.add_modules!(@world_modules || [], @namespaced_world_modules || {})
       end
 
       def end_scenario
@@ -155,8 +166,8 @@ module Cucumber
         end
       end
 
-      def add_hook(phase, hook)
-        hooks[phase.to_sym] << hook
+      def add_hook(type, hook)
+        hooks[type.to_sym] << hook
         hook
       end
 
@@ -164,20 +175,8 @@ module Cucumber
         @hooks = nil
       end
 
-      def hooks_for(phase, scenario) # :nodoc:
-        hooks[phase.to_sym].select { |hook| scenario.accept_hook?(hook) }
-      end
-
-      def unmatched_step_definitions
-        available_step_definition_hash.keys - invoked_step_definition_hash.keys
-      end
-
-      def available_step_definition(regexp_source, file_colon_line)
-        available_step_definition_hash[StepDefinitionLight.new(regexp_source, file_colon_line)] = nil
-      end
-
-      def invoked_step_definition(regexp_source, file_colon_line)
-        invoked_step_definition_hash[StepDefinitionLight.new(regexp_source, file_colon_line)] = nil
+      def hooks_for(type, scenario) # :nodoc:
+        hooks[type.to_sym].select { |hook| scenario.accept_hook?(hook) }
       end
 
       def create_expression(string_or_regexp)
@@ -187,14 +186,6 @@ module Cucumber
         raise ArgumentError, 'Expression must be a String or Regexp'
       end
 
-      def self.cli_snippet_type_options
-        registry = CucumberExpressions::ParameterTypeRegistry.new
-        cucumber_expression_generator = CucumberExpressions::CucumberExpressionGenerator.new(registry)
-        Snippet::SNIPPET_TYPES.keys.sort_by(&:to_s).map do |type|
-          Snippet::SNIPPET_TYPES[type].cli_option_string(type, cucumber_expression_generator)
-        end
-      end
-
       private
 
       def parameter_type_envelope(parameter_type)
@@ -215,22 +206,9 @@ module Cucumber
         )
       end
 
-      def available_step_definition_hash
-        @available_step_definition_hash ||= {}
-      end
-
-      def invoked_step_definition_hash
-        @invoked_step_definition_hash ||= {}
-      end
-
       def hooks
         @hooks ||= Hash.new { |h, k| h[k] = [] }
       end
     end
-
-    def self.backtrace_line(proc, name)
-      location = Cucumber::Core::Test::Location.from_source_location(*proc.source_location)
-      "#{location}:in `#{name}'"
-    end
   end
 end

data/lib/cucumber/glue/snippet.rb

@@ -61,13 +61,11 @@ module Cucumber
         end
 
         def do_block
-          # TODO: [LH] - Just use a heredoc here to fix this up
-          do_block = String.new
-          do_block << "do#{parameters}\n"
-          multiline_argument.append_comment_to(do_block)
-          do_block << "  pending # Write code here that turns the phrase above into concrete actions\n"
-          do_block << 'end'
-          do_block
+          <<~DOC.chomp
+            do#{parameters}
+              #{multiline_argument.comment}
+            end
+          DOC
         end
 
         def parameters
@@ -96,11 +94,10 @@ module Cucumber
             "#{prefix}#{code_keyword}('#{expr.source}') do#{parameters(expr)}"
           end.join("\n")
 
-          # TODO: [LH] - Just use a heredoc here to fix this up
-          body = String.new
-          multiline_argument.append_comment_to(body)
-          body << "  pending # Write code here that turns the phrase above into concrete actions\n"
-          body << 'end'
+          body = <<~DOC.chomp
+              #{multiline_argument.comment}
+            end
+          DOC
 
           "#{header}\n#{body}"
         end
@@ -179,7 +176,9 @@ module Cucumber
             array << 'doc_string'
           end
 
-          def append_comment_to(string); end
+          def comment
+            'pending # Write code here that turns the phrase above into concrete actions'
+          end
         end
 
         class DataTable
@@ -191,15 +190,19 @@ module Cucumber
             array << 'table'
           end
 
-          def append_comment_to(string)
-            string << "  # table is a #{Cucumber::MultilineArgument::DataTable}\n"
+          def comment
+            <<~COMMENT.chomp
+              # table is a #{Cucumber::MultilineArgument::DataTable}
+                pending # Write code here that turns the phrase above into concrete actions
+            COMMENT
           end
         end
 
         class None
           def append_block_parameter_to(array); end
-
-          def append_comment_to(string); end
+          def comment
+            'pending # Write code here that turns the phrase above into concrete actions'
+          end
         end
       end
     end

data/lib/cucumber/glue/step_definition.rb

@@ -73,7 +73,6 @@ module Cucumber
         @registry = registry
         @expression = expression
         @proc = proc
-        # @registry.available_step_definition(regexp_source, location)
       end
 
       def to_envelope

data/lib/cucumber/hooks.rb

@@ -10,17 +10,17 @@ module Cucumber
   module Hooks
     class << self
       def before_hook(id, location, &block)
-        build_hook_step(id, location, block, BeforeHook, Core::Test::UnskippableAction)
+        build_hook_step(id, location, block, BeforeHook, Core::Test::Action::Unskippable)
       end
 
       def after_hook(id, location, &block)
-        build_hook_step(id, location, block, AfterHook, Core::Test::UnskippableAction)
+        build_hook_step(id, location, block, AfterHook, Core::Test::Action::Unskippable)
       end
 
       def after_step_hook(id, test_step, location, &block)
         raise ArgumentError if test_step.hook?
 
-        build_hook_step(id, location, block, AfterStepHook, Core::Test::Action)
+        build_hook_step(id, location, block, AfterStepHook, Core::Test::Action::Defined)
       end
 
       def around_hook(&block)

data/lib/cucumber/multiline_argument/data_table.rb

@@ -4,6 +4,7 @@ require 'forwardable'
 require 'cucumber/gherkin/data_table_parser'
 require 'cucumber/gherkin/formatter/escaping'
 require 'cucumber/multiline_argument/data_table/diff_matrices'
+require 'cucumber/deprecate'
 
 module Cucumber
   module MultilineArgument
@@ -75,8 +76,8 @@ module Cucumber
         def eof; end
       end
 
-      # This is a Hash being initialized with a default value of a Hash, DO NOT REFORMAT TO REMOVE {}
-      # Future versions [3.4.0+] of ruby will interpret these as keywords and break.
+      # This is a Hash being initialized with a default value of a Hash
+      # DO NOT REFORMAT TO REMOVE {} - Ruby 3.4+ will interpret these as keywords and cucumber will not work
       NULL_CONVERSIONS = Hash.new({ strict: false, proc: ->(cell_value) { cell_value } }).freeze
 
       # @param data [Core::Test::DataTable] the data for the table
@@ -367,6 +368,11 @@ module Cucumber
       # TODO: remove the below function if it's not actually being used.
       # Nothing else in this repo calls it.
       def text?(text)
+        Cucumber.deprecate(
+          'This method is no longer supported for checking text',
+          '#text?',
+          '11.0.0'
+        )
         raw.flatten.compact.detect { |cell_value| cell_value.index(text) }
       end
 

data/lib/cucumber/runtime/after_hooks.rb

@@ -11,9 +11,7 @@ module Cucumber
       end
 
       def apply_to(test_case)
-        test_case.with_steps(
-          test_case.test_steps + after_hooks.reverse
-        )
+        test_case.with_steps(test_case.test_steps + after_hooks.reverse)
       end
 
       private

data/lib/cucumber/runtime.rb

@@ -255,13 +255,13 @@ module Cucumber
           filters << Filters::ApplyBeforeHooks.new(@support_code)
           filters << Filters::ApplyAfterHooks.new(@support_code)
           filters << Filters::ApplyAroundHooks.new(@support_code)
+          filters << Filters::BroadcastTestRunStartedEvent.new(@configuration)
+          filters << Filters::Quit.new
         end
 
         filters << Filters::BroadcastTestCaseReadyEvent.new(@configuration)
 
         unless configuration.dry_run?
-          filters << Filters::BroadcastTestRunStartedEvent.new(@configuration)
-          filters << Filters::Quit.new
           filters << Filters::Retry.new(@configuration)
           # need to do this last so it becomes the first test step
           filters << Filters::PrepareWorld.new(self)

data/lib/cucumber/step_definition_light.rb

@@ -11,6 +11,11 @@ module Cucumber
     def initialize(regexp_source, location)
       @regexp_source = regexp_source
       @location = location
+      Cucumber.deprecate(
+        'StepDefinitionLight class is no longer a supported part of cucumber',
+        '#initialize',
+        '11.0.0'
+      )
     end
 
     def eql?(other)

data/lib/cucumber.rb

@@ -10,7 +10,8 @@ require 'cucumber/term/ansicolor'
 
 module Cucumber
   class << self
-    attr_accessor :wants_to_quit, :use_legacy_autoloader
+    attr_accessor :wants_to_quit
+    attr_reader :use_legacy_autoloader
 
     def logger
       return @log if @log
@@ -23,5 +24,14 @@ module Cucumber
     def logger=(logger)
       @log = logger
     end
+
+    def use_legacy_autoloader=(value)
+      Cucumber.deprecate(
+        'This will be phased out of cucumber and should not be used. It is only there to support legacy systems',
+        '.use_legacy_autoloader',
+        '11.0.0'
+      )
+      @use_legacy_autoloader = value
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: cucumber
 version: !ruby/object:Gem::Version
-  version: 9.2.1
+  version: 10.0.0
 platform: ruby
 authors:
 - Aslak Hellesøy
@@ -10,8 +10,22 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-01-12 00:00:00.000000000 Z
+date: 2025-06-12 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: base64
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: builder
   requirement: !ruby/object:Gem::Requirement
@@ -52,54 +66,40 @@ dependencies:
     requirements:
     - - ">"
       - !ruby/object:Gem::Version
-        version: '13'
+        version: '15'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '14'
+        version: '17'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">"
       - !ruby/object:Gem::Version
-        version: '13'
+        version: '15'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '14'
+        version: '17'
 - !ruby/object:Gem::Dependency
   name: cucumber-cucumber-expressions
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '17.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '17.0'
-- !ruby/object:Gem::Dependency
-  name: cucumber-gherkin
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">"
       - !ruby/object:Gem::Version
-        version: '24'
+        version: '17'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '28'
+        version: '19'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">"
       - !ruby/object:Gem::Version
-        version: '24'
+        version: '17'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '28'
+        version: '19'
 - !ruby/object:Gem::Dependency
   name: cucumber-html-formatter
   requirement: !ruby/object:Gem::Requirement
@@ -121,39 +121,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '22'
 - !ruby/object:Gem::Dependency
-  name: cucumber-messages
+  name: diff-lcs
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
-      - !ruby/object:Gem::Version
-        version: '19'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '25'
+        version: '1.5'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">"
-      - !ruby/object:Gem::Version
-        version: '19'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '25'
+        version: '1.5'
 - !ruby/object:Gem::Dependency
-  name: diff-lcs
+  name: logger
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '1.6'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: '1.6'
 - !ruby/object:Gem::Dependency
   name: mini_mime
   requirement: !ruby/object:Gem::Requirement
@@ -188,98 +182,84 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.2'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: cucumber-compatibility-kit
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '15.0'
+        version: '18.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '15.0'
+        version: '18.0'
 - !ruby/object:Gem::Dependency
   name: nokogiri
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.14'
+        version: '1.15'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.14'
+        version: '1.15'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.1'
+        version: '13.2'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '13.1'
+        version: '13.2'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.12'
+        version: '3.13'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.12'
+        version: '3.13'
 - !ruby/object:Gem::Dependency
   name: rubocop
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.56.4
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 1.56.4
-- !ruby/object:Gem::Dependency
-  name: rubocop-capybara
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: 2.19.0
+        version: 1.71.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.19.0
+        version: 1.71.0
 - !ruby/object:Gem::Dependency
   name: rubocop-packaging
   requirement: !ruby/object:Gem::Requirement
@@ -314,14 +294,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.25.0
+        version: 3.4.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.25.0
+        version: 3.4.0
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -436,6 +416,7 @@ files:
 - lib/cucumber/formatter/query/pickle_step_by_test_step.rb
 - lib/cucumber/formatter/query/step_definitions_by_test_step.rb
 - lib/cucumber/formatter/query/test_case_started_by_test_case.rb
+- lib/cucumber/formatter/query/test_run_started.rb
 - lib/cucumber/formatter/rerun.rb
 - lib/cucumber/formatter/stepdefs.rb
 - lib/cucumber/formatter/steps.rb
@@ -494,6 +475,7 @@ metadata:
   documentation_uri: https://www.rubydoc.info/github/cucumber/cucumber-ruby/
   mailing_list_uri: https://groups.google.com/forum/#!forum/cukes
   source_code_uri: https://github.com/cucumber/cucumber-ruby
+  funding_uri: https://opencollective.com/cucumber
 post_install_message:
 rdoc_options:
 - "--charset=UTF-8"
@@ -503,15 +485,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.7'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.1
+      version: 3.2.8
 requirements: []
 rubygems_version: 3.4.20
 signing_key:
 specification_version: 4
-summary: cucumber-9.2.1
+summary: cucumber-10.0.0
 test_files: []