sprout 0.7.220-x86-darwin-10

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+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.

data/TODO

@@ -0,0 +1,12 @@
+
+---------------------------------
+In the interest of being a better member of our growing community, 
+I have extracted the contents of this file to the googlecode site at:
+
+http://code.google.com/p/projectsprouts/issues/list?q=label:Beta1.0&can=2
+
+Please feel free to check over the available issues and see if any look appealing!
+
+If you're considering a contribution, please check in on our mailing list first just to be sure.
+(projectsprouts@googlegroups.com)
+

data/bin/sprout

@@ -0,0 +1,128 @@
+#!/usr/bin/env ruby
+#
+#  Created by Luke Bayes on 2007-4-29.
+#  Copyright (c) 2007. All rights reserved.
+
+begin
+  require 'rubygems'
+rescue LoadError
+  # no rubygems to load, so we fail silently
+end
+
+$:.push(File.dirname(__FILE__) + '/../lib')
+require 'sprout'
+require 'sprout/generator'
+require 'optparse'
+
+OPTIONS = {
+  :sources            => [],
+  :project_name       => nil,
+  :sprout_name        => nil,
+  :requirements	      => nil,
+  :remove_all         => false
+}
+
+def fail_with(opts, message)
+  puts "[ERROR] #{message}"
+  puts ""
+  puts opts
+  exit
+end
+
+parser = OptionParser.new do |opts|
+  opts.banner = <<BANNER
+Sprout is an open-source, cross-platform project generation and configuration tool
+
+Usage: #{File.basename($0)} [options] [ProjectName]
+
+Examples:
+
+Create a new ActionScript 3.0 project named 'SomeProject':
+  #{File.basename($0)} -n as3 SomeProject
+
+Create a new ActionScript 2.0 project named 'OtherProject':
+  #{File.basename($0)} -n as2 OtherProject
+
+Remove all Sprout gems and cached files:
+  #{File.basename($0)} -R
+
+Options are:
+BANNER
+  opts.separator ""
+
+  opts.on("-n", "--name NAME", String, "The name of the sprout bundle whose project generator will be executed (e.g., as2 or as3)") do |name|
+    OPTIONS[:sprout_name] = name
+  end
+
+  opts.on('--source [URL]', String, "Use URL as the remote source for gems") do |source|
+    OPTIONS[:sources] << source
+  end
+
+  opts.on('-r', '--requirements REQUIREMENTS', String, "The specific gem version requirements for the named bundle (e.g., 0.3.2)") do |requirements|
+    OPTIONS[:requirements] = requirements
+  end
+
+  opts.on("-R", "--remove-all", "Remove all sprout gems and cached files") do
+    OPTIONS[:remove_all] = true
+    Sprout::Sprout.remove_all
+  end
+  
+  opts.on("-v", "--version", "Display the installed version of the sprout gem") do |version|
+    puts "sprout #{Sprout::VERSION::STRING}"
+    exit
+  end
+  
+  opts.on("-h", "--help", "Show this help message.") do
+    puts opts
+    exit
+  end
+  
+  opts.parse!(ARGV)
+  
+  if(OPTIONS[:sources].size > 0)
+    set_sources OPTIONS[:sources]
+  end
+
+  if(ARGV.size > 0)
+    if(OPTIONS[:sprout_name])
+      OPTIONS[:project_name] = ARGV.pop
+      if(OPTIONS[:project_name] == "=")
+        fail_with(opts, "Invalid project name #{OPTIONS[:project_name]}")
+      end
+    else
+      fail_with(opts, "You must provide a sprout name argument such as, '-n as2' or '-n as3'")
+    end
+  elsif(OPTIONS[:remove_all])
+    exit
+  else
+    fail_with(opts, "Expected a sprout bundle name and project name like: 'sprout -n as2 SomeProject'")
+  end
+
+end
+
+#############################################
+
+sprout_name         = OPTIONS[:sprout_name]
+sprout_requirements	= OPTIONS[:requirements]
+project_name        = OPTIONS[:project_name]
+
+#############################################
+
+puts ">> Creating new project '#{project_name}' with #{sprout_name}"
+Sprout::Sprout.project_name = project_name
+
+begin
+    # Fallback if a version was specified
+    if(sprout_requirements)
+      sprout(sprout_name, sprout_requirements)
+    end
+    # Try to run the generator against user home and existing gems first
+    Sprout::Sprout.generate(sprout_name, 'project', [project_name])
+rescue RubiGen::GeneratorError
+    # Failing that, try to download a sprout gem by name
+    sprout(sprout_name, sprout_requirements)
+    # Then try again....
+    Sprout::Sprout.generate(sprout_name, 'project', [project_name])
+end
+
+Sprout::Log.flush

