visionmedia-jspec 2.8.4 → 2.9.0

data/server/browsers.rb

@@ -1,16 +1,228 @@
 
-module JSpec
-  class Browser
-    def open url
-      `open -g -a #{name} #{url}`
+require 'rbconfig'
+
+#--
+# Browser
+#++
+ 
+class Browser
+  
+  ##
+  # Check if the user agent _string_ matches this browser.
+  
+  def self.matches_agent? string; end
+  
+  ##
+  # Check if the browser matches the name _string_.
+  
+  def self.matches_name? string; end
+    
+  ##
+  # Subclasses.
+  
+  def self.subclasses
+    @subclasses ||= []
+  end
+  
+  ##
+  # Stack subclasses.
+  
+  def self.inherited subclass
+    subclasses << subclass
+  end
+  
+  ##
+  # Weither or not the browser is supported.
+  
+  def supported?; true end
+  
+  ##
+  # Server setup.
+  
+  def setup; end
+  
+  ##
+  # Server teardown.
+  
+  def teardown; end
+  
+  ##
+  # Host environment.
+ 
+  def host
+    Config::CONFIG['host']
+  end
+  
+  ##
+  # Check if we are using macos.
+  
+  def macos?
+    host.include? 'darwin'
+  end
+  
+  ##
+  # Check if we are using windows.
+  
+  def windows?
+    host.include? 'mswin'
+  end
+  
+  ##
+  # Check if we are using linux.
+  
+  def linux?
+    host.include? 'linux'
+  end
+  
+  ##
+  # Run applescript _code_.
+  
+  def applescript code
+    raise "Can't run AppleScript on #{host}" unless macos?
+    system "osascript -e '#{code}' 2>&1 >/dev/null"
+  end
+  
+  #--
+  # Firefox
+  #++
+  
+  class Firefox < self
+    def self.matches_agent? string
+      string =~ /firefox/i
+    end
+    
+    def self.matches_name? string
+      string =~ /ff|firefox|mozilla/i
+    end
+    
+    def visit uri
+      system "open -g -a Firefox '#{uri}'" if macos?
+      system "firefox #{uri}" if linux?
+      system "#{File.join(ENV['ProgramFiles'] || 'c:\Program Files', '\Mozilla Firefox\firefox.exe')} #{uri}" if windows? 
+    end
+    
+    def to_s
+      'Firefox'
+    end
+  end
+  
+  #--
+  # Safari
+  #++
+  
+  class Safari < self
+    def self.matches_agent? string
+      string =~ /safari/i && string !~ /chrome/i
+    end
+    
+    def self.matches_name? string
+      string =~ /safari/i
+    end
+    
+    def supported?
+      macos?
+    end
+
+    def setup
+      applescript 'tell application "Safari" to make new document'
+    end           
+                  
+    def visit uri 
+      applescript 'tell application "Safari" to set URL of front document to "' + uri + '"'
+    end
+    
+    def matches_agent? string
+      string =~ /safari/i
+    end
+
+    def to_s
+      'Safari'
+    end
+  end
+  
+  #--
+  # Chrome
+  #++
+  
+  class Chrome < self
+    def self.matches_agent? string
+      string =~ /chrome/i
+    end
+    
+    def self.matches_name? string
+      string =~ /google|chrome/i
+    end
+    
+    def supported?
+      macos?
+    end
+    
+    def visit uri
+      system "open -g -a Chromium #{uri}" if macos?
+    end
+    
+    def to_s
+      'Chrome'
+    end
+  end
+  
+  #--
+  # Internet Explorer
+  #++
+  
+  class IE < self
+    def self.matches_agent? string
+      string =~ /microsoft/i
+    end
+    
+    def self.matches_name? string
+      string =~ /ie|explorer/i
     end
     
-    def name
-      self.class.to_s.split('::').last
+    def supported?
+      windows?
     end
     
