js_spec 0.3.1 → 0.3.2

data/CHANGES

@@ -1,3 +1,6 @@
+0.3.2
+- Fixed vendor directory not being included in the gem
+
 0.3.1
 - Client accepts selenium_browser_start_command parameter, which allows the user to parameterize the selenium_browser_start_command
 

data/Rakefile

@@ -26,14 +26,15 @@ def run_suite
 end
 
 PKG_NAME = "js_spec"
-PKG_VERSION = "0.3.1"
+PKG_VERSION = "0.3.2"
 PKG_FILES = FileList[
   '[A-Z]*',
   '*.rb',
   'lib/**/*.rb',
   'core/**',
   'bin/**',
-  'spec/**/*.rb'
+  'spec/**/*.rb',
+  'vendor/**/*'
 ]
 
 spec = Gem::Specification.new do |s|

data/vendor/js-test-core/CHANGES

@@ -0,0 +1,15 @@
+- Remove File caching because it doesn't cause a noticable performance benefit over a local network and because it sometimes doesn't write over stale files.
+- Client accepts selenium_browser_start_command parameter, which allows the user to parameterize the selenium_browser_start_command
+- Added support for running specs in Internet Explorer via POST /runners/iexplore
+- Resource file download performance improvements via caching and chunked sending
+- Fixed false positive bug when Client connection times out
+
+0.1.1
+- SuiteFinish#post immediately closes the connection
+
+0.1.0
+- Initial Release extracted from JsTestCore.
+- Added JsTestCore::WebRoot.dispatch_specs and .dispatch_strategy
+- Extracted JsTestCore::Resources::Specs::SpecDir
+- Extracted JsTestCore::Resources::Specs::SpecFile
+- No longer depending on Guid. The child libraries are responsible for obtaining the Selenium session_id from the client by using top.runOptions.getSessionId().

data/vendor/js-test-core/README

@@ -0,0 +1,12 @@
+= JsTestCore
+The JsTestCore library is the core javascript test server library used by several JS Test server libraries.
+
+To hook up your own JS Test framework:
+  * You will need to call either JsTestCore::Resources::WebRoot.dispatch_specs or JsTestCore::Resources::WebRoot.dispatch_tests
+    depending if you are serving specs or tests.
+  * Set JsTestCore.core_path to the directory of the client side test framework (javascript files)
+  * Override JsTestCore::Resources::Specs::SpecFile#get or JsTestCore::Resources::Specs::TestFile#get
+  * Override JsTestCore::Resources::Specs::SpecDir#get or JsTestCore::Resources::Specs::TestDir#get
+
+NOTE: The current version of JsTestCore does not yet support tests. Support will be added soon.
+      I just wanted the test stuff to be in the docs to establish the current architectural direction.

data/vendor/js-test-core/Rakefile

