sproutcore 0.9.0

data/History.txt

@@ -0,0 +1,4 @@
+== 0.9.0 2008-03-08
+
+* 1 major enhancement:
+  * Initial release of the new BlueRibbon train build system

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Sprout Systems, Inc.
+
+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/Manifest.txt

@@ -0,0 +1,269 @@
+History.txt
+License.txt
+Manifest.txt
+README.txt
+Rakefile
+app_generators/sproutcore/USAGE
+app_generators/sproutcore/sproutcore_generator.rb
+app_generators/sproutcore/templates/README
+app_generators/sproutcore/templates/environment.yml
+bin/sc-build
+bin/sc-gen
+bin/sc-server
+bin/sproutcore
+clients/sc_docs/controllers/docs.js
+clients/sc_docs/core.js
+clients/sc_docs/english.lproj/body.css
+clients/sc_docs/english.lproj/body.rhtml
+clients/sc_docs/english.lproj/controls.css
+clients/sc_docs/english.lproj/icons/small/next.png
+clients/sc_docs/english.lproj/icons/small/reset.png
+clients/sc_docs/english.lproj/images/gradients.png
+clients/sc_docs/english.lproj/images/indicator.gif
+clients/sc_docs/english.lproj/images/toolbar.png
+clients/sc_docs/english.lproj/no_docs.rhtml
+clients/sc_docs/english.lproj/strings.js
+clients/sc_docs/english.lproj/warning.rhtml
+clients/sc_docs/fixtures/doc.js
+clients/sc_docs/main.js
+clients/sc_docs/models/doc.js
+clients/sc_docs/tests/controllers/docs.rhtml
+clients/sc_docs/tests/models/doc.rhtml
+clients/sc_docs/tests/views/doc_frame.rhtml
+clients/sc_docs/tests/views/doc_label_view.rhtml
+clients/sc_docs/views/doc_frame.js
+clients/sc_docs/views/doc_label.js
+clients/sc_test_runner/controllers/runner.js
+clients/sc_test_runner/core.js
+clients/sc_test_runner/english.lproj/body.css
+clients/sc_test_runner/english.lproj/body.rhtml
+clients/sc_test_runner/english.lproj/controls.css
+clients/sc_test_runner/english.lproj/icons/small/next.png
+clients/sc_test_runner/english.lproj/icons/small/reset.png
+clients/sc_test_runner/english.lproj/images/gradients.png
+clients/sc_test_runner/english.lproj/images/indicator.gif
+clients/sc_test_runner/english.lproj/images/toolbar.png
+clients/sc_test_runner/english.lproj/no_tests.rhtml
+clients/sc_test_runner/english.lproj/strings.js
+clients/sc_test_runner/english.lproj/warning.rhtml
+clients/sc_test_runner/fixtures/test.js
+clients/sc_test_runner/main.js
+clients/sc_test_runner/models/test.js
+clients/sc_test_runner/views/runner_frame.js
+clients/sc_test_runner/views/test_label.js
+config/hoe.rb
+config/requirements.rb
+environment.yml
+frameworks/prototype/prototype.js
+frameworks/sproutcore/Core.js
+frameworks/sproutcore/README
+frameworks/sproutcore/controllers/array.js
+frameworks/sproutcore/controllers/collection.js
+frameworks/sproutcore/controllers/controller.js
+frameworks/sproutcore/controllers/object.js
+frameworks/sproutcore/drag/drag.js
+frameworks/sproutcore/drag/drag_data_source.js
+frameworks/sproutcore/drag/drag_source.js
+frameworks/sproutcore/drag/drop_target.js
+frameworks/sproutcore/english.lproj/blank.gif
+frameworks/sproutcore/english.lproj/buttons.css
+frameworks/sproutcore/english.lproj/buttons.png
+frameworks/sproutcore/english.lproj/inline_text_editor.css
+frameworks/sproutcore/english.lproj/menu.css
+frameworks/sproutcore/english.lproj/panels/background-fat.jpg
+frameworks/sproutcore/english.lproj/panels/background-thin.jpg
+frameworks/sproutcore/english.lproj/panels/bottom-edge.png
+frameworks/sproutcore/english.lproj/panels/bottom-left-corner.png
+frameworks/sproutcore/english.lproj/panels/bottom-right-corner.png
+frameworks/sproutcore/english.lproj/panels/left-edge.png
+frameworks/sproutcore/english.lproj/panels/overlay.png
+frameworks/sproutcore/english.lproj/panels/right-edge.png
+frameworks/sproutcore/english.lproj/panels/top-edge.png
+frameworks/sproutcore/english.lproj/panels/top-left-corner.png
+frameworks/sproutcore/english.lproj/panels/top-right-corner.png
+frameworks/sproutcore/english.lproj/panes.css
+frameworks/sproutcore/english.lproj/picker.css
+frameworks/sproutcore/english.lproj/strings.js
+frameworks/sproutcore/english.lproj/tab.css
+frameworks/sproutcore/english.lproj/tests.css
+frameworks/sproutcore/english.lproj/theme.css
+frameworks/sproutcore/foundation/animator.js
+frameworks/sproutcore/foundation/application.js
+frameworks/sproutcore/foundation/array.js
+frameworks/sproutcore/foundation/benchmark.js
+frameworks/sproutcore/foundation/binding.js
+frameworks/sproutcore/foundation/date.js
+frameworks/sproutcore/foundation/error.js
+frameworks/sproutcore/foundation/input_manager.js
+frameworks/sproutcore/foundation/json.js
+frameworks/sproutcore/foundation/mock.js
+frameworks/sproutcore/foundation/node_descriptor.js
+frameworks/sproutcore/foundation/object.js
+frameworks/sproutcore/foundation/observable.js
+frameworks/sproutcore/foundation/page.js
+frameworks/sproutcore/foundation/path_module.js
+frameworks/sproutcore/foundation/responder.js
+frameworks/sproutcore/foundation/routes.js
+frameworks/sproutcore/foundation/run_loop.js
+frameworks/sproutcore/foundation/server.js
+frameworks/sproutcore/foundation/set.js
+frameworks/sproutcore/foundation/string.js
+frameworks/sproutcore/foundation/undo_manager.js
+frameworks/sproutcore/foundation/unittest.js
+frameworks/sproutcore/foundation/utils.js
+frameworks/sproutcore/globals/panels.js
+frameworks/sproutcore/globals/popups.js
+frameworks/sproutcore/globals/window.js
+frameworks/sproutcore/lib/index.rhtml
+frameworks/sproutcore/models/collection.js
+frameworks/sproutcore/models/record.js
+frameworks/sproutcore/models/store.js
+frameworks/sproutcore/panes/dialog.js
+frameworks/sproutcore/panes/manager.js
+frameworks/sproutcore/panes/menu.js
+frameworks/sproutcore/panes/overlay.js
+frameworks/sproutcore/panes/pane.js
+frameworks/sproutcore/panes/panel.js
+frameworks/sproutcore/panes/picker.js
+frameworks/sproutcore/tests/controllers/array.rhtml
+frameworks/sproutcore/tests/controllers/controller.rhtml
+frameworks/sproutcore/tests/controllers/object.rhtml
+frameworks/sproutcore/tests/foundation/application.rhtml
+frameworks/sproutcore/tests/foundation/array.rhtml
+frameworks/sproutcore/tests/foundation/object.rhtml
+frameworks/sproutcore/tests/globals/window.rhtml
+frameworks/sproutcore/tests/panes/pane.rhtml
+frameworks/sproutcore/tests/views/collection.rhtml
+frameworks/sproutcore/tests/views/popup_button.rhtml
+frameworks/sproutcore/tests/views/text_field.rhtml
+frameworks/sproutcore/validators/credit_card.js
+frameworks/sproutcore/validators/date.js
+frameworks/sproutcore/validators/email.js
+frameworks/sproutcore/validators/not_empty.js
+frameworks/sproutcore/validators/number.js
+frameworks/sproutcore/validators/password.js
+frameworks/sproutcore/validators/validator.js
+frameworks/sproutcore/views/button.js
+frameworks/sproutcore/views/checkbox_field.js
+frameworks/sproutcore/views/collection.js
+frameworks/sproutcore/views/container.js
+frameworks/sproutcore/views/error_explanation.js
+frameworks/sproutcore/views/field.js
+frameworks/sproutcore/views/filter_button.js
+frameworks/sproutcore/views/form.js
+frameworks/sproutcore/views/image.js
+frameworks/sproutcore/views/inline_text_editor.js
+frameworks/sproutcore/views/label.js
+frameworks/sproutcore/views/menu_item.js
+frameworks/sproutcore/views/pagination.js
+frameworks/sproutcore/views/popup_button.js
+frameworks/sproutcore/views/popup_menu.js
+frameworks/sproutcore/views/progress.js
+frameworks/sproutcore/views/radio_field.js
+frameworks/sproutcore/views/radio_group.js
+frameworks/sproutcore/views/segmented.js
+frameworks/sproutcore/views/select_field.js
+frameworks/sproutcore/views/spinner.js
+frameworks/sproutcore/views/tab.js
+frameworks/sproutcore/views/text_field.js
+frameworks/sproutcore/views/textarea_field.js
+frameworks/sproutcore/views/toolbar.js
+frameworks/sproutcore/views/view.js
+frameworks/sproutcore/views/workspace.js
+generators/client/README
+generators/client/USAGE
+generators/client/client_generator.rb
+generators/client/templates/core.js
+generators/client/templates/english.lproj/body.css
+generators/client/templates/english.lproj/body.rhtml
+generators/client/templates/english.lproj/controls.css
+generators/client/templates/english.lproj/strings.js
+generators/client/templates/main.js
+generators/controller/USAGE
+generators/controller/controller_generator.rb
+generators/controller/templates/controller.js
+generators/controller/templates/test.rhtml
+generators/framework/README
+generators/framework/USAGE
+generators/framework/framework_generator.rb
+generators/framework/templates/core.js
+generators/framework/templates/english.lproj/body.css
+generators/framework/templates/english.lproj/body.rhtml
+generators/framework/templates/english.lproj/controls.css
+generators/framework/templates/english.lproj/strings.js
+generators/language/USAGE
+generators/language/language_generator.rb
+generators/language/templates/strings.js
+generators/model/USAGE
+generators/model/model_generator.rb
+generators/model/templates/fixture.js
+generators/model/templates/model.js
+generators/model/templates/test.rhtml
+generators/test/USAGE
+generators/test/templates/test.rhtml
+generators/test/test_generator.rb
+generators/view/USAGE
+generators/view/templates/test.rhtml
+generators/view/templates/view.js
+generators/view/view_generator.rb
+jsdoc/README.txt
+jsdoc/app/DocFile.js
+jsdoc/app/DocTag.js
+jsdoc/app/Doclet.js
+jsdoc/app/Dumper.js
+jsdoc/app/JsDoc.js
+jsdoc/app/JsHilite.js
+jsdoc/app/JsIO.js
+jsdoc/app/JsParse.js
+jsdoc/app/JsPlate.js
+jsdoc/app/JsTestrun.js
+jsdoc/app/JsToke.js
+jsdoc/app/Symbol.js
+jsdoc/app/Transformer.js
+jsdoc/app/Util.js
+jsdoc/app/js.jar
+jsdoc/app/run.js
+jsdoc/plugins/min.js
+jsdoc/plugins/strip.js
+jsdoc/templates/sproutcore/class.tmpl
+jsdoc/templates/sproutcore/default.css
+jsdoc/templates/sproutcore/index.html
+jsdoc/templates/sproutcore/index.tmpl
+jsdoc/templates/sproutcore/prototype.js
+jsdoc/templates/sproutcore/publish.js
+jsdoc/templates/sproutcore/splash.html
+lib/sproutcore.rb
+lib/sproutcore/build_tools.rb
+lib/sproutcore/build_tools/html_builder.rb
+lib/sproutcore/build_tools/resource_builder.rb
+lib/sproutcore/bundle.rb
+lib/sproutcore/bundle_manifest.rb
+lib/sproutcore/generator_helper.rb
+lib/sproutcore/helpers.rb
+lib/sproutcore/helpers/capture_helper.rb
+lib/sproutcore/helpers/static_helper.rb
+lib/sproutcore/helpers/tag_helper.rb
+lib/sproutcore/helpers/text_helper.rb
+lib/sproutcore/jsdoc.rb
+lib/sproutcore/jsmin.rb
+lib/sproutcore/library.rb
+lib/sproutcore/merb.rb
+lib/sproutcore/merb/bundle_controller.rb
+lib/sproutcore/merb/router.rb
+lib/sproutcore/version.rb
+lib/sproutcore/view_helpers.rb
+lib/sproutcore/view_helpers/button_views.rb
+lib/sproutcore/view_helpers/core_views.rb
+lib/sproutcore/view_helpers/form_views.rb
+lib/sproutcore/view_helpers/menu_views.rb
+script/destroy
+script/generate
+script/txt2html
+setup.rb
+spec/spec.opts
+spec/spec_helper.rb
+spec/sproutcore_spec.rb
+tasks/deployment.rake
+tasks/environment.rake
+tasks/rspec.rake
+tasks/website.rake

