restfulx 1.2.1 → 1.2.2

data/rails_generators/rx_config/rx_config_generator.rb

@@ -11,11 +11,20 @@ class RxConfigGenerator < Rails::Generator::Base
               :command_controller_name, 
               :component_names, 
               :application_tag,
-              :use_air
+              :use_air,
+              :flex_root,
+              :base_flex_package,
+              :distributed
 
   def initialize(runtime_args, runtime_options = {})
     super
-    @project_name, @flex_project_name, @command_controller_name, @base_package, @base_folder = extract_names
+    @project_name, @flex_project_name, @command_controller_name, @base_package, @base_folder, 
+      @flex_root = extract_names
+    
+    @base_package = options[:base_flex_package] if options[:base_flex_package]
+    @base_folder = options[:base_flex_package].gsub('.', '/') if options[:base_flex_package]
+    @flex_root = options[:flex_root] if options[:flex_root]
+    @distributed = options[:distributed]
     
     # if we are updating main file only we probably want to maintain the type of project it is
     if options[:main_only]
@@ -32,7 +41,7 @@ class RxConfigGenerator < Rails::Generator::Base
     else
       @use_air = options[:air_config]
     end
-                
+                    
     if @use_air
       @application_tag = 'WindowedApplication'
     else
@@ -40,60 +49,72 @@ class RxConfigGenerator < Rails::Generator::Base
     end
         
     @component_names = []
-    if File.exists?("app/flex/#{base_folder}/components/generated")
-      @component_names = list_mxml_files("app/flex/#{base_folder}/components/generated")
+    if File.exists?("#{flex_root}/#{base_folder}/components/generated")
+      @component_names = list_mxml_files("#{flex_root}/#{base_folder}/components/generated")
     end
   end
 
   def manifest
     record do |m|
-      if !options[:main_only]
-        m.file 'restfulx_tasks.rake', 'lib/tasks/restfulx_tasks.rake'
-        m.file 'flex.properties', '.flexProperties'
-        m.file 'restfulx.yml', 'config/restfulx.yml'
-        if @use_air
-          m.template 'actionscriptair.properties', '.actionScriptProperties'
-          m.template 'projectair.properties', '.project'
-        else
-          m.template 'actionscript.properties', '.actionScriptProperties'
-          m.template 'project.properties', '.project'
-        end
-  
-        m.directory 'html-template/history'      
-        %w(index.template.html AC_OETags.js playerProductInstall.swf).each do |file|
-          m.file "html-template/#{file}", "html-template/#{file}"
-        end
-        
-        %w(history.css history.js historyFrame.html).each do |file|
-          m.file "html-template/history/#{file}", "html-template/history/#{file}"
-        end
-        
-        %w(components controllers commands models events).each do |dir|
-          m.directory "app/flex/#{base_folder}/#{dir}"
-        end
-        
-        m.directory "app/flex/#{base_folder}/components/generated"
-        
-        framework_release = RestfulX::FRAMEWORK_VERSION
-        framework_distribution_url = "http://restfulx.github.com/releases/restfulx-#{framework_release}.swc"
-        framework_destination_file = "lib/restfulx-#{framework_release}.swc"
-        
-        if !options[:skip_framework] && !File.exist?(framework_destination_file)
-          puts "fetching #{framework_release} framework binary from: #{framework_distribution_url} ..."
-          open(framework_destination_file, "wb").write(open(framework_distribution_url).read)
-          puts "done. saved to #{framework_destination_file}"
-        end
-  
-        m.file 'swfobject.js', 'public/javascripts/swfobject.js'
-        m.file 'expressInstall.swf', 'public/expressInstall.swf'
-        m.template 'index.html.erb', 'public/index.html'
-        
-        m.dependency 'rx_controller', @args
+      m.file 'restfulx_tasks.rake', 'lib/tasks/restfulx_tasks.rake' if !options[:skip_tasks]
+      m.file 'flex.properties', '.flexProperties'
+      m.template 'restfulx.yml', 'config/restfulx.yml'
+      m.template 'restfulx.erb', 'config/initializers/restfulx.rb'
+      
+      m.directory "#{flex_root}"
+      
+      if @use_air
+        m.template 'actionscriptair.properties', '.actionScriptProperties'
+        m.template 'projectair.properties', '.project'
+      else
+        m.template 'actionscript.properties', '.actionScriptProperties'
+        m.template 'project.properties', '.project'
+      end
+      
+      m.template 'project-textmate.erb', "#{project_name}.tmproj"
+      m.template 'mainapp.mxml', File.join("#{flex_root}", "#{flex_project_name}.mxml")
+      m.template 'mainapp-config.xml', File.join("#{flex_root}", "#{flex_project_name}-config.xml")
+      m.template 'mainair-app.xml', File.join("#{flex_root}", "#{flex_project_name}-app.xml") if @use_air
+
+      m.directory 'html-template/history'      
+      %w(index.template.html AC_OETags.js playerProductInstall.swf).each do |file|
+        m.file "html-template/#{file}", "html-template/#{file}"
+      end
+      
+      %w(history.css history.js historyFrame.html).each do |file|
+        m.file "html-template/history/#{file}", "html-template/history/#{file}"
       end