-    class Firefox < self; end
-    class Safari < self; end
-    class Opera < self; end
+    def setup
+      require 'win32ole'
+    end
+
+    def visit uri
+      ie = WIN32OLE.new 'InternetExplorer.Application'
+      ie.visible = true
+      ie.Navigate uri
+      while ie.ReadyState != 4 do
+        sleep 1
+      end
+    end
+
+    def to_s
+      'Internet Explorer'
+    end
+  end
+  
+  #--
+  # Opera
+  #++
+  
+  class Opera < self
+    def self.matches_agent? string
+      string =~ /opera/i
+    end
+    
+    def self.matches_name? string
+      string =~ /opera/i
+    end
+    
+    def visit uri
+      system "open -g -a Opera #{uri}" if macos?
+      system "c:\Program Files\Opera\Opera.exe #{uri}" if windows? 
+      system "opera #{uri}" if linux?
+    end
+    
+    def to_s
+      'Opera'
+    end
   end
-end
+  
+end

data/server/helpers.rb

@@ -0,0 +1,82 @@
+
+helpers do
+  
+  ##
+  # Return dotted assertion graph for _assertions_.
+  
+  def assertion_graph_for assertions
+    return if assertions.empty?
+    assertions.map do |assertion|
+      assertion['passed'] ? green('.') : red('.')
+    end.join
+  end
+  
+  ##
+  # Override Sinatra's #send_file to prevent caching.
+  
+  def send_file path, opts = {}
+    stat = File.stat(path)
+    response['Cache-Control'] = 'no-cache'
+    content_type media_type(opts[:type]) ||
+      media_type(File.extname(path)) ||
+      response['Content-Type'] ||
+      'application/octet-stream'
+    response['Content-Length'] ||= (opts[:length] || stat.size).to_s
+
+    if opts[:disposition] == 'attachment' || opts[:filename]
+      attachment opts[:filename] || path
+    elsif opts[:disposition] == 'inline'
+      response['Content-Disposition'] = 'inline'
+    end
+
+    halt ::Sinatra::Application::StaticFile.open(path, 'rb')
+  rescue Errno::ENOENT
+    not_found
+  end
+  
+  ##
+  # Find the browser name for the current user agent.
+  
+  def browser_name
+    Browser.subclasses.find do |browser|
+      browser.matches_agent? env['HTTP_USER_AGENT']
+    end.new
+  rescue
+    'Unknown'
+  end
+  
+  ##
+  # Wrap _string_ with ansi escape sequence using _code_.
+  
+  def color string, code
+    "\e[#{code}m#{string}\e[0m"
+  end
+  
+  ##
+  # Bold _string_.
+  
+  def bold string
+    color string, 1
+  end
+  
+  ##
+  # Color _string_ red.
+  
+  def red string  
+    color string, 31
+  end
+  
+  ##
+  # Color _string_ green.
+  
+  def green string
+    color string, 32
+  end
+  
+  ##
+  # Color _string_ blue.
+  
+  def blue string
+    color string, 34
+  end
+end

data/server/routes.rb

@@ -0,0 +1,57 @@
+
+get '/jspec/*' do |path|
+  send_file JSPEC_ROOT + '/lib/' + path
+end
+
+post '/results' do
+  require 'json'
+  data = JSON.parse request.body.read
+  if data['options'].include?('verbose') && data['options']['verbose'] ||
+     data['options'].include?('failuresOnly') && data['options']['failuresOnly']
+    puts "\n\n %s Passes: %s Failures: %s\n\n" % [
+      bold(browser_name), 
+      green(data['stats']['passes']), 
+      red(data['stats']['failures'])]
+    data['results'].compact.each do |suite|
+      specs = suite['specs'].compact.map do |spec|
+        case spec['status'].to_sym
+        when :pass 
+          next if data['options'].include?('failuresOnly') && data['options']['failuresOnly']
+          '  ' + green(spec['description']) + assertion_graph_for(spec['assertions']).to_s + "\n"
+        when :fail
+          "  #{red(spec['description'])}\n  #{spec['message']}\n\n"
+        else
+          "  #{blue(spec['description'])}\n" 
+        end
+      end.join
+      unless specs.strip.empty?
+        puts "\n " + bold(suite['description']) 
+        puts specs
+      end
+    end
+  else
+    puts "%20s Passes: %s Failures: %s" % [
+      bold(browser_name), 
+      green(data['stats']['passes']), 
+      red(data['stats']['failures'])]
+  end
+  halt 200
+end
+
+get '/*' do |path|
+  pass unless File.exists?(path)
+  send_file path
+end
+
+#--
+# Simulation Routes
+#++
+
+get '/slow/*' do |seconds|
+  sleep seconds.to_i
+  halt 200
+end
+
+get '/status/*' do |code|
+  halt code.to_i
+end

