uspec 0.1.1 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5dce7ef226b32d0ffef1d178b04c11a474cb3f137bb8697244cec85ace59ad5
-  data.tar.gz: 9f80cd6442661e2993df1ec9ad7486999d435c962f39adc893db2335f05da4c9
+  metadata.gz: adfc4745c3e11f9afa82923366d86c5515745666b98606ded26418cb520b9bb9
+  data.tar.gz: b62be6efc2f67ba658c2701b6984764d7fdb36e0acc79f1e20378efeef1c534c
 SHA512:
-  metadata.gz: 6cd294e9ec21d0b5d48c2dee3328667e335f6a5c1922d7b28c6d392c146b0237eefa523b42217e6927dab206a453eff72e8f97b5133ec6d86096b3a23df7b037
-  data.tar.gz: 05f5582a527627d26fbe3563644feb5702fc56d398ac0b5685ffbb953499ba063c238281e175d1b85dcb76b777aed4e4ce05851470da40f27805af340e727461
+  metadata.gz: b89e9ab10352cbe0d18278c1d5aa823b72d3d9c40dbf49d0c2791b6f92748841d2018e6ac1ddee04016fa40c6353a76c94d8c6c7bfe11c7197a60606e38180b5
+  data.tar.gz: 51dc3f357ffff68b6e7ffc3d1a81376ad2755813490a2749e55bbcef6142ae3432f92076b7dcd5599625f55fb77ce6a8f099612972119bf90f24315e30d7f688

data/.circleci/config.yml

@@ -0,0 +1,21 @@
+version: 2.1
+orbs:
+  ruby: circleci/ruby@0.1.2 
+
+jobs:
+  build:
+    docker:
+      - image: circleci/ruby:2.6.3-stretch-node
+    executor: ruby/default
+    steps:
+      - checkout
+      - run:
+          name: Which bundler?
+          command: bundle -v
+      - ruby/bundle-install
+  test:
+    executor: ruby/default
+    steps:
+      - run:
+          name: Uspec tests
+          command: bundle exec uspec

data/.editorconfig

@@ -0,0 +1,11 @@
+# EditorConfig is awesome: https://EditorConfig.org
+
+root = true
+
+[*]
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+charset = utf-8
+trim_trailing_whitespace = true

data/.rubocop.yml

@@ -0,0 +1,56 @@
+# Rubocop override settings
+
+AllCops:
+  TargetRubyVersion: 2.0
+
+Metrics/LineLength:
+  Max: 120
+  Exclude:
+    - config_module.gemspec
+    - "uspec/**/*"
+
+Naming/PredicateName:
+  Enabled: false
+
+Style/PreferredHashMethods:
+  Exclude:
+    - "**/*"
+
+Style/Documentation:
+  Enabled: false
+
+Style/MethodDefParentheses:
+  Enabled: false
+
+Style/ParallelAssignment:
+  Enabled: false
+
+Style/SingleLineMethods:
+  Enabled: false
+
+Style/Alias:
+  Enabled: false
+
+Style/CaseEquality:
+  Enabled: false
+
+Style/SymbolArray:
+  Enabled: false
+
+Bundler/OrderedGems:
+  Enabled: false
+
+Style/StringLiterals:
+  EnforcedStyle: double_quotes
+
+Style/StringLiteralsInInterpolation:
+  EnforcedStyle: double_quotes
+
+Layout/AccessModifierIndentation:
+  EnforcedStyle: outdent
+
+Style/EnforcedStyleForMultiline:
+  EnforcedStyle: consistent_comma
+
+Naming/RescuedExceptionsVariableName:
+  PreferredName: error

data/README.markdown

@@ -3,29 +3,45 @@ Uspec
 
 Uspec is a shiny little testing framework for your apps!
 
