sprout 0.7.219-i686-darwin10

data/lib/sprout/remote_file_loader.rb

@@ -0,0 +1,71 @@
+
+module Sprout
+  class RemoteFileLoaderError < StandardError #:nodoc:
+  end
+
+  class RemoteFileLoader #:nodoc:
+    
+    def get_remote_file(uri, force=false, md5=nil)
+      response = fetch(uri.to_s)
+      if(force || response_is_valid?(response, md5))
+        return response
+      end
+    end
+    
+    def response_is_valid?(response, expected_md5sum=nil)
+      if(expected_md5sum)
+        md5 = Digest::MD5.new
+        md5 << response
+        
+        if(expected_md5sum != md5.hexdigest)
+          puts "The MD5 Sum of the downloaded file (#{md5.hexdigest}) does not match what was expected (#{expected_md5sum})."
+          puts "Would you like to install anyway? [Yn]"
+          response = $stdin.gets.chomp!
+          if(response.downcase == 'y')
+            return true
+          else
+            raise RemoteFileLoaderError.new('MD5 Checksum failed')
+          end
+        end
+      end
+      return true
+    end
+    
+    def fetch(uri)
+      uri = URI.parse(uri)
+      progress = nil
+      response = nil
+      name = uri.path.split("/").pop
+      
+      raise RemoteFileLoaderError.new("The RemoteFileTask failed for #{name}. We can only handle HTTP requests at this time, it seems you were trying: '#{uri.scheme}'") if uri.scheme != 'http'
+      begin
+        open(uri.to_s, :content_length_proc => lambda {|t|
+          if t && t > 0
+            progress = ProgressBar.new(name, t)
+            progress.file_transfer_mode
+            progress.set(0)
+          else
+            progress = ProgressBar.new(name, 0)
+            progress.file_transfer_mode
+            progress.set(0)
+          end
+        },
+        :progress_proc => lambda {|s|
+          progress.set s if progress
+        }) do |f|
+          response = f.read
+          progress.finish
+        end
+      rescue SocketError => sock_err
+        raise RemoteFileLoaderError.new("[ERROR] #{sock_err.to_s}")
+      rescue OpenURI::HTTPError => http_err
+        raise RemoteFileLoaderError.new("[ERROR] Failed to load file from: '#{uri.to_s}'\n[REMOTE ERROR] #{http_err.io.read.strip}")
+      rescue Errno::ECONNREFUSED => econ_err
+        raise Errno::ECONNREFUSED.new("[ERROR] Connection refused at: '#{uri.to_s}'")
+      end
+
+      return response
+    end
+    
+  end
+end

data/lib/sprout/remote_file_target.rb

