restfulx 1.2.0

data/History.txt

@@ -0,0 +1,7 @@
+== 1.1.2 / 2009-01-11
+
+* Got rid of default_methods helper for AR models. to_fxml(:methods => []) syntax must be used instead.
+
+== 1.1.1 / 2009-01-09
+
+* Bug fixing code generation templates so that AIR projects compile properly with Flex SDK 3.2.0

data/Manifest.txt

@@ -0,0 +1,127 @@
+History.txt
+Manifest.txt
+README.rdoc
+Rakefile
+app_generators/rx_app/USAGE
+app_generators/rx_app/rx_app_generator.rb
+app_generators/rx_app/templates/actionscript.properties
+app_generators/rx_app/templates/actionscriptair.properties
+app_generators/rx_app/templates/app.yaml.erb
+app_generators/rx_app/templates/default_tasks.rake
+app_generators/rx_app/templates/empty.txt
+app_generators/rx_app/templates/expressInstall.swf
+app_generators/rx_app/templates/flex.properties
+app_generators/rx_app/templates/generate.rb
+app_generators/rx_app/templates/html-template/AC_OETags.js
+app_generators/rx_app/templates/html-template/history/history.css
+app_generators/rx_app/templates/html-template/history/history.js
+app_generators/rx_app/templates/html-template/history/historyFrame.html
+app_generators/rx_app/templates/html-template/index.template.html
+app_generators/rx_app/templates/html-template/playerProductInstall.swf
+app_generators/rx_app/templates/index.html.erb
+app_generators/rx_app/templates/index.yaml
+app_generators/rx_app/templates/mainair-app.xml
+app_generators/rx_app/templates/mainapp-config.xml
+app_generators/rx_app/templates/mainapp.mxml
+app_generators/rx_app/templates/project-textmate.erb
+app_generators/rx_app/templates/project.properties
+app_generators/rx_app/templates/projectair.properties
+app_generators/rx_app/templates/swfobject.js
+bin/rx-gen
+generators/rx_config/USAGE
+generators/rx_config/rx_config_generator.rb
+generators/rx_controller/USAGE
+generators/rx_controller/rx_controller_generator.rb
+generators/rx_controller/templates/assist.py
+generators/rx_controller/templates/controller.as.erb
+generators/rx_controller/templates/restful.py
+generators/rx_main_app/USAGE
+generators/rx_main_app/rx_main_app_generator.rb
+generators/rx_main_app/templates/main.py.erb
+generators/rx_main_app/templates/mainapp.mxml
+generators/rx_scaffold/USAGE
+generators/rx_scaffold/rx_scaffold_generator.rb
+generators/rx_scaffold/templates/component.mxml.erb
+generators/rx_scaffold/templates/controller.py.erb
+generators/rx_scaffold/templates/model.as.erb
+generators/rx_scaffold/templates/model.py.erb
+generators/rx_yaml_scaffold/USAGE
+generators/rx_yaml_scaffold/rx_yaml_scaffold_generator.rb
+lib/restfulx.rb
+lib/restfulx/active_foo.rb
+lib/restfulx/active_record_tasks.rb
+lib/restfulx/configuration.rb
+lib/restfulx/datamapper_foo.rb
+lib/restfulx/rails/recipes.rb
+lib/restfulx/rails/swf_helper.rb
+lib/restfulx/tasks.rb
+rails_generators/rx_config/USAGE
+rails_generators/rx_config/rx_config_generator.rb
+rails_generators/rx_config/templates/actionscript.properties
+rails_generators/rx_config/templates/actionscriptair.properties
+rails_generators/rx_config/templates/expressInstall.swf
+rails_generators/rx_config/templates/flex.properties
+rails_generators/rx_config/templates/html-template/AC_OETags.js
+rails_generators/rx_config/templates/html-template/history/history.css
+rails_generators/rx_config/templates/html-template/history/history.js
+rails_generators/rx_config/templates/html-template/history/historyFrame.html
+rails_generators/rx_config/templates/html-template/index.template.html
+rails_generators/rx_config/templates/html-template/playerProductInstall.swf
+rails_generators/rx_config/templates/index.html.erb
+rails_generators/rx_config/templates/mainair-app.xml
+rails_generators/rx_config/templates/mainapp-config.xml
+rails_generators/rx_config/templates/mainapp.mxml
+rails_generators/rx_config/templates/project-textmate.erb
+rails_generators/rx_config/templates/project.properties
+rails_generators/rx_config/templates/projectair.properties
+rails_generators/rx_config/templates/restfulx.yml
+rails_generators/rx_config/templates/restfulx_tasks.rake
+rails_generators/rx_config/templates/swfobject.js
+rails_generators/rx_controller/USAGE
+rails_generators/rx_controller/rx_controller_generator.rb
+rails_generators/rx_controller/templates/controller.as.erb
+rails_generators/rx_scaffold/USAGE
+rails_generators/rx_scaffold/rx_scaffold_generator.rb
+rails_generators/rx_scaffold/templates/component.mxml.erb
+rails_generators/rx_scaffold/templates/controller.rb.erb
+rails_generators/rx_scaffold/templates/fixtures.yml.erb
+rails_generators/rx_scaffold/templates/migration.rb.erb
+rails_generators/rx_scaffold/templates/model.as.erb
+rails_generators/rx_scaffold/templates/model.rb.erb
+rails_generators/rx_yaml_scaffold/USAGE
+rails_generators/rx_yaml_scaffold/rx_yaml_scaffold_generator.rb
+rdoc/generators/template/html/jamis.rb
+spec/restfulx_spec.rb
+spec/spec_helper.rb
+test/rails/controllers/application.rb
+test/rails/controllers/locations_controller.rb
+test/rails/controllers/notes_controller.rb
+test/rails/controllers/projects_controller.rb
+test/rails/controllers/tasks_controller.rb
+test/rails/controllers/users_controller.rb
+test/rails/database.yml
+test/rails/fixtures/locations.yml
+test/rails/fixtures/notes.yml
+test/rails/fixtures/projects.yml
+test/rails/fixtures/simple_properties.yml
+test/rails/fixtures/tasks.yml
+test/rails/fixtures/users.yml
+test/rails/helpers/functional_test_helper.rb
+test/rails/helpers/test_helper.rb
+test/rails/helpers/unit_test_helper.rb
+test/rails/model.yml
+test/rails/models/location.rb
+test/rails/models/note.rb
+test/rails/models/project.rb
+test/rails/models/simple_property.rb
+test/rails/models/task.rb
+test/rails/models/user.rb
+test/rails/playing_around_in_a_console.txt
+test/rails/schema.rb
+test/rails/test.swf
+test/rails/test_active_foo.rb
+test/rails/test_rails_integration_functional.rb
+test/rails/test_to_fxml.rb
+test/rails/test_to_json.rb
+test/rails/views/notes/empty_params_action.html.erb
+test/rails/views/notes/index.html.erb

