guilded 1.1.0 → 2.0.0.pre

data/lib/guilded/rails.rb

@@ -1,4 +1,7 @@
-module Guilded
-  module Rails    
-  end
-end
+module Guilded::Rails
+
+  autoload :Controller,  'guilded/rails/controller'
+  autoload :Helpers,     'guilded/rails/helpers'
+  autoload :ViewHelpers, 'guilded/rails/view_helpers'
+
+end

data/lib/guilded/rails/controller.rb

@@ -0,0 +1,23 @@
+module Guilded::Rails
+  module Controller
+
+    def self.included( base )
+      base.instance_eval do
+        attr_reader :guilded
+        helper_method :guilded
+        before_filter :initialize_guilded
+      end
+
+      base.send :include, InstanceMethods
+    end
+
+    module InstanceMethods
+
+      def initialize_guilded
+        @guilded = Guilded::Guilder.new
+      end
+
+    end
+
+  end
+end

data/lib/guilded/rails/helpers.rb

@@ -1,9 +1,7 @@
 module Guilded
   module Rails
 
-    require 'active_support'
-    #require 'rubygems'
-    #gem 'activesupport', '2.3.2'
+    #require 'active_support/all'
 
     # Common functionality that Rails Guilded components may need to use.
     #

data/lib/guilded/rails/view_helpers.rb

@@ -1,118 +1,22 @@
-module Guilded
-  module Rails
-    module ViewHelpers
+module Guilded::Rails
+  module ViewHelpers
 
-      # Generates the initGuildedElements function and includes a call to each GUIlded
-      # element(s) Init method.
-      #
-      # Must be called once per rendered page.  You can include it just before the closing body
-      # tag of your application layout.  If no Guilded elements were called in the template, the
-      # call to g_apply_behavior will not output anything.
-      #
-      def g_apply_behavior( options={} )
-        Guilded::Guilder.instance.generate_javascript_init( options )
-      end
+    def jquery_include_tag( options={} )
+      version = options.fetch( :version, Guilded.configuration.jquery_version )
+      min     = options.fetch( :min, false )
 
-      # Generates the JavaScript include(s) for each Guilded element that is used.
-      #
-      # Must be called once per rendered page.  You can include it just before the closing body
-      # tag of your application layout.  If no Guilded elements were called in the template, the
-      # call to g_apply_includes will not output anything.
-      #
-      def g_apply_includes
-        g = Guilded::Guilder.instance
-        g.generate_asset_lists
-
-        # JavaScript
-        if g.production? && g.use_remote_jquery
-          js_groups = g.combined_js_srcs.partition { |src| src == g.jquery_js }
-          output = javascript_include_tag( g.jquery_remote_url )
-          output << javascript_include_tag( js_groups[1], :cache => "cache/#{g.js_cache_name}" ) unless js_groups[1].nil?
-        else
-          output = javascript_include_tag( g.combined_js_srcs, :cache => "cache/#{g.js_cache_name}" )
-        end
-        output
-      end
-
-      def g_apply_style
-        "<!-- guilded.styles -->"
-      end
-
-      # Injects the CSS into the header.  Must be called once per rendered page and within a scope that allows access
-      # to the output buffer of the tempalte system being used.
-      #
-      def g_inject_styles
-        g = Guilded::Guilder.instance
-        self.output_buffer.sub!( /<!-- guilded.styles -->/, stylesheet_link_tag( g.combined_css_srcs, :cache => "cache/#{g.css_cache_name}" ) )
-      end
-
-      # Creates a javascript include tag for a Guilded specific file.  The only difference
-      # being that it adds the file to a sources array to be concatenated and included at the
-      # end of the page with the dependencies specified for the Guilded components used.
-      #
-      # To explicitly include the jQuery or MooTools libraries you can use :jquery and/or :mootools
-      # respectively.  If a component that uses either jQuery or MooTools is used on a page, there is
-      # no need to explicitly include the library, as it will be resolved as a dependency and only
-      # included once.
-      #
-      def g_javascript_include_tag( *sources )
-        g = Guilded::Guilder.instance
-        defaults = nil
-        if sources.include?( :defaults )
-          defaults = ActionView::Helpers::AssetTagHelper::JAVASCRIPT_DEFAULT_SOURCES
-          sources.delete( :defaults )
-        end
-        if sources.include?( :jquery )
-          sources.insert( 0, g.jquery_js ) unless sources.include?( g.jquery_js )
-          sources.delete( :jquery )
-        end
-        if sources.include?( :mootools )
-          unless sources.include?( g.mootools_js )
-            insert_at = 0
-            insert_at = 1 if( sources.include?( g.jquery_js ) )
-            sources.insert( insert_at, g.mootools_js )
-          end
-          sources.delete( :mootools )
-        end
-        if defaults
-          g.add_js_sources( *(sources << defaults) )
-        else
-          g.add_js_sources( *sources )
-        end
-        ''
-      end
-
-      # Replaces the Rails stylesheet_link_tag helper if you wnat Guilded to manage CSS for you.
-      # Although the syntax is exactly the same, the method works a little differently.
-      #
-      # This helper adds the stylesheet(s) to a collection to be renderred out together
-      # with all the guilded componenets stylesheets.  This allows the stylesheets passed
-      # to this method to be cached with the guilded stylesheests into a single reusable file.
-      #
-      # The helper will ensure that these stylesheets are included after Guilded's reset
-      # stylesheet and before guilded's component's stylesheets so that they can override any
-      # resets, etc and not override any guilded components styles.
-
-      # *options*
-      # :position The place to position the css. pre for before the component's css or post for after.
-      #    Defaults to post.
-      #
-      def g_stylesheet_link_tag( *sources )
-        options = sources.extract_options! || {}
-        options[:position] ||= :post
-        sources.each { |src| Guilded::Guilder.instance.add_css_source( src, options[:position] ) }
-        ''
-      end
+      raw "<script src=\"#{jquery_url( version, min )}\" type=\"text/javascript\"></script>"
+    end
 