-      m.template 'project-textmate.erb', "#{project_name.underscore}.tmproj"
-      m.template 'mainapp.mxml', File.join('app/flex', "#{project_name}.mxml")
-      m.template 'mainapp-config.xml', File.join('app/flex', "#{project_name}-config.xml")
-      m.template 'mainair-app.xml', File.join('app/flex', "#{project_name}-app.xml") if @use_air
+      
+      %w(components controllers commands models events).each do |dir|
+        m.directory "#{flex_root}/#{base_folder}/#{dir}"
+      end
+      
+      m.directory "#{flex_root}/#{base_folder}/components/generated"
+      
+      framework_release = RestfulX::FRAMEWORK_VERSION
+      framework_distribution_url = "http://restfulx.github.com/releases/restfulx-#{framework_release}.swc"
+      framework_destination_file = "lib/restfulx-#{framework_release}.swc"
+      
+      if !options[:skip_framework] && !File.exist?(framework_destination_file)
+        puts "fetching #{framework_release} framework binary from: #{framework_distribution_url} ..."
+        open(framework_destination_file, "wb").write(open(framework_distribution_url).read)
+        puts "done. saved to #{framework_destination_file}"
+      end
+
+      m.file 'swfobject.js', 'public/javascripts/swfobject.js'
+      m.file 'expressInstall.swf', 'public/expressInstall.swf'
+      
+      m.file 'flex_controller.erb', 'app/controllers/flex_controller.rb'
+      
+      m.directory "app/views/flex"
+      
+      m.template 'index.erb', 'app/views/flex/index.html.erb'
+      
+      m.file 'routes.erb', 'config/routes.rb', :collision => :force
+      
+      FileUtils.rm 'public/index.html' if File.exist?('public/index.html')
+              
+      m.dependency 'rx_controller', @args
     end
   end
 
@@ -101,12 +122,18 @@ class RxConfigGenerator < Rails::Generator::Base
   def add_options!(opt)
     opt.separator ''
     opt.separator 'Options:'
-    opt.on("-m", "--main-only", "Only generate the main Flex/AIR application file.", 
-      "Default: false") { |v| options[:main_only] = v }
     opt.on("-a", "--air", "Configure AIR project instead of Flex. Flex is default.", 
       "Default: false") { |v| options[:air_config] = v }
     opt.on("--skip-framework", "Don't fetch the latest framework binary. You'll have to link/build the framework yourself.", 
       "Default: false") { |v| options[:skip_framework] = v }
+    opt.on("--skip-tasks", "Don't install restfulx gem tasks hook into the project.", 
+      "Default: false") { |v| options[:skip_tasks] = v }
+    opt.on("--flex-root [FOLDER]", "Root folder for generated flex code.", 
+      "Default: app/flex") { |v| options[:flex_root] = v }
+    opt.on("--base-flex-package [PACKAGE]", "Base package for your application.", 
+      "Default: #{flex_project_name}") { |v| options[:base_flex_package] = v }
+    opt.on("--distributed", "Creates migrations, controllers and models that use UUIDs and are distribution ready", 
+      "Default: false") { |v| options[:distributed] = v }
   end
 
   def banner