-[![Build Status](https://travis-ci.org/acook/uspec.png?branch=master)](https://travis-ci.org/acook/uspec)
-[![Code Climate](https://codeclimate.com/github/acook/uspec.png)](https://codeclimate.com/github/acook/uspec)
+[![Gem Version](https://img.shields.io/gem/v/uspec.svg?style=for-the-badge)](https://rubygems.org/gems/uspec/)
+[![Build Status](https://img.shields.io/circleci/build/github/acook/uspec.svg?style=for-the-badge)](https://app.circleci.com/pipelines/github/acook/uspec)
+[![Code Climate](https://img.shields.io/codeclimate/maintainability/acook/uspec.svg?style=for-the-badge)](https://codeclimate.com/github/acook/uspec)
 
 Philosophy / Why Uspec?
 -----------------------
 
 > Uspec is just Ruby!
 
-Unlike other testing frameworks there's no need for special matchers, 
-there can only be one assertion per test, 
+Unlike other testing frameworks there's no need for special matchers,
+there can only be one assertion per test,
 and you never have to worry that your tests lack assertions.
 
-That's because when the `spec` block is evaluated the return value is used (in a very ruby-like way) 
-to determine the validity of the statement. Standard Ruby comparisons are your friend! 
+That's because when the `spec` block is evaluated the return value is used (in a very ruby-like way)
+to determine if the test has passed or failed. Standard Ruby comparisons are your friend!
 No more digging around in your test framework's documentation to figure out what matcher you're supposed to use.
 This also means *no monkey patching* core classes!
 
-Uspec's output is in beautiful ansi technicolor, 
+Uspec's output is in beautiful ansi technicolor,
 with red for failures, green for successes, and yellow for pending specs. Here's a screenshot:
 
 ![Screenshot!](http://i.imgur.com/M2F5YvO.png)
 
-Uspec is tiny, painless, and easy to use. Download it and give it a shot. :)
+Uspec is tiny, painless, and easy to use. Download it and give it a try!
+
+Example
+-------
+
+Uspec is **just Ruby**. The DSL is minimal - there's only one method to remember!
+
+Writing a spec is easy:
+
+```ruby
+spec 'AwesomeMcCoolname.generate creates a cool name' do
+  AwesomeMcCoolname.generate.include? 'Cool'
+end
+```
+
+That's it!
 
 Installation
 ------------
@@ -38,7 +54,7 @@ And then execute:
 
     $ bundle
 
-Or install it yourself as:
+Or install it directly with:
 
     $ gem install uspec
 
@@ -46,46 +62,31 @@ Or install it yourself as:
 Quickstart
 ----------
 
-0. Create a `spec` directory to keep your specs in.
+0. Create a `uspec` directory to keep your specs in.
 1. Name your specs ending with `_spec.rb`.
-2. Write some specs in Ruby using the `spec` method.
+2. Write some specs in Ruby using the `spec` method (example above).
 2. Use the included `uspec` executable to run your specs.
 
-**Hint:** A lot of people also put `require_relative 'spec_helper'` in their tests for global start up code.
+**Hint:** A lot of people also put `require_relative 'spec_helper'` at the top of their test files for sharing code between tests.
 
-Usage
------
+Commandline Usage
+-----------------
 
-``` 
+```
 $ uspec --help
 uspec - minimalistic ruby testing framework
 usage: uspec [<file_or_path>...]
 ```
 
-- Without arguments the `uspec` command will automatially look for `spec` directories and load any `*_spec.rb` files inside them. 
+- Without arguments the `uspec` command will automatially look for a `uspec` directory and load any `*_spec.rb` files inside them.
 - You can also pass in arbitrary files and it will attempt to run them as specs.
-- If you pass in directories `uspec` will find and run any specs inside them.
-- Uspec will return `0` if all specs pass and `255` if any fail.
-
-Syntax
-------
-
-Uspec is **just Ruby**. The DSL is minimal - there's only one method to remember!
-
-Writing a spec is easy:
-
-```ruby
-spec 'AwesomeMcCoolname.generate creates a cool name' do
-  AwesomeMcCoolname.generate.include? 'Cool'
-end
-```
-
-That's it!
+- If you pass in directories `uspec` will scan for and run any specs inside them.
+- Uspec will return the number of failures as its status code to the commandline, 0 if none.
 
 Output
 ------
 
-Examples of Uspec's output below!
+A brief explanation of `uspec`'s output to show you what it can do!
 
 ### Success
 
@@ -157,7 +158,7 @@ When you run the test Uspec will helpfully display:
 Tips & Tricks
 -------------
 
-Because there's no matchers and only one method there's no reference documentation to look at, so here are some ideas to get you going!
+Because there's no matchers and only one method there's no need for specialized reference documentation, but here are some ideas to get you going!
 
 ### String matching
 
@@ -190,8 +191,8 @@ What if you want to test that an error has occured? Just use Ruby!
 spec 'calling AwesomeMcCoolname.awesomeness without specifying the awesomeness level should explode' do
   begin
     AwesomeMcCoolname.awesomeness
-  rescue => error
-    error.class == ArgumentError || raise
+  rescue ArgumentError => error
+    error.message.include?("Needs awesomeness level!") || raise
   end
 end
 ```
@@ -200,6 +201,11 @@ If there's no error, then Uspec will see the result of the method call (whatever
 If the wrong Exception is raised, then because of reraising (by just calling `raise` without parameters),
 Ruby will dutifully pass along the error for Uspec to display.
 
+Mocks, Spies, Stubs, and More!
+-----------------------
+
+Since `uspec` is a very straight forward testing utility it is easy to use any of the standard Ruby mocking frameworks with it. However, the [Impasta gem](https://github.com/acook/impasta) was made specifically for simple but comprehensive mocking, stubbing, and spying.
+
 Assertions & Debugging
 ----------------------
 
@@ -212,7 +218,7 @@ require 'uspec'
 
 class MyFoo
   extend Uspec::DSL
-  
+
   def assert
     spec 'foo is valid' do
       false
@@ -223,19 +229,20 @@ end
 MyFoo.new.assert
 ```
 
-If there are any specs that fail, your application will exit with a `255``. 
+Assertions will be displayed as they occur, success or failure along with any informative output.
+If there are any specs that fail, when your application exits its error code will equal the number of failures.
 
 ```
 $ ruby foo.rb
  -- foo is valid: false
 $ echo $?
-255
+1
 ```
 
 Uspec is just Ruby
 ------------------
 
-If for some reason you don't want to use the `uspec` command, you can `require 'uspec'` and `extend Uspec::DSL`. 
+If for some reason you don't want to use the `uspec` command, you can `require 'uspec'` and `extend Uspec::DSL`.
 From there you can just run the file with ruby: `ruby my_test_spec.rb`
 
 Contributing
@@ -250,4 +257,4 @@ Contributing
 Author
 ------
 
-> Anthony M. Cook 2013-2016
+> Anthony M. Cook 2013-2020

data/bin/uspec

@@ -1,4 +1,4 @@
 #!/usr/bin/env ruby
 
 require_relative '../lib/uspec/cli'
-Uspec::CLI.invoke ARGV
+Uspec::CLI.new(ARGV).invoke

data/lib/uspec.rb

@@ -1,5 +1,4 @@
 require_relative 'uspec/version'
-require_relative 'uspec/formatter'
 require_relative 'uspec/dsl'
 require_relative 'uspec/stats'
 
@@ -9,9 +8,10 @@ module Uspec
     exit 2
   end
 
+  # this method used to be how we injected the spec method
   def self.extended object
-    object.extend Uspec::DSL
+    #unless object.respond_to? :spec
+    #  object.extend Uspec::DSL
+    #end
   end
 end
-
-at_exit { exit Uspec::Stats.exit_code }

data/lib/uspec/cli.rb

@@ -2,29 +2,34 @@ require 'pathname'
 require_relative '../uspec'
 
 class Uspec::CLI
-  class << self
-    def usage
-      warn "uspec - minimalistic ruby testing framework"
-      warn "usage: #{File.basename $0} [<file_or_path>...]"
-    end
+  def initialize args
+    usage unless (args & %w[-h --help -? /? -v --version]).empty?
 
-    def run_specs paths
-      uspec_cli = self.new paths
-      uspec_cli.run_paths
-    end
+    @paths = args
+    @pwd = Pathname.pwd.freeze
+    @stats = Uspec::Stats.new
+    @dsl = Uspec::DSL.new self
+  end
+  attr :stats, :dsl
 
-    def invoke args
-      if (args & %w[-h --help -? /?]).empty? then
-        run_specs args
-      else
-        usage
-      end
-    end
+  def usage
+    warn "uspec v#{::Uspec::VERSION} - minimalistic ruby testing framework"
+    warn "usage: #{File.basename $0} [<file_or_path>...]"
+    exit 1
   end
 
-  def initialize paths
-    @paths = paths
-    @pwd = Pathname.pwd.freeze
+  def run_specs
+    run_paths
+  end
+
+  def invoke
+    run_specs
+    puts @stats.summary
+    exit exit_code
+  end
+
+  def exit_code
+    [@stats.failure.size, 255].min
   end
 
   def paths
@@ -44,21 +49,37 @@ class Uspec::CLI
   end
 
   def run path
+    spec = nil
     if path.directory? then
       Pathname.glob(path.join('**', '**_spec.rb')).each do |spec|
         run spec
       end
     elsif path.exist? then
       puts "#{path.basename path.extname}:"
-      Uspec::DSL.instance_eval(path.read, path.to_s)
+      dsl.instance_eval(path.read, path.to_s)
     else
       warn "path not found: #{path}"
     end
-  rescue LoadError => result
-    formatter = Uspec::Formatter.new
-    print ' -- FAILED TO LOAD TEST FILE DUE TO: '
-    Uspec::Stats.results << result
-    puts formatter.colorize(result, result.backtrace)
+  rescue Exception => error
+
+    error_file, error_line, _ = error.backtrace.first.split ?:
+
+    message = <<-MSG
+      #{error.class} : #{error.message}
+
+      Uspec encountered an error when loading a test file.
+      This is probably a typo in the test file or the file it is testing.
+
+      If you think this is a bug in Uspec please report it: https://github.com/acook/uspec/issues/new
+
+      Error occured when loading test file `#{spec || path}`.
+      The origin of the error may be in file `#{error_file}` on line ##{error_line}.
+
+\t#{error.backtrace[0,3].join "\n\t"}
+    MSG
+    puts
+    warn message
+    self.class.stats.failure << Uspec::Result.new(message, error, caller)
   end
 
 end

data/lib/uspec/dsl.rb

@@ -1,20 +1,55 @@
+require_relative "result"
+
 module Uspec
-  module DSL
-    module_function
-    def spec description
-      formatter = Uspec::Formatter.new
+  class DSL
+    def initialize cli
+      @__uspec_cli = cli
+    end
+
+    def __uspec_cli
+      @__uspec_cli
+    end
+
+    def __uspec_stats
+      @__uspec_cli.stats
+    end
 
+    def spec description
       print ' -- ', description
 
-      return print(': ' + formatter.yellow('pending') + formatter.vspace) unless block_given?
+      if block_given? then
+        begin
+          raw_result = yield
+        rescue Exception => raw_result
+        end
+      end
+
+      result = Result.new description, raw_result, caller
 
-      begin
-        result = yield
-      rescue => result
+      unless block_given? then
+        result.pending!
       end
 
-      Uspec::Stats.results << result
-      print ': ', formatter.colorize(result, caller), "\n"
+      if result.success?
+        __uspec_stats.success << result
+      elsif result.pending?
+        stats.pending << result
+      else
+        __uspec_stats.failure << result
+      end
+
+      print ': ', result.pretty, "\n"
+    rescue => error
+      message = <<-MSG
+        #{error.class} : #{error.message}
+
+        Uspec encountered an internal error, please report this bug: https://github.com/acook/uspec/issues/new
+
+\t#{error.backtrace.join "\n\t"}
+      MSG
+      puts
+      warn message
+      __uspec_stats.failure << Uspec::Result.new(message, error, caller)
     end
   end
 end

data/lib/uspec/result.rb

@@ -0,0 +1,111 @@
+require_relative "terminal"
+require "toisb"
+
+module Uspec
+  class Result
+    include Terminal
+
+    def initialize spec, raw, source
+      @spec = spec
+      @raw = raw
+      @source = source
+      @handler = ::TOISB.wrap raw
+    end
+    attr_reader :spec, :raw, :source, :handler
+
+    def pretty
+      if raw == true then
+        green raw
+      elsif raw == false then
+        red raw
+      elsif pending? then
+        yellow 'pending'
+      elsif Exception === raw then
+        [
+          red('Exception'), vspace,
+          hspace, 'Spec encountered an Exception ', newline,
+          hspace, 'in spec at ', source.first, vspace,
+          hspace, message, vspace,
+          white(trace)
+        ].join
+      else
+        [
+          red('Failed'), vspace,
+          hspace, 'Spec did not return a boolean value ', newline,
+          hspace, 'in spec at ', source.first, vspace,
+          hspace, red(subklassinfo), inspector, newline
+        ].join
+      end
+    end
+
+    def trace
+      raw.backtrace.inject(String.new) do |text, line|
+        text << "#{hspace}#{line}#{newline}"
+      end
+    end
+
+    def message
+      "#{red subklassinfo}#{raw.message}"
+    end
+
+    def subklassinfo
+      "#{handler.subklassinfo}: "
+    end
+
+    # Attempts to inspect an object
+    def inspector
+      if String === raw && raw.include?(?\n) then
+        # if object is a multiline string, display it unescaped
+        [
+          vspace,
+          hspace, yellow('"""'), newline,
+          raw, normal, newline,
+          hspace, yellow('"""')
+        ].join
+      else
+        handler.inspector!
+      end
+    rescue Exception => error
+      return handler.simple_inspector if error.message.include? handler.get_id
+
+      error_file, error_line, _ = error.backtrace[4].split ?:
+
+      <<-MSG
+
+      #{error.class} : #{error.message}
+
+      Uspec detected a bug in your source code!
+      Calling #inspect on an object will recusively call #inspect on its instance variables and contents.
+      If one of those contained objects does not have an #inspect method you will see this message.
+      You will also get this message if your #inspect method or one of its callees raises an exception.
+      This is most likely to happen with BasicObject and its subclasses.
+
+      If you think this is a bug in Uspec please report it: https://github.com/acook/uspec/issues/new
+
+      Error may have occured in test `#{spec}` in file `#{error_file}` on line ##{error_line}.
+
+\t#{error.backtrace.join "\n\t"}
+      MSG
+    end
+
+    def success?
+      raw == true
+    end
+
+    def failure?
+      raw != true && !@pending
+    end
+
+    def pending?
+      !!@pending
+    end
+
+    def pending!
+      @pending = true
+    end
+
+    def inspect
+      "#{self.class} for `#{spec}` -> #{pretty}"
+    end
+  end
+end

data/lib/uspec/stats.rb

@@ -1,23 +1,36 @@
 module Uspec
   class Stats
-    class << self
-      def results?
-        !results.empty?
-      end
+    def initialize
+      clear_results!
+    end
+    attr :success, :failure, :pending
 
-      def results
-        @results ||= clear_results!
-      end
+    def clear_results!
+      @success = Array.new
+      @failure = Array.new
+      @pending = Array.new
+    end
 
-      def clear_results!
-        @results = Array.new
-      end
+    def inspect
+      <<-INFO
+        #{super} Failures: #{exit_code}
+        #{results.map{|r| r.inspect}.join "\n\t" }
+      INFO
+    end
+
+    def results
+      @success + @failure + @pending
+    end
 
-      def exit_code
-        # checking for truthy isn't good enough, it must be exactly true!
-        failures = results.count{|result| result != true }
-        failures > 255 ? 255 : failures
-      end
+    def summary
+      [
+        "test summary: ",
+        Uspec::Terminal.green("#{@success.size} successful"),
+        ", ",
+        Uspec::Terminal.red("#{@failure.size} failed"),
+        ", ",
+        Uspec::Terminal.yellow("#{@pending.size} pending")
+      ].join
     end
   end
 end

data/lib/uspec/terminal.rb

@@ -0,0 +1,47 @@
+module Uspec
+  module Terminal
+  module_function
+
+    def colors
+      {
+        red: 1,
+        green: 2,
+        yellow: 3,
+        white: 7
+      }
+    end
+
+    def color hue, text = nil
+      "#{esc "3#{colors[hue]};1"}#{text}#{normal unless text.nil?}"
+    end
+
+    def esc seq
+      "\e[#{seq}m"
+    end
+
+    def normal text=nil
+      "#{esc 0}#{text}"
+    end
+
+    def hspace
+      '    '
+    end
+
+    def vspace
+      "#{newline}#{newline}"
+    end
+
+    def newline
+      $/
+    end
+
+    def method_missing name, *args, &block
+      if colors.keys.include? name then
+        color name, *args
+      else
+        super
+      end
+    end
+
+  end
+end

data/lib/uspec/version.rb

@@ -1,3 +1,3 @@
 module Uspec
-  VERSION = '0.1.1'
+  VERSION = '1.0.0'
 end

data/uspec.gemspec

@@ -1,19 +1,29 @@
 # -*- encoding: utf-8 -*-
-lib = File.expand_path('../lib', __FILE__)
+lib = File.expand_path("../lib", __FILE__)
 $LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
-require 'uspec/version'
+require "uspec/version"
 
 Gem::Specification.new do |gem|
   gem.name          = "uspec"
   gem.version       = Uspec::VERSION
-  gem.authors       = ["Anthony Cook"]
-  gem.email         = ["anthonymichaelcook@gmail.com"]
+  gem.authors       = ["Anthony M. Cook"]
+  gem.email         = ["github@anthonymcook.com"]
   gem.description   = %q{Uspec is a shiny little spec framework for your apps! Unlike other testing frameworks there's no need for matchers, there can only be one assertion per test, and you never have to worry that your tests lack assertions.}
   gem.summary       = %q{a shiny little spec framework for your apps!}
   gem.homepage      = "http://github.com/acook/uspec#readme"
+  gem.license       = "MIT"
 
   gem.files         = `git ls-files`.split($/)
   gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
   gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
   gem.require_paths = ["lib"]
+
+  # due to require_relative semantics in 1.9.x and issues with BasicObject support in 2.0
+  # technically should still work in 2.0 but some of the test suite won't pass
+  gem.required_ruby_version = ">= 2.1"
+
+  gem.add_dependency "that_object_is_so_basic", "~> 0.0.5"
+
+  gem.add_development_dependency "pry"
+  gem.add_development_dependency "pry-doc"
 end

data/uspec/cli_spec.rb

@@ -12,25 +12,25 @@ end
 spec 'runs a path of specs' do
   output = capture do
     path = Pathname.new(__FILE__).parent.parent.join('example_specs').to_s
-    Uspec::CLI.run_specs Array(path)
+    Uspec::CLI.new(Array(path)).run_specs
   end
 
-  output.include? 'I love passing tests'
+  output.include?('I love passing tests') || output
 end
 
 spec 'runs an individual spec' do
   output = capture do
     path =  Pathname.new(__FILE__).parent.parent.join('example_specs', 'example_spec.rb').to_s
-    Uspec::CLI.run_specs Array(path)
+    Uspec::CLI.new(Array(path)).run_specs
   end
 
-  output.include? 'I love passing tests'
+  output.include?('I love passing tests') || output
 end
 
-spec 'exits with failure status if a test has a broken require' do
+spec 'broken requires in test files count as test failures' do
   path =  Pathname.new(__FILE__).parent.join('test_specs', 'broken_require_spec')
 
-  capture do
+  output = capture do
     exec "bin/uspec #{path}"
   end
 
@@ -44,5 +44,5 @@ spec 'displays information about test file with broken require' do
     exec "bin/uspec #{path}"
   end
 
-  output.include? 'cannot load such file'
-end
+  output.include?('cannot load such file') || output
+end

data/uspec/result_spec.rb

@@ -0,0 +1,70 @@
+require_relative "uspec_helper"
+
+bo = BasicObject.new
+
+spec "#pretty doesn't die when given a BasicObject" do
+  result = Uspec::Result.new "BasicObject Result", bo, []
+  expected = "#<BasicObject:"
+  actual = result.pretty
+  actual.include?(expected) || actual
+end
+
+# If we don't prefix the classname with "::", Ruby defines it under an anonymous class
+class ::TestObject < BasicObject; end
+obj = TestObject.new
+
+spec "ensure BasicObject subclasses work" do
+  result = Uspec::Result.new "BasicObject Subclass Result", obj, []
+  expected = "#<BasicObject/TestObject:"
+  actual =  result.pretty
+  actual.include?(expected) || result.pretty
+end
+
+spec "display basic info about Object" do
+  result = Uspec::Result.new "Object Result", Object.new, []
+  expected = "Object < BasicObject"
+  actual =  result.pretty
+  actual.include?(expected) || result.pretty
+end
+
+spec "display basic info about Array" do
+  result = Uspec::Result.new "Array Result", [], []
+  expected = "Array < Object"
+  actual =  result.pretty
+  actual.include?(expected) || result.pretty
+end
+
+spec "display basic info about Array class" do
+  result = Uspec::Result.new "Array Class Result", Array, []
+  #expected = "Class < ???" # TODO: Make classes display nicer in TOISB
+  expected = "#<Class:Object> < #<Class:BasicObject>: \e[0mArray"
+  actual =  result.pretty
+  actual.include?(expected) || result.pretty
+end
+
+parent = [obj]
+
+spec "ensure parent object of BasicObject subclasses get a useful error message" do
+  result = Uspec::Result.new "BasicObject Parent Result", parent, []
+  expected = "BasicObject and its subclasses"
+  actual =  result.pretty
+  actual.include?(expected) || result.inspector
+end
+
+class ::InspectFail; def inspect; raise RuntimeError, "This error is intentional and part of the test."; end; end
+inspect_fail = InspectFail.new
+
+spec "display a useful error message when a user-defined inspect method fails" do
+  result = Uspec::Result.new "Inspect Fail Result", inspect_fail, []
+  expected = "raises an exception"
+  actual =  result.pretty
+  actual.include?(expected) || result.inspector
+end
+
+spec "display strings more like their actual contents" do
+  expected = "this string:\nshould display \e[42;2mproperly"
+  result = Uspec::Result.new "Inspect Fail Result", expected, []
+  actual =  result.pretty
+  actual.include?(expected) || result.inspector
+end
+

data/uspec/uspec_spec.rb

@@ -10,6 +10,16 @@ spec 'catches errors' do
   output.include? 'Exception'
 end
 
+spec 'catches even non-StandardError-subclass exceptions' do
+  output = capture do
+    spec 'not implemented error' do
+      raise ::NotImplementedError, 'test exception'
+    end
+  end
+
+  output.include? 'Exception'
+end
+
 spec 'complains when spec block returns non boolean' do
   output = capture do
     spec 'whatever' do
@@ -17,7 +27,7 @@ spec 'complains when spec block returns non boolean' do
     end
   end
 
-  output.include? 'Unknown Result'
+  output.include? 'Failed'
 end
 
 spec 'marks test as pending when no block supplied' do
@@ -33,24 +43,34 @@ spec 'should not define DSL methods on arbitrary objects' do
 end
 
 spec 'exit code is the number of failures' do
-  capture do
-    50.times do
-      spec 'fail' do
+  expected = 50
+  output = capture do
+    __uspec_stats.clear_results! # because we're forking, we will have a copy of the current results
+
+    expected.times do |count|
+      spec "fail ##{count + 1}" do
         false
       end
     end
+
+    exit __uspec_cli.exit_code
   end
+  actual = $?.exitstatus
 
-  $?.exitstatus == 50 || $?
+  actual == expected || puts("", output) || $?
 end
 
 spec 'if more than 255 failures, exit status is 255' do
   capture do
+    __uspec_stats.clear_results! # because we're forking, we will have a copy of the current results
+
     500.times do
       spec 'fail' do
         false
       end
     end
+
+    exit __uspec_cli.exit_code
   end
 
   $?.exitstatus == 255 || $?

metadata

@@ -1,29 +1,73 @@
 --- !ruby/object:Gem::Specification
 name: uspec
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 1.0.0
 platform: ruby
 authors:
-- Anthony Cook
+- Anthony M. Cook
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-06-15 00:00:00.000000000 Z
-dependencies: []
+date: 2021-02-25 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: that_object_is_so_basic
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.0.5
+- !ruby/object:Gem::Dependency
+  name: pry
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: pry-doc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Uspec is a shiny little spec framework for your apps! Unlike other testing
   frameworks there's no need for matchers, there can only be one assertion per test,
   and you never have to worry that your tests lack assertions.
 email:
-- anthonymichaelcook@gmail.com
+- github@anthonymcook.com
 executables:
 - uspec
 extensions: []
 extra_rdoc_files: []
 files:
+- ".circleci/config.yml"
+- ".editorconfig"
 - ".gitignore"
+- ".rubocop.yml"
 - ".ruby-gemset"
 - ".ruby-version"
-- ".travis.yml"
 - Gemfile
 - LICENSE.txt
 - README.markdown
@@ -34,16 +78,19 @@ files:
 - lib/uspec.rb
 - lib/uspec/cli.rb
 - lib/uspec/dsl.rb
-- lib/uspec/formatter.rb
+- lib/uspec/result.rb
 - lib/uspec/stats.rb
+- lib/uspec/terminal.rb
 - lib/uspec/version.rb
 - uspec.gemspec
 - uspec/cli_spec.rb
+- uspec/result_spec.rb
 - uspec/test_specs/broken_require_spec
 - uspec/uspec_helper.rb
 - uspec/uspec_spec.rb
 homepage: http://github.com/acook/uspec#readme
-licenses: []
+licenses:
+- MIT
 metadata: {}
 post_install_message: 
 rdoc_options: []
@@ -53,7 +100,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '0'
+      version: '2.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="

data/.travis.yml

@@ -1,23 +0,0 @@
-language: ruby
-
-rvm:
-  - 2.2.3
-  - 2.0.0
-  - 1.9.3
-  - 1.9.2
-
-  - jruby-19mode
-  - ruby-head
-
-before_install:
-  - gem update bundler
-before_script:
-  - bundle exec gem list
-script: bundle exec uspec
-
-matrix:
-  allow_failures:
-    - rvm: ruby-head
-    - rvm: jruby-19mode
-
-sudo: false

data/lib/uspec/formatter.rb

@@ -1,90 +0,0 @@
-module Uspec
-  class Formatter
-    def colors
-      {
-        red: 1,
-        green: 2,
-        yellow: 3,
-        white: 7
-      }
-    end
-
-    def color hue, text = nil
-      esc("3#{colors[hue]};1") + "#{text}#{normal}"
-    end
-
-    def esc seq
-      "\e[#{seq}m"
-    end
-
-    def normal text=nil
-      esc(0) + text.to_s
-    end
-
-    def colorize result, source
-      if result == true then
-        green result
-      elsif result == false then
-        red result
-      elsif result.is_a? Exception then
-        [
-          red('Exception'), vspace,
-          hspace, 'Spec encountered an Exception ', newline,
-          hspace, 'in spec at ', source.first, vspace,
-          hspace, message(result), vspace,
-          white(trace result)
-        ].join
-      else
-        [
-          red('Unknown Result'), vspace,
-          hspace, 'Spec did not return a boolean value ', newline,
-          hspace, 'in spec at ', source.first, vspace,
-          hspace, red(classinfo(result)), result.inspect, newline
-        ].join
-      end
-    end
-
-    def trace error
-      error.backtrace.inject(String.new) do |text, line|
-        text << hspace + line + newline
-      end
-    end
-
-    def message error
-      red(classinfo error) + error.message
-    end
-
-    def classinfo object
-      "#{classify object} < #{superclass object}: "
-    end
-
-    def classify object
-      object.is_a?(Module) ? object : object.class
-    end
-
-    def superclass object
-      classify(object).superclass
-    end
-
-    def hspace
-      '    '
-    end
-
-    def vspace
-      newline + newline
-    end
-
-    def newline
-      $/
-    end
-
-    def method_missing name, *args, &block
-      if colors.keys.include? name then
-        color name, *args
-      else
-        super
-      end
-    end
-
-  end
-end