# File sprout/lib/sprout.rb, line 457
    def self.child_rakefile(dir)
      @@default_rakefiles.each do |file|
        rake_path = File.join(dir, file)
        if(File.exists?(rake_path))
          return rake_path
        end
      end
      return nil
    end

# File sprout/lib/sprout.rb, line 355
    def self.find_gem_spec(name, requirements=nil, recursed=false)
      specs = Gem::cache.sprout_search(/.*#{name}$/).reverse # Found specs are returned in order from oldest to newest!?
      requirement = nil
      if(requirements)
        requirement = Gem::Requirement.new(requirements)
      end
      specs.each do |spec|
        if(requirements)
          if(requirement.satisfied_by?(spec.version))
            return spec
          end
        else
          return spec
        end
      end

      if(recursed)
        raise SproutError.new("Gem Spec not found for #{name} #{requirements}")
      else
        msg = ">> Loading gem [#{name}]"
        msg << " #{requirements}" if requirements
        msg << " from #{gem_sources.join(', ')} with its dependencies"
        Log.puts msg
        parts = [ 'ins', '-r', name ]
        # This url should be removed once released, released gems should be hosted from the rubyforge
        # project, and development gems will be hosted on our domain.
        parts << "--source #{gem_sources.join(' --source ')}" if(Log.debug || name.index('sprout-'))
        parts << "-v #{requirements}" unless requirements.nil?

        self.load_gem(parts.join(" "))
        Gem::cache.refresh!
        return find_gem_spec(name, requirements, true)
      end
    end

# File sprout/lib/sprout.rb, line 344
    def self.gem_file_cache(name, version)
      return File.join(sprout_cache, "#{name}-#{version}")
    end

# File sprout/lib/sprout.rb, line 136
    def self.generate(sprout_name, generator_name, params, project_path=nil)
      # params.each_index do |index|
      #   params[index] = clean_project_name(params[index])
      # end
      RubiGen::Base.use_sprout_sources!(sprout_name, project_path)
      generator = RubiGen::Base.instance(generator_name, params)
      generator.command(:create).invoke!
    end

# File sprout/lib/sprout.rb, line 252
    def self.get_executable(name, archive_path=nil, version=nil)
      target = self.sprout(name, version)
      if(archive_path)
        # If caller sent in a relative path to an executable (e.g., bin/mxmlc), use it
        exe = File.join(target.installed_path, archive_path)
        if(User.new.is_a?(WinUser) && !archive_path.match(/.exe$/))
          # If we're on Win (even Cygwin), add .exe to support custom binaries (see sprout-flex3sdk-tool)
          if(File.exists?(exe + '.exe'))
            exe << '.exe'
          end
        end
      elsif(target.url)
        # Otherwise, use the default path to an executable if the RemoteFileTarget has a url prop
        exe = File.join(target.installed_path, target.archive_path)
      else
        # Otherwise attempt to run the feature from the system path
        exe = target.archive_path
      end
      
      if(!File.exists?(exe))
        raise UsageError.new("Could not retrieve requested executable from path: #{exe}")
      end
      
      if(File.exists?(exe) && !File.directory?(exe) && File.stat(exe).executable?)
        File.chmod 0755, exe
      end
      
      return exe
    end

# File sprout/lib/sprout.rb, line 208
    def self.get_executable_from_path(exe)
      path = ENV['PATH']
      file_path = nil
      path.split(get_path_delimiter).each do |p|
        file_path = File.join(p, exe)
#        file_path = file_path.split("/").join("\\")
#        file_path = file_path.split("\\").join("/")
        if(File.exists?(file_path))
          return User.clean_path(file_path)
        end
      end
      return nil
    end

# File sprout/lib/sprout.rb, line 193
    def self.get_gem_preamble
      usr = User.new()
      if(!usr.is_a?(WinUser))
        # Everyone but Win and Cygwin users get 'sudo '
        return "#{SUDO_INSTALL_GEMS ? 'sudo ' : ''}gem"
      elsif(!usr.is_a?(CygwinUser))
        # We're in the DOS Shell
        return "ruby #{get_executable_from_path('gem')}"
      end
      # We're either a CygwinUser or some other non-sudo supporter
      return 'gem'
    end

# File sprout/lib/sprout.rb, line 467
    def self.get_implicit_project_path(path)
      # We have recursed to the root of the filesystem, return nil
      if(path.nil? || path == '/' || path.match(/[A-Z]\:\//))
        return Dir.pwd
      end
      # Look for a rakefile as a child of the current path
      if(child_rakefile(path))
        return path
      end
      # No rakefile and no root found, check in parent dir
      return Sprout.get_implicit_project_path(File.dirname(path))
    end

# File sprout/lib/sprout.rb, line 222
    def self.get_path_delimiter
      usr = User.new
      if(usr.is_a?(WinUser) && !usr.is_a?(CygwinUser))
        return ';'
      else
        return ':'
      end
    end

# File sprout/lib/sprout.rb, line 319
    def self.home
      return @@home
    end

# File sprout/lib/sprout.rb, line 401
    def self.ignore_file? file
      @@COPY_IGNORE_FILES.each do |name|
        if(name == file)
          return true
        end
      end
      return false
    end

# File sprout/lib/sprout.rb, line 337
    def self.inferred_sprout_cache
      home = User.application_home(@@name)
      return File.join(home, @@cache, "#{VERSION::MAJOR}.#{VERSION::MINOR}")
    end

# File sprout/lib/sprout.rb, line 390
    def self.load_gem(args)
      # This must use a 'system' call because RubyGems
      # sends an 'exit'?
      system("#{get_gem_preamble} #{args}")
    end

# File sprout/lib/sprout.rb, line 431
    def self.project_name
      @@project_name ||= ''
    end

# File sprout/lib/sprout.rb, line 444
    def self.project_path
      @@project_path ||= self.project_path = get_implicit_project_path(Dir.pwd)
    end

# File sprout/lib/sprout.rb, line 449
    def self.project_rakefile
      if(!defined?(@@project_rakefile))
        path = project_path
      end
      return @@project_rakefile ||= nil
    end

# File sprout/lib/sprout.rb, line 146
    def self.remove_all
      # Set up sudo prefix if not on win machine
      # Only show confirmation if there is at least one installed sprout gem
      confirmation = false
      count = 0
      # For each sprout found, remove it!
      RubiGen::GemGeneratorSource.new().each_sprout do |sprout|
        count += 1
        command = "#{get_gem_preamble} uninstall -x -a -q #{sprout.name}"

        if(!confirmation)
          break unless confirmation = remove_gems_confirmation
        end
        puts "executing #{command}"
        raise ">> Exited with errors: #{$?}" unless system(command)
      end
      
      if(confirmation)
        puts "All Sprout gems have been successfully uninstalled"
      elsif(count > 0)
        puts "Some Sprout gems have been left on the system"
      else
        puts "No Sprout gems were found on this system"
      end

      # Now clear out the cache
      cache = File.dirname(File.dirname(Sprout.sprout_cache))
      
      if(File.exists?(cache))
        puts "\n[WARNING]\n\nAbout to irrevocably destroy the sprout cache at:\n\n#{cache}\n\n"
        puts "Are you absolutely sure? [Yn]"
        response = $stdin.gets.chomp!
        if(response.downcase.index('y'))
          FileUtils.rm_rf(cache)
        else
          puts "Leaving the Sprout file cache in tact...."
        end
      else
        puts "No cached files found on this system"
      end
      
      puts "To completely remove sprouts now, run:"
      puts "  #{get_gem_preamble} uninstall sprout"
    end

# File sprout/lib/sprout.rb, line 231
    def self.remove_gems_confirmation
      msg ="About to uninstall all RubyGems that match 'sprout-'....\nAre you sure you want to do this? [Yn]\n" 
      puts msg
      response = $stdin.gets.chomp!
      if(response.downcase.index('y'))
        return true
      end
      return false
    end

# File sprout/lib/sprout.rb, line 292
    def self.sprout(name, version=nil)
      name = sprout_to_gem_name(name)
      gem_spec = self.find_gem_spec(name, version)
      sprout_spec_path = File.join(gem_spec.full_gem_path, @@spec)
      
      if(gem_spec.autorequire)
        $:.push(File.join(gem_spec.full_gem_path, 'lib'))
        require gem_spec.autorequire
      end
      if(File.exists?(sprout_spec_path))
        # Ensure the requisite files get downloaded and unpacked
        Builder.build(sprout_spec_path, gem_file_cache(gem_spec.name, gem_spec.version))
      else
        return gem_spec
      end
    end

# File sprout/lib/sprout.rb, line 329
    def self.sprout_cache
      @@sprout_cache ||= self.inferred_sprout_cache
    end

# File sprout/lib/sprout.rb, line 333
    def self.sprout_cache=(cache)
      @@sprout_cache = cache
    end

# File sprout/lib/sprout.rb, line 311
    def self.sprout_to_gem_name(name)
      if(!name.match(/^sprout-/))
        name = "sprout-#{name}-bundle"
      end
      return name
    end