uspec 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in uspec.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Anthony Cook
+
+MIT License
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,132 @@
+Uspec
+=====
+
+Uspec is a shiny little testing framework for your apps!
+
+    Anthony M. Cook 2013
+
+Philosophy / Why Uspec?
+-----------------------
+
+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.
+
+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! No more digging around in your test framework's documentation to figure out what matcher you're supposed to use.
+
+You can't tell here in the docs, but Uspec's output is in beautiful ansi technicolor, with red for failures, green for successes, and yellow for pending specs. Download it and give it a show, its painless and uber easy to use. :)
+
+Usage
+-----
+
+I suggest creating a `uspec` directory in your project folder to put your specs in. Then you'll need this incantation:
+
+```ruby
+require 'uspec'
+extend Uspec
+```
+
+You can slot it in the top of your test file, or if you have other setup code you can put it in a `uspec_helper.rb` and `relative_require 'uspec_helper'` in them instead.
+
+Then all you have to do is put in your specs:
+
+```ruby
+spec 'AwesomeMcCoolname.generate creates a cool name' do
+  AwesomeMcCoolname.generate.include? 'Cool'
+end
+```
+
+If it passes:
+
+```
+ -- AwesomeMcCoolname.generate creates a cool name: true
+```
+
+If it fails:
+
+```
+ -- AwesomeMcCoolname.generate creates a cool name: false
+```
+
+If it throws an error:
+
+```
+ -- AwesomeMcCoolname.generate creates a cool name: Exception
+ 
+    Encountered an Exception while running spec
+    at uspec/awesome_mc_coolname_spec.rb:3: in `<main>'
+    
+    RuntimeError < StandardError: 'wtf'
+    
+    /Users/Dude/Projects/Awesome/lib/awesome_mc_coolname.rb:18:in `explode'
+    uspec/awesome_mc_coolname_spec.rb:4:in `block in <main>'
+```
+
+If you create a spec that doesn't return a boolean value (`nil` doesn't count either!) like this:
+
+```ruby
+spec 'AwesomeMcCoolname.generate creates a cool name' do
+  AwesomeMcCoolname.generate =~ /Badass/
+end
+```
+
+Then Uspec will let you know:
+
+```
+ -- AwesomeMcCoolname.generate creates a badass name: Unknown Result
+ 
+    Spec did not return a boolean value
+    at uspec/awesome_mc_coolname_spec.rb:6: in `<main>'
+    
+    Integer < Numeric: 5
+```
+
+If you aren't ready to fill out a spec, maybe as a reminder to add functionality later, just leave off the block and it will be marked as `pending`:
+
+```ruby
+spec 'a feature I have not implemented yet'
+```
+
+When you run the test Uspec will helpfully display:
+
+```
+ -- a feature I have not implemented yet: pending
+```
+
+What if you want to test that an error has occured? Just use Ruby!
+
+```ruby
+spec 'calling AwesomeMcCoolname.awesomeness without specifying the awesomeness level should explode' do
+  begin
+    AwesomeMcCoolname.awesomeness
+  rescue => error
+    error.class == ArgumentError || raise
+  end
+end
+```
+
+If there's no error, then Uspec will see the result of the method call (whatever it might be).
+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.
+
+Installation
+------------
+
+Add this line to your application's Gemfile:
+
+    gem 'uspec'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install uspec
+
+Contributing
+------------
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1 @@
+require "bundler/gem_tasks"

data/lib/uspec/dsl.rb

@@ -0,0 +1,18 @@
+module Uspec
+  module DSL
+    def spec description
+      formatter = Uspec::Formatter.new
+
+      print ' -- ', description
+
+      return puts(': ' + formatter.yellow('pending') + formatter.vspace) unless block_given?
+
+      begin
+        result = yield
+      rescue => result
+      end
+
+      print ': ', formatter.colorize(result, caller), "\n"
+    end
+  end
+end

data/lib/uspec/formatter.rb

@@ -0,0 +1,90 @@
+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 if text}"
+    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

data/lib/uspec/version.rb

@@ -0,0 +1,3 @@
+module Uspec
+  VERSION = "0.0.1"
+end

data/lib/uspec.rb

@@ -0,0 +1,16 @@
+require_relative 'uspec/version'
+require_relative 'uspec/formatter'
+require_relative 'uspec/dsl'
+
+module Uspec
+  def self.included object
+    warn 'Use extend instead of include.'
+    exit
+  end
+
+  def self.extended object
+    object.extend Uspec::DSL
+  end
+end
+
+

data/uspec/uspec_spec.rb

@@ -0,0 +1,50 @@
+require_relative '../lib/uspec'
+extend Uspec
+
+def capture
+  readme, writeme = IO.pipe
+  pid = fork do
+    $stdout.reopen writeme
+    readme.close
+
+    yield
+  end
+
+  writeme.close
+  output = readme.read
+  Process.waitpid(pid)
+
+  output
+end
+
+spec 'catches errors' do
+  output = capture do
+    spec 'exception' do
+      raise 'test exception'
+    end
+  end
+
+  output.include? 'Exception'
+end
+
+spec 'complains when spec block returns non boolean' do
+  output = capture do
+    spec 'whatever' do
+      "string"
+    end
+  end
+
+  output.include? 'Unknown Result'
+end
+
+spec 'marks test as pending when no block supplied' do
+  output = capture do
+    spec 'pending test'
+  end
+
+  output.include? 'pending'
+end
+
+spec 'should not define DSL methods on arbitrary objects' do
+  !(Array.respond_to? :spec)
+end

data/uspec.gemspec

@@ -0,0 +1,19 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+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.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.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"]
+end

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification
+name: uspec
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Anthony Cook
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-08 00:00:00.000000000 Z
+dependencies: []
+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
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE.txt
+- README.markdown
+- Rakefile
+- lib/uspec.rb
+- lib/uspec/dsl.rb
+- lib/uspec/formatter.rb
+- lib/uspec/version.rb
+- uspec.gemspec
+- uspec/uspec_spec.rb
+homepage: http://github.com/acook/uspec#readme
+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: a shiny little spec framework for your apps!
+test_files: []