sproutit-sproutcore 1.0.0.20090407205609

data/buildtasks/render.rake

@@ -0,0 +1,21 @@
+# ===========================================================================
+# SC::Target Buildtasks
+# copyright 2008, Sprout Systems, Inc. and Apple, Inc. all rights reserved
+# ===========================================================================
+
+# Tasks invoked to actually render a single HTML file.  Works much like a 
+# build task but also expects a CONTEXT variable that contains the html 
+# context.
+namespace :render do
+
+  desc "renders erubis including .rhtml and .html.erb files"
+  task :erubis do
+    CONTEXT.compile SC::RenderEngine::Erubis.new(CONTEXT), SRC_PATH
+  end
+  
+  desc "renders haml files"
+  task :haml do
+    CONTEXT.compile SC::RenderEngine::Haml.new(CONTEXT), SRC_PATH
+  end
+  
+end

data/buildtasks/target.rake

@@ -0,0 +1,42 @@
+# ===========================================================================
+# SC::Target Buildtasks
+# copyright 2008, Sprout Systems, Inc. and Apple, Inc. all rights reserved
+# ===========================================================================
+
+# Tasks invoked while building Target objects.  You can override these methods
+# in your buildfiles.
+namespace :target do
+
+  # Invoked whenever a new target is created to prepare standard properties 
+  # needed on the build system.  Extend this task to add other standard
+  # properties
+  task :prepare do
+
+    # use url_root config or merge url_prefix + target_name
+    TARGET.url_root = CONFIG.url_root || 
+      [nil, CONFIG.url_prefix, TARGET.target_name].join('/').gsub(/\/+/,'/')
+    
+    # use index_root config or merge index_prefix + target_name
+    TARGET.index_root = CONFIG.index_root || 
+      [nil, CONFIG.index_prefix, TARGET.target_name].join('/').gsub(/\/+/, '/')
+
+    # Split all of these paths in case we are on windows...
+    TARGET.build_root = File.expand_path(CONFIG.build_root || 
+      File.join(PROJECT.project_root.to_s, 
+        (CONFIG.build_prefix || '').to_s.split('/'), 
+        (CONFIG.url_prefix || '').to_s.split('/'), 
+        TARGET.target_name.to_s.split('/')))
+        
+    TARGET.staging_root = File.expand_path(CONFIG.staging_root ||
+      File.join(PROJECT.project_root.to_s, 
+        (CONFIG.staging_prefix || '').to_s.split('/'), 
+        (CONFIG.url_prefix || '').to_s.split('/'), 
+        TARGET.target_name.to_s))
+      
+    TARGET.build_number = TARGET.compute_build_number
+    
+    # The target is loadable if it is an app
+    TARGET.loadable = TARGET.target_type == :app
+  end
+  
+end

data/gen/Buildfile

@@ -0,0 +1,16 @@
+# This is the root buildfile shared by all generators.  It defines the basic
+# built-in tasks needed for all generators to function.
+
+namespace :generator do
+  
+  desc "prepares the generator by performing any added pre-processing"
+  task :prepare 
+  
+  desc "builds the generator, copying files to the build root"
+  task :build do
+    GENERATOR.each_template do |filename, src_path, dst_path|
+      GENERATOR.copy_file src_path, dst_path
+    end
+  end
+  
+end

data/gen/app/Buildfile

@@ -0,0 +1,36 @@
+# ==========================================================================
+# Generator: APP
+# Copyright: ©2006-2009 Sprout Systems, Inc. and contributors
+#            portions copyright ©2009 Apple, Inc.
+# ==========================================================================
+
+namespace :generator do
+  
+  # Require a project then make sure the build root is always the project 
+  # root.
+  task :prepare do
+    GENERATOR.requires! :target_project
+    
+    # if the target name has a slash in it, then we are trying to create a 
+    # nested target.  extract the final part (since this is the target name)
+    # and then set the build root to the parent target.
+    if GENERATOR.target_name && GENERATOR.target_name =~ /\//
+      parent_target_name = GENERATOR.target_name.split('/')
+      GENERATOR.target_name = parent_target_name.pop
+      
+      parent_target_name = parent_target_name * "/"
+      project = GENERATOR.target_project
+      
+      GENERATOR.parent_target_name = parent_target_name
+      GENERATOR.parent_target = project.target_for(parent_target_name)
+      GENERATOR.requires! :parent_target, :parent_target_name
+      
+      GENERATOR.build_root = GENERATOR.parent_target.source_root
+    
+    # otherwise just use project_root
+    else        
+      GENERATOR.build_root = GENERATOR.target_project.project_root
+    end
+  end
+  
+end

