captproton-restfulx 1.2.3

data/rxgen_generators/rx_main_app/USAGE

@@ -0,0 +1,8 @@
+Description:
+    Refreshes main Flex/AIR application file to make sure that
+    any of the generated components are included. Warning,
+    this will wipe your main application file. Used mostly
+    during code generation phase.
+
+Examples:
+    `./script/generate rx_main_app`

data/rxgen_generators/rx_main_app/rx_main_app_generator.rb

@@ -0,0 +1,65 @@
+class RxMainAppGenerator < RubiGen::Base
+  include RestfulX::Configuration
+  
+  attr_reader :project_name, 
+              :flex_project_name, 
+              :base_package, 
+              :base_folder, 
+              :command_controller_name,
+              :model_names, 
+              :component_names,
+              :controller_names,
+              :use_air,
+              :use_gae,
+              :application_tag,
+              :flex_root,
+              :distributed
+
+  def initialize(runtime_args, runtime_options = {})
+    super
+    @project_name, @flex_project_name, @command_controller_name, @base_package, @base_folder,
+      @flex_root, @distributed = extract_names
+
+    project_file_name = APP_ROOT + '/.project'
+    if File.exist?(project_file_name)
+      @use_air = true if File.read(project_file_name) =~/com.adobe.flexbuilder.apollo.apollobuilder/m
+    end
+
+    if @use_air
+      @application_tag = 'WindowedApplication'
+    else
+      @application_tag = 'Application'
+    end
+
+    @component_names = []
+    if File.exists?("#{flex_root}/#{base_folder}/views/generated")
+      @component_names = list_mxml_files("#{flex_root}/#{base_folder}/views/generated")
+    end
+    
+    @controller_names = []
+    if options[:gae] && File.exists?("app/controllers")
+      @use_gae = true
+      @controller_names = 
+        Dir.entries("app/controllers").grep(/\.py$/).delete_if { |name| name == "__init__.py" || name == "restful.py" }.map { |name| name.sub(/\.py$/, "") }
+    end
+  end
+
+  def manifest
+    record do |m|      
+      m.template 'mainapp.mxml', File.join("#{flex_root}", "#{flex_project_name}.mxml")
+      if options[:gae]
+        m.template 'main.py.erb', 'main.py'
+      end
+    end
+  end
+
+  protected
+  def add_options!(opt)
+    opt.separator ''
+    opt.separator 'Options:'
+    opt.on("--gae", "Generate Google App Engine Python classes in addition to RestfulX Flex resources.", 
+      "Default: false") { |v| options[:gae] = v }
+    opt.on("--distributed", "Creates migrations, controllers and models that use UUIDs and are distribution ready", 
+      "Default: false") { |v| options[:distributed] = v }
+  end
+end

data/rxgen_generators/rx_main_app/templates/main.py.erb

@@ -0,0 +1,29 @@
+#!/usr/bin/env python
+
+import logging
+import wsgiref.handlers
+
+from google.appengine.api import users
+from google.appengine.ext import webapp
+from google.appengine.ext.webapp.util import run_wsgi_app
+from app.controllers import <%= controller_names.join(", ") %>
+
+class AppController(webapp.RequestHandler):
+  def get(self):
+    self.redirect("/public/index.html")
+
+def main():
+  application = webapp.WSGIApplication(
+  [('/*$', AppController), 
+<% for component in controller_names -%>
+<% if component == controller_names.last -%>
+  ('/<%= component %>.*', <%= component %>.Controller)
+<% else -%>
+  ('/<%= component %>.*', <%= component %>.Controller),
+<% end -%>
+<% end -%>
+  ], debug=True)
+  wsgiref.handlers.CGIHandler().run(application)
+
+if __name__ == '__main__':
+  main()

data/rxgen_generators/rx_main_app/templates/mainapp.mxml

