uspec 0.1.1 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5dce7ef226b32d0ffef1d178b04c11a474cb3f137bb8697244cec85ace59ad5
-  data.tar.gz: 9f80cd6442661e2993df1ec9ad7486999d435c962f39adc893db2335f05da4c9
+  metadata.gz: 65de448e566c6f625bd228e6581a0ee78bd8811a0189e04f4588d7474201e516
+  data.tar.gz: 62ba89fc56bdd1fb21cf2709ab8441ed0ad9cbe3f5426ce1719d8c36933161d7
 SHA512:
-  metadata.gz: 6cd294e9ec21d0b5d48c2dee3328667e335f6a5c1922d7b28c6d392c146b0237eefa523b42217e6927dab206a453eff72e8f97b5133ec6d86096b3a23df7b037
-  data.tar.gz: 05f5582a527627d26fbe3563644feb5702fc56d398ac0b5685ffbb953499ba063c238281e175d1b85dcb76b777aed4e4ce05851470da40f27805af340e727461
+  metadata.gz: f9353937b8b7e4b44ed2ea214fcb69ce1c0558d7774e10dedd4d071e20ad10f1fca8485e0063bacdf614d25389a9893439f4bafd0617347fd91649b85c9284d1
+  data.tar.gz: 87f381e5c1f7f715c28543f47531589ef8344266d648e729c9d6fb01d7f9bfb7a79a966b2437c7f76e8a7d995dc0d378563b819881cb8b46b92e0b5dbbccee00

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/.travis.yml

@@ -1,11 +1,16 @@
 language: ruby
 
 rvm:
-  - 2.2.3
+  - 2.6.3
+  - 2.5.5
+  - 2.4.6
+  - 2.3.8
+  - 2.2.10
+  - 2.1.10
+  
   - 2.0.0
   - 1.9.3
   - 1.9.2
-
   - jruby-19mode
   - ruby-head
 
@@ -17,6 +22,9 @@ script: bundle exec uspec
 
 matrix:
   allow_failures:
+    - rvm: 2.0.0
+    - rvm: 1.9.3
+    - rvm: 1.9.2
     - rvm: ruby-head
     - rvm: jruby-19mode
 

data/README.markdown

@@ -11,21 +11,36 @@ 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 +53,7 @@ And then execute:
 
     $ bundle
 
-Or install it yourself as:
+Or install it directly with:
 
     $ gem install uspec
 
@@ -46,46 +61,31 @@ Or install it yourself as:
 Quickstart
 ----------
 