data/gen/app/README

@@ -0,0 +1 @@
+Your application target is now ready to use!

data/gen/app/USAGE

@@ -0,0 +1,13 @@
+app - Create a new SproutCore application target.
+
+USAGE:
+
+  sc-gen app AppName [--filename=FILENAME] [--target=TARGET_NAME]
+
+DISCUSSION:
+
+This generator will create a new SproutCore application for a particular project.  You should pass as the first parameter your AppName you want to create.  For example:
+
+sc-gen app Todos
+
+defines a new application called Todos in the file apps/todos/ .

data/gen/app/templates/apps/{target_name}/core.js

@@ -0,0 +1,27 @@
+// ==========================================================================
+// Project:   <%= namespace %>
+// Copyright: ©<%= Time.now.year %> My Company, Inc.
+// ==========================================================================
+/*globals <%= namespace %> */
+
+/** @namespace
+
+  My cool new app.  Describe your application.
+  
+  @extends SC.Object
+*/
+<%= namespace %> = SC.Object.create(
+  /** @scope <%= namespace %>.prototype */ {
+
+  NAMESPACE: '<%= namespace %>',
+  VERSION: '0.1.0',
+
+  // This is your application store.  You will use this store to access all
+  // of your model data.  You can also set a data source on this store to
+  // connect to a backend server.  The default setup below connects the store
+  // to any fixtures you define.
+  store: SC.Store.create().from(SC.Record.fixtures)
+  
+  // TODO: Add global constants or singleton objects needed by your app here.
+
+}) ;

data/gen/app/templates/apps/{target_name}/english.lproj/loading.rhtml

@@ -0,0 +1,9 @@
+<%% content_for :loading do %>
+<%% # Any HTML in this file will be visible on screen while your page loads
+   # its application JavaScript.  SproutCore applications are optimized for 
+   # caching and startup very fast, so your users will often only see this 
+   # content for a brief moment on their first app load, if at all.
+%>
+<p class="loading">Loading...<p>
+
+<%% end %>

data/gen/app/templates/apps/{target_name}/english.lproj/main_page.js

@@ -0,0 +1,22 @@
+// ==========================================================================
+// Project:   <%= namespace %> - mainPage
+// Copyright: ©<%= Time.now.year %> My Company, Inc.
+// ==========================================================================
+/*globals <%= namespace %> */
+
+// This page describes the main user interface for your application.  
+<%= namespace %>.mainPage = SC.Page.design({
+
+  // The main pane is made visible on screen as soon as your app is loaded.
+  // Add childViews to this pane for views to display immediately on page 
+  // load.
+  mainPane: SC.MainPane.design({
+    childViews: 'labelView'.w(),
+    
+    labelView: SC.LabelView.design({
+      layout: { centerX: 0, centerY: 0, width: 100, height: 18 },
+      tagName: "h1", value: "Hello World"
+    })
+  })
+
+});

data/gen/app/templates/apps/{target_name}/english.lproj/strings.js

@@ -0,0 +1,15 @@
+// ==========================================================================
+// Project:   <%= namespace %> Strings
+// Copyright: ©<%= Time.now.year %> My Company, Inc.
+// ==========================================================================
+/*globals <%= namespace %> */
+
+// Place strings you want to localize here.  In your app, use the key and
+// localize it using "key string".loc().  HINT: For your key names, use the
+// english string with an underscore in front.  This way you can still see
+// how your UI will look and you'll notice right away when something needs a
+// localized string added to this file!
+//
+SC.stringsFor('English', {
+  // "_String Key": "Localized String"
+}) ;