data/server/server.rb

@@ -1,100 +1,88 @@
 
-require 'rubygems'
-require 'rack'
-require 'server/browsers'
+$:.unshift File.dirname(__FILE__) 
+
+require 'sinatra'
+require 'thread'
+require 'browsers'
+require 'helpers'
+require 'routes'
 
 module JSpec
   class Server
-    attr_reader :responses, :browsers, :root
     
-    def initialize options = {}
-      @responses = []
-      @browsers = options.delete :browsers
-      @root = options.delete :root
-    end
+    ##
+    # Suite HTML.
     
-    def call env
-      request = Rack::Request.new env
-      path = request.path_info
-      body = case path
-      when '/'
-        agent = env['HTTP_USER_AGENT']
-        responses << browser(agent)
-        display_results browser(agent), request['failures'], request['passes']
-        type = 'text/plain'
-        'close'
-      when /jspec/
-        type = 'application/javascript'
-        File.read File.join(JSPEC_ROOT, 'lib', File.basename(path))
-      else
-        type = Rack::Mime.mime_type File.extname(path)
-        File.read File.join(root, path) rescue ''
-      end
-      [200, { 'Content-Type' => type, 'Content-Length' => body.length.to_s }, body]
-    end
-
-    def display_results browser, failures, passes
-      puts '%-14s - passes: %s failures: %s' % [bold(browser), green(passes), red(failures)]
-    end
-
-    def browser string
-      case string
-      when /Safari/  ; :Safari
-      when /Firefox/ ; :Firefox
-      when /MSIE/    ; :MSIE
-      when /Opera/   ; :Opera
-      end
-    end
-
-    def bold string
-      color string, 1
-    end
-
-    def red string
-      color string, 31
-    end
-
-    def green string
-      color string, 32
-    end
-
-    def color string, code
-      "\e[#{code}m#{string}\e[m"
+    attr_accessor :suite
+    
+    ##
+    # Host string.
+    
+    attr_reader :host
+    
+    ##
+    # Port number.
+    
+    attr_reader :port
+    
+    ##
+    # Server instance.
+    
+    attr_reader :server
+    
+    ##
+    # Initialize.
+    
+    def initialize suite, port
+      @suite, @port, @host = suite, port, :localhost
     end
     
-    def when_finished &block
-      Thread.new {
-        sleep 0.1 while responses.length < browsers.length
-        yield
-      }
+    ##
+    # URI formed by the given host and port.
+    
+    def uri
+      'http://%s:%d' % [host, port]
     end
     