data/README.rdoc

@@ -0,0 +1,50 @@
+= RestfulX Framework: The RESTful way to develop Adobe Flex and AIR applications
+
+== Description
+
+Here's some of the things you can do with *RestfulX*:
+
+* *Create* a complete _Adobe_ _Flex_ or _AIR_ application in less than 5 minutes.
+
+  Use our lightweight Ruby-based code generation toolkit to create a fully functional
+  CRUD application. Simply do:
+  
+    sudo gem install restfulx
+  
+  And then run:
+  
+    rx-gen -h
+
+* *Integrate* with _Ruby_ _On_ _Rails_, _Merb_ or _Sinatra_ applications 
+  that use _ActiveRecord_, _DataMapper_, _CouchRest_, _ActiveCouch_ and so on.
+
+* *Communicate* between your Flex/AIR Rich Internet Application and service providers 
+  using either _XML_ or _JSON_.
+  
+* *Persist* your data directly in Adobe AIR _SQLite_ database or _CouchDB_ 
+  without any additional infrastructure or intermediate servers.
+  
+* *Deploy* your RestfulX application on the Google App Engine and use Google
+  DataStore for persistence.
+  
+* *Synchronize* your data between AIR _SQLite_ and other service providers. 
+
+== Getting Started
+
+For details on how to get started with the RestfulX framework refer to:
+    
+    http://restfulx.org
+    
+== Getting Involved
+
+Report bugs or track framework development progress:
+
+    http://restfulx.lighthouseapp.com/dashboard
+  
+Get involved with the community:
+      
+    http://groups.google.com/group/restfulx-framework
+    
+== License
+
+Copyright (c) 2008-2009 Dima Berastau and Contributors, released under MIT License

data/Rakefile