data/gen/app/templates/apps/{target_name}/main.js

@@ -0,0 +1,30 @@
+// ==========================================================================
+// Project:   <%= namespace %>
+// Copyright: ©<%= Time.now.year %> My Company, Inc.
+// ==========================================================================
+/*globals <%= namespace %> */
+
+// This is the function that will start your app running.  The default
+// implementation will load any fixtures you have created then instantiate
+// your controllers and awake the elements on your page.
+//
+// As you develop your application you will probably want to override this.
+// See comments for some pointers on what to do next.
+//
+<%= namespace %>.main = function main() {
+
+  // Step 1: Instantiate Your Views
+  // The default code here will make the mainPane for your application visible
+  // on screen.  If you app gets any level of complexity, you will probably 
+  // create multiple pages and panes.  
+  <%= namespace %>.getPath('mainPage.mainPane').append() ;
+
+  // Step 2. Set the content property on your primary controller.
+  // This will make your app come alive!
+
+  // TODO: Set the content property on your primary controller
+  // ex: <%= class_name %>.contactsController.set('content',<%= class_name %>.contacts);
+
+} ;
+
+function main() { <%= namespace %>.main(); }

data/gen/controller/Buildfile

@@ -0,0 +1,18 @@
+# ==========================================================================
+# Generator: Controller
+# Copyright: ©2006-2009 Sprout Systems, Inc. and contributors
+#            portions copyright ©2009 Apple, Inc.
+# ==========================================================================
+
+namespace :generator do
+
+  # - Verify required properties are present
+  # - Accept second argument as base class
+  # - If file name ends in "_controller", strip it off
+  task :prepare do
+    GENERATOR.requires! :target_project, :target, :namespace, :class_name
+    GENERATOR.base_class_name ||= GENERATOR.arguments[2]
+    GENERATOR.filename = GENERATOR.filename.sub(/_controller$/,'')
+  end
+  
+end

data/gen/controller/README

@@ -0,0 +1 @@
+Your controller is now ready to use!

data/gen/controller/USAGE

@@ -0,0 +1,13 @@
+model - Create a new controller class in your SproutCore app.
+
+USAGE:
+
+  sc-gen controller AppName.ClassNameController [--filename=FILENAME] [--target=TARGET_NAME]
+
+DISCUSSION:
+
+This generator will create a new SproutCore controller file in your app.  You should pass as the first parameter your AppName.ClassNameController combination you want to create.  For example:
+
+sc-gen controller Todos.TaskController
+
+defines a new class called Todos.TaskController in the file apps/todos/controllers/task.js .

data/gen/controller/templates/controllers/{filename}.js

@@ -0,0 +1,18 @@
+// ==========================================================================
+// Project:   <%= namespace_instance_name %>
+// Copyright: ©<%= Time.now.year %> My Company, Inc.
+// ==========================================================================
+/*globals <%= namespace %> */
+
+/** @class
+
+  (Document Your Controller Here)
+
+  @extends <%= base_class_name || 'SC.Object' %>
+*/
+<%= namespace_instance_name %> = <%= base_class_name || 'SC.Object' %>.create(
+/** @scope <%= namespace_instance_name %>.prototype */ {
+
+  // TODO: Add your own code here.
+
+}) ;

data/gen/controller/templates/tests/controllers/{filename}.js

@@ -0,0 +1,15 @@
+// ==========================================================================
+// Project:   <%= namespace_instance_name %> Unit Test
+// Copyright: ©<%= Time.now.year %> My Company, Inc.
+// ==========================================================================
+/*globals <%= namespace %> module test ok equals same stop start */
+
+module("<%= namespace_instance_name %>");
+
+// TODO: Replace with real unit test for <%= namespace_instance_name %>
+test("test description", function() {
+  var expected = "test";
+  var result   = "test";
+  equals(result, expected, "test should equal test");
+});
+

data/gen/framework/Buildfile