data/rails_generators/rx_config/templates/actionscript.properties

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<actionScriptProperties mainApplicationPath="<%= project_name %>.mxml" version="3">
-<compiler additionalCompilerArguments="-locale en_US -keep-as3-metadata+=Resource,HasOne,HasMany,BelongsTo,DateTime,Lazy,Ignored" copyDependentFiles="true" enableModuleDebug="true" generateAccessible="false" htmlExpressInstall="true" htmlGenerate="true" htmlHistoryManagement="true" htmlPlayerVersion="9.0.28" htmlPlayerVersionCheck="true" outputFolderPath="public/bin" rootURL="http://localhost:3000/bin" sourceFolderPath="app/flex" strict="true" useApolloConfig="false" verifyDigests="true" warn="true">
+<actionScriptProperties mainApplicationPath="<%= flex_project_name %>.mxml" version="3">
+<compiler additionalCompilerArguments="-locale en_US -keep-as3-metadata+=Resource,HasOne,HasMany,BelongsTo,DateTime,Lazy,Ignored" copyDependentFiles="true" enableModuleDebug="true" generateAccessible="false" htmlExpressInstall="true" htmlGenerate="true" htmlHistoryManagement="true" htmlPlayerVersion="9.0.28" htmlPlayerVersionCheck="true" outputFolderPath="public/bin" rootURL="http://localhost:3000/bin" sourceFolderPath="<%= flex_root %>" strict="true" useApolloConfig="false" verifyDigests="true" warn="true">
   <compilerSourcePath/>
   <libraryPath defaultLinkType="1">
     <libraryPathEntry kind="4" path=""/>
@@ -9,7 +9,7 @@
   <sourceAttachmentPath/>
 </compiler>
 <applications>
-  <application path="<%= project_name %>.mxml"/>
+  <application path="<%= flex_project_name %>.mxml"/>
 </applications>
 <modules/>
 <buildCSSFiles/>

data/rails_generators/rx_config/templates/actionscriptair.properties

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<actionScriptProperties mainApplicationPath="<%= project_name %>.mxml" version="3">
-<compiler additionalCompilerArguments="-locale en_US -keep-as3-metadata+=Resource,HasOne,HasMany,BelongsTo,DateTime,Lazy,Ignored" copyDependentFiles="true" enableModuleDebug="true" generateAccessible="false" htmlExpressInstall="true" htmlGenerate="false" htmlHistoryManagement="false" htmlPlayerVersion="9.0.28" htmlPlayerVersionCheck="true" outputFolderPath="bin-debug" sourceFolderPath="app/flex" strict="true" useApolloConfig="true" verifyDigests="true" warn="true">
+<actionScriptProperties mainApplicationPath="<%= flex_project_name %>.mxml" version="3">
+<compiler additionalCompilerArguments="-locale en_US -keep-as3-metadata+=Resource,HasOne,HasMany,BelongsTo,DateTime,Lazy,Ignored" copyDependentFiles="true" enableModuleDebug="true" generateAccessible="false" htmlExpressInstall="true" htmlGenerate="false" htmlHistoryManagement="false" htmlPlayerVersion="9.0.28" htmlPlayerVersionCheck="true" outputFolderPath="bin-debug" sourceFolderPath="<%= flex_root %>" strict="true" useApolloConfig="true" verifyDigests="true" warn="true">
   <compilerSourcePath/>
   <libraryPath defaultLinkType="1">
     <libraryPathEntry kind="4" path=""/>
@@ -9,7 +9,7 @@
   <sourceAttachmentPath/>
 </compiler>
 <applications>
-  <application path="<%= project_name %>.mxml"/>
+  <application path="<%= flex_project_name %>.mxml"/>
 </applications>
 <modules/>
 <buildCSSFiles/>

data/rails_generators/rx_config/templates/flex_controller.erb

@@ -0,0 +1,4 @@
+class FlexController < ApplicationController
+  def index
+  end
+end

data/rails_generators/rx_config/templates/{index.html.erb → index.erb}

@@ -3,15 +3,13 @@
 		<title><%= project_name %></title>
 		<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
 		<script type="text/javascript" src="javascripts/swfobject.js"></script>
