Exspec 1.0.1

data/lib/exspec.rb

@@ -0,0 +1,217 @@
+require "active_support/core_ext"
+
+require_relative "exspec/context_manager"
+require_relative "exspec/executor"
+require_relative "exspec/spec_manager"
+require_relative "exspec/logger"
+require_relative "exspec/spec_runner"
+require_relative "exspec/reporter"
+require_relative "exspec/regression_test_reporter"
+require_relative "exspec/helpers"
+require_relative "exspec/extensions/extension"
+require_relative "exspec/extensions/mocking"
+require_relative "exspec/extensions/rails"
+parent_dirs do |parent_dir|
+  configured = false
+  ["exspec.rb", "config/exspec.rb", "exspec/config.rb", "exspec/exspec.rb"].each do |file|
+    file = File.expand_path file, parent_dir
+    require file and configured = true and break if File.file?(file)
+  end
+  break if configured
+end
+
+module Exspec
+  def self.config
+    config = {
+      :test_dir => "test/exspec",
+      :command_prefix => "!",
+      :comment_sign => "!# ",
+      :spec_separator => ".",
+      :spec_extension => ".rb",
+      :regression_test_reporter => RegressionTestReporter
+    }
+    Extension.config config
+    config
+  end
+
+  TEST_DIR = File.expand_path(config[:test_dir])
+  COMMAND_PREFIX = config[:command_prefix]
+  COMMENT_SIGN = config[:comment_sign]
+  SPEC_SEPARATOR = config[:spec_separator]
+  SPEC_EXTENSION = config[:spec_extension]
+  REGRESSION_TEST_REPORTER = config[:regression_test_reporter]
+
+  SkipSignal = Class.new(StandardError)
+
+  class Exspec
+    def initialize(components={})
+      Extension.initialize_exspec self, components
+      @context_manager = components[:context_manager] || ContextManager.new(self)
+      @executor = components[:executor] || Executor.new(self)
+      @spec_manager = components[:spec_manager] || SpecManager.new(self)
+      @logger = components[:logger] || Logger.new
+      @runner = components[:runner] || SpecRunner.new(self)
+      @reporter = components[:reporter] || Reporter.new
+    end
+
+    delegate :without_logging, :last_instruction, :erase_last_instruction, :log, :to => :@logger
+    delegate :eval, :raw_eval, :exspec_eval, :last_value, :last_value=, :last_exspec_value, :to => :@context_manager
+    delegate :spec, :specs, :current_spec, :to => :@spec_manager
+    delegate :spec_failed, :spec_succeeded, :puts, :print, :show_comment, :to => :@reporter
+    delegate :run, :run_specs, :run_stack, :to => :@runner
+
+    attr_reader :logger, :context_manager, :reporter, :spec_manager, :runner, :executor
+    alias_method :context, :context_manager
+
+    def module
+      ::Exspec
+    end
+
+    def execute(instruction)
+      executor.eval instruction do |callbacks|
+        callbacks.after do |command, params, value|
+          context.last_exspec_value = value
+          if command.nil?
+            commit instruction, value
+          end
+          if last_exspec_value != last_value || command == "_" || command == ""
+            puts "#{COMMAND_PREFIX}_: #{last_exspec_value.inspect}"
+          end
+        end
+      end
+    end
+
+    def report_to(reporter=reporter)
+      reporter = reporter.new if reporter.is_a? Class
+      reporter_backup = @reporter
+      @reporter = reporter
+      if block_given?
+        begin
+          yield if block_given?
+        ensure
+          @reporter = reporter_backup if block_given?
+        end
+      end
+    end
+
+    def save(description, comment=nil)
+      comment(comment) unless comment.nil?
+      spec_manager.save logger, description
+    end
+
+    def load(description)
+      reset
+      spec = spec(description)
+      return nil if spec.nil?
+      without_logging { runner.run_stack spec }
+      spec_manager.current_spec = spec
+    end
+
+    def include(description)
+      spec = spec(description)
+      without_logging do
+        run spec
+      end
+      commit "#{COMMAND_PREFIX}include #{spec.name}"
+    end
+
+    def retry
+      instructions = logger.instructions
+      load current_spec
+      instructions.each do |instruction|
+        execute instruction rescue nil
+      end
+      last_value
+    end
+
+    def reset
+      context_manager.start_new_context
+      logger.clear
+      spec_manager.current_spec = nil
+      return_spec nil
+    end
+
+    def comment(text)
+      show_comment text
+      commit "#{COMMAND_PREFIX}comment #{text}", last_value
+    end
+
+    def redo
+      last = last_instruction
+      return nil if last.nil?
+      execute last
+    end
+
+    def assert(statement=nil, comment=nil)
+      val = without_logging { raw_eval statement }
+      if val
+        spec_succeeded "Successful: #{comment || statement}"
+      else
+        spec_failed "Failed: #{comment || statement}"
+      end
+      commit "#{COMMAND_PREFIX}assert #{statement.strip}" + (comment ? " #{COMMENT_SIGN}#{comment}" : "")
+      val
+    end
+
+    def expect(statement=nil, comment=nil)
+      return expect_inspect nil, comment if statement.nil?
+      actual = last_value
+      expect = without_logging { raw_eval statement }
+      if expect == actual
+        spec_succeeded "Successful: #{comment || "value is #{prepare_output(expect)}"}"
+      else
+        spec_failed "Failed: #{comment || "expected #{prepare_output(expect)}"}, but got #{prepare_output(actual)}"
+      end
+      commit "#{COMMAND_PREFIX}expect #{statement.strip}" + (comment ? " #{COMMENT_SIGN}#{comment}" : ""), expect
+    end
+
+    def expect_inspect(expect=nil, comment=nil)
+      actual = inspect_last_value
+      expect = actual if expect.nil?
+      successful = actual.to_s == expect.to_s
+      if successful
+        spec_succeeded "Successful: #{comment || "inspecting last value has yielded #{prepare_output(actual)}"}"
+      else
+        actual_pos = 0
+        successful = true
+        expect.each_char do |char|
+          successful = false
+          for actual_pos in actual_pos..actual.length
+            successful = (actual[actual_pos] == char)
+            break if successful
+          end
+          break if actual_pos == actual.length
+        end
+        spec_succeeded "Successful (fuzzy): #{comment || "inspecting last value has yielded #{prepare_output(actual)}"}" if successful
+      end
+      unless successful
+        spec_failed "Failed: #{comment || "expected inspecting last value to yield #{prepare_output(expect)}, but was #{prepare_output(actual)}"}"
+      end
+      commit "#{COMMAND_PREFIX}expect_inspect #{expect}" + (comment ? " #{COMMENT_SIGN}#{comment}" : "")
+      actual
+    end
+
+    def inspect_last_value
+      last_value.is_a?(String) ? last_value : last_value.inspect
+    end
+
+    def commit(instruction, value=last_value)
+      logger.log instruction, value
+      return_spec value
+    end
+
+    def return_spec(value)
+      self.last_value = value
+    end
+
+    def prepare_output(value)
+      return "nil" if value.nil?
+      return "\"#{value}\"" if value.is_a? String
+      value
+    end
+  end
+end
+
+require_relative "exspec/irb/irb_exspec"
+
+Exspec::Extension.loaded

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: Exspec
+version: !ruby/object:Gem::Version
+  version: 1.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Helge Holzmann
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-03-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Don't write specs anymore, just save 'em while testing your code interactively.
+  Specs will become a byproduct.
+email: helgeho@invelop.de
+executables:
+- exspec
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/exspec/context_manager.rb
+- lib/exspec/execute_callbacks.rb
+- lib/exspec/executor.rb
+- lib/exspec/extensions/extension.rb
+- lib/exspec/extensions/mocking.rb
+- lib/exspec/extensions/rails.rb
+- lib/exspec/helpers.rb
+- lib/exspec/irb/irb_context_manager.rb
+- lib/exspec/irb/irb_exspec.rb
+- lib/exspec/irb/irb_patch.rb
+- lib/exspec/logger.rb
+- lib/exspec/regression_test_reporter.rb
+- lib/exspec/reporter.rb
+- lib/exspec/spec.rb
+- lib/exspec/spec_manager.rb
+- lib/exspec/spec_runner.rb
+- lib/exspec.rb
+- bin/exspec
+homepage: https://github.com/helgeho/Exspec
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.25
+signing_key: 
+specification_version: 3
+summary: Exspec test framework
+test_files: []