nyan 0.0.1

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+.rvmrc
+Gemfile.lock
+pkg/*

data/.rspec

@@ -0,0 +1 @@
+--colour

data/Gemfile

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

data/Guardfile

@@ -0,0 +1,6 @@
+guard 'rspec', :version => 2 do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+end
+

data/README.md

@@ -0,0 +1,80 @@
+Nyan ![travis-ci](https://secure.travis-ci.org/textgoeshere/nyan.png)
+==================
+
+Your favourite aging meme is reheated as an RSpec custom formatter.
+
+For entertainment purposes only.
+
+FAQ
+---
+
+* Didn't this meme jump the shark, like, ages ago?
+
+Yes.
+
+* It's got no tail
+
+Look closer.
+
+* It's got no feet!
+
+LOOK CLOSER.
+
+* It's really slow
+
+Write faster specs.
+
+* It's still really slow
+
+Send me a pull request where the animation runs in a separate thread.
+
+* The colours are all wrong
+
+Probably need a new graphics card or something.
+
+Requirements
+------------
+
+* RSpec 2 (tested against RSpec 2.6)
+
+Install
+-------
+
+Add to your `Gemfile` (usually inside your `:test` group):
+
+    gem "nyan"
+
+Alternatively install directly:
+
+    $ gem install nyan
+
+Usage
+-----
+
+    $ rspec spec -f Nyan::Formatter
+
+Or if you want the joy of Nyan without running specs, use the binary:
+
+    $ nyan
+
+Your terminal should be at least 180 columns x 50 rows.
+
+Development
+-----------
+
+* Source hosted at [GitHub](https://github.com/kapoq/nyan)
+* Report issues/Questions/Feature requests on [GitHub Issues](https://github.com/kapoq/nyan)
+* CI at [Travis](http://travis-ci.org/#!/textgoeshere/nyan)
+
+Pull requests are very welcome! Make sure your patches are well tested. Please create a topic branch for every separate change
+you make.
+
+Testing
+-------
+
+    $ rake
+
+Author
+------
+
+[Dave Nolan](https://github.com/textgoeshere)

data/Rakefile

@@ -0,0 +1,7 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/bin/nyan.rb

@@ -0,0 +1,11 @@
+#!/usr/bin/env ruby
+nyan_dir = File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(nyan_dir) unless $LOAD_PATH.include?(nyan_dir)
+require "nyan"
+
+print cls
+flight = Nyan::Flight.new
+loop do
+  flight.next!
+end
+  

data/lib/nyan.rb

@@ -0,0 +1,20 @@
+require "nyan/version"
+
+require "nyan/colour"
+require "nyan/shape"
+require "nyan/sprite"
+require "nyan/stage"
+
+require "nyan/flight"
+
+module Nyan
+  BLOCK   = "\u2588"
+  SPACE   = "\x20"
+  NEWLINE = "\n"
+  
+  require "nyan/sprites/rainbow"
+  require "nyan/sprites/cat_head"
+  require "nyan/sprites/pop_tart"
+  require "nyan/sprites/tail"
+  require "nyan/sprites/star"
+end

data/lib/nyan/colour.rb

@@ -0,0 +1,27 @@
+require "ansi"
+include ANSI::Code
+
+module Nyan
+  module Colour    
+    MAP = {
+      "#" => "#{bright}#{black}",
+      "b" => "#{dark}#{black}",
+      "R" => "#{bright}#{magenta}",
+      "p" => "#{dark}#{magenta}",
+      "2" => "#{bright}#{yellow}",
+      "`" => "#{dark}#{yellow}",
+      "o" => "#{bright}#{white}",
+      "_" => "#{bright}#{white}",
+      "." => "#{dark}#{white}",
+      "1" => "#{bright}#{red}",
+      "3" => "#{bright}#{green}",
+      "4" => "#{bright}#{blue}",
+      "5" => "#{bright}#{magenta}"
+    }
+
+    def self.colourize(char)
+      escape_codes = MAP.fetch(char, reset)
+      "#{escape_codes}#{Nyan::BLOCK}"
+    end
+  end
+end

data/lib/nyan/flight.rb

@@ -0,0 +1,51 @@
+module Nyan
+  class Flight
+    def initialize
+      @stage   = Stage.new
+      
+      @rainbow  = Sprite.new(:x => 0, :y => 17, :z => 1, :frames => Nyan::Rainbow.to_frames)
+
+      @cat_head = Sprite.new(:x        => Nyan::Rainbow::TOTAL_LENGTH - 2,
+                            :y         => 17,
+                            :z         => 100,
+                            :frames    => Nyan::CatHead.to_frames,
+                            :animation => Proc.new do
+                              @initial_x ||= @x
+                              @initial_y ||= @y
+                              case offset = [@x == @initial_x && :initial || :offset, @y == @initial_y && :initial || :offset]
+                              when [:initial, :initial] then @y -= 2
+                              when [:initial, :offset]  then @x += 2
+                              when [:offset, :offset]   then @y += 2
+                              when [:offset, :initial]  then @x -= 2
+                              end
+                            end)
+
+      @pop_tart = Sprite.new(:x => @cat_head.x - 20,
+                            :y => @cat_head.y - 2,
+                            :z => @cat_head.z - 1,
+                            :frames => Nyan::PopTart.to_frames)
+      
+      @stage.add_sprite(@rainbow)
+      @stage.add_sprite(@cat_head)
+      @stage.add_sprite(@pop_tart)
+      @tick_time = Time.now
+    end
+
+    def next!
+      if rand > 0.85
+        speed = rand > 0.5 ? 2 : 5
+        star = Sprite.new(:x           => @stage.width,
+                          :y           => rand(@stage.height - 11),
+                          :z           => 0,
+                          :speed       => speed,
+                          :frames      => Nyan::Star.to_frames,
+                          :frame_index => rand(Nyan::Star.to_frames.length - 1),
+                          :animation   => Proc.new { self.x -= @options[:speed] })
+        @stage.add_sprite(star)
+      end
+      @stage.play!
+      loop until Time.now - @tick_time >= 0.09
+      @tick_time = Time.now
+    end
+  end
+end

data/lib/nyan/formatter.rb

@@ -0,0 +1,44 @@
+require 'rspec/core/formatters/base_text_formatter'
+require 'nyan'
+
+module Nyan
+  class Formatter < RSpec::Core::Formatters::BaseTextFormatter
+    def initialize(*args)
+      super
+      @nyan_flight = Nyan::Flight.new
+      @still_passing = true
+      print cls
+      puts "Awaiting Nyan..."
+    end
+    
+    def example_passed(_)
+      @nyan_flight.next! if @still_passing
+    end
+
+    def example_failed(example)
+      super
+      @output.print cls
+      @output.print move(0,0)
+      @output.puts red("NO NYAN FOR YOU")
+      @still_passing = false
+    end
+
+    def dump_failures
+      return if failed_examples.empty?
+      output.puts
+      output.puts "Failures:"
+      failed_examples.each_with_index do |example, index|
+        output.puts
+        dump_pending_example_fixed(example, index) || dump_failure(example, index)
+        dump_backtrace(example)
+      end
+    end
+
+    def dump_backtrace(example)
+      format_backtrace(example.execution_result[:exception].backtrace, example).each do |backtrace_info|
+        output.puts cyan("         # #{backtrace_info}")
+      end
+    end
+
+  end
+end

data/lib/nyan/shape.rb

@@ -0,0 +1,16 @@
+module Nyan
+  module Shape
+    attr_accessor :top, :bottom, :left, :right
+
+    def outside?(other_shape)
+      (right < other_shape.left)   or
+        (top > other_shape.bottom) or
+        (left > other_shape.right) or
+        (bottom < other_shape.top)
+    end
+
+    def inside?(other_shape)
+      !outside(other_shape)
+    end
+  end
+end

data/lib/nyan/sprite.rb

@@ -0,0 +1,60 @@
+# -*- coding: utf-8 -*-
+module Nyan
+  class Sprite
+    include Shape
+    
+    attr_accessor :x, :y, :z, :frames, :frame_index
+    attr_reader   :blk
+
+    def initialize(options = {}, &blk)
+      @options = options
+      self.x = @options.fetch(:x, 0)
+      self.y = @options.fetch(:y, 0)
+      self.z = @options.fetch(:z, 0)
+      self.frames      = @options.fetch(:frames, [])
+      self.frame_index = @options.fetch(:frame_index, 0)
+      @blk = blk || @options[:animation]
+    end
+
+    def frame
+      frames[frame_index]
+    end
+
+    def lines
+      frame.lines    
+    end
+
+    def animate!
+      self.frame_index = (self.frame_index + 1) % frames.length
+      self.instance_eval(&blk) if blk
+    end
+
+    def height
+      @height ||= frame.lines.count
+    end
+
+    def width
+      @width ||= frame.lines.map { |l| l.chomp.unansi.length }.max
+    end
+
+    def top
+      y
+    end
+
+    def bottom
+      y + height
+    end
+
+    def left
+      x
+    end
+
+    def right
+      x + width
+    end
+
+    def <=>(other)
+      z <=> other.z
+    end
+  end
+end

data/lib/nyan/sprites/cat_head.rb

@@ -0,0 +1,26 @@
+module Nyan
+    module CatHead
+    SHAPE =<<EOF
+ #                     #
+#.###               ###.#
+#....##            ##...#
+#__....############...__#
+ ___...#..........#..___
+ #__.................__#
+ #.....................#
+  #....o#.......o#....#
+  #....##.......##....#
+  #........b.b........#
+  #.p.......b.......p.#
+   #.p.b....b....b.p.#
+   #...b....b....b...#
+   #....bbbb.bbbb....#
+    ###...........###
+       ###########
+EOF
+
+    def self.to_frames
+      @frames ||= Array(SHAPE)
+    end
+  end
+end

data/lib/nyan/sprites/pop_tart.rb

@@ -0,0 +1,28 @@
+module Nyan
+    module PopTart
+    SHAPE =<<-EOF
+     ooooooooooooooooooooooooooooo
+    o22222222222222222222222222222o
+   o222222ppppppppppppppppp22222222o
+  o22222ppppppRRRpppppppppppppppp222o
+  o22pppppppppRRRppppppppppppppppp22o
+ o22pppppRRRppRRRpppppppRRpppppppp222o
+ o222ppppRRRppppppppppppRppppppppp222o
+ o222pppppppppppppppppppRpppppppppp22o
+  o222ppppRRRppppppRRRppppppppppp222o
+  o222ppppRRRppppppRRRppppppppppp2222o
+ o22pppppppppppppppppppppppppppp22222o
+ o22ppppppppRRRpppppppppppppppppp2222o
+ o22ppppppppRRRppppppRRRppppppppp2222o
+ o22ppppppppRRRppppppRRRppppppppp2222o
+ o22pppppppppppppppppRRRpppppppppp222o
+ o222pppppppppppppppppppppppppppp2222o
+ o222222ppppppppppppppppp222222222222o
+  ooooooooooooooooooooooooooooooooooo  
+EOF
+
+    def self.to_frames
+      @fames ||= Array(SHAPE)
+    end
+  end
+end

data/lib/nyan/sprites/rainbow.rb

@@ -0,0 +1,45 @@
+module Nyan
+  module Rainbow
+    BAND_HEIGHT = 3
+    BEND_LENGTH = 18
+    SECTIONS    = 5
+
+    COLOURS = %w(1 2 3 4 5)
+    BLANK   = ([Nyan::SPACE] * BEND_LENGTH).join
+
+    FRAME_HEIGHT = COLOURS.length * BAND_HEIGHT + 1
+    FRAME_WIDTH  = SECTIONS * BEND_LENGTH
+
+    TOTAL_LENGTH = SECTIONS * BEND_LENGTH
+    TOTAL_HEIGHT = BAND_HEIGHT * COLOURS.length
+
+    SLICE = COLOURS.each_with_object([]) do |colour, slice|
+      BAND_HEIGHT.times do
+        slice << "#{colour}" * BEND_LENGTH
+      end
+    end    
+
+    def self.frame(is_peak = true)
+      frame_rows = Array.new(FRAME_HEIGHT + 1) { String.new }
+      
+      SECTIONS.times do
+        this_slice = SLICE.dup
+        FRAME_HEIGHT.times do |i|
+          this_row = if (is_peak && i == FRAME_HEIGHT - 1) or (!is_peak && i == 0)
+                       BLANK
+                     else
+                       this_slice.shift
+                     end
+          frame_rows[i] << this_row
+        end
+        is_peak = !is_peak
+      end
+
+      frame_rows.join(NEWLINE)
+    end
+    
+    def self.to_frames
+      @frames ||= [frame(true), frame(false)]
+    end
+  end
+end

data/lib/nyan/sprites/star.rb

@@ -0,0 +1,81 @@
+module Nyan
+  module Star
+    SHAPE_LIST =<<EOF
+...........
+...........
+...........
+...........
+...........
+.....X.....
+...........
+...........
+...........
+...........
+...........
+--
+...........
+...........
+...........
+...........
+.....X.....
+....X.X....
+.....X.....
+...........
+...........
+...........
+...........
+--
+...........
+...........
+...........
+.....X.....
+.....X.....
+...XX.XX...
+.....X.....
+.....X.....
+...........
+...........
+...........
+--
+...........
+.....X.....
+.....X.....
+.....X.....
+...........
+.XXX.X.XXX.
+...........
+.....X.....
+.....X.....
+.....X.....
+...........
+--
+...........
+....XXX....
+...X...X...
+.X.......X.
+X.........X
+X.........X
+X.........X
+.X.......X.
+..X.....X..
+....XXX....
+...........
+--
+.....X.....
+...........
+...........
+...........
+...........
+X.........X
+...........
+...........
+...........
+...........
+.....X.....
+EOF
+
+    def self.to_frames
+      @frames ||= SHAPE_LIST.gsub(/\./, SPACE).gsub(/X/, BLOCK).split(/--./m)
+    end
+  end
+end

data/lib/nyan/sprites/tail.rb

@@ -0,0 +1,27 @@
+module Nyan
+    module Tail
+    SHAPE_LIST =<<-EOF
+..................
+..................
+..................
+..................
+..................
+--
+..................
+..................
+..................
+..................
+..................
+--
+..................
+..................
+..................
+..................
+..................
+EOF
+
+    def self.to_frames
+      @frames ||= SHAPE_LIST.gsub(/\./, SPACE).gsub(/X/, BLOCK).split(/--./m)
+    end
+  end    
+end

data/lib/nyan/stage.rb

@@ -0,0 +1,109 @@
+module Nyan
+  class Stage
+    include Shape
+
+    SPACE   = "\x20"
+    NOTHING = ""
+    
+    attr_reader :output, :height, :width
+    
+    def initialize(options = {})
+      @output   = options.fetch(:output, $stdout)
+      @height   = options.fetch(:height, ANSI::Terminal.terminal_height)
+      @width    = options.fetch(:width, ANSI::Terminal.terminal_width)
+      @coloured = options.fetch(:coloured, true)
+      clear_buffer
+    end
+    
+    def sprites
+      @sprites ||= []
+    end
+    
+    def add_sprite(sprite)
+      self.sprites.push(sprite)
+    end
+
+    def remove_sprite(sprite)
+      self.sprites.delete(sprite)
+    end
+
+    def play!
+      render
+      animate!
+      clean!
+    end
+
+    def render
+      clear_buffer
+      sprites.sort.each { |s| write_to_buffer(s) }
+      print_buffer
+    end
+
+    def animate!
+      sprites.each { |s| s.animate! }
+    end
+
+    def clean!
+      sprites.delete_if { |s| s.outside?(self) }
+    end
+
+    def top
+      0
+    end
+
+    def bottom
+      height - 1
+    end
+
+    def left
+      0
+    end
+
+    def right
+      width - 1
+    end
+
+    def coloured?
+      @coloured
+    end
+
+    private
+
+    def clear_buffer
+      @buffer = Array.new(height) do
+        Array.new(width) do
+          { :char => SPACE, :colourized_char => SPACE }
+        end
+      end
+    end
+    
+    def write_to_buffer(sprite)
+      sprite.lines.each_with_index do |line, i|
+        line_y = sprite.y + i
+        previous_colourized_char = nil
+        if line_y.between?(top, bottom)
+          line.chomp.chars.each_with_index do |char, j|
+            char_x = sprite.x + j
+            if char_x.between?(left, right) && char != Nyan::SPACE
+              colourized_char = Colour.colourize(char)
+              colourized_char = Nyan::BLOCK if colourized_char == previous_colourized_char
+              @buffer[line_y][char_x] = { :char => char, :colourized_char => colourized_char }
+              previous_colourized_char = colourized_char
+            end
+          end
+        end
+      end
+    end
+
+    def print_buffer
+      key = coloured? ? :colourized_char : :char
+      @buffer.each_with_index do |row, i|
+        output.print move(i, 0)
+        output.print clear_line
+        output.print reset
+        output.print row.map { |h| h[key] }.join
+        output.print "\n" unless i == bottom
+      end
+    end
+  end
+end

data/lib/nyan/version.rb

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

data/nyan.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "nyan/version"
+
+Gem::Specification.new do |s|
+  s.name        = "nyan"
+  s.version     = Nyan::VERSION
+  s.authors     = ["dave@kapoq.com"]
+  s.email       = ["dave@kapoq.com"]
+  s.homepage    = "https://github.com/kapoq/nyan_formatter"
+  s.summary     = "Nyan Cat flies across your terminal while your RSpec specs run!"
+  s.description = "Your favourite aging meme is reheated as an RSpec custom formatter. For entertainment purposes only. WARNING: enterprise-ready"
+
+  s.add_dependency "ansi"
+  s.add_dependency "rspec"
+  
+  s.add_development_dependency "guard-rspec"
+  s.add_development_dependency "rake"
+  if RUBY_PLATFORM =~ /linux/
+    s.add_development_dependency "rb-inotify"
+    s.add_development_dependency "libnotify"
+  end
+  
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/spec/lib/colour_spec.rb

@@ -0,0 +1,15 @@
+require 'spec_helper'
+
+describe Nyan::Colour do
+  describe ".colourize" do
+    it "looks up the char in the map" do
+      Nyan::Colour::MAP.should_receive(:fetch).with("X", anything)
+      Nyan::Colour.colourize("X")
+    end
+    
+    it "returns the escape code for the colour followed by a block char" do
+      Nyan::Colour::MAP.stub(:fetch => "__ESC__")
+      Nyan::Colour.colourize("X").should eql "__ESC__#{Nyan::BLOCK}"
+    end
+  end
+end

data/spec/lib/shape_spec.rb

@@ -0,0 +1,41 @@
+require 'spec_helper'
+
+class SimpleShape
+  include ::Nyan::Shape
+
+  def initialize
+    @top, @bottom, @left, @right = [0, 0, 0, 0]    
+  end
+end
+
+describe Nyan::Shape do
+  let(:shape) { SimpleShape.new }
+  
+  describe "#outside?" do
+    let(:other_shape) { SimpleShape.new }
+
+    it "is outside when its right edge is beyond the left edge of the other shape" do
+      shape.right = other_shape.left - 1
+      shape.should be_outside(other_shape)
+    end
+    
+    it "is outside when its left edge is beyond the right edge of the other shape" do
+      shape.left = other_shape.right + 1
+      shape.should be_outside(other_shape)
+    end
+    
+    it "is outside when its top edge is below the bottom edge of the other shape" do
+      shape.top = other_shape.bottom + 1
+      shape.should be_outside(other_shape)
+    end
+    
+    it "is outside when its bottom edge is above the top edge of the other shape" do
+      shape.bottom = other_shape.top - 1
+      shape.should be_outside(other_shape)
+    end
+
+    it "is not outside when its edges are all within the edges of the other shape" do
+      shape.should_not be_outside(other_shape)
+    end
+  end
+end

data/spec/lib/sprite_spec.rb

@@ -0,0 +1,124 @@
+require 'spec_helper'
+
+describe Nyan::Sprite do
+  let(:output) { StringIO.new }
+  let(:sprite) { Nyan::Sprite.new }
+  let(:frame1) { double(:frame1) }
+  let(:frame2) { double(:frame2) }
+  let(:frames) { [frame1, frame2] }
+
+  describe "#initialize" do
+    it "accepts optional x, y, and frames parameters and sets its instance variables to their values" do
+      sprite = Nyan::Sprite.new(:x => 1, :y => 2, :z => 3, :frames => frames, :frame_index => 4)
+      sprite.x.should == 1
+      sprite.y.should == 2
+      sprite.z.should == 3
+      sprite.frame_index.should == 4
+      sprite.frames.should == frames
+    end
+
+    describe "defaults" do
+      it "x = 0" do
+        sprite.x.should == 0
+      end
+
+      it "y = 0" do
+        sprite.y.should == 0
+      end
+      
+      it "z = 0" do
+        sprite.z.should == 0
+      end
+
+      it "frames is an empty array" do
+        sprite.frames.should == []
+      end
+
+      it "frame_index = 0" do
+        sprite.frame_index.should == 0
+      end
+    end
+
+    it "accepts an block which is executed each animation step" do
+      sprite = Nyan::Sprite.new(:frames => frames) do
+        self.x = 99
+      end
+      sprite.should_receive(:x=).with(99)
+      sprite.animate!
+    end
+
+    it "accepts a Proc as an optional animation parameter which is executed each animation step" do
+      sprite = Nyan::Sprite.new(:frames => frames, :animation => Proc.new { self.x = 99 })
+      sprite.should_receive(:x=).with(99)
+      sprite.animate!
+    end
+
+    it "has left at x" do
+      sprite.x = 99
+      sprite.left.should == 99
+    end
+
+    it "has right at x + width" do
+      sprite.x = 99
+      sprite.stub(:width => 99)
+      sprite.right.should == 198
+    end
+
+    it "has top at y" do
+      sprite.y = 77
+      sprite.top.should == 77
+    end
+
+    it "has bottom at y + height" do
+      sprite.y = 77
+      sprite.stub(:height => 99)
+      sprite.bottom.should == 176
+    end
+  end
+
+  describe "frames" do
+    before do
+      sprite.frames = frames
+    end
+
+    describe "#frames" do
+      it "returns array of frames" do
+        sprite.frames.should eql frames
+      end
+    end
+
+    describe "#frame" do
+      it "returns the current frame" do
+        sprite.frame.should eql frame1
+      end
+    end
+    
+    describe "#animate!" do
+      it "sets current frame to the next frame, looping to the start when necessary" do
+        sprite.frame_index = 1
+        sprite.animate!
+        sprite.frame.should eql frame1
+      end
+    end
+  end
+
+  it "has a height equal to the number of lines in the frame" do
+    sprite.frames = ["1\n2\n3\n4"]
+    sprite.height.should == 4
+  end
+
+  it "has a width equal to the number of characters in widest line of the frame excluding line breaks" do
+    sprite.frames = ["1\n22\n333\n22\n22"]
+    sprite.width.should == 3
+  end
+
+  describe "#<=>" do
+    let(:a) { double("Sprite a") }
+    let(:b) { double("Sprite b") }
+    
+    it "sorts by z" do
+      a.should_receive(:<=>).with(b)
+      a <=> b
+    end
+  end
+end

data/spec/lib/stage_spec.rb

@@ -0,0 +1,175 @@
+require 'spec_helper'
+
+describe Nyan::Stage do
+  let(:output) { StringIO.new }
+  let(:stage)  { Nyan::Stage.new(:output => output, :height => 5, :width => 5, :coloured => false) }
+  let(:sprite) { mock(:sprite) }
+
+  before do
+
+  end
+  
+  describe "#initialize" do
+    context "when output parameter is present" do
+      it "sets output to the value of the output parameter" do
+        stage = Nyan::Stage.new(:output => output)
+        stage.output.should eql output
+      end
+    end
+
+    context "defaults" do
+      let(:default_stage) { Nyan::Stage.new }
+
+      it "sets output to $stdout" do
+        default_stage.output.should eql $stdout
+      end
+
+      it "is coloured" do
+        default_stage.should be_coloured
+      end
+
+      it "has a height equal to the terminal height" do
+        ::ANSI::Terminal.stub(:terminal_height => 99)
+        default_stage.height.should == 99
+      end
+
+      it "has a width equal to the terminal width" do
+        ::ANSI::Terminal.stub(:terminal_width => 99)
+        default_stage.width.should == 99
+      end
+      
+      it "has top at 0" do
+        default_stage.top.should == 0
+      end
+
+      it "has left at 0" do
+        default_stage.left.should == 0
+      end
+
+      it "has right at width - 1" do
+        width = 99
+        default_stage.stub :width => width
+        default_stage.right.should == width - 1
+      end
+
+      it "has bottom at height - 1" do
+        height = 99
+        default_stage.stub :height => height
+        default_stage.bottom.should == height - 1
+      end
+    end
+  end
+  
+  describe "#add_sprite" do
+    it "adds a sprite" do
+      stage.add_sprite(sprite)
+      stage.sprites.should include(sprite)
+    end
+  end
+
+  describe "#remove_sprite" do
+    it "removes a sprite" do
+      sprite1 = double(:sprite1)
+      sprite2 = double(:sprite2)
+      stage.add_sprite(sprite1)
+      stage.add_sprite(sprite2)
+      stage.remove_sprite(sprite1)
+      stage.sprites.should == [sprite2]
+    end
+  end
+
+  describe "#play!" do
+    it "renders, animates, and cleans" do
+      stage.should_receive(:render)
+      stage.should_receive(:animate!)
+      stage.should_receive(:clean!)
+      stage.play!
+    end
+  end
+  
+  describe "#render" do
+    let(:sprites) { double("Sprites") }
+    let(:sprite)  { Nyan::Sprite.new }
+    
+    before do
+      stage.stub(:sprites => sprites)
+      sprites.stub(:sort  => [sprite])
+    end
+      
+    it "renders its sprites to its output in order of z-index" do
+      sprites.should_receive(:sort).and_return([])
+      stage.render
+    end
+
+    it "prints each sprite to the output" do
+      sprite.frames = %w(XXXX)
+      stage.render
+      output.string.should =~ /XXXX/
+    end
+
+    it "only prints characters within the viewport" do
+      stage.stub(:height => 1, :width => 1)
+      sprite.x = -1
+      sprite.y = -1
+      sprite.frames = ["OOO\nOXO\nOOO"]
+      stage.render
+      output.string.should =~ /X/
+      output.string.should_not =~ /O/
+    end
+    
+    it "renders each sprite at its correct position" do
+      sprite.x = stage.right
+      sprite.y = stage.bottom
+      sprite.frames = %w(X)
+      stage.render
+      output.string.unansi.should =~ /X$/
+    end
+
+    context "when coloured" do
+      before do
+        stage.stub(:coloured? => true)
+      end
+      
+      it "prints coloured chars" do
+        Nyan::Colour.stub(:colourize => "__COLOURED__")
+        sprite.frames = %w(x)
+        stage.render
+        output.string.should =~ /__COLOURED__/
+      end
+    end
+  end
+
+  describe "#clean!" do
+    before do
+      stage.stub(:sprites => [sprite])
+    end
+    
+    it "checks whether the sprite is outside the stage" do
+      sprite.should_receive(:outside?).with(stage)
+      stage.clean!
+    end
+
+    it "removes sprites outside the stage" do
+      sprite.stub(:outside? => true)
+      stage.clean!
+      stage.sprites.should_not include(sprite)
+    end
+    
+    it "does not remove sprites inside the stage" do
+      sprite.stub(:outside? => false)
+      stage.clean!
+      stage.sprites.should include(sprite)
+    end
+  end
+
+  describe "#animate!" do
+    before do
+      stage.add_sprite(sprite)
+    end
+
+    it "updates its sprites to their next frame" do
+      sprite.should_receive(:animate!)
+      stage.animate!
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1 @@
+require 'nyan'

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: nyan
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- dave@kapoq.com
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2011-10-07 00:00:00.000000000 +02:00
+default_executable: 
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ansi
+  requirement: &10658100 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *10658100
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: &10657680 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: *10657680
+- !ruby/object:Gem::Dependency
+  name: guard-rspec
+  requirement: &10657260 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *10657260
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: &10705640 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *10705640
+- !ruby/object:Gem::Dependency
+  name: rb-inotify
+  requirement: &10705180 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *10705180
+- !ruby/object:Gem::Dependency
+  name: libnotify
+  requirement: &10704760 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: *10704760
+description: ! 'Your favourite aging meme is reheated as an RSpec custom formatter.
+  For entertainment purposes only. WARNING: enterprise-ready'
+email:
+- dave@kapoq.com
+executables:
+- nyan.rb
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- Gemfile
+- Guardfile
+- README.md
+- Rakefile
+- bin/nyan.rb
+- lib/nyan.rb
+- lib/nyan/colour.rb
+- lib/nyan/flight.rb
+- lib/nyan/formatter.rb
+- lib/nyan/shape.rb
+- lib/nyan/sprite.rb
+- lib/nyan/sprites/cat_head.rb
+- lib/nyan/sprites/pop_tart.rb
+- lib/nyan/sprites/rainbow.rb
+- lib/nyan/sprites/star.rb
+- lib/nyan/sprites/tail.rb
+- lib/nyan/stage.rb
+- lib/nyan/version.rb
+- nyan.gemspec
+- spec/lib/colour_spec.rb
+- spec/lib/shape_spec.rb
+- spec/lib/sprite_spec.rb
+- spec/lib/stage_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: https://github.com/kapoq/nyan_formatter
+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.6.2
+signing_key: 
+specification_version: 3
+summary: Nyan Cat flies across your terminal while your RSpec specs run!
+test_files: []