-      def g_skin_tag( source, skin='default' )
-        path = "#{RAILS_ROOT}/public/stylesheets/#{GUILDED_JS_FOLDER}#{GUILDED_NS}#{source.to_s}/#{skin}.css"
-        if File.exists?( path )
-          stylesheet_link_tag( "/stylesheets/#{GUILDED_JS_FOLDER}#{GUILDED_NS}#{source.to_s}/#{skin}.css" )
-        else
-          ""
-        end
-      end
+    def jquery_url( version, min )
+      %w(development test cucumber).include?( Guilded.configuration.environment.to_s ) ?
+        Guilded.configuration.local_jquery_name( version, min ) :
+        Guilded.configuration.jquery_google_url( version )
+    end
 
+    def apply_guilded_behavior
+      raw guilded.javascript_initializer
     end
+
   end
-end
+end

data/lib/guilded/version.rb

@@ -1,3 +1,3 @@
 module Guilded
-  VERSION = "1.1.0"
+  VERSION = "2.0.0.pre"
 end

data/spec/guilded/component_spec.rb

@@ -0,0 +1,13 @@
+require 'spec_helper'
+
+describe Guilded::Component do
+
+  let :component do
+    described_class.new :flash_growler, :position => :bottom, :delay => 4000
+  end
+
+  it "should produce the correct javascript initializer" do
+    component.javascript_initializer.should == "g.initFlashGrowler({\"position\":\"bottom\",\"delay\":4000});"
+  end
+
+end

data/spec/guilded/configuration_spec.rb

@@ -0,0 +1,68 @@
+require 'spec_helper'
+
+describe Guilded::Configuration do
+
+  subject { Guilded.configuration }
+
+  before :each do
+    Guilded.configure do |config|
+      config.environment    = :production
+      config.jquery_version = '1.8.3'
+    end
+  end
+
+  it "should have the correct value for environment" do
+    subject.environment.should == :production
+  end
+
+  it "should have the correct value for jquery_verison" do
+    subject.jquery_version.should == '1.8.3'
+  end
+
+  context "when the jquery_google_url_template is not overridden" do
+
+    it "should have the correct value for the jquery_google_url_template" do
+      subject.jquery_google_url_template.should == "https://ajax.googleapis.com/ajax/libs/jquery/{{version}}/jquery.min.js"
+    end
+
+  end
+
+  context "when the jquery_google_url_template is overridden" do
+
+    before :each do
+      Guilded.configure do |config|
+        config.jquery_google_url_template = "something"
+      end
+    end
+
+    it "should have the correct value for the jquery_google_url_template" do
+      subject.jquery_google_url_template.should == "something"
+    end
+
+  end
+
+  it "should have return the correct value for jquery_google_url" do
+    subject.jquery_google_url( '1.8.3' ).should == "https://ajax.googleapis.com/ajax/libs/jquery/1.8.3/jquery.min.js"
+  end
+
+  describe "#local_jquery_name" do
+
+    context "when min version is requested" do
+
+      it "should return the correct value" do
+        subject.local_jquery_name( '1.8.3', true ).should == "/assets/jquery-1.8.3.min.js"
+      end
+
+    end
+
+    context "when uncompressed version is requested" do
+
+      it "should return the correct value" do
+        subject.local_jquery_name( '1.8.3', false ).should == "/assets/jquery-1.8.3.js"
+      end
+
+    end
+
+  end
+
+end

data/spec/guilded/data_spec.rb

@@ -0,0 +1,29 @@
+require 'spec_helper'
+
+describe Guilded::Data do
+
+  let :data do
+    subject
+  end
+
+  context "when there is no data" do
+
+    it "should output the correct javascript" do
+      data.to_javascript.should == "g[\"data\"]={};"
+    end
+
+  end
+
+  context "when there is data" do
+
+    before :each do
+      data.add :a => 1, :b => { :c => 3}
+    end
+
+    it "should output the correct javascript" do
+      data.to_javascript.should == "g[\"data\"]={\"a\":1,\"b\":{\"c\":3}};"
+    end
+
+  end
+
+end

