evergreen 1.0.0.rc → 1.0.0

data/README.rdoc

@@ -16,6 +16,14 @@ isolation from your application. If you need a tool that tests how your
 JavaScript integrates with your application you should use an integration
 testing framework, such as {Capybara}[http://github.com/jnicklas/capybara].
 
+== Community
+
+Please ask questions on the {mailing
+list}[http://groups.google.com/group/ruby-evergreen].  If you have found a
+reproducible error, please {file it on
+GitHub}[https://github.com/jnicklas/evergreen/issues]. Do not contact the
+maintainers directly.
+
 == Installation
 
 Install as a Ruby gem:
@@ -28,12 +36,12 @@ Evergreen assumes a file and directory structure, place all your javascript
 code inside ./public and all spec files inside ./spec/javascripts. All spec
 files should end in _spec.js. For example:
 
-    public/widget.js
+    public/javascripts/widget.js
     spec/javascripts/widget_spec.js
 
 You can require files from the public directory inside your spec file:
 
-    require('/widget.js')
+    require('/javascripts/widget.js')
 
     describe('a widget', function() {
       ...

data/config/routes.rb

@@ -1,3 +1,3 @@
 Rails.application.routes.draw do
-  mount Evergreen.build_application, :at => '/evergreen'
+  mount Evergreen::Application, :at => '/evergreen'
 end

data/lib/evergreen.rb

@@ -15,19 +15,15 @@ module Evergreen
   autoload :Template, 'evergreen/template'
 
   class << self
-    attr_accessor :driver, :public_dir, :template_dir, :spec_dir, :root, :mounted_at
+    attr_accessor :driver, :public_dir, :template_dir, :spec_dir, :root, :mounted_at, :application
 
     def configure
       yield self
     end
 
-    def extensions(&block)
-      @extensions = block if block
-      @extensions
-    end
-
     def use_defaults!
       configure do |config|
+        config.application = Evergreen::Application
         config.driver = :selenium
         config.public_dir = 'public'
         config.spec_dir = 'spec/javascripts'

data/lib/evergreen/application.rb

@@ -1,71 +1,50 @@
 module Evergreen
-  class << self
-    attr_writer :application
+  class Application < Sinatra::Base
+    set :static, false
+    set :root, File.expand_path('.', File.dirname(__FILE__))
 
-    def application
-      @application ||= build_application
-    end
-
-    def build_application
-      Rack::Builder.new do
-        instance_eval(&Evergreen.extensions) if Evergreen.extensions
-
-        map "/jasmine" do
-          use Rack::Static, :urls => ["/"], :root => File.expand_path('../jasmine/lib', File.dirname(__FILE__))
-          run lambda { |env| [404, {}, "No such file"]}
-        end
+    helpers do
+      def url(path)
+        Evergreen.mounted_at.to_s + path.to_s
+      end
 
-        map "/resources" do
-          use Rack::Static, :urls => ["/"], :root => File.expand_path('resources', File.dirname(__FILE__))
-          run lambda { |env| [404, {}, "No such file"]}
-        end
+      def render_spec(spec)
+        spec.read if spec
+      rescue StandardError => error
+        erb :_spec_error, :locals => { :error => error }
+      end
+    end
 
-        map "/" do
-          app = Class.new(Sinatra::Base).tap do |app|
-            app.reset!
-            app.class_eval do
-              set :static, true
-              set :root, File.expand_path('.', File.dirname(__FILE__))
-              set :public_folder, File.expand_path(File.join(Evergreen.root, Evergreen.public_dir), File.dirname(__FILE__))
+    get '/' do
+      @suite = Evergreen::Suite.new
+      erb :list
+    end
 
-              helpers do
-                def url(path)
-                  Evergreen.mounted_at.to_s + path.to_s
-                end
+    get '/run/all' do
+      @suite = Evergreen::Suite.new
+      @js_spec_helper = @suite.get_spec('spec_helper.js')
+      @coffee_spec_helper = @suite.get_spec('spec_helper.coffee')
+      erb :run
+    end
 
-                def render_spec(spec)
-                  spec.read if spec
-                rescue StandardError => error
-                  erb :_spec_error, :locals => { :error => error }
-                end
-              end
+    get '/run/*' do |name|
+      @suite = Evergreen::Suite.new
+      @spec = @suite.get_spec(name)
+      @js_spec_helper = @suite.get_spec('spec_helper.js')
+      @coffee_spec_helper = @suite.get_spec('spec_helper.coffee')
+      erb :run
+    end
 
-              get '/' do
-                @suite = Evergreen::Suite.new
-                erb :list
-              end
+    get "/jasmine/*" do |path|
+      send_file File.expand_path(File.join('../jasmine/lib/jasmine-core', path), File.dirname(__FILE__))
+    end
 
-              get '/run/all' do
-                @suite = Evergreen::Suite.new
-                @js_spec_helper = @suite.get_spec('spec_helper.js')
-                @coffee_spec_helper = @suite.get_spec('spec_helper.coffee')
-                erb :run
-              end
+    get "/resources/*" do |path|
+      send_file File.expand_path(File.join('resources', path), File.dirname(__FILE__))
+    end
 
-              get '/run/*' do |name|
-                @suite = Evergreen::Suite.new
-                @spec = @suite.get_spec(name)
-                @js_spec_helper = @suite.get_spec('spec_helper.js')
-                @coffee_spec_helper = @suite.get_spec('spec_helper.coffee')
-                erb :run
-              end
-            end
-          end
-          run app
-        end
-      end.tap do |app|
-        def app.inspect; '<Evergreen Application>'; end
-      end
+    get '/*' do |path|
+      send_file File.join(Evergreen.root, Evergreen.public_dir, path)
     end
   end
 end

data/lib/evergreen/cli.rb

@@ -16,10 +16,10 @@ module Evergreen
 
       case command
       when "serve"
-        Evergreen::Suite.new.serve
+        Evergreen::Server.new.serve
         return true
       when "run"
-        return Evergreen::Suite.new.run
+        return Evergreen::Runner.new.run
       else
         puts "no such command '#{command}'"
         return false

data/lib/evergreen/runner.rb

@@ -87,8 +87,7 @@ module Evergreen
 
     attr_reader :suite, :io
 
-    def initialize(suite, io=STDOUT)
-      @suite = suite
+    def initialize(io=STDOUT)
       @io = io
     end
 
@@ -136,7 +135,11 @@ module Evergreen
     end
 
     def session
-      @session ||= Capybara::Session.new(Evergreen.driver, suite.application)
+      @session ||= Capybara::Session.new(Evergreen.driver, Evergreen.application)
+    end
+
+    def suite
+      @suite ||= Evergreen::Suite.new
     end
 
   protected

data/lib/evergreen/server.rb

@@ -2,10 +2,6 @@ module Evergreen
   class Server
     attr_reader :suite
 
-    def initialize(suite)
-      @suite = suite
-    end
-
     def serve
       server.boot
       Launchy.open(server.url(Evergreen.mounted_at.to_s + '/'))
@@ -15,7 +11,7 @@ module Evergreen
   protected
 
     def server
-      @server ||= Capybara::Server.new(suite.application)
+      @server ||= Capybara::Server.new(Evergreen.application)
     end
   end
 end

data/lib/evergreen/suite.rb

@@ -1,6 +1,6 @@
 module Evergreen
   class Suite
-    attr_reader :runner, :server, :driver, :application
+    attr_reader :driver
 
     def initialize
       paths = [
@@ -9,10 +9,6 @@ module Evergreen
         "#{ENV["HOME"]}/.evergreen"
       ]
       paths.each { |path| load(path) if File.exist?(path) }
-
-      @runner = Runner.new(self)
-      @server = Server.new(self)
-      @application = Evergreen.application
     end
 
     def root
@@ -23,14 +19,6 @@ module Evergreen
       Evergreen.mounted_at
     end
 
-    def run
-      runner.run
-    end
-
-    def serve
-      server.serve
-    end
-
     def get_spec(name)
       Spec.new(self, name)
     end

data/lib/evergreen/tasks.rb

@@ -4,7 +4,7 @@ require 'evergreen'
 namespace :spec do
   desc "Run JavaScript specs via Evergreen"
   task :javascripts => :environment do
-    result = Evergreen::Suite.new.run
+    result = Evergreen::Runner.new.run
     Kernel.exit(1) unless result
   end
 end

data/lib/evergreen/version.rb

@@ -1,3 +1,3 @@
 module Evergreen
-  VERSION = '1.0.0.rc'
+  VERSION = '1.0.0'
 end

data/lib/jasmine/Contribute.markdown

@@ -0,0 +1,44 @@
+# Developing for Jasmine Core     
+
+## How to Contribute
+
+We welcome your contributions - Thanks for helping make Jasmine a better project for everyone. Please review the backlog and discussion lists (the main group - [http://groups.google.com/group/jasmine-js](http://groups.google.com/group/jasmine-js) and the developer's list - [http://groups.google.com/group/jasmine-js-dev](http://groups.google.com/group/jasmine-js-dev)) before starting work - what you're looking for may already have been done. If it hasn't, the community can help make your contribution better.
+
+## How to write new Jasmine code     
+
+Or, How to make a successful pull request
+
+* _Do not change the public interface_. Lots of projects depend on Jasmine and if you aren't careful you'll break them
+* _Be environment agnostic_ - server-side developers are just as important as browser developers
+* _Be browser agnostic_ - if you must rely on browser-specific functionality, please write it in a way that degrades gracefully
+* _Write specs_ - Jasmine's a testing framework; don't add functionality without test-driving it
+* _Ensure the *entire* test suite is green_ in all the big browsers, Node, and JSHint - your contribution shouldn't break Jasmine for other users                                     
+
+Follow these tips and your pull request, patch, or suggestion is much more likely to be integrated.
+
+## Environment
+
+Ruby, RubyGems and Rake are used in order to script the various file interactions. You will need to run on a system that supports Ruby in order to run Jasmine's specs.
+
+Node.js is used to run most of the specs (the HTML-independent code) and should be present. Additionally, the JS Hint project scrubs the source code as part of the spec process.
+
+## Development
+
+All source code belongs in `src/`. The `core/` directory contains the bulk of Jasmine's functionality. This code should remain browser- and environment-agnostic. If your feature or fix cannot be, as mentioned above, please degrade gracefully. Any code that should only be in a non-browser environment should live in `src/console/`. Any code that depends on a browser (specifically, it expects `window` to be the global or `document` is present) should live in `src/html/`.
+
+Please respect the code patterns as possible. For example, using `jasmine.getGlobal()` to get the global object so as to remain environment agnostic.
+
+## Running Specs
+
+As in all good projects, the `spec/` directory mirrors `src/` and follows the same rules. The browser runner will include and attempt to run all specs. The node runner will exclude any html-dependent specs (those in `spec/html/`).
+
+You will notice that all specs are run against the built `jasmine.js` instead of the component source files. This is intentional as a way to ensure that the concatenation code is working correctly.
+
+Please ensure all specs are green before committing.
+
+There are rake tasks to help with getting green:
+* `rake spec` outputs the expected number of specs that should be run and attempts to run in browser and Node
+* `rake spec:browser` opens `spec/runner.html` in the default browser on MacOS. Please run this in at least Firefox and Chrome before committing
+* `rake spec:node` runs all the Jasmine specs in Node.js - it will complain if Node is not installed
+* `rake hint` runs all the files through JSHint and will complain about potential viable issues with your code. Fix them.
+

data/lib/jasmine/Gemfile

@@ -1,6 +1,4 @@
-source :gemcutter
-
-gem "jekyll", "0.6.2"
-gem "json_pure", "~>1.4.3"
-gem "ragaskar-jsdoc_helper"
-gem "rake", "0.8.7"
+source :rubygems
+gem "term-ansicolor", :require => "term/ansicolor"
+gem "rake"
+gemspec

data/lib/jasmine/MIT.LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2008-2010 Pivotal Labs
+Copyright (c) 2008-2011 Pivotal Labs
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/lib/jasmine/README.markdown

@@ -2,27 +2,30 @@
 =======
 **A JavaScript Testing Framework**
 
-Want to use Jasmine in a project? Go HERE: [http://pivotal.github.com/jasmine/](http://pivotal.github.com/jasmine/)
+Jasmine is a Behavior Driven Development testing framework for JavaScript. It does not rely on browsers, DOM, or any JavaScript framework. Thus it's suited for websites, [Node.js](http://nodejs.org) projects, or anywhere that JavaScript can run.
+
+Documentation & guides live here: [http://pivotal.github.com/jasmine/](http://pivotal.github.com/jasmine/)
+
+## What's Here?
+
+* 
+
 
-Want to contribute to Jasmine? Read on...
 
-<i>(More developer docs to come...)</i>
 
 ## Support
-We now have a Google Group for support & discussion.
 
-* Discussion: [http://groups.google.com/group/jasmine-js](http://groups.google.com/group/jasmine-js)
-* Group email: [jasmine-js@googlegroups.com](jasmine-js@googlegroups.com)
-* Current build status of Jasmine is visible at [ci.pivotallabs.com](http://ci.pivotallabs.com)
-* Pivotal Tracker project: [http://www.pivotaltracker.com/projects/10606](http://www.pivotaltracker.com/projects/10606)
-* Twitter: [@JasmineBDD](http://twitter.com/JasmineBDD)
+* Search past discussions: [http://groups.google.com/group/jasmine-js](http://groups.google.com/group/jasmine-js)
+* Send an email to the list: [jasmine-js@googlegroups.com](jasmine-js@googlegroups.com)
+* Check the current build status: [ci.pivotallabs.com](http://ci.pivotallabs.com)
+* View the project backlog at Pivotal Tracker: [http://www.pivotaltracker.com/projects/10606](http://www.pivotaltracker.com/projects/10606)
+* Follow us on Twitter: [@JasmineBDD](http://twitter.com/JasmineBDD)
+
 
 ## Maintainers
+
 * [Davis W. Frank](mailto:dwfrank@pivotallabs.com), Pivotal Labs
 * [Rajan Agaskar](mailto:rajan@pivotallabs.com), Pivotal Labs
-* [Christian Williams](mailto:xian@pivotallabs.com), Pivotal Labs
-
-## Developers
-We welcome your contributions! Jasmine is currently maintained by Davis Frank ([infews](http://github.com/infews)), Rajan Agaskar ([ragaskar](http://github.com/ragaskar)), and Christian Williams ([Xian](http://github.com/Xian)). You can help us by removing all other recipients from your pull request.
+* [Christian Williams](mailto:antixian666@gmail.com), Square
 
-Copyright (c) 2008-2010 Pivotal Labs. This software is licensed under the MIT License.
+Copyright (c) 2008-2011 Pivotal Labs. This software is licensed under the MIT License.

data/lib/jasmine/Rakefile

@@ -1,182 +1,33 @@
-def jasmine_sources
-  sources  = ["src/base.js", "src/util.js", "src/Env.js", "src/Reporter.js", "src/Block.js"]
-  sources += Dir.glob('src/*.js').reject { |f| f == 'src/base.js' || sources.include?(f) }.sort
-  sources
+require "bundler"
+Bundler::GemHelper.install_tasks
+require "term/ansicolor"
+require "json"
+require "tilt"
+
+Dir["#{File.dirname(__FILE__)}/tasks/**/*.rb"].each do |file|
+  require file
 end
 
-def jasmine_html_sources
-  ["src/html/TrivialReporter.js"]
-end
+task :default => :spec
 
-def jasmine_version
-  "#{version_hash['major']}.#{version_hash['minor']}.#{version_hash['build']}"
+task :require_pages_submodule do
+  raise "Submodule for Github Pages isn't present. Run git submodule update --init" unless pages_submodule_present
 end
 
-def version_hash
-  require 'json'
-  @version ||= JSON.parse(File.new("src/version.json").read);
+task :require_node do
+  raise "\nNode.js is required to develop code for Jasmine. Please visit http://nodejs.org to install.\n\n" unless node_installed?
 end
 
-task :default => 'jasmine:dist'
-
-def substitute_jasmine_version(filename)
-  contents = File.read(filename)
-  contents = contents.gsub(/##JASMINE_VERSION##/, (jasmine_version))
-  contents = contents.gsub(/[^\n]*REMOVE_THIS_LINE_FROM_BUILD[^\n]*/, '')
-  File.open(filename, 'w') { |f| f.write(contents) }
+def pages_submodule_present
+  File.exist?('pages/download.html')
 end
 
-namespace :jasmine do
-
-  desc 'Prepares for distribution'
-  task :dist => ['jasmine:build', 'jasmine:doc', 'jasmine:build_example_project', 'jasmine:fill_index_downloads']
-
-  desc 'Check jasmine sources for coding problems'
-  task :lint do
-    passed = true
-    jasmine_sources.each do |src|
-      lines = File.read(src).split(/\n/)
-      lines.each_index do |i|
-        line = lines[i]
-        undefineds = line.scan(/.?undefined/)
-        if undefineds.include?(" undefined") || undefineds.include?("\tundefined")
-          puts "Dangerous undefined at #{src}:#{i}:\n > #{line}"
-          passed = false
-        end
-
-        if line.scan(/window/).length > 0
-          puts "Dangerous window at #{src}:#{i}:\n > #{line}"
-          passed = false
-        end
-      end
-    end
-
-    unless passed
-      puts "Lint failed!"
-      exit 1
-    end
-  end
-
-  desc 'Builds lib/jasmine from source'
-  task :build => :lint do
-    puts 'Building Jasmine from source'
-
-    sources = jasmine_sources
-    version = version_hash
-
-    old_jasmine_files = Dir.glob('lib/jasmine*.js')
-    old_jasmine_files.each { |file| File.delete(file) }
-
-    File.open("lib/jasmine.js", 'w') do |jasmine|
-      sources.each do |source_filename|
-        jasmine.puts(File.read(source_filename))
-      end
-
-      jasmine.puts %{
-jasmine.version_= {
-  "major": #{version['major'].to_json},
-  "minor": #{version['minor'].to_json},
-  "build": #{version['build'].to_json},
-  "revision": #{Time.now.to_i}
-};
-}
-    end
-
-    File.open("lib/jasmine-html.js", 'w') do |jasmine_html|
-      jasmine_html_sources.each do |source_filename|
-        jasmine_html.puts(File.read(source_filename))
-      end
-    end
-
-    FileUtils.cp("src/html/jasmine.css", "lib/jasmine.css")
-  end
-
-  downloads_file = 'pages/download.html.md'
-  task :need_pages_submodule do
-    unless File.exists?(downloads_file)
-      raise "Jasmine pages submodule isn't present.  Run git submodule update --init"
-    end
-  end
-
-  desc "Build jasmine documentation"
-  task :doc => :need_pages_submodule do
-    puts 'Creating Jasmine Documentation'
-    require 'rubygems'
-    require 'jsdoc_helper'
-
-    FileUtils.rm_r "pages/jsdoc", :force => true
-
-    JsdocHelper::Rake::Task.new(:lambda_jsdoc) do |t|
-      t[:files] = jasmine_sources << jasmine_html_sources
-      t[:options] = "-a"
-      t[:out] = "pages/jsdoc"
-      # JsdocHelper bug: template must be relative to the JsdocHelper gem, ick
-      t[:template] = File.join("../".*(100), Dir::getwd, "jsdoc-template")
-    end
-    Rake::Task[:lambda_jsdoc].invoke
-  end
-
-  desc "Build example project"
-  task :build_example_project => :need_pages_submodule do
-    require 'tmpdir'
-
-    temp_dir = File.join(Dir.tmpdir, 'jasmine-standalone-project')
-    puts "Building Example Project in #{temp_dir}"
-    FileUtils.rm_r temp_dir if File.exists?(temp_dir)
-    Dir.mkdir(temp_dir)
-
-    root = File.expand_path(File.dirname(__FILE__))
-    FileUtils.cp_r File.join(root, 'example/.'), File.join(temp_dir)
-    substitute_jasmine_version(File.join(temp_dir, "SpecRunner.html"))
-
-    lib_dir = File.join(temp_dir, "lib/jasmine-#{jasmine_version}")
-    FileUtils.mkdir_p(lib_dir)
-    {
-        "lib/jasmine.js" => "jasmine.js",
-        "lib/jasmine-html.js" => "jasmine-html.js",
-        "src/html/jasmine.css" => "jasmine.css",
-        "MIT.LICENSE"  => "MIT.LICENSE"
-    }.each_pair do |src, dest|
-      FileUtils.cp(File.join(root, src), File.join(lib_dir, dest))
-    end
-
-    dist_dir = File.join(root, 'pages/downloads')
-    zip_file_name = File.join(dist_dir, "jasmine-standalone-#{jasmine_version}.zip")
-    puts "Zipping Example Project and moving to #{zip_file_name}"
-    FileUtils.mkdir(dist_dir) unless File.exist?(dist_dir)
-    if File.exist?(zip_file_name)
-      puts "WARNING!!! #{zip_file_name} already exists!"
-      FileUtils.rm(zip_file_name)
-    end
-    exec "cd #{temp_dir} && zip -r #{zip_file_name} . -x .[a-zA-Z0-9]*"
-  end
-
-  task :fill_index_downloads do
-    require 'digest/sha1'
-
-    download_html = "<!-- START_DOWNLOADS -->\n"
-    Dir.glob('pages/downloads/*.zip').sort.reverse.each do |f|
-      sha1 = Digest::SHA1.hexdigest File.read(f)
-
-      fn = f.sub(/^pages\//, '')
-      version = /jasmine-standalone-(.*).zip/.match(f)[1]
-      prerelease = /\.rc/.match(f)
-      download_html += prerelease ? "<tr class=\"rc\">\n" : "<tr>\n"
-      download_html += "  <td class=\"link\"><a href=\"#{fn}\">#{fn.sub(/downloads\//, '')}</a></td>\n"
-      download_html += "  <td class=\"version\">#{version}</td>\n"
-      download_html += "  <td class=\"size\">#{File.size(f) / 1024}k</td>\n"
-      download_html += "  <td class=\"date\">#{File.mtime(f).strftime("%Y/%m/%d %H:%M:%S %Z")}</td>\n"
-      download_html += "  <td class=\"sha\">#{sha1}</td>\n"
-      download_html += "</tr>\n"
-    end
-    download_html += "<!-- END_DOWNLOADS -->"
+def node_installed?
+ `which node` =~ /node/
+end
 
-    downloads_page = File.read(downloads_file)
-    matcher = /<!-- START_DOWNLOADS -->.*<!-- END_DOWNLOADS -->/m
-    downloads_page = downloads_page.sub(matcher, download_html)
-    File.open(downloads_file, 'w') {|f| f.write(downloads_page)}
-    puts "rewrote that file"
-  end
+class String
+  include Term::ANSIColor
 end
 
-task :jasmine => ['jasmine:dist']
+Term::ANSIColor.coloring = STDOUT.isatty