amfora 0.0.1

data/.document

@@ -0,0 +1,5 @@
+README.rdoc
+lib/**/*.rb
+bin/*
+features/**/*.feature
+LICENSE

data/.gitignore

@@ -0,0 +1,4 @@
+pkg/*
+.loadpath
+.project
+/rdoc/

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Dima Berastau
+
+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/README.rdoc

@@ -0,0 +1,16 @@
+= Amfora
+
+RESTful Middleware that provides AMF0/AMF3 support to Rails and Rack applications.
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a future version unintentionally.
+* Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but 
+  bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009 Dima Berastau. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,49 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "amfora"
+    gem.summary = %Q{RESTful AMF0/AMF3 Rack Middleware}
+    gem.description = %Q{RESTful Rack Middleware that provides AMF0/AMF3 support to Rails and Rack applications}
+    gem.email = "dima.berastau@gmail.com"
+    gem.homepage = "http://github.com/dima/amfora"
+    gem.authors = ['Dima Berastau', 'Tony Hillerson', 'Stephen Augenstein']
+    gem.add_development_dependency "rspec"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  if File.exist?('VERSION')
+    version = File.read('VERSION')
+  else
+    version = ""
+  end
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "amfora #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.0.1

data/amfora.gemspec

@@ -0,0 +1,66 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE
+# Instead, edit Jeweler::Tasks in Rakefile, and run `rake gemspec`
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{amfora}
+  s.version = "0.0.1"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Dima Berastau", "Tony Hillerson", "Stephen Augenstein"]
+  s.date = %q{2009-11-19}
+  s.description = %q{RESTful Rack Middleware that provides AMF0/AMF3 support to Rails and Rack applications}
+  s.email = %q{dima.berastau@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "VERSION",
+     "amfora.gemspec",
+     "lib/amf.rb",
+     "lib/amf/active_record.rb",
+     "lib/amf/class_mapping.rb",
+     "lib/amf/constants.rb",
+     "lib/amf/messages.rb",
+     "lib/amf/pure.rb",
+     "lib/amf/pure/deserializer.rb",
+     "lib/amf/pure/io_helpers.rb",
+     "lib/amf/pure/remoting.rb",
+     "lib/amf/pure/serializer.rb",
+     "lib/amf/version.rb",
+     "lib/amfora.rb",
+     "lib/rack/amf.rb",
+     "lib/rack/amf/application.rb",
+     "spec/amfora_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+  s.homepage = %q{http://github.com/dima/amfora}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{RESTful AMF0/AMF3 Rack Middleware}
+  s.test_files = [
+    "spec/amfora_spec.rb",
+     "spec/spec_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+    else
+      s.add_dependency(%q<rspec>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 0"])
+  end
+end

data/lib/amf.rb

@@ -0,0 +1,70 @@
+$:.unshift(File.dirname(__FILE__)) unless $:.include?(File.dirname(__FILE__)) || $:.include?(File.expand_path(File.dirname(__FILE__)))
+$:.unshift "#{File.expand_path(File.dirname(__FILE__))}/amf/"
+
+require 'amf/version'
+require 'amf/class_mapping'
+require 'amf/messages'
+
+module AMF
+  begin
+    raise LoadError, 'C extentions not implemented'
+  rescue LoadError
+    require 'amf/pure'
+  end
+  
+  ClassMapper = AMF::ClassMapping.new
+  
+  class << self
+    # Deserialize the AMF string _source_ into a Ruby data structure and return it.
+    def deserialize(source, options = {})
+      options[:amf_version] ||= 0
+      if options[:amf_version] == 0
+        AMF::AMF0Deserializer.new.deserialize(source)
+      elsif options[:amf_version] == 3
+        AMF::AMF3Deserializer.new.deserialize(source)
+      else
+        raise AMFError, "unsupported version #{amf_version}"
+      end
+    end
+
+    # Serialize the given Ruby data structure _obj_ into an AMF stream
+    def serialize(obj, options = {}, &block)
+      options[:amf_version] ||= 3
+      if options[:amf_version] == 0
+        AMF::AMF0Serializer.new(options).serialize(obj, &block)
+      elsif options[:amf_version] == 3
+        AMF::AMF3Serializer.new(options).serialize(obj, &block)
+      else
+        raise AMFError, "unsupported version #{amf_version}"
+      end
+    end
+  end
+  
+  # The base exception for AMF errors.
+  class AMFError < StandardError; end
+end
+
+if defined?(ActiveRecord::Base)
+  require 'amf/active_record'
+  Mime::Type.register 'application/x-amf', :amf
+  ActiveRecord::Base.send :include, AMF::ActiveRecord
+end
+
+class Array
+  def to_amf(options = {})
+    raise "Not all elements respond to to_amf" unless all? { |e| e.respond_to? :to_amf }
+    
+    options[:amf_version] ||= 3
+    
+    if options[:amf_version] == 3
+      serializer_class = AMF::AMF3Serializer
+    elsif options[:amf_version] == 0
+      serializer_class = AMF::AMF0Serializer
+    else
+      raise AMF::AMFError, "unsupported serializer version #{options[:amf_version]}"
+    end
+    
+    serializer = serializer_class.new({:options => options})
+    serializer.serialize(self)
+  end
+end

data/lib/amf/active_record.rb

@@ -0,0 +1,60 @@
+module AMF
+  module Serialization
+    class AMFSerializer < ActiveRecord::Serialization::Serializer      
+      def initialize(record, options = {})
+        super(record, options)
+        @options[:amf_version] = 3
+      end
+
+      def serialize
+        if @options[:amf_version] == 3
+          serializer_class = AMF::AMF3Serializer
+        elsif @options[:amf_version] == 0
+          serializer_class = AMF::AMF0Serializer
+        else
+          raise AMF::AMFError, "unsupported serializer version #{@options[:amf_version]}"
+        end
+      
+        serializer = serializer_class.new({:serializable_names => serializable_names, :options => @options})
+
+        serializer.serialize(@record) do |s|
+          add_includes do |association, records, opts|
+            s.stream << add_associations(association, records, opts, s)
+          end
+          yield serializer if block_given?
+        end
+      end
+
+      def add_associations(association, records, opts, serializer)
+        result = serializer.write_utf8_vr(association.to_s)
+        if records.is_a?(Enumerable)
+          result << records.each { |record| record.to_amf(opts) }.join("")
+        else
+          if record = @record.send(association)
+            result << record.to_amf(opts)
+          end
+        end
+        result
+      end
+    end
+  end
+  
+  module ActiveRecord    
+    def self.included(base)
+      base.send :include, InstanceMethods
+    end
+
+    module InstanceMethods
+      def to_amf(options = {}, &block)
+        serializer = AMF::Serialization::AMFSerializer.new(self, options)
+        block_given? ? serializer.to_s(&block) : serializer.to_s
+      end
+
+      def from_amf(amf, options = {})
+        options[:amf_version] ||= 3
+        self.attributes = AMF.deserialize(amf, options[:amf_version])
+        self
+      end
+    end
+  end
+end

data/lib/amf/class_mapping.rb

@@ -0,0 +1,137 @@
+module AMF
+  class ClassMapping
+    class MappingSet
+      attr_accessor :default_as_prefix
+      
+      def initialize #:nodoc:
+        @as_mappings = {}
+        @ruby_mappings = {}
+        @default_as_prefix = ""
+
+        # Map defaults
+        map :as => 'flex.messaging.messages.AbstractMessage', :ruby => 'AMF::Messages::AbstractMessage'
+        map :as => 'flex.messaging.messages.RemotingMessage', :ruby => 'AMF::Messages::RemotingMessage'
+        map :as => 'flex.messaging.messages.AsyncMessage', :ruby => 'AMF::Messages::AsyncMessage'
+        map :as => 'flex.messaging.messages.CommandMessage', :ruby => 'AMF::Messages::CommandMessage'
+        map :as => 'flex.messaging.messages.AcknowledgeMessage', :ruby => 'AMF::Messages::AcknowledgeMessage'
+        map :as => 'flex.messaging.messages.ErrorMessage', :ruby => 'AMF::Messages::ErrorMessage'
+      end
+
+      # Map a given AS class to a ruby class.
+      #
+      # Use fully qualified names for both.
+      #
+      # Example:
+      #
+      #   m.map :as 'com.example.Date', :ruby => 'Example::Date'
+      def map(params)
+        [:as, :ruby].each {|k| params[k] = params[k].to_s} # Convert params to strings
+        @as_mappings[params[:as]] = params[:ruby]
+        @ruby_mappings[params[:ruby]] = params[:as]
+      end
+
+      # Returns the AS class name for the given ruby class name, returing nil if
+      # not found
+      def get_as_class_name(class_name) #:nodoc:
+        unless as_class_name = @ruby_mappings[class_name.to_s]
+          as_class_name = "#{@default_as_prefix}#{class_name}"
+        end
+        as_class_name
+      end
+
+      # Returns the ruby class name for the given AS class name, returing nil if
+      # not found
+      def get_ruby_class_name(class_name) #:nodoc:
+        unless ruby_class_name = @as_mappings[class_name.to_s]
+          ruby_class_name = class_name.sub(default_as_prefix, "")
+        end
+        ruby_class_name
+      end
+    end
+
+    # Define class mappings in the block. Block is passed a MappingSet object as
+    # the first parameter.
+    #
+    # Example:
+    #
+    #   AMF::ClassMapper.define do |m|
+    #     m.map :as => 'AsClass', :ruby => 'RubyClass'
+    #   end
+    def define #:yields: mapping_set
+      yield mappings
+    end
+    
+    def default_as_prefix
+      mappings.default_as_prefix
+    end
+    
+    def default_as_prefix=(value)
+      mappings.default_as_prefix = value
+    end
+
+    # Returns the AS class name for the given ruby object. Will also take a string
+    # containing the ruby class name
+    def get_as_class_name(obj)
+      # Get class name
+      if obj.is_a?(String)
+        ruby_class_name = obj
+      else
+        ruby_class_name = obj.class.name
+      end
+
+      # Get mapped AS class name
+      mappings.get_as_class_name(ruby_class_name)
+    end
+    
+    def get_ruby_class_name(as_class_name)
+      mappings.get_ruby_class_name(as_class_name.to_s)
+    end
+
+    # Instantiates a ruby object using the mapping configuration based on the
+    # source AS class name. If there is no mapping defined, it returns a hash.
+    def get_ruby_obj(as_class_name)
+      ruby_class_name = mappings.get_ruby_class_name(as_class_name)
+      if ruby_class_name.nil?
+        # Populate a simple hash, since no mapping
+        return Hash.new
+      else
+        ruby_class = deep_const_get(ruby_class_name)
+        return ruby_class.new
+      end
+    end
+    
+    # Return the constant located at _path_. The format of _path_ has to be
+    # either ::A::B::C or A::B::C. In any case A has to be located at the top
+    # level (absolute namespace path?). If there doesn't exist a constant at
+    # the given path, an ArgumentError is raised.
+    def deep_const_get(path) # :nodoc:
+      path = path.to_s
+      path.split(/::/).inject(Object) do |p, c|
+        case
+        when c.empty?             then p
+        when p.const_defined?(c)  then p.const_get(c)
+        else                      raise ArgumentError, "can't find const #{path}"
+        end
+      end
+    end
+
+    # Populates the ruby object using the given properties
+    def populate_ruby_obj(obj, props, dynamic_props=nil)
+      props.merge! dynamic_props if dynamic_props
+      hash_like = obj.respond_to?("[]=")
+      props.each do |key, value|
+        if obj.respond_to?("#{key}=")
+          obj.send("#{key}=", value)
+        elsif hash_like
+          obj[key.to_sym] = value
+        end
+      end
+      obj
+    end
+
+    private
+    def mappings
+      @mappings ||= MappingSet.new
+    end
+  end
+end

data/lib/amf/constants.rb

@@ -0,0 +1,47 @@
+module AMF
+  # AMF0 Type Markers
+  AMF0_NUMBER_MARKER       = 0x00 #"\000"
+  AMF0_BOOLEAN_MARKER      = 0x01 #"\001"
+  AMF0_STRING_MARKER       = 0x02 #"\002"
+  AMF0_OBJECT_MARKER       = 0x03 #"\003"
+  AMF0_MOVIE_CLIP_MARKER   = 0x04 #"\004" # Unused
+  AMF0_NULL_MARKER         = 0x05 #"\005"
+  AMF0_UNDEFINED_MARKER    = 0x06 #"\006"
+  AMF0_REFERENCE_MARKER    = 0x07 #"\a"
+  AMF0_HASH_MARKER         = 0x08 #"\b"
+  AMF0_OBJECT_END_MARKER   = 0x09 #"\t"
+  AMF0_STRICT_ARRAY_MARKER = 0x0A #"\n"
+  AMF0_DATE_MARKER         = 0x0B #"\v"
+  AMF0_LONG_STRING_MARKER  = 0x0C #"\f"
+  AMF0_UNSUPPORTED_MARKER  = 0x0D #"\r"
+  AMF0_RECORDSET_MARKER    = 0x0E #"\016" # Unused
+  AMF0_XML_MARKER          = 0x0F #"\017"
+  AMF0_TYPED_OBJECT_MARKER = 0x10 #"\020"
+  AMF0_AMF3_MARKER         = 0x11 #"\021"
+
+  # AMF3 Type Markers
+  AMF3_UNDEFINED_MARKER    =  0x00 #"\000"
+  AMF3_NULL_MARKER         =  0x01 #"\001"
+  AMF3_FALSE_MARKER        =  0x02 #"\002"
+  AMF3_TRUE_MARKER         =  0x03 #"\003"
+  AMF3_INTEGER_MARKER      =  0x04 #"\004"
+  AMF3_DOUBLE_MARKER       =  0x05 #"\005"
+  AMF3_STRING_MARKER       =  0x06 #"\006"
+  AMF3_XML_DOC_MARKER      =  0x07 #"\a"
+  AMF3_DATE_MARKER         =  0x08 #"\b"
+  AMF3_ARRAY_MARKER        =  0x09 #"\t"
+  AMF3_OBJECT_MARKER       =  0x0A #"\n"
+  AMF3_XML_MARKER          =  0x0B #"\v"
+  AMF3_BYTE_ARRAY_MARKER   =  0x0C #"\f"
+
+  # Other AMF3 Markers
+  AMF3_EMPTY_STRING             = 0x01
+  AMF3_ANONYMOUS_OBJECT         = 0x01
+  AMF3_DYNAMIC_OBJECT           = 0x0B
+  AMF3_CLOSE_DYNAMIC_OBJECT     = 0x01
+  AMF3_CLOSE_DYNAMIC_ARRAY      = 0x01
+
+  # Other Constants
+  MAX_INTEGER               = 268435455
+  MIN_INTEGER               = -268435456
+end