@@ -0,0 +1,151 @@
+
+module Sprout
+  class RemoteFileTargetError < StandardError #:nodoc:
+  end
+
+  class RemoteFileTarget # :nodoc:
+
+    attr_writer   :archive_path
+    
+    # The string environment variable name to check before downloading anything.
+    attr_accessor :environment
+    
+    # The user path where this gem will download and install files
+    # This value is set by the Sprout::Builder that creates this RemoteFileTarget
+    attr_accessor :install_path
+
+    # Optional md5 hash, usually set in the sprout.spec for each RemoteFileTarget
+    # If this value is set, the downloaded archive will be hashed, the hashes will
+    # be compared and if they differ, the installation process will break.
+    attr_accessor :md5
+
+    # Used for dmg archives. Absolute path to the mounted dmg (essentially its name)
+    attr_accessor :mount_path
+
+    # Which platform will this RemoteFileTarget support.
+    # Supported options are:
+    #  * universal
+    #  * macosx
+    #  * win32
+    #  * linux
+    attr_accessor :platform
+
+    # URL where Sprouts can go to download the RemoteFileTarget archive
+    attr_accessor :url
+    
+    # If the archive type cannot be assumed from the returned file name,
+    # it must be provided as one of the following:
+    #   :exe
+    #   :zip
+    #   :targz
+    #   :gzip
+    #   :swc
+    #   :rb
+    #   :dmg
+    # @see ArchiveUnpacker
+    attr_accessor :archive_type
+
+    # Filename for the downloaded file. Introduced to fix railsy URL issues.
+    attr_accessor :filename
+
+    # Relative path within the archive to the executable or binary of interest
+    def archive_path
+      @archive_path ||= ''
+    end
+
+    # Resolve this RemoteFileTarget now. This method is called by the Sprout::Builder
+    # and will download, install and unpack the described archive, unless it is
+    # already installed
+    def resolve(update=false)
+      # Wanted to raise, but it seems we support RemoteFileTargets that are actually self-installed binaries...
+      # like SWFMill on Linux. @see the BuilderTest.test_build_no_install for more info.
+      # raise RemoteFileTargetError.new('Cannot retrieve a RemoteFileTarget without a url') if url.nil?
+      return if url.nil?
+      
+      if(filename)
+        self.downloaded_path = File.join(File.dirname(downloaded_path), filename)
+      end
+      
+      if(url && (update || !File.exists?(downloaded_path)))
+        content = download(url, update)
+        FileUtils.makedirs(File.dirname(downloaded_path))
+        FileUtils.touch(downloaded_path)
+        File.open(downloaded_path, 'rb+') do |file|
+          file.write(content)
+        end
+      end
+
+      if(!File.exists?(installed_path) || !File.exists?(File.join(installed_path, archive_path) ))
+        archive_root = File.join(install_path, 'archive')
+        install(downloaded_path, archive_root, update, archive_type)
+      end
+    end
+    
+    # Return the basename of the executable that this RemoteFileTarget refers to
+    def executable
+      return File.basename(archive_path)
+    end
+    
+    # The root path to the unpacked archive files. This is the base path that will be added to any
+    # +archive_path+ relative paths
+    def installed_path
+      @installed_path ||= inferred_installed_path
+      return @installed_path
+    end
+    
+    def downloaded_path=(path)
+      @downloaded_path = path
+    end
+    
+    # Parent directory where archives are downloaded
+    # can be something like: ~/Library/Sprouts/cache/0.7/sprout-somesprout-tool.x.x.x/
+    def downloaded_path
+      @downloaded_path ||= File.join(install_path, file_name(url))
+      return @downloaded_path
+    end
+    
+    # Base file name represented by the provided +url+
+    # Will strip off any ? arguments and trailing slashes. May not play nice with Rails URLS,
+    # We expect archive file name suffixes like, zip, gzip, tar.gz, dmg, etc.
+    def file_name(url=nil)
+      return @filename if(@filename)
+
+      url ||= self.url
+      url = url.split('?').shift
+      
+      parts = url.split('/')
+      if(parts.last == '/')
+        parts.pop
+      end
+      
+      file = parts.pop
+      
+      if(!archive_type.nil? && file.match(/\.#{archive_type.to_s}$/).nil?)
+        file << ".#{archive_type.to_s}"
+      end
+      
+      return file
+    end
+    
+    private
+    
+    def inferred_installed_path
+      if(!environment.nil? && !ENV[environment].nil? && File.exists?(ENV[environment]))
+        return ENV[environment]
+      end
+      
+      return File.join(install_path, 'archive')
+    end
+    
+    def download(url, update=false)
+      loader = RemoteFileLoader.new
+      loader.get_remote_file(url, update, md5)
+    end
+    
+    def install(from, to, force, archive_type=nil)
+      unpacker = ArchiveUnpacker.new
+      unpacker.unpack_archive(from, to, force, archive_type)
+    end
+    
+  end
+end

data/lib/sprout/simple_resolver.rb

@@ -0,0 +1,88 @@
+=begin
+Copyright (c) 2007 Pattern Park
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+=end
+require 'erb'
+
+module Sprout
+
+  class SimpleResolver #:nodoc:
+
+    def initialize(template, output, files, base_dir=nil)
+      @template = template
+      @output = output
+      @files = files
+      @base_dir = base_dir
+      @ignored_files = []
+      execute
+      finish
+    end
+  
+    def execute
+      template_file = File.open(@template, 'r')
+      content = template_file.read
+      result = ERB.new(content, nil, '>').result(binding)
+
+      output_file = File.open(@output, 'w')
+      output_file.write(result)
+    
+      template_file.close
+      output_file.close
+    end
+  
+    def files
+      return @files
+    end
+
+    def finish
+      if(@ignored_files.size > 0)
+        Logger.puts '>> SimpleResolver ignored the following files because their names were invalid:'
+        @ignored_files.each do |file|
+          puts file
+        end
+      end
+    end
+  
+    def xml_edit_warning
+      return <<EOF
+    <!--
+    DO NOT EDIT THIS FILE!
+    This file was auto-generated from
+    an ERB template which can be
+    found at: 
+    #{@template}
+    -->
+EOF
+    end
+  
+    def edit_warning
+      return <<EOF
+  /*************************************
+   * DO NOT EDIT THIS FILE!
+   * This file was auto-generated from
+   * an ERB template which can be
+   * found at: 
+   * #{@template}
+   *************************************/
+EOF
+    end
+  end
+end

data/lib/sprout/tasks/erb_resolver.rb

@@ -0,0 +1,118 @@
+require 'erb'
+
+# Rake task that makes it stupid-easy to render ERB templates
+# to disk. Just add parameters to the yielded object, and
+# they will be available to your Template.
+#
+#   erb_resolver 'config/SomeFile.xml' do |t|
+#     t.param1 = 'value'
+#     t.other_param = 'other value'
+#     t.another_param = ['a', 'b', 'c']
+#   end
+#
+# Your erb template must be found at: 
+#
+#   [task_name].erb
+#
+# For the above example, this file would be: 
+#
+#   config/SomeFile.xml.erb
+# 
+module Sprout
+  
+  class ERBResolver < Rake::FileTask
+
+    # Path to the input ERB template. This
+    # value will default to the value of
+    # "#{ERBResolver.output}.erb"
+    attr_accessor :template
+
+    def initialize(name, app) # :nodoc:
+      super
+      @context = ERBContext.new
+    end
+
+    def define(args)
+    end
+
+    def prepare
+      prepare_prerequisites
+    end
+
+    # Modified from Rake::Task.execute
+    def execute(args=nil)
+      args ||= EMPTY_TASK_ARGS
+      if application.options.dryrun
+        puts "** Execute (dry run) #{name}"
+        return
+      end
+      if application.options.trace
+        puts "** Execute #{name}"
+      end
+      application.enhance_with_matching_rule(name) if @actions.empty?
+      @actions.each do |action|
+        execute_erb_task(action, args)
+      end
+    end
+    
+    def execute_erb_task(action, args=nil)
+      case action.arity
+      when 1
+        action.call(@context)
+      else
+        action.call(@context, args)
+      end
+      
+      @context.execute(template, output, args)
+    end
+
+    def self.define_task(*args, &block)
+      t = super
+      if(t.is_a?(ERBResolver))
+        t.define(args)
+        t.prepare
+      end
+      return t
+    end
+
+    def template
+      @template ||= "#{output}.erb"
+    end
+
+    def output
+      self.name
+    end
+
+    protected
+
+    def prepare_prerequisites
+      prerequisites << file(template)
+      CLEAN.add(output)
+    end
+
+  end
+  
+  # An empty, dynamic object that will be yielded
+  # to the provided block and later supplied to the
+  # ERB template.
+  #
+  # Returning this empty object gives us the ability
+  # to use parameter names in our templates even if
+  # they are already used by Rake tasks (i.e. name).
+  class ERBContext
+    include DynamicAccessors
+    
+    def execute(template, output, args=nil)
+      content = nil
+      File.open(template, 'r') { |f| content = f.read }
+      result = ERB.new(content, nil, '>').result(binding)
+      File.open(output, 'w') { |f| f.write(result) }
+      Log.puts ">> Created ERB output at: #{output} from: #{template}"
+    end
+  end
+  
+end
+
+def erb_resolver(*args, &block)
+  Sprout::ERBResolver.define_task(args, &block)
+end

data/lib/sprout/tasks/gem_wrap_task.rb

@@ -0,0 +1,200 @@
+=begin
+Copyright (c) 2007 Pattern Park
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+TODO: Update mxmlc task
+ * Update mxmlc to include all advanced options
+ * Clean up default values
+ * Investigate jruby support, especially:
+    http://livedocs.adobe.com/flex/201/html/wwhelp/wwhimpl/common/html/wwhelp.htm?context=LiveDocs_Book_Parts&file=compilers_123_09.html
+=end
+
+module Sprout
+  class GemWrapError < StandardError #:nodoc:
+  end
+
+  # Creates a ruby gem from a slightly simpler rake task than what gems provides.
+  # Adds support for adding a sprout.spec file to your new gem which is usually useful
+  # for tool or library sprout gems.
+  class GemWrapTask < Rake::Task
+    # The full name of the gem to create like:
+    #   t.gem_name = 'sprout-as3-bundle'
+    attr_writer :gem_name
+    # The type of sprout to create, defaults to 'library'
+    # Other possible values are, 'bundle' and 'tool'
+    attr_writer :sprout_type
+    # Full string rubygem version for this sprout, usually in three parts like:
+    #  t.version = '0.0.1'
+    attr_writer :version
+    # Folder that the newly-created gem should be placed in
+    attr_writer :package
+    # Summary or short description for the gem
+    attr_writer :summary
+    # The author that created the gem
+    attr_writer :author
+    # Email address for interested users to send questions to
+    attr_writer :email
+    # Homepage where users can learn more about this gem
+    attr_writer :homepage
+    # A string remote file specification usually something like:
+    # 
+    #   t.sprout_spec   =<<EOF
+    #   - !ruby/object:Sprout::RemoteFileTarget 
+    #     platform: universal
+    #     url: http://as3flickrlib.googlecode.com/files/flickr-.87.zip
+    #     archive_path: flickr-.87/src
+    #   EOF
+    attr_writer :sprout_spec
+
+    def self.define_task(args, &block)
+      t = super
+      yield t if block_given?
+      t.define
+    end
+
+    def define # :nodoc:
+      define_gem_name
+      define_extensions(extensions)
+    end
+
+    def initialize(task_name, app) # :nodoc:
+      super
+      @sprout_type    = "library"
+      @package        = "pkg"
+      @summary        = "#{task_name}"
+      @email          = "projectsprouts@googlegroups.com"
+      @homepage       = "http://www.projectsprouts.org"
+    end
+  
+    def execute(*args) # :nodoc:
+      super
+      raise GemWrapError.new("A version must be provided to produce a Gem!") unless @version
+      @summary = "#{name} #{@sprout_type} generated by Sprout::GemWrapTask" unless @summary
+
+      FileUtils.mkdir_p(gem_package)
+      render_sprout_spec(gem_package, @sprout_spec) if @sprout_spec
+#      render_extensions(gem_package, extensions) if extensions.size
+
+      Dir.chdir(gem_package) do
+  
+        spec = Gem::Specification.new do |s|
+          files           = []
+          s.platform      = Gem::Platform::RUBY
+          s.version       = @version
+          s.author        = @author if @author
+          s.summary       = @summary
+          s.name          = @gem_name
+          s.email         = @email
+          s.homepage      = @homepage
+          s.rubyforge_project = 'sprout'
+          gem_dependencies.each do |dep|
+            s.requirements << dep
+          end
+          
+          sprout_requirement = s.requirements.collect do |req|
+            (req[0] == 'sprout')
+          end
+          
+          if(!sprout_requirement)
+            s.add_dependency('sprout', '>= 0.7.209')
+          end
+
+          if(File.exists?('sprout.spec'))
+            files << 'sprout.spec'
+          end
+          if(extensions.size > 0)
+            files << 'ext'
+          end
+          zipped_extensions.each do |ext|
+            files << File.join('ext', File.basename(ext))
+          end
+          s.files         = files
+        end
+        Gem::Builder.new(spec).build
+      end
+
+      FileUtils.mv("#{gem_package}/#{@gem_name}-#{@version}.gem", @package)  
+      FileUtils.rm_rf(gem_package)
+    end
+    
+    # Add a gem dependency either with only the gem name
+    # or with a full name and version hash like:
+    # 
+    #   t.add_dependency('sprout-flashplayer-tool')
+    # or
+    #   t.add_dependency('sprout-flashplayer-tool' => '9.115.0')
+    #
+    def add_dependency(args)
+      gem_dependencies << args
+    end
+
+    def gem_dependencies
+      return @gem_dependencies ||= []
+    end
+    
+    # Add files to include in the gem/ext folder
+    def extensions
+      return @extensions ||= []
+    end
+    
+    private
+
+    def gem_package
+      @gem_package ||= File.join(@package, @gem_name)
+    end
+
+    def zipped_extensions
+      return @zipped_extensions ||= []
+    end
+
+    def define_gem_name
+      @gem_name = "sprout-#{name}-#{@sprout_type}" if !@gem_name
+    end
+
+    def define_extensions(exts)
+      exts.each do |ext|
+        if(File.directory?(ext))
+          full = File.expand_path(ext)
+          t = nil
+
+          zip full do |z|
+            z.input = full
+            z.output = File.join(gem_name, 'ext', File.basename(full) + '.zip')
+          end
+          puts "pwd: #{Dir.pwd} out #{t.output}"
+          zipped_extensions << File.expand_path(t.output)
+          prerequisites << t.output
+        end
+      end
+    end
+
+    def render_sprout_spec(target, spec)
+      File.open(File.join(target, 'sprout.spec'), 'w') do |f|
+        f.write(spec)
+      end
+    end
+
+  end
+end
+
+def gem_wrap(args, &block)
+  Sprout::GemWrapTask.define_task(args, &block)
+end