data/README.txt

@@ -0,0 +1,67 @@
+SproutCore JavaScript Framework
+
+SproutCore is a full MVC framework written in JavaScript for building desktop-like applications on the web.  It makes building sophisticated applications for the web easier and more fun.
+
+This package includes both the raw SproutCore source as well as a complete build system for creating JavaScript applications and JavaScript libraries.
+
+==== Benefits
+
+SproutCore comes loaded with a lot of features you would normally find in a full MVC desktop framework including:
+
+2. "Bindings" that can automatically relay changes in a property from your model objects to your views.
+
+2. A simple in-memory database for storing your models.
+
+4. Buttons, labels, and other controls that can automatically enable, disable, change state and otherwise update themselves as your application state changes.
+
+5. Efficient controls for rendering lists of items.
+
+6. Efficient page loading optimized for handling large numbers of JavaScript controls.
+ 
+==== Quick Start
+
+1. To install the SproutCore build tools, just install the ruby gem:
+
+sudo gem install sproutcore
+
+2. Then create your first application:
+
+sproutcore addressbook
+
+You can now start editing your app in my_app/clients.  Each directory here is a single "page" that loads in your web browser.  You will find directories already setup for your models, views, controllers, as well as HTML, images, and other resources.
+
+3. To see your new app, just start the sproutcore server:
+
+cd addressbook
+sc-server
+
+Now visit: http://localhost:4020/addressbook
+
+4. To add a new model, controller, or view use the generators:
+
+cd addressbook
+sc-gen model addressbook/contact
+
+Now you can edit the model in clients/addressbook/models/contact.js.
+
+5. When you are ready to deploy your app, do a static build:
+
+cd addressbook
+sc-build
+
+Copy the files created in tmp/build to your web server and you should be ready to go.  Built SproutCore applications are static HTML files; you do not need any kind of web application server to host them.  (Of course, if you want to provide any data via Ajax, you will need a web application server for that.)
+
+==== Documentation and Unit Testing
+
+To get the documentation for SproutCore, you can simply visit:
+
+http://localhost:4020/sproutcore/-docs
+
+You can do the same with your own clients to generate documentation for them as well.
+
+To run unit tests for your client, just visit:
+
+http://localhost:4020/addressbook/-tests
+
+Unit tests are automatically created whenever you generate a new view, controller, or model object.  They are automatically excluded from your build whenever you build for production.
+