-		<script type="text/javascript">
-		swfobject.embedSWF("bin/<%= project_name %>.swf", "mainApp", "100%", "100%", "9.0.0", "expressInstall.swf");
-		</script>
+    <%%= swfobject("/bin/<%= flex_project_name %>.swf") %>
 		<style>
 		  body { margin: 0px; overflow: hidden; }
 		</style>
 	</head>
 	<body>
-		<div id="mainApp">
+		<div id="flashContent">
 			<p><a href="http://www.adobe.com/go/getflashplayer"><img src="http://www.adobe.com/images/shared/download_buttons/get_flash_player.gif" alt="Get Adobe Flash player" /></a></p>
 		</div>
 	</body>

data/rails_generators/rx_config/templates/mainair-app.xml

@@ -15,13 +15,13 @@
 -->
 
 	<!-- The application identifier string, unique to this application. Required. -->
-	<id><%= project_name %></id>
+	<id><%= flex_project_name %></id>
 
 	<!-- Used as the filename for the application. Required. -->
-	<filename><%= project_name %></filename>
+	<filename><%= flex_project_name %></filename>
 
 	<!-- The name that is displayed in the AIR application installer. Optional. -->
-	<name><%= project_name %></name>
+	<name><%= flex_project_name %></name>
 
 	<!-- An application version designator (such as "v1", "2.5", or "Alpha 1"). Required. -->
 	<version>v1</version>

data/rails_generators/rx_config/templates/mainapp.mxml

@@ -6,20 +6,119 @@
   <mx:Script>
     <![CDATA[
 <% if use_air -%>
+<% if distributed -%>
+      import air.net.SocketMonitor;
+      import org.restfulx.events.PullEndEvent;
+      import org.restfulx.events.PullStartEvent;
+      import org.restfulx.events.PushEndEvent;
+      import org.restfulx.events.PushStartEvent;
+      import org.restfulx.controllers.ChangeController;
+      import org.restfulx.services.ISyncingServiceProvider;
+      import org.restfulx.services.http.XMLHTTPServiceProvider;
+<% end -%>
       import org.restfulx.services.air.AIRServiceProvider;
 <% end -%>
       import org.restfulx.Rx;
       import <%= base_package %>.controllers.<%= command_controller_name %>;
+<% if use_air -%>
+<% if distributed -%>
+
+      [Bindable]
+      private var socketMonitor:SocketMonitor;
+
+      [Bindable]
+      private var online:Boolean;
+
+      [Bindable]
+      private var syncStatus:String;
+<% end -%>
+<% end -%>
 
       private function init():void {
 <% if use_air -%>
-        <%= command_controller_name %>.initialize([AIRServiceProvider], AIRServiceProvider.ID, "<%= base_package %>");
+<% if distributed -%>
+        Rx.httpRootUrl = "http://localhost:3000/";
+        Rx.enableSync = true;
+
+        socketMonitor = new SocketMonitor("localhost", 3000);
+        socketMonitor.pollInterval = 2000; /* miliseconds */
+        socketMonitor.addEventListener(StatusEvent.STATUS, onNetworkStatusChange);
+        socketMonitor.start();
+        
+<% end -%>
+        <%= command_controller_name %>.initialize([AIRServiceProvider], 
+          AIRServiceProvider.ID, "<%= base_package %>");
+<% if distributed -%>
+
+        Rx.changes.setSyncProviders(
+          ISyncingServiceProvider(Rx.services.getServiceProvider(AIRServiceProvider.ID)),
+            Rx.services.getServiceProvider(XMLHTTPServiceProvider.ID));
+
+        Rx.changes.addEventListener(PushStartEvent.ID, onPushStart);
+        Rx.changes.addEventListener(PushEndEvent.ID, onPushEnd);
+        Rx.changes.addEventListener(PullStartEvent.ID, onPullStart);
+        Rx.changes.addEventListener(PullEndEvent.ID, onPullEnd);
+<% end -%>
 <% else -%>
         <%= command_controller_name %>.initialize();
 <% end -%>
       }
+<% if use_air -%>
+<% if distributed -%>
+
+      private function onPushStart(event:Event):void {
+        syncStatus = "Pushing changes ...";
+      }
+
+      private function onPushEnd(event:Event):void {
+        syncStatus = "Push complete.";
+      }
+
+      private function onPullStart(event:Event):void {
+        syncStatus = "Pulling data...";
+      }
+
+      private function onPullEnd(event:Event):void {
+        syncStatus = "Pull complete.";
+      }
+
+      private function onNetworkStatusChange(event:StatusEvent):void {
+        online = (socketMonitor.available) ? true : false;
+  
+        if (online) {
+          Rx.defaultServiceId = XMLHTTPServiceProvider.ID;
+        } else {
+          Rx.defaultServiceId = AIRServiceProvider.ID;
+        }
+      }
+
+      private function getCurrentProviderName(id:int):String {
+        switch (id) {
+          case XMLHTTPServiceProvider.ID:
+            return "Rails";
+          case AIRServiceProvider.ID:
+            return "AIR (SQLite)";
+          default :
+            return "No idea";
+        }
+      }
+<% end -%>
+<% end -%>
     ]]>
   </mx:Script>