@@ -0,0 +1,36 @@
+# ==========================================================================
+# Generator: Framework
+# Copyright: ©2006-2009 Sprout Systems, Inc. and contributors
+#            portions copyright ©2009 Apple, Inc.
+# ==========================================================================
+
+namespace :generator do
+  
+  # Require a project then make sure the build root is always the project 
+  # root.
+  task :prepare do
+    GENERATOR.requires! :target_project
+    
+    # if the target name has a slash in it, then we are trying to create a 
+    # nested target.  extract the final part (since this is the target name)
+    # and then set the build root to the parent target.
+    if GENERATOR.target_name && GENERATOR.target_name =~ /\//
+      parent_target_name = GENERATOR.target_name.split('/')
+      GENERATOR.target_name = parent_target_name.pop
+      
+      parent_target_name = parent_target_name * "/"
+      project = GENERATOR.target_project
+      
+      GENERATOR.parent_target_name = parent_target_name
+      GENERATOR.parent_target = project.target_for(parent_target_name)
+      GENERATOR.requires! :parent_target, :parent_target_name
+      
+      GENERATOR.build_root = GENERATOR.parent_target.source_root
+    
+    # otherwise just use project_root
+    else        
+      GENERATOR.build_root = GENERATOR.target_project.project_root
+    end
+  end
+  
+end

data/gen/framework/README

@@ -0,0 +1 @@
+Your framework is now ready to use!

data/gen/framework/USAGE

@@ -0,0 +1,13 @@
+framework - Create a new SproutCore framework.
+
+USAGE:
+
+  sc-gen framework FrameworkName [--filename=FILENAME] [--target=TARGET_NAME]
+
+DISCUSSION:
+
+This generator will create a new SproutCore framework for a particular project.  You should pass as the first parameter your FrameworkName you want to create.  For example:
+
+sc-gen framework Todos
+
+defines a new framework called Todos in the file frameworks/todos/ .

data/gen/framework/templates/frameworks/{target_name}/core.js

@@ -0,0 +1,21 @@
+// ==========================================================================
+// Project:   <%= namespace %>
+// Copyright: ©<%= Time.now.year %> My Company, Inc.
+// ==========================================================================
+/*globals <%= namespace %> */
+
+/** @namespace
+
+  My cool new framework.  Describe your framework.
+  
+  @extends SC.Object
+*/
+<%= namespace %> = SC.Object.create(
+  /** @scope <%= namespace %>.prototype */ {
+
+  NAMESPACE: '<%= namespace %>',
+  VERSION: '0.1.0',
+
+  // TODO: Add global constants or singleton objects needed by your app here.
+
+}) ;

data/gen/framework/templates/frameworks/{target_name}/english.lproj/strings.js

@@ -0,0 +1,15 @@
+// ==========================================================================
+// Project:   <%= namespace %> Strings
+// Copyright: ©<%= Time.now.year %> My Company, Inc.
+// ==========================================================================
+/*globals <%= namespace %> */
+
+// Place strings you want to localize here.  In your app, use the key and
+// localize it using "key string".loc().  HINT: For your key names, use the
+// english string with an underscore in front.  This way you can still see
+// how your UI will look and you'll notice right away when something needs a
+// localized string added to this file!
+//
+SC.stringsFor('English', {
+  // "_String Key": "Localized String"
+}) ;

data/gen/language/Buildfile

@@ -0,0 +1,26 @@
+# ==========================================================================
+# Generator: Language
+# Copyright: ©2006-2009 Sprout Systems, Inc. and contributors
+#            portions copyright ©2009 Apple, Inc.
+# ==========================================================================
+
+namespace :generator do
+
+  # First argument must be the namespace.  Second argument should be the 
+  # language we want to add.  Generate a filename (foo.lproj) and language
+  # name.
+  task :prepare do
+    long_languages = %w(english french german italian spanish japanese)
+    if language = GENERATOR.arguments[2]
+      if long_languages.include?(language.downcase)
+        GENERATOR.language = language.downcase.capitalize
+        GENERATOR.filename = language.downcase + '.lproj'
+      else
+        GENERATOR.language = language.gsub('_', '-') 
+        GENERATOR.filename = language.gsub('-', '_') + '.lproj'
+      end
+    end
+    GENERATOR.requires! :target_project, :target, :language, :filename
+  end
+  
+end