sproutcore 1.6.0.beta.2-x86-mingw32

data/lib/sproutcore/builders/handlebars.rb

@@ -0,0 +1,30 @@
+# ===========================================================================
+# Project:   Abbot - SproutCore Build Tools
+# Copyright: ©2011 Strobe Inc.
+#            and contributors
+# ===========================================================================
+
+require "sproutcore/builders/base"
+require "fileutils"
+require "json"
+
+module SC
+
+  class Builder::Handlebars < Builder::Base
+
+    def readlines(src_path)
+      if File.exist?(src_path) && !File.directory?(src_path)
+        File.read(src_path)
+      else
+        ""
+      end
+    end
+
+    def build(dst_path)
+      template_name = entry.rootname[/^.*\/([^\/]*)$/, 1]
+      writelines dst_path, "SC.TEMPLATES[#{template_name.inspect}] = SC.Handlebars.compile(#{readlines(entry[:source_path]).to_json})"
+    end
+  end
+
+end
+

data/lib/sproutcore/builders/html.rb

@@ -0,0 +1,213 @@
+# ===========================================================================
+# Project:   Abbot - SproutCore Build Tools
+# Copyright: ©2009 Apple Inc.
+#            portions copyright @2006-2011 Strobe Inc.
+#            and contributors
+# ===========================================================================
+
+require "sproutcore/builders/base"
+
+module SC
+
+  # Builds an HTML files.  This will setup an HtmlContext and then invokes
+  # the render engines for each source before finally rendering the layout.
+  class Builder::Html < Builder::Base
+
+    include SC::Helpers::TagHelper
+    include SC::Helpers::TextHelper
+    include SC::Helpers::CaptureHelper
+    include SC::Helpers::StaticHelper
+    include SC::Helpers::DomIdHelper
+    include SC::ViewHelpers
+
+    # the entry we are building
+    attr_reader :entry
+
+    # bundle is an alias for target included for backwards compatibility
+    attr_reader :target, :bundle
+
+    # the full set of entries we plan to build
+    attr_reader :entries
+
+    # the final filename
+    attr_reader :filename
+
+    # the current builder language
+    attr_reader :language
+
+    # library is an alias for project for backwards compatibility
+    attr_reader :project, :library
+
+    # the current render
+    attr_reader :renderer
+
+    # manifest owning the current entry
+    attr_reader :manifest
+
+    def target_name; target[:target_name].to_s.sub(/^\//,''); end
+    alias_method :bundle_name, :target_name # backwards compat
+
+    def config; target.config; end
+
+    # The entry for the layout we want to build.  this will be used to
+    # stage the layout if needed..
+    def layout_entry
+      @manifest.entry_for(@layout) || @manifest.entry_for(@layout, :hidden => true)
+    end
+
+    # the path to the current layout for the resource.  this is computed
+    # from the layout property, which is a relative pathname.
+    def layout_path
+      entry = layout_entry
+      entry.nil? ? nil : entry[:staging_path]
+    end
+
+    def initialize(entry)
+      super(entry)
+      @target = @bundle = entry.manifest.target
+      @filename = entry[:filename]
+      @language = @entry.manifest[:language]
+      @project = @library = @target.project
+      @manifest = entry.manifest
+      @renderer = nil
+
+      # set the current layout from the target's config.layout
+      @layout = @target.config[:layout] || 'lib/index.rhtml'
+
+      # find all entries -- use source_Entries + required if needed
+      @entries = entry[:source_entries].dup
+      if entry.include_required_targets?
+        @target.expand_required_targets.each do |target|
+          cur_manifest = target.manifest_for(@manifest.variation).build!
+          cur_entry = cur_manifest.entry_for(entry[:filename], :combined => true) || cur_manifest.entry_for(entry[:filename], :hidden => true, :combined => true)
+          next if cur_entry.nil?
+          @entries += cur_entry[:source_entries]
+        end
+      end
+    end
+
+    # Returns the expanded list of required targets for the passed target.
+    # This method can be overridden by subclasses to provide specific
+    # config settings.
+    def expand_required_targets(target, opts = {})
+      opts[:debug] = target.config[:load_debug]
+      opts[:theme] = true
+      return target.expand_required_targets(opts)
+    end
+
+    # Renders the html file, returning the resulting string which can be
+    # written to a file.
+    def render
+
+      # render each entry...
+      @entries.each { |entry| render_entry(entry) }
+
+      # then finally compile the layout.
+      if self.layout_path.nil?
+        raise "html_builder could not find a layout file for #{@layout}"
+      end
+
+      compile(SC::RenderEngine::Erubis.new(self), self.layout_path, :_final_)
+      return @content_for__final_
+    end
+
+    def build(dst_path)
+      if CONFIG[:html5_manifest]
+        $to_html5_manifest << dst_path
+        $to_html5_manifest_networks = CONFIG[:html5_manifest_networks]
+        @content_for_html5_manifest = true
+      end
+
+      writelines dst_path, [self.render]
+      
+    end
+
+    def default_content_for_key; :resources; end
+
+    # Loads the passed input file and then hands it to the render_engine
+    # instance to compile th file.  the results will be targeted at the
+    # @content_for_resources area by default unless you pass an optional
+    # content_for_key or otherwise override in your template.
+    #
+    # === Params
+    #  render_engine:: A render engine instance
+    #  input_path:: The file to load
+    #  content_for_key:: optional target for content
+    #
+    # === Returns
+    #  self
+    #
+    def compile(render_engine, input_path, content_for_key = nil)
+
+      if content_for_key.nil?
+        if @in_partial
+          content_for_key = :_partial_
+        else
+          content_for_key = self.default_content_for_key
+        end
+      end
+
+      if !File.exist?(input_path)
+        raise "html_builder could compile file at #{input_path} because the file could not be found"
+      end
+
+      old_renderer = @renderer
+      @renderer = render_engine  # save for capture...
+
+      input = File.read(input_path)
+
+      content_for content_for_key do
+        _render_compiled_template( render_engine.compile(input), input_path )
+      end
+
+      @render = old_renderer
+      return self
+    end
+
+    private
+
+    # Renders an entry as a partial.  This will insert the results inline
+    # instead of into a content div.
+    def render_partial(entry)
+
+      # save off
+      old_partial = @content_for__partial_
+      old_in_partial = @in_partial
+
+      @content_for__partial_ = ''
+      @in_partial = true
+      render_entry(entry)
+      ret = @content_for__partial_
+      @content_for__partial_ = old_partial
+      @in_partial = old_in_partial
+
+      return ret
+
+    end
+
+    # Renders a single entry.  The entry will be staged and then its
+    # render task will be executed.
+    def render_entry(entry)
+      @content_for_designer = '<script type="text/javascript">SC.suppressMain = YES;</script>' if $design_mode
+      entry.stage!
+      entry.target.buildfile.invoke entry[:render_task],
+        :entry    => entry,
+        :src_path => entry[:staging_path],
+        :context  => self
+    end
+
+    # Renders a compiled template within this context
+    def _render_compiled_template(compiled_template, input_path="(compiled erb)")
+      self.instance_eval "def __render(); #{compiled_template}; end", input_path
+      begin
+        self.send(:__render) do |*names|
+          self.instance_variable_get("@content_for_#{names.first}")
+        end
+      ensure
+        class << self; self end.class_eval{ remove_method(:__render) } rescue nil
+      end
+    end
+
+  end
+
+end

data/lib/sproutcore/builders/javascript.rb

@@ -0,0 +1,107 @@
+# ===========================================================================
+# Project:   Abbot - SproutCore Build Tools
+# Copyright: ©2009 Apple Inc.
+#            portions copyright @2006-2011 Strobe Inc.
+#            and contributors
+# ===========================================================================
+
+require "sproutcore/builders/base"
+require 'fileutils'
+
+module SC
+
+  # This build is used to process a single javascript file.  It will
+  # substitute any calls to sc_super and sc_static() (or static_url()).  It
+  # does NOT product a combined JavaScript for production.  See the
+  # Builder::CombinedJavaScript for more.
+  class Builder::JavaScript < Builder::Base
+
+    def readlines(src_path)
+      if File.exist?(src_path) && !File.directory?(src_path)
+        File.read(src_path)
+      else
+        ""
+      end
+    end
+
+    def build(dst_path)
+      lines = ""
+      target_name = entry.target[:target_name].to_s.sub(/^\//,'')
+
+      if entry[:lazy_instantiation] && entry[:notify_onload]
+      lines << ";
+if ((typeof SC !== 'undefined') && SC && !SC.LAZY_INSTANTIATION) {
+  SC.LAZY_INSTANTIATION = {};
+}
+if(!SC.LAZY_INSTANTIATION['#{target_name}']) {
+  SC.LAZY_INSTANTIATION['#{target_name}'] = [];
+}
+SC.LAZY_INSTANTIATION['#{target_name}'].push(
+  (
+    function() {
+"
+      end
+
+      code = rewrite_inline_code(readlines(entry[:source_path]))
+      code = handle_debug_code(code)
+      lines << code
+
+      # Try to load dependencies if we're not combining javascript.
+      if entry[:notify_onload]
+        lines << "; if ((typeof SC !== 'undefined') && SC && SC.Module && SC.Module.scriptDidLoad) SC.Module.scriptDidLoad('#{target_name}');"
+      end
+
+      if entry[:lazy_instantiation] && entry[:notify_onload]
+        lines << "
+    }
+  )
+);
+"
+      end
+
+      writelines dst_path, lines
+    end
+
+    # Returns true if the current entry is a localized strings file.  These
+    # files receive some specialized processing to allow for server-side only
+    # strings.  -- You can name a string key beginning with "@@" and it will
+    # be removed.
+    def localized_strings?
+      @lstrings ||= entry[:localized] && entry[:filename] =~ /strings.js$/
+    end
+
+    # Strips or replaces @if(debug) blocks, depending on build mode.
+    def handle_debug_code(code)
+      code.gsub(/\/\/\s*@if\s*\(\s*debug\s*\)([^\0]*?)\/\/\s*@endif/) {|match|
+        if CONFIG[:load_debug]
+          $1
+        else
+          "\n"
+        end
+      }
+    end
+
+    # Rewrites inline content for a single line
+    def rewrite_inline_code(code)
+
+      # Fors strings file, remove server-side keys (i.e '@@foo' = 'bar')
+      if localized_strings?
+        code.gsub!(/["']@@.*["']\s*?:\s*?["'].*["']\s*,\s*$/,'')
+
+      # Otherwise process sc_super
+      else
+        code.gsub!(/sc_super\(\s*\)/, 'arguments.callee.base.apply(this,arguments)')
+        code.gsub!(/sc_super\((.+?)\)/) do
+          SC.logger.warn "\nWARNING: Calling sc_super() with arguments is DEPRECATED. Please use sc_super() only.\n\n"
+          "arguments.callee.base.apply(this, #{$1})"
+        end
+      end
+
+      # and finally rewrite static_url
+      replace_static_url(code)
+      code
+    end
+
+  end
+
+end

data/lib/sproutcore/builders/less.rb

@@ -0,0 +1,41 @@
+# ===========================================================================
+# Project:   Abbot - SproutCore Build Tools
+# Copyright: ©2009 Apple Inc.
+#            portions copyright @2006-2011 Strobe Inc.
+#            and contributors
+# ===========================================================================
+
+require "sproutcore/builders/stylesheet"
+require 'fileutils'
+
+module SC
+
+  # This build can compile a Less stylesheet.
+  class Builder::Less < Builder::Stylesheet
+
+    def build(dst_path)
+      begin
+        require 'less'
+      rescue
+        raise "Cannot compile #{entry.source_path} because less is not installed.  Please try 'sudo gem install less' and try again"
+      end
+
+      begin
+        content = readlines(entry.source_path)
+        css = ::Less::Engine.new(content).to_css
+        lines = []
+        css.each_line { |l| lines << rewrite_inline_code(l) }
+        writelines dst_path, lines
+      rescue Exception => e
+
+        # explain sass syntax error a bit more...
+        if e.is_a? Less::SyntaxError
+          e.message << " of #{@entry.source_path}"
+        end
+        raise e # reraise
+      end # rescue
+    end # def
+
+  end
+
+end

data/lib/sproutcore/builders/minify.rb

@@ -0,0 +1,148 @@
+# ===========================================================================
+# Project:   Abbot - SproutCore Build Tools
+# Copyright: ©2009 Apple Inc.
+#            portions copyright @2006-2011 Strobe Inc.
+#            and contributors
+# ===========================================================================
+
+require "sproutcore/builders/base"
+require 'fileutils'
+
+module SC
+
+  # This builder combines several javascript files into a single file.  It is
+  # used to prepare a single javascript file for production use.  This build
+  # tool expects the javascript files to have already been processed for any
+  # build directives such sc_static().
+  #
+  class Builder::Minify < Builder::Base
+
+    # main entry called by build tasls
+    def self.build(entry, dst_path, kind)
+      new(entry, kind).build(dst_path)
+    end
+
+    def initialize(entry=nil, kind=nil)
+      super(entry)
+      @kind = kind
+    end
+
+    # override this method in subclasses to actually do build
+    def build(dst_path)
+      send("build_#{@kind}".to_sym, dst_path)
+    end
+
+    def build_css(dst_path)
+      a = Regexp.new('^'+MANIFEST.build_root)
+      if dst_path =~ a
+        # $to_minify << dst_path
+        FileUtils.mkdir_p(File.dirname(dst_path))
+        FileUtils.copy(entry.source_path, dst_path)
+      else
+        FileUtils.mkdir_p(File.dirname(dst_path)) # make sure loc exists...
+        filecompress = "java -Xmx128m -jar \"" + SC.yui_jar + "\" --type css --charset utf-8 --line-break 0 --nomunge --preserve-semi --disable-optimizations \"" + entry.source_path + "\" -o \"" + dst_path + "\" 2>&1"
+        SC.logger.info  'Compressing CSS with YUI .... '+ dst_path
+        SC.logger.debug `#{filecompress}`
+
+        if $?.exitstatus != 0
+          _report_error(output, entry.filename, entry.source_path)
+          SC.logger.fatal("!!!!YUI compressor failed, please check that your css code is valid.")
+          SC.logger.fatal("!!!!Failed compressing CSS... "+ dst_path)
+        end
+      end
+    end
+
+    # Minify some javascript by invoking the YUI compressor.
+    def build_javascript(dst_path)
+      entry.source_entry.build!
+
+      # Minify module JavaScript immediately so it can be string-wrapped
+      if entry.target[:target_type] == :module
+        SC::Helpers::Minifier.minify dst_path
+      elsif entry.target[:target_type] == :app
+        SC::Helpers::Minifier << dst_path
+      end
+    end
+
+    def build_inline_javascript(dst_path)
+      SC.logger.info  'Compiling inline Javascript with YUI: ' + dst_path + "..."
+      FileUtils.mkdir_p(File.dirname(dst_path)) # make sure loc exists...
+      filecompress = "java -Xmx128m -jar \"" + SC.yui_jar + "\" --type js \"" + entry.source_path + "\" -o \"" + dst_path + "\" 2>&1"
+      SC.logger.info  'Compiling with YUI:  '+ filecompress + "..."
+
+      output = `#{filecompress}`      # It'd be nice to just read STDERR, but
+                                      # I can't find a reasonable, commonly-
+                                      # installed, works-on-all-OSes solution.
+      if $?.exitstatus != 0
+        _report_error(output, entry.filename, entry.source_path)
+        SC.logger.fatal("!!!!YUI compiler failed, please check that your js code is valid")
+        SC.logger.fatal("!!!!Failed compiling ... "+ dst_path)
+      end
+    end
+
+  private
+
+    def _report_error(output, input_filename, input_filepath)
+      # The output might have some clues to what exactly was wrong, and it'll
+      # be convenient for users if we include the subset.  So we'll read the
+      # line numbers from any output lines that start with "[ERROR]" those
+      # lines, too.
+      if output
+        parsed_a_line = false
+        output.each_line { |output_line|
+          output_line = output_line.chomp
+          if (output_line =~ /^\[ERROR\] (\d+):(\d+):.*/) != nil
+            line_number = $1
+            position    = $2
+            parsed_a_line = true
+            if ( position  &&  position.to_i > 0 )
+              # Read just that line and output it.
+              # (sed -n '3{;p;q;}' would probably be faster, but not
+              # universally available)
+              line_number  = line_number.to_i
+              line_counter = 1
+              begin
+                file = File.new(input_filepath, "r")
+                outputted_line = false
+                previous_line = nil
+                while (file_line = file.gets)
+
+                  if ( line_counter == line_number )
+                    message = "YUI compressor error:  #{output_line} on line #{line_number} of #{input_filename}:\n"
+                    if !previous_line.nil?
+                      message += "        [#{line_number - 1}]  #{previous_line}"
+                    end
+                    message   += "   -->  [#{line_number}]  #{file_line}"
+
+                    SC.logger.error message
+                    outputted_line = true
+                    break
+                  else
+                    previous_line = file_line
+                  end
+                  line_counter += 1
+                end
+                file.close
+              rescue => err
+                SC.logger.error "Could not read the actual line from the file:  #{err}"
+              end
+
+              if !outputted_line
+                SC.logger.error "YUI compressor error:  #{output_line}, but couldn't read that line in the input file"
+              end
+            end
+          end
+        }
+
+        # If we didn't handle at least one line of output specially, then
+        # just output it all.
+        if !parsed_a_line
+          SC.logger.error output
+        end
+      end
+    end
+
+
+  end
+
+end

data/lib/sproutcore/builders/module.rb

@@ -0,0 +1,74 @@
+# ===========================================================================
+# Project:   Abbot - SproutCore Build Tools
+# Copyright: ©2009 Apple Inc.
+#            portions copyright @2006-2011 Strobe Inc.
+#            and contributors
+# ===========================================================================
+
+require "sproutcore/builders/base"
+
+module SC
+
+  # Builds a module_info.js file which MUST be run *before* the framework is
+  # loaded by the application or framework doing the loading.
+  class Builder::ModuleInfo < Builder::Base
+
+    def build(dst_path)
+      begin
+        require 'erubis'
+      rescue
+        raise "Cannot render module_info.js because erubis is not installed. Try running 'sudo gem install erubis' and try again."
+      end
+
+      eruby = Erubis::Eruby.new <<-EOT
+        ;(function() {
+          var target_name = '<%= @target_name %>' ;
+          if (!SC.MODULE_INFO) throw "SC.MODULE_INFO is not defined!" ;
+          if (SC.MODULE_INFO[target_name]) return ; <%# not an error... %>
+
+          <%# first time, so add a Hash with this target's module_info %>
+          SC.MODULE_INFO[target_name] = {
+            dependencies:[<%= @dependencies.join(',') %>],
+            styles:[<%= @styles.join(',') %>],
+            styles2x: [<%= @styles2x.join(',') %>],
+            scriptURL:'<%= @script %>',
+            stringURL:'<%= @string %>'<% if @prefetched %>,
+            isPrefetched: YES
+            <% end %>
+          }
+        })();
+      EOT
+
+      output = ""
+
+      entry.targets.each do |t|
+        next unless t[:target_type] == :module
+
+        manifest = t.manifest_for(entry.manifest.variation)
+
+        script_entry = manifest.find_entry('javascript.js')
+        next if not script_entry
+        script_url = script_entry.cacheable_url
+
+        string_entry = manifest.find_entry('javascript-strings.js')
+        next if not string_entry
+        string_url = string_entry.cacheable_url
+
+        module_info = t.module_info({ :variation => entry[:variation] })
+
+        output << eruby.evaluate({
+          :target_name => t[:target_name].to_s.sub(/^\//,''),
+          :dependencies    => module_info[:requires].map{ |t| "'#{t[:target_name].to_s.sub(/^\//,'')}'" },
+          :styles      => module_info[:css_urls].map{ |url| "'#{url}'" },
+          :styles2x    => module_info[:css_2x_urls].map {|url| "'#{url}'"},
+          :script      => script_url,
+          :string      => string_url,
+          :prefetched  => t[:prefetched_module]
+        })
+      end
+      writelines dst_path, [output]
+    end
+
+  end
+
+end

data/lib/sproutcore/builders/sass.rb

@@ -0,0 +1,65 @@
+# ===========================================================================
+# Project:   Abbot - SproutCore Build Tools
+# Copyright: ©2009 Apple Inc.
+#            portions copyright @2006-2011 Strobe Inc.
+#            and contributors
+# ===========================================================================
+
+require "sproutcore/builders/stylesheet"
+require 'fileutils'
+
+module SC
+
+  # This build can compile a Sass stylesheet.  At this point it does no
+  # further processing than simply executing the Sass.  It would be nice to
+  # add support for sc_static and other directives at some point.
+  #
+  class Builder::Sass < Builder::Stylesheet
+    @@sass_syntax = :sass
+
+    # main entry called by build tasks
+    def self.build(entry, dst_path, sass_syntax=:sass)
+      @@sass_syntax =sass_syntax
+      new(entry).build(dst_path)
+    end
+
+    def build(dst_path)
+      begin
+        require 'sass'
+      rescue
+        raise "Cannot compile #{entry.source_path} because sass is not installed.  Please try 'sudo gem install haml' and try again"
+      end
+
+      begin
+        content = readlines(entry.source_path)
+        load_paths = [entry.source_path[0..entry.source_path.rindex('/')]]
+        css = ::Sass::Engine.new(content, :syntax => @@sass_syntax, :load_paths => load_paths).render
+        lines = []
+        css.each_line { |l| lines << rewrite_inline_code(l) }
+        writelines dst_path, lines
+      rescue Exception => e
+
+        # explain sass syntax error a bit more...
+        if e.is_a? Sass::SyntaxError
+          e_string = "#{e.class}: #{e.message}"
+          e_string << "\non line #{e.sass_line}"
+          e_string << " of #{@entry.source_path}"
+          if File.exists?(@entry.source_path)
+            e_string << "\n\n"
+            min = [e.sass_line - 5, 0].max
+            File.read(@entry.source_path).rstrip.split("\n")[
+              min .. e.sass_line + 5
+            ].each_with_index do |line, i|
+              e_string << "#{min + i + 1}: #{line}\n"
+            end # File.read
+          end # if File.exists?
+          raise e_string
+        else
+          raise e # reraise
+        end
+      end # rescue
+    end # def
+
+  end
+
+end