data/Rakefile

@@ -0,0 +1,4 @@
+require 'config/requirements'
+require 'config/hoe' # setup Hoe + all gem configuration
+
+Dir['tasks/**/*.rake'].each { |rake| load rake }

data/app_generators/sproutcore/USAGE

@@ -0,0 +1,5 @@
+Description:
+  
+  
+Usage:
+  

data/app_generators/sproutcore/sproutcore_generator.rb

@@ -0,0 +1,66 @@
+class SproutcoreGenerator < RubiGen::Base
+  
+  DEFAULT_SHEBANG = File.join(Config::CONFIG['bindir'],
+                              Config::CONFIG['ruby_install_name'])
+  
+  default_options :author => nil
+  
+  attr_reader :name
+  
+  def initialize(runtime_args, runtime_options = {})
+    super
+    usage if args.empty?
+    @destination_root = File.expand_path(args.shift)
+    @name = base_name
+    extract_options
+  end
+
+  def manifest
+    record do |m|
+      # Ensure appropriate folder(s) exists
+      m.directory ''
+      BASEDIRS.each { |path| m.directory path }
+      
+      # Create stubs
+      m.template_copy_each %w(README environment.yml)
+      m.dependency "install_rubigen_scripts", [destination_root, 'sproutcore'], 
+        :shebang => options[:shebang], :collision => :force
+        
+      # Create initial client
+      m.dependency "client", [destination_root, @name], 
+        :shebang => options[:shebang], :collision => :force
+        
+    end
+  end
+
+  protected
+    def banner
+      <<-EOS
+Creates a new SproutCore application for use with the BlueRibbon toolset
+
+USAGE: #{spec.name} name
+EOS
+    end
+
+    def add_options!(opts)
+      opts.separator ''
+      opts.separator 'Options:'
+      # For each option below, place the default
+      # at the top of the file next to "default_options"
+      # opts.on("-a", "--author=\"Your Name\"", String,
+      #         "Some comment about this option",
+      #         "Default: none") { |options[:author]| }
+      opts.on("-v", "--version", "Show the #{File.basename($0)} version number and quit.")
+    end
+    
+    def extract_options
+      # for each option, extract it into a local variable (and create an "attr_reader :author" at the top)
+      # Templates can access these value via the attr_reader-generated methods, but not the
+      # raw instance variable value.
+      # @author = options[:author]
+    end
+
+    # Installation skeleton.  Intermediate directories are automatically
+    # created so don't sweat their absence here.
+    BASEDIRS = %w(clients frameworks lib public log)
+end