@@ -0,0 +1,42 @@
+# Look in the tasks/setup.rb file for the various options that can be
+# configured in this Rakefile. The .rake files in the tasks directory
+# are where the options are used.
+
+begin
+  require 'bones'
+  Bones.setup
+rescue LoadError
+  load 'tasks/setup.rb'
+end
+
+ensure_in_path 'lib'
+require 'restfulx'
+
+depend_on 'rubigen', '1.4.0'
+depend_on 'activesupport', '2.0.0'
+
+task :default => 'spec:run'
+
+PROJ.name = 'restfulx'
+PROJ.summary = 'RestfulX Framework Code Generation Engine / Rails 2.1+ Integration Support'
+PROJ.authors = 'Dima Berastau'
+PROJ.email = 'dima.berastau@gmail.com'
+PROJ.url = 'http://wiki.github.com/dima/restfulx'
+PROJ.version = RestfulX::VERSION
+
+PROJ.executables = ['bin/rx-gen']
+
+#PROJ.rdoc.opts << '-Tjamis'
+PROJ.rdoc.exclude << %w(.txt)
+PROJ.rdoc.main = 'README.rdoc'
+PROJ.rdoc.dir = 'doc/api'
+
+PROJ.readme_file = 'README.rdoc'
+PROJ.rubyforge.name = 'restfulx'
+
+PROJ.exclude << %w(.DS_Store .gitignore .log, .sqlite3)
+
+PROJ.spec.opts << '--color'
+PROJ.test.opts << '-W1'
+
+# EOF

data/app_generators/rx_app/USAGE

@@ -0,0 +1,22 @@
+Description:
+    Generates the primary RestfulX project directory structure and sets 
+    up Flex Builder and TextMate specific descriptor files
+    
+    You can generate Flex Builder configuration for either *pure* Flex
+    project or an AIR project. To generate AIR configuration pass the -a
+    (--air) option to the generator.
+    
+    You can also choose to generate a simple Google App Engine back-end
+    along with your Flex front-end by passing the --gae option.
+
+Examples:
+    `rx-gen pomodo`     # generates project structure and a 
+                        # default Flex app configuration.
+    `rx-gen -a pomodo`  # as above but generates an AIR app
+                        # and configuration
+    `rx-gen --gae pomodo` # generate Flex + GAE application
+                          # configuration
+                           
+Next Steps:
+    In your new RestfulX project folder run `ruby script/generate` for
+    a list of available generators.

data/app_generators/rx_app/rx_app_generator.rb

@@ -0,0 +1,94 @@
+class RxAppGenerator < RubiGen::Base
+  include RestfulX::Configuration
+
+  attr_reader :project_name, 
+              :flex_project_name, 
+              :base_package, 
+              :base_folder, 
+              :command_controller_name, 
+              :component_names, 
+              :application_tag,
+              :use_air
+
+  def initialize(runtime_args, runtime_options = {})
+    super
+    usage if args.empty?
+    @destination_root = File.expand_path(args.shift)
+    
+    @project_name, @flex_project_name, @command_controller_name, 
+      @base_package, @base_folder = extract_names(base_name)
+
+    @use_air = options[:air_config]
+    if @use_air
+      @application_tag = 'WindowedApplication'
+    else
+      @application_tag = 'Application'
+    end
+
+    @component_names = []
+  end
+
+  def manifest
+    record do |m|
+      m.directory ''
+      
+      %w(script lib db bin-debug).each { |dir| m.directory dir }
+      
+      if options[:gae]
+        m.file 'index.yaml', 'index.yaml' unless File.exist?('index.yaml')
+        m.template 'app.yaml.erb', 'app.yaml' unless File.exist?('app.yaml')
+        m.directory 'app/controllers'
+        m.file 'empty.txt', 'app/__init__.py'
+        m.file 'empty.txt', 'app/controllers/__init__.py'
+        m.directory 'app/models'
+        m.file 'empty.txt', 'app/models/__init__.py'
+      end
+
+      m.file 'default_tasks.rake', 'Rakefile' unless File.exist?('Rakefile')      
+      m.file 'flex.properties', '.flexProperties'
+      m.file 'generate.rb', 'script/generate', { :chmod => 0755 }
+      if @use_air
+        m.template 'actionscriptair.properties', '.actionScriptProperties'
+        m.template 'projectair.properties', '.project'
+      else
+        m.template 'actionscript.properties', '.actionScriptProperties'
+        m.template 'project.properties', '.project'
+        
+        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.directory 'public/javascripts'
+        m.file 'swfobject.js', 'public/javascripts/swfobject.js'
+        m.file 'expressInstall.swf', 'public/expressInstall.swf'
+        m.template 'index.html.erb', 'public/index.html'
+      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"
+
+      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      
+    end
+  end
+
+  protected
+  def add_options!(opt)
+    opt.separator ''
+    opt.separator 'Options:'
+    opt.on("-a", "--air", "Configure AIR project instead of Flex. Flex is default.", 
+      "Default: false") { |v| options[:air_config] = v }
+    opt.on("--gae", "Generate Google App Engine Python classes in addition to RestfulX Flex resources.", 
+      "Default: false") { |v| options[:gae] = v }
+  end
+end