data/spec/guilded/guilder_spec.rb

@@ -1,77 +1,81 @@
-require File.expand_path( File.join( File.dirname(__FILE__), '..', 'spec_helper' ) )
+require 'spec_helper'
 
 describe Guilded::Guilder do
-  before :each do
-    @g = Guilded::Guilder.instance
-  end
-  
-  it "should return an instance" do
-    @g.should_not be_nil
-  end
-  
-  it "should be a singleton" do
-    @g.initialized_at.should eql( Guilded::Guilder.instance.initialized_at )
-  end
-  
-  it "should have 1 css source after init" do
-    @g.combined_css_srcs.size.should eql( 1 )
-  end
-  
-  it "should have 3 js sources after init" do
-    @g.combined_js_srcs.size.should eql( 3 )
-  end
-  
-  it "should increase count by one when you add a component" do
-    count = @g.count
-    @g.add( 'grid', { :id => 'grid' } )
-    @g.count.should eql( count + 1 )
-  end
-  
-  it "should respond to add" do
-    @g.respond_to?( :add ).should be_true
-  end
-  
-  it "should respond to count" do
-    @g.respond_to?( :count ).should be_true
-  end
 
-  it "should respond to reset!" do
-    @g.respond_to?( :reset! ).should be_true
+  let :guilder do
+    subject
   end
 
-  it "should respond to apply" do
-    @g.respond_to?( :apply ).should be_true
-  end
-  
-  it "should respond to generate_javascript_init" do
-    @g.respond_to?( :generate_javascript_init ).should be_true
-  end
+  describe "#component?" do
 
-  it "should respond_to js_cache_name" do
-    @g.respond_to?( :js_cache_name ).should be_true
-  end
+    context "when there is a component already in existence" do
 
-  it "should respond_to css_cache_name" do
-    @g.respond_to?( :css_cache_name ).should be_true
-  end
-  
-  it "should respond_to generate_js_cache_name" do
-    @g.respond_to?( :generate_js_cache_name ).should be_true
-  end
+      before :each do
+        guilder.add :flash_growler
+      end
 
-  it "should respond_to generate_css_cache_name" do
-    @g.respond_to?( :generate_css_cache_name ).should be_true
-  end
+      it "should agree that the component is already defined" do
+        guilder.component?( :flash_growler ).should be_true
+      end
+
+    end
+
+    context "when there is not a component already in existence" do
+
+      before :each do
+        guilder.add :flash_growler
+      end
+
+      it "should agree that the component is already defined" do
+        guilder.component?( :scroll_to ).should be_false
+      end
+
+    end
 
-  it "should respond_to combined_css_srcs" do
-    @g.respond_to?( :combined_css_srcs ).should be_true
   end
 
-  it "should respond_to combined_js_srcs" do
-    @g.respond_to?( :combined_js_srcs ).should be_true
+  context "when there are components requiring javascript" do
+
+    before :each do
+      guilder.add :flash_growler, :position => :bottom
+    end
+
+    it "should generate the correct javascript initializer" do
+      guilder.javascript_initializer.should == "<script type=\"text/javascript\">\n//<![CDATA[\ng[\"data\"]={};var initGuilded = function(){g.initFlashGrowler({\"position\":\"bottom\"});};jQuery('document').ready(initGuilded);jQuery('body').trigger('guildedInitialized');\n//]]>\n</script>"
+    end
+
   end
 
-  it "should respond_to initialized_at" do
-    @g.respond_to?( :initialized_at ).should be_true
+  context "when there are no components requiring javascript" do
+
+    before :each do
+      guilder.add :flash_growler, :has_javascript => false, :position => :bottom
+    end
+
+    it "should generate the correct javascript initializer" do
+      guilder.javascript_initializer.should == "<script type=\"text/javascript\">\n//<![CDATA[\ng[\"data\"]={};jQuery('body').trigger('guildedInitialized');\n//]]>\n</script>"
+    end
+
+    context "and there is no data to pass" do
+
+      it "should generate the correct javascript initializer" do
+        guilder.javascript_initializer.should == "<script type=\"text/javascript\">\n//<![CDATA[\ng[\"data\"]={};jQuery('body').trigger('guildedInitialized');\n//]]>\n</script>"
+      end
+
+    end
+
+    context "and there is data to pass" do
+
+      before :each do
+        guilder.add_data :a => 1
+      end
+
+      it "should generate the correct javascript initializer" do
+        guilder.javascript_initializer.should == "<script type=\"text/javascript\">\n//<![CDATA[\ng[\"data\"]={\"a\":1};jQuery('body').trigger('guildedInitialized');\n//]]>\n</script>"
+      end
+
+    end
+
   end
-end
+
+end