sproutit-sproutcore 1.0.0.20090407205609

data/spec/fixtures/ordered_entries/apps/no_requires/lproj/strings.js

@@ -0,0 +1 @@
+// strings.js

data/spec/fixtures/ordered_entries/apps/no_requires/utils.js

@@ -0,0 +1 @@
+// utils.js

data/spec/fixtures/ordered_entries/apps/with_requires/a.js

@@ -0,0 +1,2 @@
+require('c');
+require('imaginary');

data/spec/fixtures/ordered_entries/apps/with_requires/b.js

@@ -0,0 +1,3 @@
+require('c');
+require('d');
+require('imaginary');

data/spec/fixtures/ordered_entries/apps/with_requires/c.js

@@ -0,0 +1,2 @@
+require('c');
+require('imaginary');

data/spec/fixtures/ordered_entries/apps/with_requires/english.lproj/a.css

@@ -0,0 +1,2 @@
+sc_require('c');
+sc_require('imaginary');

data/spec/fixtures/ordered_entries/apps/with_requires/english.lproj/b.css

@@ -0,0 +1,2 @@
+sc_require('c');
+sc_require('imaginary');

data/spec/fixtures/ordered_entries/apps/with_requires/english.lproj/c.css

@@ -0,0 +1,2 @@
+sc_require('c');
+sc_require('imaginary');

data/spec/fixtures/ordered_entries/apps/with_requires/english.lproj/d.js

@@ -0,0 +1 @@
+// tests loading resources from within english.lproj

data/spec/fixtures/real_world/Buildfile

@@ -0,0 +1,12 @@
+# Project-level Buildfile
+
+# required because this buildfile lives inside of the source dir which itself
+# has a Buildfile
+project! 
+
+# This is the generic requirement for most apps.  Of course SproutCore will
+# override this for itself, so you don't have to worry about it causing 
+# trouble.
+config :all, :required => :sproutcore
+
+config :mobile_photos, :required => 'sproutcore/mobile'

data/spec/fixtures/real_world/apps/account/README

@@ -0,0 +1 @@
+This file added to ensure git creates this directory.

data/spec/fixtures/real_world/apps/calendar/README

@@ -0,0 +1 @@
+This file added to ensure git creates this directory.

data/spec/fixtures/real_world/apps/contacts/README_BEFORE_EDITING

@@ -0,0 +1 @@
+Note: the buildtasks/manifest/prepare_build_tasks/html_spec.rb assumes this (contacts) target contains NO .rhtml or .haml fragments.  

data/spec/fixtures/real_world/apps/files/README

@@ -0,0 +1 @@
+This file added to ensure git creates this directory.

data/spec/fixtures/real_world/apps/mail/README

@@ -0,0 +1 @@
+This file added to ensure git creates this directory.

data/spec/fixtures/real_world/apps/mobile_photos/README

@@ -0,0 +1 @@
+This file added to ensure git creates this directory.

data/spec/fixtures/real_world/apps/photos/README

@@ -0,0 +1 @@
+This file added to ensure git creates this directory.

data/spec/fixtures/real_world/apps/uploader/README

@@ -0,0 +1 @@
+This file added to ensure git creates this directory.

data/spec/fixtures/real_world/frameworks/sproutcore/Buildfile

@@ -0,0 +1,26 @@
+# Framework-level Buildfile
+
+# By default, all of these frameworks don't require anything. 
+# This is necessary since the default buildfile requires sproutcore.
+config :all, :required => [] 
+
+config :sproutcore, :required => :desktop
+
+config :foundation,
+  :required => :costello
+  
+config :application, 
+  :required => %w(costello foundation)
+  
+config :data_store,
+  :required => %w(costello foundation)
+  
+config :desktop,
+  :required => %w(costello foundation application data_store)
+  
+config :mobile,
+  :required => %w(costello foundation application data_store)
+
+%w(uploader docs test_runner).each do |target_name|
+  config target_name, :required => :sproutcore
+end

data/spec/fixtures/real_world/frameworks/sproutcore/README

@@ -0,0 +1 @@
+Sample README

data/spec/fixtures/real_world/frameworks/sproutcore/english.lproj/demo.css

@@ -0,0 +1,4 @@
+body {
+  background-image: sc_static('demo') top left no-repeat;
+}
+