@@ -0,0 +1,72 @@
+require "rake"
+require 'rake/gempackagetask'
+require 'rake/contrib/rubyforgepublisher'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc "Runs the Rspec suite"
+task(:default) do
+  run_suite
+end
+
+desc "Runs the Rspec suite"
+task(:spec) do
+  run_suite
+end
+
+desc "Copies the trunk to a tag with the name of the current release"
+task(:tag_release) do
+  tag_release
+end
+
+def run_suite
+  dir = File.dirname(__FILE__)
+  system("ruby #{dir}/spec/spec_suite.rb") || raise("Example Suite failed")
+end
+
+PKG_NAME = "js_test_core"
+PKG_VERSION = "0.1.1"
+PKG_FILES = FileList[
+  '[A-Z]*',
+  '*.rb',
+  'lib/**/*.rb',
+  'core/**',
+  'bin/**',
+  'spec/**/*.rb'
+]
+
+spec = Gem::Specification.new do |s|
+  s.name = PKG_NAME
+  s.version = PKG_VERSION
+  s.summary = "The JsTestCore library is the core javascript test server library used by several JS Test server libraries."
+  s.test_files = "spec/spec_suite.rb"
+  s.description = s.summary
+
+  s.files = PKG_FILES.to_a
+  s.require_path = 'lib'
+
+  s.has_rdoc = true
+  s.extra_rdoc_files = [ "README", "CHANGES" ]
+  s.rdoc_options = ["--main", "README", "--inline-source", "--line-numbers"]
+
+  s.test_files = Dir.glob('spec/*_spec.rb')
+  s.require_path = 'lib'
+  s.author = "Brian Takita"
+  s.email = "brian@pivotallabs.com"
+  s.homepage = "http://pivotallabs.com"
+  s.rubyforge_project = "pivotalrb"
+  s.add_dependency('Selenium')
+  s.add_dependency('thin', '=0.8.1')
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.need_zip = true
+  pkg.need_tar = true
+end
+
+def tag_release
+  dashed_version = PKG_VERSION.gsub('.', '-')
+  svn_user = "#{ENV["SVN_USER"]}@" || ""
+  `svn cp svn+ssh://#{svn_user}rubyforge.org/var/svn/pivotalrb/js_test_core/trunk svn+ssh://#{svn_user}rubyforge.org/var/svn/pivotalrb/js_test_core/tags/REL-#{dashed_version} -m 'Version #{PKG_VERSION}'`
+end

data/vendor/js-test-core/lib/js_test_core.rb

@@ -0,0 +1,38 @@
+require "rubygems"
+gem "thin", ">=0.8.0"
+
+dir = File.dirname(__FILE__)
+$LOAD_PATH.unshift File.expand_path("#{dir}/../vendor/thin-rest/lib")
+require "thin_rest"
+
+# This causes errors to be printed to STDOUT.
+Thin::Logging.silent = false
+Thin::Logging.debug = true
+
+require "fileutils"
+require "tmpdir"
+require "timeout"
+require "cgi"
+require "net/http"
+require "selenium"
+require "optparse"
+
+require "#{dir}/js_test_core/extensions"
+require "#{dir}/js_test_core/thin"
+require "#{dir}/js_test_core/rack"
+require "#{dir}/js_test_core/resources"
+require "#{dir}/js_test_core/selenium"
+
+require "#{dir}/js_test_core/client"
+require "#{dir}/js_test_core/selenium_server_configuration"
+require "#{dir}/js_test_core/server"
+require "#{dir}/js_test_core/rails_server"
+
+module JsTestCore
+  DEFAULT_HOST = "0.0.0.0"
+  DEFAULT_PORT = 8080
+
+  class << self
+    attr_accessor :core_path
+  end
+end

data/vendor/js-test-core/lib/js_test_core/client.rb

