aruba 2.4.0 → 3.0.0

data/lib/aruba/runtime.rb

@@ -17,9 +17,15 @@ module Aruba
     # @!attribute [r] current_directory
     #   Returns the current working directory
     #
+    # @!attribute [r] working_directory
+    #   Returns the working directory
+    #
     # @!attribute [r] root_directory
     #   Returns the root directory of aruba
-    attr_reader :current_directory, :root_directory
+    #
+    # @!attribute [r] home_directory
+    #   Returns the home directory used to mock HOME by aruba
+    attr_reader :current_directory, :working_directory, :root_directory, :home_directory
 
     # @!attribute [r] config
     #   Access configuration of aruba
@@ -39,40 +45,46 @@ module Aruba
     # @!attribute [r] event_bus
     #   Handle events (private)
     #
-    attr_accessor :config, :environment, :logger, :command_monitor, :announcer, :event_bus
+    attr_reader :config, :environment, :logger, :command_monitor, :announcer, :event_bus
 
-    def initialize(opts = {})
+    def initialize(config: Aruba.config)
       @event_bus       = EventBus.new(Aruba::Events.registry)
-      @announcer       = opts.fetch(:announcer, Aruba.platform.announcer.new)
-      @config          = opts.fetch(:config,
-                                    ConfigWrapper.new(Aruba.config.make_copy, @event_bus))
-      @environment     = opts.fetch(:environment, Aruba.platform.environment_variables.new)
-      @current_directory = ArubaPath.new(@config.working_directory)
-      @root_directory    = ArubaPath.new(@config.root_directory)
+      @announcer       = Aruba.platform.announcer.new
+      @config          = ConfigWrapper.new(config.make_copy, @event_bus)
+      @environment     = Aruba.platform.environment_variables.new
+
+      @root_directory = ArubaPath.new(@config.root_directory)
 
       @environment.update(@config.command_runtime_environment)
 
-      @command_monitor = opts.fetch(:command_monitor,
-                                    Aruba.platform.command_monitor.new(announcer: @announcer))
+      @command_monitor = Aruba.platform.command_monitor.new(announcer: @announcer)
 
-      @logger = opts.fetch(:logger, Aruba.platform.logger.new)
+      @logger = Aruba.platform.logger.new
       @logger.mode = @config.log_level
 
+      @setup = Aruba::Setup.new(self)
       @setup_done = false
     end
 
-    # @private
-    #
-    # Setup of aruba is finshed. Should be used only internally.
-    def setup_done
+    # Set up Aruba's workspace and event bus. Cleans out the workspace as well.
+    def setup
+      return if @setup_done
+
+      @setup.setup
+
+      @home_directory = @setup.workspace_directory
+      @working_directory = Pathname.new(@home_directory)
+                                   .relative_path_from(@config.root_directory).to_s
+      @current_directory = ArubaPath.new(@working_directory)
+
       @setup_done = true
     end
 
-    # @private
-    #
-    # Has aruba already been setup. Should be used only internally.
-    def setup_already_done?
-      @setup_done == true
+    def teardown
+      return unless @setup_done
+
+      @setup.teardown
+      @setup_done = false
     end
 
     # The path to the directory which contains fixtures
@@ -99,5 +111,11 @@ module Aruba
 
       ArubaPath.new(@fixtures_directory)
     end
+
+    private
+
+    def setup_already_done?
+      @setup_done == true
+    end
   end
 end

data/lib/aruba/setup.rb

@@ -2,40 +2,39 @@
 
 module Aruba
   class Setup
-    private
-
-    attr_reader :runtime
-
-    public
-
     def initialize(runtime)
       @runtime = runtime
     end
 
-    def call(clobber = true)
-      return if runtime.setup_already_done?
-
-      working_directory(clobber)
+    def setup
+      create_workspace
       register_event_handlers
+    end
 
-      runtime.setup_done
-
-      self
+    def teardown
+      destroy_workspace
     end
 
+    attr_reader :workspace_directory
+
     private
 
-    def working_directory(clobber = true)
-      if clobber
-        Aruba.platform.rm File.join(runtime.config.root_directory,
-                                    runtime.config.working_directory),
-                          force: true
-      end
-      Aruba.platform.mkdir File.join(runtime.config.root_directory,
-                                     runtime.config.working_directory)
+    attr_reader :runtime
+
+    def create_workspace
+      workspace_base = File.join(runtime.config.root_directory, 'tmp')
+      prefix = "#{runtime.config.working_directory_suffix}-"
+
+      Aruba.platform.mkdir workspace_base
+      @workspace_directory = Dir.mktmpdir(prefix, workspace_base)
+
       Aruba.platform.chdir runtime.config.root_directory
     end
 
+    def destroy_workspace
+      Aruba.platform.rm workspace_directory, force: true
+    end
+
     def handle_command_started(event)
       runtime.announcer.announce(:command) { event.entity.commandline }
       runtime.announcer.announce(:timeout, 'exit') { event.entity.exit_timeout }