data/spec/fixtures/real_world/frameworks/sproutcore/english.lproj/demo.html

@@ -0,0 +1 @@
+<!-- another test -->

data/spec/fixtures/real_world/frameworks/sproutcore/english.lproj/file_extension_test.html.erb

@@ -0,0 +1 @@
+<% # demo ErB %>

data/spec/fixtures/real_world/frameworks/sproutcore/english.lproj/has_require.css

@@ -0,0 +1,4 @@
+/* this CSS has requires() & sc_requires() statements */
+
+sc_require('demo2');
+require('no_require'); /* DEPRECATED */

data/spec/fixtures/real_world/frameworks/sproutcore/english.lproj/no_require.css

@@ -0,0 +1 @@
+/* this CSS has no requires */

data/spec/fixtures/real_world/frameworks/sproutcore/english.lproj/no_sc_resource.rhtml

@@ -0,0 +1 @@
+<% # does not contain an sc_resource() call.. %>

data/spec/fixtures/real_world/frameworks/sproutcore/english.lproj/sc_resource.css

@@ -0,0 +1,6 @@
+/* this CSS has several sc_resource() calls */
+
+sc_resource('foo');
+sc_resource('bar.css');
+
+

data/spec/fixtures/real_world/frameworks/sproutcore/english.lproj/sc_resource.rhtml

@@ -0,0 +1,3 @@
+<% # contains an sc_resource() call %>
+<% sc_resource('foo') %>
+<% sc_resource(  'bar'  ) %>

data/spec/fixtures/real_world/frameworks/sproutcore/english.lproj/strings.js

@@ -0,0 +1 @@
+// English Strings

data/spec/fixtures/real_world/frameworks/sproutcore/fixtures/sample-json-fixture.json

@@ -0,0 +1 @@
+{ JSON! }

data/spec/fixtures/real_world/frameworks/sproutcore/french.lproj/strings.js

@@ -0,0 +1 @@
+// French Strings

data/spec/fixtures/real_world/frameworks/sproutcore/has_require.js

@@ -0,0 +1,4 @@
+/* this JS has requires() & sc_requires() statements */
+
+sc_require('demo2');
+require('no_require'); // DEPRECATED

data/spec/fixtures/real_world/frameworks/sproutcore/lib/index.html

@@ -0,0 +1 @@
+<!-- Sample INdex.html -->

data/spec/fixtures/real_world/frameworks/sproutcore/no_require.js

@@ -0,0 +1 @@
+/* Javascript with no requires */

data/spec/fixtures/real_world/frameworks/sproutcore/sc_resource.js

@@ -0,0 +1,6 @@
+/* this CSS has several sc_resource() calls */
+
+sc_resource('foo');
+sc_resource('bar.js');
+
+

data/spec/fixtures/real_world/frameworks/sproutcore/tests/sample.rhtml

@@ -0,0 +1 @@
+<!-- Sample tests -->

data/spec/fixtures/real_world/frameworks/sproutcore/views/view.js

@@ -0,0 +1 @@
+// Sample View.js

data/spec/fixtures/real_world/generators/sample_custom/templates/{filename}.js

@@ -0,0 +1 @@
+<%= filename %>

data/spec/fixtures/recursive_project/Buildfile

@@ -0,0 +1,8 @@
+# This buildfile causes the sproutcore/costello target to require the 
+# sproutcore project, which requires the sproutcore/costello target (i.e.
+# a recursive reference)
+#
+# Test against this project to ensure this sort of thing does not cause 
+# infinite loops
+config :all, :required => :sproutcore
+config :sproutcore, :required => :costello

data/spec/lib/builders/combine_spec.rb