+<% if use_air -%>
+<% if distributed -%>
+  <mx:VBox height="100%">
+    <mx:Label text="Current Provider: {getCurrentProviderName(Rx.defaultServiceId)}"/>
+    <mx:Label text="Status: {online ? 'Online' : 'Offline' }"/>
+    <mx:HBox>
+      <mx:Button label="Push" click="{Rx.changes.push()}" enabled="{online}"/>
+      <mx:Button label="Pull" click="{Rx.changes.pull()}" enabled="{online}"/>
+    </mx:HBox>
+    <mx:Label text="{syncStatus}"/>
+  </mx:VBox>
+<% end -%>
+<% end -%>
   <mx:LinkBar dataProvider="{mainViewStack}" direction="vertical" borderStyle="solid" backgroundColor="#EEEEEE"/>
   <mx:ViewStack id="mainViewStack" width="100%" height="100%">
     <!-- For a simple demo, put all the components here. -->
@@ -28,4 +127,3 @@
 <% end -%>
   </mx:ViewStack>
 </mx:<%= application_tag %>>
-

data/rails_generators/rx_config/templates/project-textmate.erb

@@ -3,14 +3,14 @@
 <plist version="1.0">
 <dict>
 	<key>currentDocument</key>
-	<string>app/flex/<%= project_name %>.mxml</string>
+	<string>app/flex/<%= flex_project_name %>.mxml</string>
 	<key>documents</key>
 	<array>
 		<dict>
 			<key>expanded</key>
 			<true/>
 			<key>name</key>
-			<string><%= project_name.underscore %></string>
+			<string><%= project_name %></string>
 			<key>regexFolderFilter</key>
 			<string>!.*/(\.[^/]*|CVS|_darcs|_MTN|\{arch\}|blib|.*~\.nib|.*\.(framework|app|pbproj|pbxproj|xcode(proj)?|bundle))$</string>
 			<key>sourceDirectory</key>
@@ -27,7 +27,7 @@
 			<key>enabled</key>
 			<true/>
 			<key>value</key>
-			<string>app/flex/<%= project_name %>.mxml</string>
+			<string>app/flex/<%= flex_project_name %>.mxml</string>
 			<key>variable</key>
 			<string>TM_FLEX_FILE_SPECS</string>
 		</dict>
@@ -35,7 +35,7 @@
 			<key>enabled</key>
 			<true/>
 			<key>value</key>
-			<string>public/bin/<%= project_name %>.swf</string>
+			<string>public/bin/<%= flex_project_name %>.swf</string>
 			<key>variable</key>
 			<string>TM_FLEX_OUTPUT</string>
 		</dict>

data/rails_generators/rx_config/templates/project.properties

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <projectDescription>
-  <name><%= flex_project_name %></name>
+  <name><%= project_name %></name>
 	<comment></comment>
 	<projects>
 	</projects>

data/rails_generators/rx_config/templates/projectair.properties

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <projectDescription>
-  <name><%= flex_project_name %></name>
+  <name><%= project_name %></name>
 	<comment></comment>
 	<projects>
 	</projects>