data/lib/aruba/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Aruba
-  VERSION = '2.4.0'
+  VERSION = '3.0.0'
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: aruba
 version: !ruby/object:Gem::Version
-  version: 2.4.0
+  version: 3.0.0
 platform: ruby
 authors:
 - Aslak Hellesøy, Matt Wynne and other Aruba Contributors
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-02 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -16,14 +15,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: 2.20.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '1.17'
+        version: 2.20.0
 - !ruby/object:Gem::Dependency
   name: contracts
   requirement: !ruby/object:Gem::Requirement
@@ -45,39 +44,45 @@ dependencies:
       - !ruby/object:Gem::Version
         version: 0.18.0
 - !ruby/object:Gem::Dependency
-  name: cucumber
+  name: cucumber-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '16.0'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '21.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '8.0'
+        version: '16.0'
     - - "<"
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '21.0'
 - !ruby/object:Gem::Dependency
-  name: irb
+  name: marcel
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '1.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '1.16'
+        version: '1.2'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rspec-expectations
   requirement: !ruby/object:Gem::Requirement
@@ -98,6 +103,20 @@ dependencies:
     - - "<"
       - !ruby/object:Gem::Version
         version: '5.0'
+- !ruby/object:Gem::Dependency
+  name: tempfile
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.3.1
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
@@ -126,6 +145,26 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.4'
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '11.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '11.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: diff-lcs
   requirement: !ruby/object:Gem::Requirement
@@ -141,19 +180,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.6'
 - !ruby/object:Gem::Dependency
-  name: json
+  name: irb
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '1.16'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.1'
+        version: '1.16'
 - !ruby/object:Gem::Dependency
   name: kramdown
   requirement: !ruby/object:Gem::Requirement
@@ -172,42 +211,30 @@ dependencies:
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '5.26'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '6.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '5.26'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '7.0'
+        version: '6.0'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '12.0'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '14.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '12.0'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '14.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: rake-manifest
   requirement: !ruby/object:Gem::Requirement
@@ -248,14 +275,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.80'
+        version: '1.92'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.80'
+        version: '1.92'
 - !ruby/object:Gem::Dependency
   name: rubocop-packaging
   requirement: !ruby/object:Gem::Requirement
@@ -276,48 +303,42 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.26'
+        version: '1.27'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.26'
+        version: '1.27'
 - !ruby/object:Gem::Dependency
   name: rubocop-rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
+        version: '3.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '3.7'
+        version: '3.10'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.18.0
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.23.0
+        version: '1.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.18.0
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.23.0
+        version: '1.1'
 description: |
   Extension for popular TDD and BDD frameworks like "Cucumber", "RSpec" and "Minitest",
   to make testing command line applications meaningful, easy and fun.
@@ -328,8 +349,8 @@ extensions: []
 extra_rdoc_files:
 - CHANGELOG.md
 - CONTRIBUTING.md
-- README.md
 - LICENSE
+- README.md
 files:
 - CHANGELOG.md
 - CONTRIBUTING.md
@@ -355,19 +376,12 @@ files:
 - lib/aruba/config/jruby.rb
 - lib/aruba/config_wrapper.rb
 - lib/aruba/configuration.rb
-- lib/aruba/console.rb
-- lib/aruba/console/help.rb
-- lib/aruba/contracts/absolute_path.rb
-- lib/aruba/contracts/enum.rb
-- lib/aruba/contracts/is_power_of_two.rb
-- lib/aruba/contracts/relative_path.rb
 - lib/aruba/cucumber.rb
 - lib/aruba/cucumber/command.rb
 - lib/aruba/cucumber/environment.rb
 - lib/aruba/cucumber/file.rb
 - lib/aruba/cucumber/hooks.rb
 - lib/aruba/cucumber/parameter_types.rb
-- lib/aruba/cucumber/testing_frameworks.rb
 - lib/aruba/errors.rb
 - lib/aruba/event_bus.rb
 - lib/aruba/events.rb
@@ -402,9 +416,7 @@ files:
 - lib/aruba/matchers/path/be_an_existing_path.rb
 - lib/aruba/matchers/path/have_permissions.rb
 - lib/aruba/matchers/string.rb
-- lib/aruba/matchers/string/include_output_string.rb
 - lib/aruba/matchers/string/match_output_string.rb
-- lib/aruba/matchers/string/output_string_eq.rb
 - lib/aruba/platform.rb
 - lib/aruba/platforms/announcer.rb
 - lib/aruba/platforms/aruba_file_creator.rb
@@ -439,7 +451,6 @@ metadata:
   documentation_uri: https://www.rubydoc.info/gems/aruba
   homepage_uri: https://github.com/cucumber/aruba
   source_code_uri: https://github.com/cucumber/aruba
-post_install_message:
 rdoc_options:
 - "--charset"
 - UTF-8