@@ -0,0 +1,114 @@
+module JsTestCore
+  class Client
+    class ClientException < Exception
+    end
+
+    class InvalidStatusResponse < ClientException
+    end
+
+    class SuiteNotFound < ClientException
+    end
+
+    class << self
+      def run(parameters={})
+        new(parameters).run
+      end
+
+      def run_argv(argv)
+        params = {}
+        parser = OptionParser.new do |o|
+          o.banner = "JsTestCore Runner"
+          o.banner << "\nUsage: #{$0} [options] [-- untouched arguments]"
+
+          o.on
+          o.on('-s', '--selenium_browser_start_command=selenium_browser_start_command', "The Selenium server command to start the browser. See http://selenium-rc.openqa.org/") do |selenium_browser_start_command|
+            params[:selenium_browser_start_command] = selenium_browser_start_command
+          end
+
+          o.on('-h', '--selenium_host=SELENIUM_HOST', "The host name of the Selenium Server relative to where this file is executed") do |host|
+            params[:selenium_host] = host
+          end
+
+          o.on('-p', '--selenium_port=SELENIUM_PORT', "The port of the Selenium Server relative to where this file is executed") do |port|
+            params[:selenium_port] = port
+          end
+
+          o.on('-u', '--spec_url=SPEC_URL', "The url of the js spec server, relative to the browsers running via the Selenium Server") do |spec_url|
+            params[:spec_url] = spec_url
+          end
+
+          o.on_tail
+        end
+        parser.order!(argv)
+        run params
+      end
+    end
+
+    attr_reader :parameters, :query_string, :http, :suite_start_response, :last_poll_status, :last_poll_reason, :last_poll
+    def initialize(parameters)
+      @parameters = parameters
+      @query_string = SeleniumServerConfiguration.query_string_from(parameters)
+    end
+
+    def run
+      Net::HTTP.start(DEFAULT_HOST, DEFAULT_PORT) do |@http|
+        start_runner
+        wait_for_suite_to_finish
+      end
+      report_result
+    end
+
+    def parts_from_query(query)
+      query.split('&').inject({}) do |acc, key_value_pair|
+        key, value = key_value_pair.split('=')
+        acc[key] = value
+        acc
+      end
+    end
+    
+    protected
+    def start_runner
+      @suite_start_response = http.post('/runners', query_string)
+    end
+
+    def wait_for_suite_to_finish
+      poll while suite_not_completed?
+    end
+
+    def report_result
+      case last_poll_status
+      when Resources::Suite::SUCCESSFUL_COMPLETION
+        STDOUT.puts "SUCCESS"
+        true
+      when Resources::Suite::FAILURE_COMPLETION
+        STDOUT.puts "FAILURE"
+        STDOUT.puts last_poll_reason
+        false
+      else
+        raise InvalidStatusResponse, "Invalid Status: #{last_poll_status}"
+      end
+    end
+
+    def suite_not_completed?
+      last_poll_status.nil? || last_poll_status == Resources::Suite::RUNNING
+    end
+
+    def poll
+      @last_poll = http.get("/suites/#{suite_id}")
+      ensure_suite_exists!
+      parts = parts_from_query(last_poll.body)
+      @last_poll_status = parts['status']
+      @last_poll_reason = parts['reason']
+    end
+
+    def ensure_suite_exists!
+      if (400..499).include?(Integer(last_poll.code))
+        raise SuiteNotFound, "Could not find suite with id #{suite_id}"
+      end
+    end
+
+    def suite_id
+      @suite_id ||= parts_from_query(suite_start_response.body)['suite_id']
+    end
+  end
+end

data/vendor/js-test-core/lib/js_test_core/extensions.rb

@@ -0,0 +1,3 @@
+Dir["#{File.dirname(__FILE__)}/extensions/*.rb"].each do |file|
+  require file
+end

data/vendor/js-test-core/lib/js_test_core/extensions/time.rb

@@ -0,0 +1,6 @@
+require "time"
+class Time
+  def rfc822
+    strftime("%a, %d %b %Y %k:%M:%S %Z")
+  end  
+end

data/vendor/js-test-core/lib/js_test_core/rack.rb

@@ -0,0 +1,2 @@
+dir = File.dirname(__FILE__)
+require "#{dir}/rack/commonlogger"

data/vendor/js-test-core/lib/js_test_core/rack/commonlogger.rb

@@ -0,0 +1,5 @@
+Rack::CommonLogger.class_eval do
+  def empty?
+    @body.empty?
+  end
+end

data/vendor/js-test-core/lib/js_test_core/rails_server.rb

@@ -0,0 +1,22 @@
+module JsTestCore
+  class RailsServer < Server
+    class << self
+      def run(rails_root, server_options = {})
+        server_options[:Host] ||= DEFAULT_HOST
+        server_options[:Port] ||= DEFAULT_PORT
+        Server.instance = new(rails_root, server_options[:Host], server_options[:Port])
+        Server.instance.run server_options
+      end
+    end
+
+    def initialize(rails_root, host=DEFAULT_HOST, port=DEFAULT_PORT)
+      super(
+        "#{rails_root}/spec/javascripts",
+        "#{rails_root}/public/javascripts",
+        "#{rails_root}/public",
+        host,
+        port
+      )
+    end
+  end
+end

data/vendor/js-test-core/lib/js_test_core/resources.rb