@@ -0,0 +1,67 @@
+require File.join(File.dirname(__FILE__), 'spec_helper')
+
+describe SC::Builder::Combine do
+  
+  include SC::SpecHelpers
+  include SC::BuilderSpecHelper
+
+  before do
+    std_before :combine_test
+  end
+
+  after do
+    std_after
+  end
+  
+  def verify_combine(main_entryname, filename_ext, src_root=nil)
+    # generate artificial entries to test.
+    source_entries = %w(a b c).map do |filename|
+      filename = filename.ext(filename_ext)
+      source_path = File.join(*([@target.source_root, src_root, filename.ext(filename_ext)].compact))
+      @entry = @manifest.add_entry filename,
+        :source_path  => source_path,
+        :staging_path => source_path,
+        :build_path   => source_path
+      
+      File.exist?(@entry.source_path).should be_true # precondition
+      @entry
+    end
+    
+    # generate wrapper to entry...
+    filename = main_entryname.ext(filename_ext)
+    @entry = @manifest.add_composite filename,
+      :source_entries  => source_entries,
+      :ordered_entries => source_entries
+    
+    @dst_path = @entry.build_path
+
+    # Generate expected...
+    expected = <<EOF
+/* >>>>>>>>>> BEGIN a.#{filename_ext} */
+CONTENT: a
+
+/* >>>>>>>>>> BEGIN b.#{filename_ext} */
+CONTENT: b !important - no newline at end
+/* >>>>>>>>>> BEGIN c.#{filename_ext} */
+CONTENT: c
+
+EOF
+
+    # OK, now do the build...
+    SC::Builder::Combine.build(@entry, @dst_path)
+
+    # And read in the result
+    result = File.readlines(@dst_path)*""
+    result.should eql(expected)
+  end
+    
+      
+  it "should combine JavaScript files according to ordered_entries, with separators in between" do
+    verify_combine 'javascript', 'js'
+  end
+  
+  it "should combine CSS files according to ordered_entries with separators in between" do
+    verify_combine 'stylesheet', 'css', 'english.lproj'
+  end
+  
+end

data/spec/lib/builders/html_spec.rb