data/app_generators/sproutcore/templates/README

@@ -0,0 +1,77 @@
+== Welcome to SproutCore Builder
+
+This is an application package for building a SproutCore application.  To get
+started, edit your JavaScript application in the clients directory (we've 
+already created one for you.)
+
+Then, start the SproutCore Dev Server by running from this directory:
+
+sc_server 
+
+This takes all the same arguments as mongrel.  You can now visit your app
+by going to:
+
+http://localhost:3000/<%= base_name %>
+
+== What Goes Where
+
+Here is a brief description of the various parts of the SproutCore app:
+
+* *clients:*  Each folder in the clients directory contains a single-page 
+  application you can load in your web browser.  By default the URL to reach 
+  each application is the /directory-name.  You will do most of your editing 
+  here.
+  
+* *frameworks:* Each folder in the frameworks directory is a SproutCore
+  library that your client applications can use.  No HTML will be generated
+  for these frameworks, but any JavaScript, CSS or other images you place
+  in here will be accessible through your web browser.
+  
+* *public:* This directory contains any other static resources your other 
+  apps needs to be able to use.  If you have static HTML or other basic 
+  files you want to have access to.  If you start your server in production
+  mode, cached output will also be saved into this directory.
+  
+* *lib:* Any ruby files you place in this directory will be automatically 
+  loaded when the sproutcore server start or when you do a static build.
+  If you write any custom view helpers, you can place them here.
+  
+* *setup.yaml:* This is a config file that you can use to set various load
+  options for the clients and frameworks in your app.  The default options are
+  specified in the default: group.  You can override the default for specific
+  frameworks or clients by naming them.
+  
+== Using Frameworks
+
+Frameworks are automatically automatically available in your app.  You can
+also name frameworks available anywhere in your load path (including those
+installed in gems).  
+
+The SproutCore gem comes with the latest versions of prototype, sproutcore,
+and sproutapp frameworks installed.  All you need to do is indicate that
+you require them.
+
+== Deploying your SproutCore App
+
+Normally you will use the sc_server to host your application while you are 
+developing your code.  Once you are ready to deploy, however, there are two
+ways you can do it:
+
+==== 1. Use sc_server in production.  
+
+The SproutCore server can be run in a production mode that will simply generate and cache web-optimized versions of all of your resources upon request.  For a low-traffic or newer site, this approach is an easy way to get your code into production.  You just replace your directory with your latest files and the sc_server will start serving the new resources.
+
+==== 2. Do a static build
+
+In general, however, loading all of your resources through a Ruby-app is not the best, especially when you could use a high-speed server such as lighttpd that is optimized for serving static content.
+
+If you want real speed, do a static build of your content and serve it through
+lighttpd or apache.  Do the static build, just run:
+
+sc_build all
+
+This will place a directory in tmp/build that contains all of your resources 
+pre-compiled and ready for static serving.
+
+
+