@@ -0,0 +1,10 @@
+dir = File.dirname(__FILE__)
+require "#{dir}/resources/runner"
+require "#{dir}/resources/file"
+require "#{dir}/resources/dir"
+require "#{dir}/resources/file_not_found"
+require "#{dir}/resources/specs/spec_file"
+require "#{dir}/resources/specs/spec_dir"
+require "#{dir}/resources/web_root"
+require "#{dir}/resources/suite"
+require "#{dir}/resources/suite_finish"

data/vendor/js-test-core/lib/js_test_core/resources/dir.rb

@@ -0,0 +1,67 @@
+module JsTestCore
+  module Resources
+    class Dir < File
+      route ANY do |env, name|
+        if file = file(name)
+          file
+        elsif subdir = subdir(name)
+          subdir
+        else
+          FileNotFound.new(env.merge(:name => name))
+        end
+      end
+
+      def get
+        connection.send_head
+        connection.send_body(::Dir.glob("#{absolute_path}/*").inject("") do |html, file|
+          file_basename = ::File.basename(file)
+          html << %Q|<a href="#{file_basename}">#{file_basename}</a>\n|
+        end)
+      end
+
+      def glob(pattern)
+        expanded_pattern = absolute_path + pattern
+        ::Dir.glob(expanded_pattern).map do |absolute_globbed_path|
+          relative_globbed_path = absolute_globbed_path.gsub(absolute_path, relative_path)
+          File.new(env.merge(
+            :absolute_path => absolute_globbed_path,
+            :relative_path => relative_globbed_path
+          ))
+        end
+      end
+
+      protected
+      def determine_child_paths(name)
+        absolute_child_path = "#{absolute_path}/#{name}"
+        relative_child_path = "#{relative_path}/#{name}"
+        [absolute_child_path, relative_child_path]
+      end
+
+      def file(name)
+        # N.B. Absolute_path and relative_path are methods. Do not shadow.
+        absolute_file_path, relative_file_path = determine_child_paths(name)
+        if ::File.exists?(absolute_file_path) && !::File.directory?(absolute_file_path)
+          Resources::File.new(env.merge(
+            :absolute_path => absolute_file_path,
+            :relative_path => relative_file_path
+          ))
+        else
+          nil
+        end
+      end
+
+      def subdir(name)
+        # N.B. Absolute_path and relative_path are methods. Do not shadow.
+        absolute_dir_path, relative_dir_path = determine_child_paths(name)
+        if ::File.directory?(absolute_dir_path)
+          Resources::Dir.new(env.merge(
+            :absolute_path => absolute_dir_path,
+            :relative_path => relative_dir_path
+          ))
+        else
+          nil
+        end
+      end
+    end
+  end
+end

data/vendor/js-test-core/lib/js_test_core/resources/file.rb

@@ -0,0 +1,40 @@
+module JsTestCore
+  module Resources
+    class File < ThinRest::Resource
+      MIME_TYPES = {
+        '.js' => 'text/javascript',
+        '.css' => 'text/css',
+        '.png' => 'image/png',
+        '.jpg' => 'image/jpeg',
+        '.jpeg' => 'image/jpeg',
+        '.gif' => 'image/gif',
+        }
+
+      property :absolute_path, :relative_path
+
+      def get
+        extension = ::File.extname(absolute_path)
+        content_type = MIME_TYPES[extension] || 'text/html'
+
+        connection.terminate_after_sending do
+          connection.send_head(
+            200,
+              'Content-Type' => content_type,
+              'Last-Modified' => ::File.mtime(absolute_path).rfc822,
+              'Content-Length' => ::File.size(absolute_path)
+          )
+          ::File.open(absolute_path) do |file|
+            while !file.eof?
+              connection.send_data(file.read(1024))
+            end
+          end
+        end
+
+        def ==(other)
+          return false unless other.class == self.class
+          absolute_path == other.absolute_path && relative_path == other.relative_path
+        end
+      end
+    end
+  end
+end