@@ -451,15 +462,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.20
-signing_key:
+rubygems_version: 4.0.16
 specification_version: 4
-summary: aruba-2.4.0
+summary: Test command line applications with Cucumber, RSpec or Minitest
 test_files: []

data/lib/aruba/console/help.rb

@@ -1,34 +0,0 @@
-# frozen_string_literal: true
-
-require 'aruba/api'
-
-# Aruba
-module Aruba
-  # Consule
-  class Console
-    # Helpers for Aruba::Console
-    module Help
-      # Output help information
-      def aruba_help
-        puts "Aruba Version: #{Aruba::VERSION}"
-        puts 'Issue Tracker: https://github.com/cucumber/aruba/issues'
-        puts 'Documentation:'
-        puts '* http://www.rubydoc.info/gems/aruba'
-        puts
-
-        nil
-      end
-
-      # List available methods in aruba
-      def aruba_methods
-        ms = (Aruba::Api.instance_methods - Module.instance_methods)
-             .each_with_object([]) { |e, a| a << format('* %s', e) }
-             .sort
-
-        puts "Available Methods:\n#{ms.join("\n")}"
-
-        nil
-      end
-    end
-  end
-end

data/lib/aruba/console.rb

@@ -1,67 +0,0 @@
-# frozen_string_literal: true
-
-require 'irb'
-
-require 'aruba/api'
-require 'aruba/console/help'
-
-# Aruba
-module Aruba
-  # Consule
-  class Console
-    # Start the aruba console
-    #
-    def start
-      # Start IRB with current context:
-      # http://stackoverflow.com/questions/4189818/how-to-run-irb-start-in-context-of-current-class
-      ARGV.clear
-      IRB.setup nil
-
-      IRB.conf[:IRB_NAME] = 'aruba'
-
-      IRB.conf[:PROMPT] = {}
-      IRB.conf[:PROMPT][:ARUBA] = {
-        PROMPT_I: '%N:%03n:%i> ',
-        PROMPT_S: '%N:%03n:%i%l ',
-        PROMPT_C: '%N:%03n:%i* ',
-        RETURN: "# => %s\n"
-      }
-      IRB.conf[:PROMPT_MODE] = :ARUBA
-
-      IRB.conf[:RC] = false
-
-      require 'irb/completion'
-      IRB.conf[:READLINE] = true
-      IRB.conf[:SAVE_HISTORY] = 1000
-      IRB.conf[:HISTORY_FILE] = Aruba.config.console_history_file
-
-      context = Class.new do
-        include Aruba::Api
-        include Aruba::Console::Help
-
-        def initialize
-          setup_aruba
-        end
-
-        def inspect
-          'aruba console'
-        end
-      end
-
-      irb = IRB::Irb.new(IRB::WorkSpace.new(context.new))
-      IRB.conf[:MAIN_CONTEXT] = irb.context
-
-      trap('SIGINT') do
-        irb.signal_handle
-      end
-
-      begin
-        catch(:IRB_EXIT) do
-          irb.eval_input
-        end
-      ensure
-        IRB.irb_at_exit
-      end
-    end
-  end
-end

data/lib/aruba/contracts/absolute_path.rb

@@ -1,22 +0,0 @@
-# frozen_string_literal: true
-
-require 'aruba/platform'
-
-# Aruba
-module Aruba
-  # Contracts
-  module Contracts
-    # Check if path is absolute
-    class AbsolutePath
-      # Check
-      #
-      # @param [Object] value
-      #   The value to be checked
-      def self.valid?(value)
-        Aruba.platform.absolute_path? value
-      rescue StandardError
-        false
-      end
-    end
-  end
-end

data/lib/aruba/contracts/enum.rb

@@ -1,29 +0,0 @@
-# frozen_string_literal: true
-
-require 'contracts'
-
-# Aruba
-module Aruba
-  # Contracts
-  module Contracts
-    # Enum
-    class Enum < ::Contracts::CallableClass
-      private
-
-      attr_reader :vals
-
-      public
-
-      # Create contract
-      def initialize(*vals)
-        super()
-        @vals = vals
-      end
-
-      # Check if value is part of array
-      def valid?(val)
-        vals.include? val
-      end
-    end
-  end
-end

data/lib/aruba/contracts/is_power_of_two.rb

@@ -1,24 +0,0 @@
-# frozen_string_literal: true
-
-require 'aruba/aruba_path'
-
-# Aruba
-module Aruba
-  # Contracts
-  module Contracts
-    # Is value power of two
-    class IsPowerOfTwo
-      # Check value
-      #
-      # @param [Integer] value
-      #   The value to be checked
-      def self.valid?(value)
-        # explanation for algorithm can be found here:
-        # http://www.exploringbinary.com/ten-ways-to-check-if-an-integer-is-a-power-of-two-in-c/
-        value.positive? && value.nobits?(value - 1)
-      rescue StandardError
-        false
-      end
-    end
-  end
-end