@@ -0,0 +1,152 @@
+<?xml version="1.0" encoding="utf-8"?>
+<mx:<%= application_tag %> xmlns:mx="http://www.adobe.com/2006/mxml"
+  xmlns:generated="<%= base_package %>.views.generated.*"
+  paddingBottom="8" paddingLeft="8" paddingRight="8" paddingTop="8"
+  layout="horizontal" styleName="plain" initialize="init()">
+  <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;
+<% end -%>
+      import org.restfulx.services.air.AIRServiceProvider;
+<% end -%>
+<% if use_gae -%>
+      import org.restfulx.services.http.GAEHTTPServiceProvider;
+<% else -%>
+      import org.restfulx.services.http.XMLHTTPServiceProvider;
+<% 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 -%>
+<% 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 -%>
+
+<% if use_gae -%>
+        Rx.changes.setSyncProviders(
+          ISyncingServiceProvider(Rx.services.getServiceProvider(AIRServiceProvider.ID)),
+            Rx.services.getServiceProvider(GAEHTTPServiceProvider.ID));
+<% else -%>
+        Rx.changes.setSyncProviders(
+          ISyncingServiceProvider(Rx.services.getServiceProvider(AIRServiceProvider.ID)),
+            Rx.services.getServiceProvider(XMLHTTPServiceProvider.ID));
+<% end -%>
+
+        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 -%>
+<% if use_gae -%>
+        <%= command_controller_name %>.initialize([GAEHTTPServiceProvider], GAEHTTPServiceProvider.ID);
+<% else -%>
+        <%= command_controller_name %>.initialize();
+<% end -%>
+<% 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) {
+<% if use_gae -%>
+          Rx.defaultServiceId = GAEHTTPServiceProvider.ID;
+<% else -%>
+          Rx.defaultServiceId = XMLHTTPServiceProvider.ID;
+<% end -%>
+        } else {
+          Rx.defaultServiceId = AIRServiceProvider.ID;
+        }
+      }
+
+      private function getCurrentProviderName(id:int):String {
+        switch (id) {
+<% if use_gae -%>
+          case GAEHTTPServiceProvider.ID:
+            return "GAE";
+<% else -%>
+          case XMLHTTPServiceProvider.ID:
+            return "XML/HTTP";
+<% end -%>
+          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. -->
+<% for component in component_names -%>
+    <generated:<%= component %>/>
+<% end -%>
+  </mx:ViewStack>
+</mx:<%= application_tag %>>

data/rxgen_generators/rx_scaffold/USAGE

@@ -0,0 +1,29 @@
+Description:
+    Scaffolds an entire RestfulX resource. The resource is ready to use as a
+    starting point for your restful, resource-oriented application.
+    
+    rx_scaffold :
+      1. Generates all required Flex code.
+      2. You can pass special belongs_to, has_one and has_many attributes
+         to generate appropriate relationships.
+
+    Pass the name of the model, either CamelCased or under_scored, as the first
+    argument, and an optional list of attribute pairs.
+
+    Attribute pairs are column_name:sql_type arguments specifying the
+    model's attributes. Timestamps are added by default, so you don't have to
+    specify them by hand as 'created_at:datetime updated_at:datetime'.
+    
+    The syntax for belongs_to, has_one and has_many attributes is as follows:
+      belongs_to:<relationship_name> or
+      belongs_to:<relationship_name>,<another_relationship>,<and_another>
+
+    You don't have to think up every attribute up front, but it helps to
+    sketch out a few so you can start working with the resource immediately.
+
+    For example, `rx_scaffold post title:string body:text published:boolean`
+    gives you a model with those three attributes.
+
+Examples:
+    `./script/generate rx_scaffold project name:string has_many:tasks`
+    `./script/generate rx_scaffold task name:string belongs_to:project`

data/rxgen_generators/rx_scaffold/rx_scaffold_generator.rb

@@ -0,0 +1,194 @@
+module RestfulX
+  module Generator
+    class GeneratedAttribute
+      attr_accessor :name, :type, :flex_name
+
+      def initialize(name, type)
+        @name, @type = name, type.to_sym
+        @flex_name = name.camelcase(:lower)
+      end
+      
+      def flex_type
+        @flex_type = case type
+        when :integer                     then 'int'
+        when :date, :datetime, :time      then 'Date'
+        when :boolean                     then 'Boolean'
+        when :float, :decimal             then 'Number'
+        else
+          'String'
+        end
+      end
+      
+      def flex_default
+        @flex_default = case type
+        when :integer                 then '0'
+        when :date, :datetime, :time  then 'new Date'
+        when :boolean                 then 'false'
+        when :float, :decimal         then 'new Number'
+        else
+          "\"\""
+        end
+      end
+      
+      def gae_type
+        @gae_type = case type
+        when :integer     then 'IntegerProperty'
+        when :date        then 'DateProperty'
+        when :time        then 'TimeProperty'
+        when :datetime    then 'DateTimeProperty'
+        when :boolean     then 'BooleanProperty'
+        when :text        then 'TextProperty'
+        when :float, :decimal then 'FloatProperty'
+        else
+          'StringProperty'
+        end
+      end
+      
+      def gae_default
+        @gae_default = case type
+        when :integer                then 'default = 0'
+        when :date, :time, :datetime then 'auto_now_add = True'
+        when :boolean                then 'default = False'
+        when :float, :decimal        then 'default = 0.0'
+        else
+          ""
+        end
+      end
+    end
+  end
+end
+
+class RxScaffoldGenerator < RubiGen::Base
+  include RestfulX::Configuration 
+  
+  attr_reader   :project_name, 
+                :flex_project_name, 
+                :base_package, 
+                :base_folder, 
+                :command_controller_name,
+                :flex_root
+
+  attr_reader   :belongs_tos, 
+                :has_manies,
+                :has_ones,
+                :attachment_field,
+                :has_many_through,
+                :polymorphic,
+                :tree_model,
+                :layout,
+                :ignored_fields,
+                :args_for_generation
+    
+  attr_reader   :name,
+                :class_name,
+                :file_name
+                                      
+  def initialize(runtime_args, runtime_options = {})
+    super
+
+    # Name argument is required.
+    usage if runtime_args.empty?
+
+    @args = runtime_args.dup
+    @name = @args.shift
+    @file_name = @name.underscore
+    @class_name = @name.camelize
+    
+    @project_name, @flex_project_name, @command_controller_name, 
+      @base_package, @base_folder, @flex_root = extract_names
+    extract_relationships
+  end
+  
+  def manifest
+    record do |m|   
+      m.template 'model.as.erb',
+        File.join("#{flex_root}", base_folder, "models", "#{@class_name}.as"), 
+        :assigns => { :resource_controller_name => "#{file_name.pluralize}" }
+
+      if @layout.size > 0
+        m.template "layouts/#{@layout}.erb",
+          File.join("#{@flex_root}", base_folder, "views", "generated", "#{@class_name}Box.mxml"), 
+          :assigns => { :resource_controller_name => "#{file_name.pluralize}" }
+      else
+        m.template "layouts/#{RxSettings.layouts.default}.erb",
+          File.join("#{@flex_root}", base_folder, "views", "generated", "#{@class_name}Box.mxml"), 
+          :assigns => { :resource_controller_name => "#{file_name.pluralize}" }
+      end
+        
+      if options[:gae]
+        m.template 'controller.py.erb', "app/controllers/#{file_name.pluralize}.py"
+        m.template 'model.py.erb', "app/models/#{file_name}.py"
+      end
+
+      m.dependency 'rx_controller', [name] + @args, :collision => :force, :gae => options[:gae]
+    end
+  end
+  
+  protected
+  def extract_relationships
+    # arrays
+    @belongs_tos = []
+    @has_ones = []
+    @has_manies = []
+    @attachment_field = []
+    @polymorphic = []
+    @tree_model = []
+    @layout = []
+    @ignored_fields = []
+    
+    # hashes
+    @has_many_through = {}
+
+    @args.each do |arg|
+      # arrays
+      if arg =~ /^has_one:/
+        @has_ones = arg.split(':')[1].split(',')
+      elsif arg =~ /^has_many:/
+        @has_manies = arg.split(":")[1].split(",")
+      elsif arg =~ /^belongs_to:/
+        @belongs_tos = arg.split(":")[1].split(',')
+      elsif arg =~ /^attachment_field:/
+        @attachment_field = arg.split(":")[1].split(',')
+      elsif arg =~ /^polymorphic:/
+        @polymorphic = arg.split(":")[1].split(',')
+      elsif arg =~ /^tree_model:/
+        @tree_model = arg.split(":")[1].split(',')
+      elsif arg =~ /^layout:/
+        @layout = arg.split(":")[1].split(',')
+      elsif arg =~ /^ignored_fields:/
+        @ignored_fields = arg.split(":")[1].split(',')
+      # hashes
+      elsif arg =~ /^has_many_through:/
+        hmt_arr = arg.split(":")[1].split(',')
+        @has_many_through[hmt_arr.first] = hmt_arr.last
+      end
+    end
+    
+    # delete special fields from @args ivar
+    %w(has_one has_many belongs_to attachment_field has_many_through 
+      polymorphic tree_model layout ignored_fields).each do |special_field|
+      @args.delete_if { |f| f =~ /^(#{special_field}):/ }
+    end
+    
+    @args_for_generation = @args.clone
+    
+    # delete ignored_fields from @args ivar
+    @ignored_fields.each do |ignored|
+      @args.delete_if { |f| f =~ /^(#{ignored}):/ }
+    end
+    
+  end
+
+  def attributes
+    @attributes ||= @args.collect do |attribute|
+      RestfulX::Generator::GeneratedAttribute.new(*attribute.split(":"))
+    end
+  end
+
+  def add_options!(opt)
+    opt.separator ''
+    opt.separator 'Options:'
+    opt.on("--gae", "Generate Google App Engine Python classes in addition to RestfulX Flex resources.", 
+      "Default: false") { |v| options[:gae] = v }
+  end
+end