data/app_generators/sproutcore/templates/environment.yml

@@ -0,0 +1,4 @@
+all:
+  required:     [sproutcore]
+  resources_at: static
+  index_at:     ''

data/bin/sc-build

@@ -0,0 +1,145 @@
+#!/usr/bin/env ruby
+
+# BUILD SPROUTCORE APPLICATIONS
+# This script will build SproutCore applications for you.  Usage:
+#
+# sc-build                 build all clients
+# sc-build bundle-name     build just the named bundle
+# sc-build -l library_root path to the library you want to load bundles from
+# sc-build -t build_root   set optional build root
+# sc-build -e development|production  defaults to production
+# sc-build bundle-name -r  builds bundle and dependent bundles but none others
+
+APP_ROOT = File.expand_path(Dir.pwd)
+SC_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+$:.unshift File.join(SC_ROOT,'lib') ;
+
+# Require SproutCore
+require 'rubygems'
+require 'rubigen'
+require 'sproutcore'
+require 'optparse'
+
+############################################################
+## Define Helper Methods
+##
+
+def not_found(bundle_name)
+  SC.logger.fatal("Could not find a bundle named: #{bundle_name}")
+  exit(1)
+end
+
+############################################################
+## Process Options
+##
+
+# Setup defaults
+build_mode = :production
+build_root = File.join(APP_ROOT,'tmp','build')
+bundle_name = ARGV.shift if (ARGV.size > 0 && ARGV[0][0..0] != '-')
+library_root = APP_ROOT
+include_dependencies = false
+verbose = false # show debug level
+languages = nil
+clean = false
+
+opts = OptionParser.new do |opts|
+  opts.version = SproutCore::VERSION::STRING
+
+  opts.banner = "Usage: sc-build {bundle-name} {options}"
+  opts.define_head "Build Tool for SproutCore applications"
+  opts.separator '*'*80
+  opts.separator 'If no flags are given, sc-build will try to build all of the bundles in the current directory'
+  opts.separator '*'*80
+
+  opts.on("-e", "--enviroment=MODE", "Set the build mode for the system.  Normally you want to build in production mode (which is the default if you do not include this option), but you can use this switch to build in development mode for testing.") do |opt_build_mode|
+    build_mode = opt_build_mode.to_s.downcase.to_sym
+  end
+  
+  opts.on("-t", "--target=PATH", "Set the target path for your build.  Normally this will be set to tmp/build in the working directory") do |opt_target|
+    build_root = File.expand_path(opt_target)
+  end
+  
+  opts.on("-l", "--library=PATH", "The library root you want to use.  Normally sc-build will use the working directory.  If you want to point to another project on disk to build from, use this option.") do |opt_library|
+    library_root = File.expand_path(opt_library)
+  end
+  
+  opts.on("-r", "--[no-]include-required", "If passed when building a single client, then the build tool will also find any required bundles and build them as well.") do |opt_req|
+    include_dependencies = !!opt_req
+  end
+  
+  opts.on("-v", "--[no-]verbose", "If set, extra debug output will be displayed during the build") do |opt_verbose|
+    verbose = !!opt_verbose
+  end
+  
+  opts.on("-L", "--languages=LANGUAGE", "Pass a comma separated list of the specific languages you want to build.  If you do not pass this option, the build tool will build all languages required by the bundles to function") do |opt_lang|
+    languages = opt_lang.split(',').map { |x| x.to_sym }
+  end
+  
+  opts.on("-c", "--[no-]clean", "If set, then the build tool will delete a bundle's output before it builds it, so you get a clean build") do |opt_clean|
+    clean = !!opt_clean
+  end
+  
+end
+opts.parse!
+
+############################################################
+## SETUP ENVIRONMENT
+##
+  
+# Configure logger
+SC.logger.level = (verbose) ? Logger::DEBUG : Logger::INFO
+SC.logger.progname = $0
+
+# Load Library
+library = SC.library_for(library_root, :public_root => build_root, :url_prefix => '', :build_mode => build_mode)
+
+############################################################
+## FIND BUNDLES TO BUILD
+##
+
+# Find the bundles to build.
+if bundle_name
+  # Get bundle
+  bundle = library.bundle_for(bundle_name.to_sym)
+  not_found(bundle) if bundle.nil?
+
+  # If dependencies are required, get those bundles as well
+  if include_dependencies
+    bundles = bundle.all_required_bundles
+  else
+    bundles = [bundle]
+  end
+  
+  SC.logger.info("Building: #{bundles.map { |x| x.bundle_name } * ', ' }...")
+  
+# No bundle provided, get all bundles for library
+else
+  bundles = library.bundles
+  SC.logger.info("Building ALL bundles:\n #{bundles.map { |x| x.bundle_name } * ', '}...")
+end  
+ 
+############################################################
+## BUILD EACH BUNDLE
+##
+
+# Detect required languages to build
+languages = bundles.map { |b| b.installed_languages }.flatten.uniq if languages.nil?
+SC.logger.info("Selected Languages: #{languages.join(', ')}")
+
+SC.logger.info('')
+bundles.each do |bundle|
+  SC.logger.info("Building #{bundle.bundle_name} > #{bundle.build_root}...")
+  
+  if clean
+    SC.logger.debug("~ Cleaning #{bundle.build_root}")
+    FileUtils.rm_rf(bundle.build_root)
+  end
+  
+  bundle.build(*languages)
+end
+
+SC.logger.debug("")
+
+
+