data/app_generators/rx_app/templates/actionscript.properties

@@ -0,0 +1,16 @@
+<?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">
+  <compilerSourcePath/>
+  <libraryPath defaultLinkType="1">
+    <libraryPathEntry kind="4" path=""/>
+    <libraryPathEntry kind="1" linkType="1" path="lib"/>
+  </libraryPath>
+  <sourceAttachmentPath/>
+</compiler>
+<applications>
+  <application path="<%= project_name %>.mxml"/>
+</applications>
+<modules/>
+<buildCSSFiles/>
+</actionScriptProperties>

data/app_generators/rx_app/templates/actionscriptair.properties

@@ -0,0 +1,16 @@
+<?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">
+  <compilerSourcePath/>
+  <libraryPath defaultLinkType="1">
+    <libraryPathEntry kind="4" path=""/>
+    <libraryPathEntry kind="1" linkType="1" path="lib"/>
+  </libraryPath>
+  <sourceAttachmentPath/>
+</compiler>
+<applications>
+  <application path="<%= project_name %>.mxml"/>
+</applications>
+<modules/>
+<buildCSSFiles/>
+</actionScriptProperties>

data/app_generators/rx_app/templates/app.yaml.erb

@@ -0,0 +1,12 @@
+application: <%= project_name.downcase %>
+version: 1
+runtime: python
+api_version: 1
+
+handlers:
+- url: /public
+  static_dir: public
+- url: .*
+  script: main.py
+
+

data/app_generators/rx_app/templates/default_tasks.rake

@@ -0,0 +1,51 @@
+# this will use the latest version of restfulx gem
+require 'restfulx/tasks'
+
+TEST_APP_NAME = 'TestApp.mxml'
+
+namespace :air do
+  desc "Build and run the AIR application"
+  task :run => ["rx:air:build", "rx:air:run"]
+end
+
+namespace :flex do
+  desc "Test flex application"
+  task :test => ["rx:test:build", "rx:test:run"]
+  
+  desc "Build flex application"
+  task :build do
+    libs = [] # you can add libraries that are not in lib folder here
+    compile_app(get_executable('mxmlc'), 'bin-debug', "-library-path+=#{libs.join(',')}")  
+  end
+end
+
+namespace :rx do 
+  namespace :test do
+    desc "Build flex test swf file"
+    task :build do
+      project_path = File.join(APP_ROOT, "app/flex", TEST_APP_NAME)
+    
+      libs = Dir.glob(File.join(APP_ROOT, 'lib', '*.swc'))
+      #libs << 'foobar' # you can add libraries that not in lib folder here
+    
+      target_project_path = File.join(APP_ROOT, "bin-debug", TEST_APP_NAME.sub(/.mxml$/, '.swf'))
+    
+      cmd = "#{get_executable('mxmlc')} +configname=air -library-path+=#{libs.join(',')} " << 
+        "-output #{target_project_path} -debug=true #{project_path}"
+
+      if !system("#{cmd}")
+        puts "failed to compile test application"
+      end
+    end
+    
+    desc "Run flex test application"
+    task :run do
+      project_path = File.join(APP_ROOT, "app/flex", TEST_APP_NAME)
+      target_project_air_descriptor = project_path.sub(/.mxml$/, '-app.xml')
+      
+      if !system("#{get_executable('adl')} #{target_project_air_descriptor} #{APP_ROOT}")
+        puts "failed to run test application"
+      end 
+    end
+  end
+end

data/app_generators/rx_app/templates/flex.properties

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<flexProperties flexServerType="0" toolCompile="true" useServerFlexSDK="false" version="1"/>

data/app_generators/rx_app/templates/generate.rb

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.join(File.dirname(__FILE__), '..')
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+require 'activesupport'
+require 'restfulx'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+
+RubiGen::Base.use_component_sources!  
+RubiGen::Scripts::Generate.new.run(ARGV)