@@ -0,0 +1,577 @@
+require File.join(File.dirname(__FILE__), 'spec_helper')
+describe SC::Builder::Html do
+  
+  include SC::SpecHelpers
+  include SC::BuilderSpecHelper
+  
+  before do
+    std_before :html_test
+    
+    # most of these tests assume load_debug is turned off like it would be
+    # in production mode
+    @target.config.load_debug = false
+    @target.config.theme = nil
+    @target.config.timestamp_urls = false
+    
+    # make sure all targets have the same settings...
+    @target.expand_required_targets.each do |t|
+      t.config.timestamp_urls = false
+    end
+    
+    # run std rules to run manifest.  Then verify preconditions to make sure
+    # no other changes to the build system effect the ability of these tests
+    # to run properly.
+    @manifest.build!
+    @index_entry = @manifest.entry_for('index.html')
+    @bar_entry   = @manifest.entry_for('bar1.html')
+  end
+
+  after do
+    std_after
+  end
+  
+  it "VERIFY PRECONDITIONS" do
+    @target.should be_loadable
+    
+    # target should require one other target...
+    (req = @target.required_targets).size.should == 1
+    req.first.target_name.should == :'/req_target_2'
+    
+    # the required target should itself require another target...
+    (req = req.first.required_targets).size.should == 1
+    req.first.target_name.should == :'/req_target_1'
+    
+    # Verify index entry -- should have erb_sample + rhtml_sample entries
+    @index_entry.should_not be_nil
+    @index_entry.should be_include_required_targets
+    entry_names = @index_entry.source_entries.map { |e| e.filename }.sort
+    entry_names.should == %w(erb_sample.html.erb rhtml_sample.rhtml)
+    
+    # Verify bar entry - should have 1 entry
+    @bar_entry.should_not be_nil
+    entry_names = @bar_entry.source_entries.map { |e| e.filename }.sort
+    entry_names.should == %w(bar1_sample.rhtml)
+  end
+
+  describe "layout_path" do
+    
+    before do 
+      @index_builder = SC::Builder::Html.new(@index_entry)
+    end
+    
+    it "initially resolves layout_path using layout config for target" do
+      # see the Buildfile for the fixture project to see this config.
+      @index_builder.layout_path.should == File.join(@project.project_root, %w(apps html_test lib layout_template.rhtml))
+    end
+    
+    it "changes its resolved path if you alter the layout variable" do
+      # use helper method...
+      @index_builder.sc_resource('index', 
+        :layout => 'req_target_2:lib/alt_layout.rhtml')
+      
+      @index_builder.layout_path.should == File.join(@project.project_root, %w(frameworks req_target_2 lib alt_layout.rhtml))
+    end
+  end
+      
+
+      
+  describe "render an index.html entry" do
+    
+    it "should render html, including any content from required targets" do
+      result = SC::Builder::Html.new(@index_entry).render
+      result.should =~ /erb_sample/
+      result.should =~ /rhtml_sample/
+      
+      # verify it included the other items..
+      result.should =~ /req_target_1_sample/
+      result.should =~ /req_target_2_sample/
+    end
+      
+  end
+  
+  describe "building non-index entries" do
+    
+    it "should render html, including only items from the target itself" do
+      result = SC::Builder::Html.new(@bar_entry).render
+      result.should =~ /bar1_sample/
+
+      # verify it did not include other targets..
+      result.should_not =~ /req_target_1_sample/
+      result.should_not =~ /req_target_2_sample/
+    end
+    
+  end
+  
+  describe "expand_required_targets helper" do
+    
+    it "returns the required targets for a typical target" do
+      @builder = SC::Builder::Html.new(@index_entry)
+      @builder.expand_required_targets(@target).should == @target.expand_required_targets
+    end
+    
+    it "include debug targets if load_debug is true" do
+      @builder = SC::Builder::Html.new(@index_entry)
+      @target.config.debug_required.should_not be_nil # precondition
+      
+      @target.config.load_debug = true
+      @builder.expand_required_targets(@target).should == @target.expand_required_targets(:debug => true)
+    end
+    
+    it "includes theme if theme is specified and target is app" do
+      @builder = SC::Builder::Html.new(@index_entry)
+      @target.config.theme = :sample_theme
+      
+      expected = @project.target_for :sample_theme
+      expected.should_not be_nil #precondition
+      @builder.expand_required_targets(@target).should include(expected)
+    end
+      
+  end
+  
+  # templates should expect to be able to access certain environmental 
+  # variables and other commands when running.  This API is exposed as methods
+  # on the HTML builder object itself.
+  describe "API for templates" do
+    
+    before do
+      # get the simplest builder...
+      @builder = SC::Builder::Html.new(@bar_entry)
+    end
+    
+    describe "Basic properties" do
+      it "exposes entry = current entry" do
+        @builder.entry.should == @bar_entry
+      end
+    
+      it "exposes current target as both 'target' & 'bundle' (for backwards compatibility)" do
+        @builder.bundle.should == @target
+        @builder.target.should == @target
+      end
+    
+      it "exposes current project as both 'project' & 'library' (for backwards compatibility)" do
+        @builder.project.should == @project
+        @builder.library.should == @project
+      end
+    
+      it "exposes output filename as 'filename'" do
+        @builder.filename.should == 'bar1.html'
+      end
+    
+      it "exposes current language as 'language'" do
+        @builder.language.should == :en
+      end
+      
+      it "exposes bundle_name & target_name" do
+        expected = @target.target_name.to_s.sub(/^\//,'')
+        @builder.target_name.should == expected
+        @builder.bundle_name.should == expected
+      end
+      
+      it "exposes title - titlizes target name, respects config.title" do
+        @target.config.title = nil
+        @builder.title.should == 'Html Test'
+        
+        @target.config.title = 'TEST'
+        @builder.title.should == "TEST"
+      end
+      
+      it "exposes config" do
+        @builder.config.should == @target.config
+      end
+      
+    end
+    
+    # Static helper contains methods needed to generate a SproutCore app
+    # such as static_url, sc_resource, etc.
+    describe "StaticHelper" do
+      
+      it "exposes static_url() & sc_static() alias" do
+        @builder.static_url('icons/image').should =~ /icons\/image.png/
+        @builder.static_url('image.jpg').should =~ /image.jpg/
+  
+        @builder.sc_static('icons/image').should =~ /icons\/image.png/
+        @builder.sc_static('image.jpg').should =~ /image.jpg/
+      end
+      
+      it "takes a :language option for static_url to select an alternate manifest (deprecated - supported for backwards compatibility)" do
+        @builder.static_url('fr.png', :language => :fr).should =~ /french-icons\/fr.png/
+        
+        @builder.sc_static('fr.png', :language => :fr).should =~ /french-icons\/fr.png/
+      end
+      
+      it "respects the timestamp_url option for static_url()" do
+        @target.config.timestamp_urls = false
+        @builder.static_url('icons/image').should_not =~ /\?.+$/
+        
+        @target.config.timestamp_urls = true
+        @builder.static_url('icons/image').should =~ /\?.+$/
+      end
+      
+      it "accepts sc_resource(rsrc_name, opts).  :layout opt may be used to set layout.  otherwise this is scanned for during manifest building" do
+        @builder.sc_resource('foo', :layout => 'bar')
+        @builder.instance_variable_get('@layout').should == 'bar'
+      end
+      
+      describe "exposes theme_name()" do
+        
+        it "returns passed default value or 'sc-theme' if no theme is configd" do
+          @target.config.theme = nil # precondition
+          @builder.theme_name.should == 'sc-theme'
+          @builder.theme_name(:default => 'foo').should == 'foo'
+        end
+        
+        it "returns targets theme_name config if set" do
+          @target.config.theme = 'sample_theme'
+          @target.config.theme_name = "foo"
+          @builder.theme_name.should == 'foo'
+        end
+        
+        it "returns theme_name set in theme target if set and not overridden in app itself" do
+          @target.config.theme = 'sample_theme'
+          @target.config.theme_name = nil # precondition
+          
+          # this value is set in the sample_theme/Buildfile
+          @builder.theme_name.should == 'sample_theme_name'
+        end
+      end
+       
+      describe "exposes loc()" do
+        
+        it "maps passed string to local target strings.js, if present" do
+          @builder.loc('local_string').should eql('LOCAL STRING')
+        end
+        
+        it "maps passed string to required target strings.js, otherwise" do
+          @builder.loc('req_string').should eql('REQ STRING')
+        end
+        
+        it "accepts a language option to loc a different language (deprecated - included for backward compatibility)" do
+          @builder.loc('local_string', :language => :fr).should eql('LOCAL STRING FR')
+        end
+        
+      end
+      
+      describe "exposes stylesheets_for_client()" do
+        
+        # look for link tags in order...
+        def expect_links(result, urls = [])
+          urls = urls.dup # don't corrupt original array
+          result.scan /\<link.+href\=\"([^\"]+)\"[^\<]+\/\>/ do |m|
+            $1.should == urls.shift
+          end
+        end
+  
+        # look for link tags in order...
+        def expect_imports(result, urls = [])
+          urls = urls.dup # don't corrupt original array
+          result.scan /@import\s+url\(\'(.+)\'\)/ do |m|
+            $1.should == urls.shift
+          end
+        end
+          
+        it "generates a link to stylesheet.css entries for all required targets if CONFIG.combine_stylesheetss = true" do
+          # figure expected urls...
+          urls = %w(req_target_1 req_target_2 html_test).map do |target_name|
+            t = @project.target_for(target_name)
+            t.manifest_for(:language => :en).build!.entry_for('stylesheet.css').url
+          end
+          
+          @target.config.combine_stylesheets = true 
+          result = @builder.stylesheets_for_client
+          expect_links(result, urls)
+          
+          # also works for @import
+          result = @builder.stylesheets_for_client(:include_method => :import)
+          expect_imports(result, urls)
+        end
+        
+        it "generates a link to the ordered entries of each stylesheet.css for all required targets if CONFIG.combine_stylesheetss = false" do
+          # figure expected urls...
+          urls = %w(req_target_1 req_target_2 html_test).map do |target_name|
+            t = @project.target_for(target_name)
+            e = t.manifest_for(:language => :en).build!.entry_for('stylesheet.css')
+            e.ordered_entries.map { |e| e.url }
+          end
+          urls.flatten!
+          
+          @target.config.combine_stylesheets = false 
+          result = @builder.stylesheets_for_client
+          expect_links(result, urls)
+  
+          result = @builder.stylesheets_for_client(:include_method => :import)
+          expect_imports(result, urls)
+        end
+      
+        it "adds stylehseet_libs to end of styles" do
+          @target.config.stylesheet_libs = %w(foo bar)
+          result = @builder.stylesheets_for_client
+          result.should =~ /href=\"foo\"/
+          result.should =~ /href=\"bar\"/
+        end
+        
+        describe "timestamp_urls support" do
+          
+          def test_timestamps(should_have)
+            result = @builder.stylesheets_for_client
+            matches = 0
+            result.scan(/href=\"([^\"]+)\"/) do |m|
+              m=m.first # look @ match...
+              matches += 1 
+              if should_have
+                m.should =~ /\?.+$/
+              else
+                m.should_not =~ /\?.+$/
+              end
+            end
+            matches.should > 0 # should match some urls...
+          end
+          
+          it "does NOT timestamp to all urls if timestamp_urls is false" do
+            # simulate having timestamp_urls set true in the root buildfile
+            @target.config.timestamp_urls = false # preconditon
+            @target.expand_required_targets.each do |t|
+              t.config.timestamp_urls = false
+            end
+            test_timestamps false
+          end
+        
+          it "does timestamp all urls if timestamp_urls is true" do
+            # simulate having timestamp_urls set true in the root buildfile
+            @target.config.timestamp_urls = true # precondition
+            @target.expand_required_targets.each do |t|
+              t.config.timestamp_urls = true
+            end
+            test_timestamps true
+          end
+        end
+          
+        
+        it "adds stylesheet for debug if CONFIG.load_debug" do
+          # figure expected urls...
+          t = @project.target_for(:debug)
+          url = t.manifest_for(:language => :en).build!.entry_for('stylesheet.css').url
+          url = /#{Regexp.escape url}/
+          
+          @target.config.combine_stylesheets = true 
+          @target.config.load_debug = true 
+          result = @builder.stylesheets_for_client
+          result.should =~ url
+          
+          # also works for @import
+          result = @builder.stylesheets_for_client(:include_method => :import)
+          result.should =~ url
+        end
+
+        it "does NOT add stylesheet for test if CONFIG.load_test" do
+          # figure expected urls...
+          t = @project.target_for(:qunit)
+          url = t.manifest_for(:language => :en).build!.entry_for('stylesheet.css').url
+          url = /#{Regexp.escape url}/
+          
+          @target.config.combine_stylesheets = true 
+          @target.config.load_test = true 
+          result = @builder.stylesheets_for_client
+          result.should_not =~ url
+          
+          # also works for @import
+          result = @builder.stylesheets_for_client(:include_method => :import)
+          result.should_not =~ url
+        end
+          
+      end
+      
+      describe "exposes javascript_for_client()" do
+        
+        # look for link tags in order...
+        def expect_scripts(result, urls = [])
+          urls = urls.dup # don't corrupt original array
+          result.scan /\<script.+src\=\"([^\"]+)\"[^\<]+\>\s*\<\/script\>/ do |m|
+            $1.should == urls.shift
+          end
+        end
+  
+        it "generates a link to javascript.js entries for all required targets if CONFIG.combine_javascript = true" do
+          # figure expected urls...
+          urls = %w(req_target_1 req_target_2 html_test).map do |target_name|
+            t = @project.target_for(target_name)
+            t.manifest_for(:language => :en).build!.entry_for('javascript.js').url
+          end
+          
+          @target.config.combine_javascript = true 
+          result = @builder.javascripts_for_client
+          expect_scripts(result, urls)
+        end
+        
+        it "generates a link to the ordered entries of each javascript.js for all required targets if CONFIG.combine_javascript = false" do
+          # figure expected urls...
+          urls = %w(req_target_1 req_target_2 html_test).map do |target_name|
+            t = @project.target_for(target_name)
+            e = t.manifest_for(:language => :en).build!.entry_for('javascript.js', :combined => true)
+            e.ordered_entries.map { |e| e.url }
+          end
+          urls.flatten!
+          
+          @target.config.combine_javascript = false 
+          result = @builder.javascripts_for_client
+          expect_scripts(result, urls)
+        end
+        
+        it "adds preferredLanguage definition" do
+          result = @builder.javascripts_for_client
+          result.should =~ /String.preferredLanguage = "en"/
+        end
+        
+        it "adds javascript_libs to end of scripts" do
+          @target.config.javascript_libs = %w(foo bar)
+          result = @builder.javascripts_for_client
+          result.should =~ /src=\"foo\"/
+          result.should =~ /src=\"bar\"/
+        end
+
+        it "adds link to debug JS if CONFIG.load_debug = true" do
+          # figure expected urls...
+          t = @project.target_for(:debug)
+          url = t.manifest_for(:language => :en).build!.entry_for('javascript.js').url
+          url = /#{Regexp.escape url}/
+          
+          @target.config.combine_javascript = true 
+          @target.config.load_debug = true
+          result = @builder.javascripts_for_client
+          result.should =~ url
+        end
+
+        it "does NOT add link to test, even if load_test is true" do
+          # figure expected urls...
+          t = @project.target_for(:qunit)
+          url = t.manifest_for(:language => :en).build!.entry_for('javascript.js').url
+          url = /#{Regexp.escape url}/
+          
+          @target.config.combine_javascript = true 
+          @target.config.load_test = true
+          result = @builder.javascripts_for_client
+          result.should_not =~ url
+        end
+
+        describe "timestamp_urls support" do
+          
+          def test_timestamps(should_have)
+            result = @builder.javascripts_for_client
+            matches = 0
+            result.scan(/src=\"([^\"]+)\"/) do |m|
+              matches += 1 
+              m = m.first # look @ match
+              if should_have
+                m.should =~ /\?.+$/
+              else
+                m.should_not =~ /\?.+$/
+              end
+            end
+            matches.should > 0 # should match some urls...
+          end
+          
+          it "does NOT timestamp to all urls if timestamp_urls is false" do
+            @target.config.timestamp_urls = false # preconditon
+            @target.expand_required_targets.each do |t|
+              t.config.timestamp_urls = false
+            end
+            test_timestamps false
+          end
+        
+          it "does timestamp all urls if timestamp_urls is true" do
+            @target.config.timestamp_urls = true # precondition
+            @target.expand_required_targets.each do |t|
+              t.config.timestamp_urls = true
+            end
+            test_timestamps true
+          end
+        end
+      
+      end
+      
+    end
+    
+    describe "TagHelpers" do
+      it "exposes tag(br) => <br />" do
+        @builder.tag(:br).should =~ /<br ?\/>/ # don't care if space is added
+      end
+      
+      it "exposes content_tag(h1, 'hello_world')" do
+        @builder.content_tag(:h1, 'hello world').should == '<h1>hello world</h1>'
+      end
+      
+      it "exposes cdata_section('hello world')" do
+        @builder.cdata_section('hello world').should == "<![CDATA[hello world]]>"
+      end
+      
+      it "exposes escape_once('1 & 2')" do
+        @builder.escape_once("1 > 2 &amp; 3").should == "1 &gt; 2 &amp; 3"
+      end
+    end
+    
+    describe "TextHelper" do
+  
+      it "exposes highlight(str, highlight_str, repl_Str)" do
+        @builder.highlight('You searched for: rails', 'rails').should == 'You searched for: <strong class="highlight">rails</strong>'
+      end
+      
+      it "exposes pluralize(cnt, 'foo')" do
+        @builder.pluralize(1, 'person').should == '1 person'
+        @builder.pluralize(2, 'person').should == '2 people'
+        @builder.pluralize(3, 'person', 'users').should == '3 users'
+      end
+    
+      begin
+        gem 'RedCloth'
+        require 'redcloth'
+        
+        it "exposes textilize('foo')" do
+          @builder.textilize("h1. foo").should == "<h1>foo</h1>"
+        end
+      rescue LoadError
+        puts "WARNING: Not testing textilize() because RedCloth is not installed"
+      end
+  
+      begin
+        gem 'bluecloth'
+        require 'bluecloth'
+        
+        it "exposes markdown('foo')" do
+          @builder.markdown("# foo").should == "<h1>foo</h1>"
+        end
+      rescue LoadError
+        puts "WARNING: Not testing markdown() because BlueCloth is not installed"
+      end
+        
+      ## TODO: Test remaining methods from TextHelper are added.
+    end
+    
+    describe "DomIdHelper" do
+      
+      it "generates a unique ID each time it is called" do
+        seen_ids = []
+        10.times do
+          next_id = @builder.dom_id!
+          seen_ids.should_not include(seen_ids)
+          seen_ids << next_id
+        end
+      end
+    end
+    
+    describe "CaptureHelper" do
+      
+      it "returns the results of the passed block - optionally passing through renderer (not tested)" do
+        result = @builder.capture { 'result' }
+        result.should == 'result'
+      end
+      
+      it "adds the result of the passed block to the builder as an instance variable called @content_for_foo" do
+        result = @builder.content_for(:foo) { "result" }
+        @builder.instance_variable_get('@content_for_foo').should == 'result'
+        result.should == ''
+      end
+    end
+        
+  end
+  
+  
+end