data/rails_generators/rx_config/templates/restfulx.erb

@@ -0,0 +1,38 @@
+# When you do file uploads from Flash with File.upload() that, unfortunately generates a new session id,
+# which will fail to authenticate if you are using restful-authentication plugin or equivalent.
+#
+# The following code is a work-around for the Flash bug that prevents file uploader
+# from sending correct session_id. Here, we hack the Session#initialize method and force the session_id
+# to load from the query string via the request URI.
+#
+# Based on the code from http://seventytwo.co.uk/posts/making-swfupload-and-rails-work-together
+class CGI::Session
+  alias original_initialize initialize
+
+  def initialize(request, option = {})
+    option = scan_for_session_id(request, '_session_id', option) unless option['session_id']
+    original_initialize(request, option)
+  end
+
+  def scan_for_session_id(request, session_key = '_session_id', option = {})
+    query_string = if (qs = request.env_table["QUERY_STRING"]) and qs != ""
+      qs
+    elsif (ru = request.env_table["REQUEST_URI"][0..-1]).include?("?")
+      ru[(ru.index("?") + 1)..-1]
+    end
+    if query_string and query_string.include?(session_key)
+      option['session_id'] = query_string.scan(/#{session_key}=(.*?)(&.*?)*$/).flatten.first
+    end
+    return option
+  end
+end
+
+# If you have configured your Rails/Flex/AIR application to share authenticity_token
+# comment this out to enable forgery protection. By default, this is disabled to allow
+# generated code to work out of the box.
+ActionController::Base.allow_forgery_protection = false
+
+<% if distributed -%>
+# If we are in distributed mode we need to make sure that the RestfulX::UUIDHelper is loaded
+require "restfulx/active_record_uuid_helper"
+<% end -%>

data/rails_generators/rx_config/templates/restfulx.yml

@@ -1,14 +1,65 @@
 # RestfulX code generation configuration options
 
+# This option controls what the main Flex application file will be called.
+# By default it will be equal to the name of your rails project camelized
+project-name: <%= project_name %>
+
+# This options determines what the root folder for generated Flex code is.
+# By default 'app/flex'
+flex-root: <%= flex_root %>
+
 # By default flex models, commands, controllers and components are genearated into
-# app/flex/<your rails project name> folder. If you'd like to customize the target folder 
+# <flex-root>/<your rails project name> folder. If you'd like to customize the target folder 
 # (to say append a "com" package before your rails project name) uncomment the line below
 # base-package must follow the usual flex package notation (a string separated by ".")
-
-#base-package: com.pomodo
+base-package: <%= base_package %>
 
 # Main RestfulX controller is typically named AppicationController. This controller is created in 
 # <base-package>.controllers folder. You can customize the name by uncommenting the following line 
 # and changing the controller name.
+controller-name: <%= command_controller_name %>
+
+# If you are using Rails on the back-end and Adobe AIR as the client you can generate Rails/Flex/AIR
+# code to take advantage of synchronization (online/offline) support in RestfulX by changing the following
+# option to true. By default distribution is disabled.
+distributed: <%= distributed %>
+
+# These options control code-generation options for view components, Flex and Rails models and so on.
+# Allowing you to choose what controller patterns, layouts, attachment plugin you want to use, etc.
+defaults: &defaults
+  attachment_plugin:  'paperclip'              # => paperclip/attachment_fu
+  controller_pattern: 'default'                # => default/resource_controller
+  layouts:
+    default:  'default'                        # => default (more coming soon)
+  ignored:                                     # => ignored tables/fields won't appear in model.yml
+    tables: [table1 table2]
+    fields: [field1 field2]
+    
+# set up specific options for development environment
+development:
+  <<: *defaults
+
+# set up specific options for test environment
+test:
+  <<: *defaults
 
-#controller-name: ApplicationController
+# set up specific options for production environment
+production:
+  <<: *defaults
+  
+# The following special model.yml fields are supported.
+#
+# For example:
+# attachment_field: [avatar]
+#   * arg takes Paperclip field name, or takes [uploaded_data] for Attachment_Fu
+# belongs_to: [account, profile]
+# has_many: [announcements, files, folders, users]
+# has_many_through: [permissions, roles]
+#   * has_many :roles, :through => :permissions
+# has_one:  [suitcase]
+# polymorphic: [commentable]
+# tree_model: [parent]
+# layout: [default]
+#   * default template is the only current theme, with more coming soon
+# ignored_fields: [children_count, ancestors_count, descendants_count, position]
+#   * specify fields you don't want generated for your template

data/rails_generators/rx_config/templates/restfulx_tasks.rake

@@ -3,4 +3,7 @@ begin
   # this will load the latest restfulx gem version
   require 'restfulx/active_record_tasks'
 rescue LoadError
+  puts "Could not load active_record_tasks from 'restfulx/active_record_tasks'. " <<
+    "If you are loading restfulx gem from vendor/gems, adjust the path to active_record_tasks in " <<
+    "lib/tasks/restfulx_tasks.rake accordingly."
 end

data/rails_generators/rx_config/templates/routes.erb

@@ -0,0 +1,47 @@
+ActionController::Routing::Routes.draw do |map|
+  
+  # Map application root to default RestfulX controller
+  map.root :controller => "flex"
+  
+  # The priority is based upon order of creation: first created -> highest priority.
+
+  # Sample of regular route:
+  #   map.connect 'products/:id', :controller => 'catalog', :action => 'view'
+  # Keep in mind you can assign values other than :controller and :action
+
+  # Sample of named route:
+  #   map.purchase 'products/:id/purchase', :controller => 'catalog', :action => 'purchase'
+  # This route can be invoked with purchase_url(:id => product.id)
+
+  # Sample resource route (maps HTTP verbs to controller actions automatically):
+  #   map.resources :products
+
+  # Sample resource route with options:
+  #   map.resources :products, :member => { :short => :get, :toggle => :post }, :collection => { :sold => :get }
+
+  # Sample resource route with sub-resources:
+  #   map.resources :products, :has_many => [ :comments, :sales ], :has_one => :seller
+  
+  # Sample resource route with more complex sub-resources
+  #   map.resources :products do |products|
+  #     products.resources :comments
+  #     products.resources :sales, :collection => { :recent => :get }
+  #   end
+
+  # Sample resource route within a namespace:
+  #   map.namespace :admin do |admin|
+  #     # Directs /admin/products/* to Admin::ProductsController (app/controllers/admin/products_controller.rb)
+  #     admin.resources :products
+  #   end
+
+  # You can have the root of your site routed with map.root -- just remember to delete public/index.html.
+  # map.root :controller => "welcome"
+
+  # See how all your routes lay out with "rake routes"
+
+  # Install the default routes as the lowest priority.
+  # Note: These default routes make all actions in every controller accessible via GET requests. You should
+  # consider removing the them or commenting them out if you're using named routes and resources.
+  map.connect ':controller/:action/:id'
+  map.connect ':controller/:action/:id.:format'
+end

data/rails_generators/rx_controller/rx_controller_generator.rb

@@ -9,20 +9,23 @@ class RxControllerGenerator < Rails::Generator::Base
               :base_folder, 
               :command_controller_name,
               :model_names, 
-              :command_names
+              :command_names,
+              :flex_root,
+              :distributed
 
   def initialize(runtime_args, runtime_options = {})
     super
-    @project_name, @flex_project_name, @command_controller_name, @base_package, @base_folder = extract_names
+    @project_name, @flex_project_name, @command_controller_name, @base_package, @base_folder, 
+      @flex_root, @distributed = extract_names
     
-    @model_names = list_as_files("app/flex/#{base_folder}/models")
-    @command_names = list_as_files("app/flex/#{base_folder}/commands")
+    @model_names = list_as_files("#{@flex_root}/#{@base_folder}/models")
+    @command_names = list_as_files("#{@flex_root}/#{@base_folder}/commands")
   end
 
   def manifest
     record do |m|      
-      m.template 'controller.as.erb', File.join("app/flex/#{base_folder}/controllers", 
-        "#{command_controller_name}.as")
+      m.template 'controller.as.erb', File.join("#{@flex_root}/#{@base_folder}/controllers", 
+        "#{@command_controller_name}.as")
     end
   end
 end