data/doc/Bundle

@@ -0,0 +1,14 @@
+
+A Sprout Bundle is a collection of Ruby code that supports a particular interest or technology. At the time of this writing, we have two bundles available.
+
+* ActionScript 2 Bundle (link[link:files/bundles/as2/README.html]) which supports ActionScript 2.0 development
+* ActionScript 3 Bundle (link[link:files/bundles/as3/README.html]) which supports ActionScript 3.0, MXML and AIR development
+
+Bundles are the named entry point that the +sprout+ shell tool uses to find project generators[link:files/doc/Generator.html].
+
+Bundles should be packaged and published to the RubyForge gem repository with very specific names as follows:
+
+sprout-#{bundle_name}-bundle where ${bundle_name} is what will be given to the -n parameter of the +sprout+ gem.
+
+The as3 bundle is released as sprout-as3-bundle on RubyForge, but we can simply enter the short name when creating new as3 projects.
+

data/doc/Generator

@@ -0,0 +1,35 @@
+A SproutGenerator is a set of specifically configured folders and files that have been placed in a particular, expected location on disk.
+The Sprout generator feature is a minor modification to the standard Rubigen generators.
+
+Sprouts modifies the underlying Rubigen Generator implementation in that we need support for multiple languages or technologies while Rubigen is able to simply expect that it's generating Ruby code. 
+
+Generators can exist in multiple different locations on disk, to learn how to create a new generator, see the Rubigen documentation[http://rubigen.rubyforge.org/].
+
+To use a new or existing generator, simply enter it's name from within a project after calling
+  script/generate
+
+When a string is passed to the generate command, sprouts will look in the following locations in the following order with 'name' being the generator name that you have requested:
+* #{project_path}/generators/#{name}
+* #{project_path}/script/generators/#{name}
+* #{project_path}/vendor/generators/#{name}
+* #{Sprout::Sprout.sprout_cache}/generators/#{Sprout::ProjectModel.language}/#{name}
+* All Rubygems with a name ending with '-bundle' and with contents that match '/lib/sprout/**/generators/[name]'
+
+This means that when you have a new project and enter:
+  script/generate foo
+
+We will first look in your project for, 'generators/foo', 'script/generators/foo' and 'vendor/generators/foo'.
+
+Assuming no viable generator is found in your project, we will then look in your Sprout::Sprout sprout_cache for a folder named 'generators/foo'.
+
+Assuming no viable generator is found in your system wide path, we will begin looking inside of installed Ruby Gems. The expected gem will have a file at:
+
+  lib/sprout/**/generators/foo/foo_generator.rb
+
+If no named generator is found in any of these places an exception will be encountered.
+
+Sprouts generators can be initiated from one of two places, either from a project directory with script/generate or directly from the Sprout gem.
+
+When executing generators directly from the Sprout gem, you must send in a bundle base name and know that only 'project' generators found in that bundle will be executed.
+
+When executing generators from a project, the Sprout::ProjectModel language parameter is used to determine the bundle (if necessary), and then the Generator name is used to execute any found generator.

data/doc/Library

@@ -0,0 +1,63 @@
+
+A Library is simply shared code. Some libraries are distributed with only source, others are only pre-compiled binaries (SWC for ActionScript libraries), and still others are made available in both forms. 
+
+The Sprout::LibraryTask will download and copy a remote library sprout gem.
+The remote archive can include (or reference) either source or a pre-compiled
+file. For ActionScript libraries, this would be a SWC file.
+
+This task is integrated with some of the compiler tasks in such
+a way that if an Sprout::MXMLCTask has any number of library tasks in
+it's prerequisites list, each of those libraries will be added
+to the compiler directive appropriately.
+
+Following is a simple example of a library task. Using only
+this simple task definition, the Adobe corelib library sprout gem
+will be downloaded, installed and copied to your Sprout::ProjectModel +lib_dir+.
+  
+  library :corelib
+
+By adding this named task as a prerequisite to your compilation task,
+that SWC will also be added to the Sprout::MXMLCTask +library_path+ parameter.
+
+  mxmlc 'bin/SomeProject.swf' => :corelib
+
+You can also specify a particular library gem version if the library
+has changed since your project began.
+
+  library :asunit3 do |t|
+    t.version = '3.0.1'
+  end
+
+This will ensure that only that particular library version is used for this project.
+
+You may want to refer to a library using a particular task name, but have it
+use a different library sprout gem. This can be done using the gem_name parameter
+as follows:
+
+  library :asunit do |t|
+    t.gem_name = 'sprout-asunit3-library'
+  end
+
+This may be useful because now the AsUnit[http://www.asunit.org] sources will be installed to:
+  lib/asunit
+instead of:
+  lib/asunit3
+and you can now depend on this library as simply +:asunit+ in your compiler tasks.
+
+You can easily create your own library gems using the Sprout::GemWrapTask and then
+refer to them by gem name. 
+
+In order to share your library tasks, you will need to
+do one of the following:
+
+* Tell interested developers to manually install your library gem
+* Upload your gem to any Rubyforge[http://www.rubyforge.org] project file releases area.
+    If your gem name begins with 'sprout-' and ends with '-library', you (and others) can refer to it by only
+    the string in between that prefix and suffix. Otherwise, you (and others) will always have
+    to set the gem_name parameter to the full name of your custom library.
+* Submit your library for inclusion from the ProjectSprouts[http://www.projectsprouts.org] project.
+* Add your gem to your own custom gem_server[http://rambleon.org/2007/04/19/creating-your-own-gem-server/], and set up your rakefiles to pull from that server
+
+You can search for all available libraries as follows:
+  gem search -r sprout-*library
+Only results that begin with 'sprout-' are known, valid libraries.

data/doc/Task

@@ -0,0 +1,21 @@
+In Sprouts, a Task is referring to a Rake[http://rake.rubyforge.org/] Task.
+
+Rake is the automated build to written in Ruby. This tool is similar to Ant[http://ant.apache.org/] and Make[http://www.gnu.org/software/make/] if you're familiar with those technologies.
+
+The main thing that differentiates Rake from it's competitors is the fact that Rake tasks are defined and configured in Ruby code rather than XML or C. This lets us more easily avoid repetition throughout a rakefile, and we gain the full power of the Ruby language to apply to our build scripts.
+
+Essentially, Rake allows us to write and maintain much smaller, more digestible build scripts.
+
+To learn more about Rake, check out Martin Fowler's seminal article[http://martinfowler.com/articles/rake.html] on the subject.
+
+At the time of this writing, Sprouts makes the following Rake tasks available:
+* Core Sprout::SFTPTask
+* Core Sprout::ZipTask
+* Core Sprout::LibraryTask
+* As3Bundle Sprout::AsDocTask
+* As3Bundle Sprout::AsUnitTask
+* As3Bundle Sprout::COMPCTask
+* As3Bundle Sprout::MXMLCTask
+* As2Bundle Sprout::MTASCTask
+* As2Bundle Sprout::SWFMillTask
+

data/doc/Tool

@@ -0,0 +1,20 @@
+  
+A Tool is a Ruby Gem that usually refers to an executable or binary application. 
+These applications are either natively cross platform, or the Ruby Gem should include a 
+YAML document that tells Sprouts where to go in order to get the appropriate binary for 
+which platform the user is currently running.
+
+CLI Tools are usually referenced by subclasses of Sprout::ToolTask.
+
+Once installed, many Tool Sprouts are made available from your path. For example
+if you install the sprout-mtasc-tool gem, from that point forward you can execute mtasc
+from the terminal as follows:
+
+  mtasc -help # Should throw an error
+  sudo gem install sprout-mtasc-tool
+  mtasc -help # Should download and execute mtasc
+
+Using just Sprout tools by themselves, we now have have the ability to install and manage
+requisite executables across platforms with zero configuration.
+
+In reality, 'Tool Sprouts' are actually nothing more than a naming convention and expected gem configuration, but once those requirements are met, the core Sprout::Sprout can do some important work with them.

data/lib/platform.rb

@@ -0,0 +1,109 @@
+#
+# platform.rb: naive platform detection for Ruby
+# author: Matt Mower
+#
+# == Platform
+#
+# Platform is a simple module which parses the Ruby constant
+# RUBY_PLATFORM and works out the OS, it's implementation,
+# and the architecture it's running on.
+#
+# The motivation for writing this was coming across a case where
+#
+# +if RUBY_PLATFORM =~ /win/+
+#
+# didn't behave as expected (i.e. on powerpc-darwin-8.1.0)
+#
+# It is hoped that providing a library for parsing the platform
+# means that we can cover all the cases and have something which
+# works reliably 99% of the time.
+#
+# Please report any anomalies or new combinations to the author(s).
+#
+# == Use
+#
+# require "platform"
+#
+# defines
+#
+# Platform::OS (:unix,:win32,:vms,:os2)
+# Platform::impl (:macosx,:linux,:mswin)
+# Platform::arch (:powerpc,:x86,:alpha)
+#
+# if an unknown configuration is encountered any (or all) of
+# these constant may have the value :unknown.
+#
+# To display the combination for your setup run
+#
+# ruby platform.rb
+#
+module Platform #:nodoc:
+   os = nil
+   impl = nil
+   arch = nil
+   
+   if RUBY_PLATFORM =~ /darwin/i
+      os = :unix
+      impl = :macosx
+   elsif RUBY_PLATFORM =~ /linux/i
+      os = :unix
+      impl = :linux
+   elsif RUBY_PLATFORM =~ /freebsd/i
+      os = :unix
+      impl = :freebsd
+   elsif RUBY_PLATFORM =~ /netbsd/i
+      os = :unix
+      impl = :netbsd
+   elsif RUBY_PLATFORM =~ /vista/i
+      os = :win32
+      impl = :vista
+   elsif RUBY_PLATFORM =~ /mswin/i
+      os = :win32
+      impl = :mswin
+   elsif RUBY_PLATFORM =~ /cygwin/i
+      os = :win32
+      impl = :cygwin
+   elsif RUBY_PLATFORM =~ /mingw/i
+      os = :win32
+      impl = :mingw
+   elsif RUBY_PLATFORM =~ /bccwin/i
+      os = :win32
+      impl = :bccwin
+   elsif RUBY_PLATFORM =~ /wince/i
+      os = :win32
+      impl = :wince
+   elsif RUBY_PLATFORM =~ /vms/i
+      os = :vms
+      impl = :vms
+   elsif RUBY_PLATFORM =~ /os2/i
+      os = :os2
+      impl = :os2 # maybe there is some better choice here?
+   else
+      os = :unknown
+      impl = :unknown
+   end
+   
+   # whither AIX, SOLARIS, and the other unixen?
+   
+   if RUBY_PLATFORM =~ /(i\d86)/i
+      arch = :x86
+   elsif RUBY_PLATFORM =~ /ia64/i
+      arch = :ia64
+   elsif RUBY_PLATFORM =~ /powerpc/i
+      arch = :powerpc
+   elsif RUBY_PLATFORM =~ /alpha/i
+      arch = :alpha
+   else
+      arch = :unknown
+   end
+   
+   OS = os
+   IMPL = impl
+   ARCH = arch
+   # What about AMD, Turion, Motorola, etc..?
+   
+end
+
+if __FILE__ == $0
+   puts "Platform OS=#{Platform::OS}, impl=#{Platform::IMPL}, arch=#{Platform::ARCH}"
+end