-    def self.start options, spec
-      app = Rack::Builder.new do
-        server = JSpec::Server.new :browsers => options.browsers, :root => '.'
-        server.when_finished { exit }
-        run server
-      end
-      unless options.server_only
-        Thread.new { 
-          sleep 2
-          puts "Running browsers: #{options.browsers.join(', ')}\n\n"
-          run_browsers options.browsers, spec
+    ##
+    # Start the server with _browsers_ which defaults to all supported browsers.
+    
+    def start browsers = nil
+      browsers ||= Browser.subclasses.map { |browser| browser.new }
+      browsers.map do |browser|
+        Thread.new {
+          sleep 1
+          if browser.supported?
+            browser.setup
+            browser.visit uri + '/' + suite
+            browser.teardown
+          end
         }
-      end
-      puts "JSpec server started\n"
-      Rack::Handler::Mongrel.run app, :Port => 4444
-      self
+      end.push(Thread.new {
+        start!
+      }).reverse.each { |thread| thread.join }
     end
     
-    def self.run_browsers browsers, spec
-      browsers.each do |name|
-        browser(name).open "http://localhost:4444/#{spec}"
+    private
+    
+    #:nodoc:
+    
+    def start!
+      Sinatra::Application.class_eval do
+        begin
+          $stderr.puts 'Started JSpec server at http://%s:%d' % [host, port.to_i]
+          detect_rack_handler.run self, :Host => host, :Port => port do |server|
+            trap 'INT' do
+              server.respond_to?(:stop!) ? server.stop! : server.stop
+            end
+          end
+        rescue Errno::EADDRINUSE
+          raise "Port #{port} already in use"
+        rescue Errno::EACCES
+          raise "Permission Denied on port #{port}"
+        end
       end
     end
     
-    def self.browser name
-      eval("JSpec::Browser::#{name}").new
-    end
   end
 end

data/spec/server.rb

@@ -0,0 +1,2 @@
+
+puts 'Use spec/jspec.rb to alter anything you like, provide routes, browsers, etc'

data/spec/spec.jquery.js

@@ -20,16 +20,16 @@ describe 'jQuery'
   
   describe 'async'
     it 'should load mah cookies (textfile)'
-      $.post('async', function(text){
+      $.get('async', function(text){
         text.should_eql 'cookies!'
       })
     end
 
     it 'should load mah cookies twice (ensure multiple async requests work)'
-      $.post('async', function(text){
+      $.get('async', function(text){
         text.should.eql 'cookies!'
       })
-      $.post('async', function(text){
+      $.get('async', function(text){
         text.should.not.eql 'rawr'
       })
     end 

data/spec/spec.matchers.js

@@ -299,6 +299,7 @@ describe 'Matchers'
         addPets  : function(a, b) { return ['izzy', a, b] }
       }
     end
+    
     it 'should pass when the method is invoked'
       personWithPets.should.receive('getPets')
       personWithPets.getPets()

data/spec/spec.server.html

@@ -1,9 +1,9 @@
 <html>
 	<head>
 		<script src="http://ajax.googleapis.com/ajax/libs/jquery/1.3.1/jquery.min.js"></script>
-		<script src="jspec.js"></script>
-		<script src="jspec.jquery.js"></script>
-		<script src="jspec.xhr.js"></script>
+		<script src="/jspec/jspec.js"></script>
+		<script src="/jspec/jspec.jquery.js"></script>
+		<script src="/jspec/jspec.xhr.js"></script>
 		<script src="modules.js"></script>
 		<script src="spec.grammar-less.js"></script>
 		<script>
@@ -19,8 +19,8 @@
 				.exec('spec.modules.js')
 				.exec('spec.xhr.js')
 				.exec('spec.jquery.xhr.js')
-				.run()
-				.reportToServer()
+				.run({ formatter : JSpec.formatters.Server })
+				.report()
 			}
 		</script>
 	</head>

data/spec/spec.xhr.js

@@ -1,6 +1,6 @@
 
 describe 'JSpec'
-  describe '.mockRequest'
+  describe 'Mock XHR'
     before
       responseFrom = function(path) {
         request = new XMLHttpRequest
@@ -10,6 +10,11 @@ describe 'JSpec'
       }
     end
     
+    it 'should provide snake DSL methods'
+      mock_request.should.equal mockRequest
+      unmock_request.should.equal unmockRequest
+    end
+    
     it 'should mock XMLHttpRequests if unmockRequest() is called or the spec block has finished'
       original = XMLHttpRequest
       mockRequest().and_return('test')

data/templates/default/spec/server.rb

@@ -0,0 +1,4 @@
+
+get '/lib/*' do |path|
+  send_file File.dirname(__FILE__) + '/../lib/' + path
+end

data/templates/default/spec/spec.server.html

@@ -1,13 +1,13 @@
 <html>
 	<head>
-		<script src="jspec.js"></script>
-		<script src="../lib/yourlib.core.js"></script>
+		<script src="/jspec/jspec.js"></script>
+		<script src="/lib/yourlib.core.js"></script>
 		<script>
 			function runSuites() {
 				JSpec
 				.exec('spec.core.js')
-				.run()
-				.reportToServer()
+				.run({ formatter : JSpec.formatters.Server, verbose: true, failuresOnly: true })
+				.report()
 			}
 		</script>
 	</head>

data/templates/rails/server.rb

@@ -0,0 +1,4 @@
+
+get '/public/*' do |path|
+  send_file File.dirname(__FILE__) + '/../public/' + path
+end

data/templates/rails/spec.server.html

@@ -1,13 +1,13 @@
 <html>
 	<head>
-		<script src="jspec.js"></script>
-		<script src="../public/javascripts/application.js"></script>
+		<script src="/jspec/jspec.js"></script>
+		<script src="/public/javascripts/application.js"></script>
 		<script>
 			function runSuites() {
 				JSpec
 				.exec('spec.application.js')
-				.run()
-				.reportToServer()
+				.run({ formatter : JSpec.formatters.Server, verbose: true, failuresOnly: true })
+				.report()
 			}
 		</script>
 	</head>