-0. Create a `spec` directory to keep your specs in.
+0. Create a `spec` (or `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'` in their tests for shared 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 `spec` and `uspec` directories 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!
+Wonder what Uspec looks like?
 
 ### Success
 
@@ -190,8 +190,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
 ```
@@ -212,7 +212,7 @@ require 'uspec'
 
 class MyFoo
   extend Uspec::DSL
-  
+
   def assert
     spec 'foo is valid' do
       false
@@ -223,19 +223,19 @@ end
 MyFoo.new.assert
 ```
 
-If there are any specs that fail, your application will exit with a `255``. 
+If there are any specs that fail, your application will exit with an error code equal to 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 +250,4 @@ Contributing
 Author
 ------
 
-> Anthony M. Cook 2013-2016
+> Anthony M. Cook 2013-2019

data/lib/uspec.rb

@@ -1,5 +1,4 @@
 require_relative 'uspec/version'
-require_relative 'uspec/formatter'
 require_relative 'uspec/dsl'
 require_relative 'uspec/stats'
 
@@ -14,4 +13,10 @@ module Uspec
   end
 end
 
-at_exit { exit Uspec::Stats.exit_code }
+at_exit do
+  failures = Uspec::Stats.exit_code
+  status = $!.respond_to?(:status) ? $!.status : 0
+  errors = $!.respond_to?(:cause) && $!.cause ? 1 : 0
+  code = [failures, status, errors].max
+  exit code
+end

data/lib/uspec/cli.rb

@@ -4,7 +4,7 @@ require_relative '../uspec'
 class Uspec::CLI
   class << self
     def usage
-      warn "uspec - minimalistic ruby testing framework"
+      warn "uspec v#{::Uspec::VERSION} - minimalistic ruby testing framework"
       warn "usage: #{File.basename $0} [<file_or_path>...]"
     end
 
@@ -14,7 +14,7 @@ class Uspec::CLI
     end
 
     def invoke args
-      if (args & %w[-h --help -? /?]).empty? then
+      if (args & %w[-h --help -? /? -v --version]).empty? then
         run_specs args
       else
         usage
@@ -44,6 +44,7 @@ class Uspec::CLI
   end
 
   def run path
+    spec = nil
     if path.directory? then
       Pathname.glob(path.join('**', '**_spec.rb')).each do |spec|
         run spec
@@ -54,11 +55,26 @@ class Uspec::CLI
     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
+    Uspec::Stats.results << Uspec::Result.new(message, error, caller)
   end
 
 end

data/lib/uspec/dsl.rb

@@ -1,20 +1,36 @@
+require_relative "result"
+
 module Uspec
   module DSL
     module_function
     def spec description
-      formatter = Uspec::Formatter.new
+      terminal = Uspec::Terminal
 
       print ' -- ', description
 
-      return print(': ' + formatter.yellow('pending') + formatter.vspace) unless block_given?
+      return print(': ' + terminal.yellow('pending') + terminal.newline) unless block_given?
 
       begin
-        result = yield
-      rescue => result
+        raw_result = yield
+      rescue => raw_result
       end
 
+      result = Result.new description, raw_result, caller
+
       Uspec::Stats.results << result
-      print ': ', formatter.colorize(result, caller), "\n"
+
+      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.results << Uspec::Result.new(message, error, caller)
     end
   end
 end

data/lib/uspec/result.rb

@@ -0,0 +1,115 @@
+require_relative "terminal"
+
+module Uspec
+  class Result
+    include Terminal
+
+    def initialize spec, raw, source
+      @spec = spec
+      @raw = raw
+      @source = source
+    end
+    attr_reader :spec, :raw, :source
+
+    def pretty
+      if raw == true then
+        green raw
+      elsif raw == false then
+        red raw
+      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('Unknown Result'), vspace,
+          hspace, 'Spec did not return a boolean value ', newline,
+          hspace, 'in spec at ', source.first, vspace,
+          hspace, red(klassinfo), inspector, newline
+        ].join
+      end
+    end
+
+    def trace
+      raw.backtrace.inject(String.new) do |text, line|
+        text << "#{hspace}#{line}#{newline}"
+      end
+    end
+
+    def message
+      "#{red klassinfo}#{raw.message}"
+    end
+
+    def klassinfo
+      superklass ? "#{klass} < #{superklass}: " : "#{klass}: "
+    end
+
+    # Attempts to inspect an object
+    def inspector
+      klass && klass.public_method_defined?(:inspect) ? raw.inspect : "#<#{klass}:0x#{get_id}>"
+    rescue Exception => error
+      return "#<#{klass}:0x#{get_id}>" if error.message.include? 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
+
+    # Returns the class of the object if it isn't already a class
+    def klass
+      Module === raw ? raw : ancestor_klasses[1]
+    end
+
+    # Returns the superclass of the object
+    def superklass
+      ancestor_klasses[2]
+    end
+
+    # Gets the object ID of an object
+    def get_id
+      raw.__id__.to_s(16) rescue 0
+    end
+
+    # Obtain the singleton class of an object
+    def singleton
+      @singleton ||= (class << raw; self; end) rescue raw.class
+    end
+
+    def ancestor_klasses
+      @ancestor_klasses ||= ancestors.select{|a| a.is_a? Class}
+    end
+
+    # Collects the ancestors of an object
+    def ancestors
+      @ancestors ||= safe_send singleton, :ancestors
+    end
+
+    # Works around BasicObject and other objects that are missing/overwrite important methods
+    def safe_send object, method, *args, &block
+      (Module === object ? Module : Object).instance_method(method).bind(object).call(*args, &block)
+    end
+
+    def inspect
+      "#{self.class} for `#{spec}` -> #{pretty}"
+    end
+  end
+end

data/lib/uspec/stats.rb

@@ -15,9 +15,16 @@ module Uspec
 
       def exit_code
         # checking for truthy isn't good enough, it must be exactly true!
-        failures = results.count{|result| result != true }
+        failures = results.count{|result| result.raw != true }
         failures > 255 ? 255 : failures
       end
+
+      def inspect
+        <<-INFO
+        #{super} Failures: #{exit_code}
+        #{results.map{|r| r.inspect}.join "\n\t" }
+        INFO
+      end
     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 = '0.2.1'
 end

data/uspec.gemspec

@@ -1,19 +1,27 @@
 # -*- 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_development_dependency "pry"
+  gem.add_development_dependency "pry-doc"
 end

data/uspec/cli_spec.rb

@@ -27,10 +27,10 @@ spec 'runs an individual spec' do
   output.include? 'I love passing tests'
 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,40 @@
+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 = "#<TestObject:"
+  actual =  result.pretty
+  actual.include?(expected) || result.inspector
+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; 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 error"
+  actual =  result.pretty
+  actual.include?(expected) || result.inspector
+end

data/uspec/uspec_spec.rb

@@ -33,15 +33,19 @@ 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
+    expected.times do |count|
+      spec "fail ##{count + 1}" do
         false
       end
     end
+
+    puts(Uspec::Stats.inspect) unless Uspec::Stats.exit_code == expected
   end
+  actual = $?.exitstatus
 
-  $?.exitstatus == 50 || $?
+  actual == expected || puts("", output) || $?
 end
 
 spec 'if more than 255 failures, exit status is 255' do

metadata

@@ -1,25 +1,54 @@
 --- !ruby/object:Gem::Specification
 name: uspec
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.1
 platform: ruby
 authors:
-- Anthony Cook
+- Anthony M. Cook
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-06-15 00:00:00.000000000 Z
-dependencies: []
+date: 2019-06-17 00:00:00.000000000 Z
+dependencies:
+- !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:
+- ".editorconfig"
 - ".gitignore"
 - ".ruby-gemset"
 - ".ruby-version"
@@ -34,16 +63,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 +85,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/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