sencha-model 0.5.0

data/.document

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

data/.gitignore

@@ -0,0 +1,6 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg
+*.log

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in shopify-api-limits.gemspec
+gemspec

data/Gemfile.lock

@@ -0,0 +1,35 @@
+PATH
+  remote: .
+  specs:
+    sencha-model (0.5.0)
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activemodel (3.0.7)
+      activesupport (= 3.0.7)
+      builder (~> 2.1.2)
+      i18n (~> 0.5.0)
+    activerecord (3.0.7)
+      activemodel (= 3.0.7)
+      activesupport (= 3.0.7)
+      arel (~> 2.0.2)
+      tzinfo (~> 0.3.23)
+    activesupport (3.0.7)
+    arel (2.0.10)
+    builder (2.1.2)
+    extlib (0.9.15)
+    i18n (0.5.0)
+    mocha (0.9.12)
+    shoulda (2.11.3)
+    tzinfo (0.3.27)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  activerecord (>= 3.0.0)
+  extlib
+  mocha
+  sencha-model!
+  shoulda

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Chris Scott
+
+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,113 @@
+= Sencha::Model
+
+A simple Model mixin with adapters for various ORM frameworks such as ActiveRecord, DataMapper and MongoMapper.  Sencha::Model was originally created as part of the gem extjs-mvc[http://github.com/extjs/mvc] to assist with auto-generating ExtJS Stores (Ext.data.Store).  However, it can be useful for a variety of Javascript frameworks for rendering data on the client.
+
+
+=== Installation
+	% sudo gem install gemcutter
+	% sudo gem install sencha-model
+
+
+=== An ORM Model mixin:  Sencha::Model
+sencha-model contains Model mixin named <tt>Sencha::Model</tt> which works for <b>three</b> popular ORM frameworks, ActiveRecord, DataMapper and MongoMapper.  The API for each framework is identical and an adapter can be created for just about any
+ORM in about an hour.
+
+Simply include the mixin into your model.  Use the class-method <tt>sencha_fields</tt> to specify those
+fields with will be used to render a record to Hash for later JSON-encoding.
+
+  class User < ActiveRecord::Base
+    include Sencha::Model
+
+    sencha_fields :exclude => [:password, :password_confirmation]
+    
+    # OR 
+    sencha_fields :name, :description
+    
+    # OR
+    sencha_fields :only => [:name, :description] # actually the same as above
+    
+    # OR
+    sencha_fields :additional => [:computed] # includes all database columns and an additional computed field
+    
+    # OR define a column as a Hash
+    sencha_fields :description, :name => {"sortDir" => "ASC"}, :created_at => {"dateFormat" => "c"}
+	
+    # OR render associations, association-fields will have their "mapping" property set automatically
+    sencha_fields :name, :description, :company => [:name, :description]
+    
+    def computed
+      name.blank? ? login : name
+    end
+  end
+
+After including the model mixin <tt>Sencha::Model</tt>, try typing the following in <tt>irb</tt> console:
+    >> User.sencha_schema
+    => { :idProperty=>"id", :fields=>[
+         {:type=>'int', :allowBlank=>true, :name=>"id"},
+         {:type=>'string', :allowBlank=>false, :name=>"first", :defaultValue => nil},
+         {:type=>'string', :allowBlank=>false, :name=>"last", :defaultValue => nil},
+         {:type=>'string', :allowBlank=>false, :name=>"email", :defaultValue => nil}
+       ]}
+
+An auto-generated schema.  This field-names were originally designed to be consumed by an <tt>Ext.data.Store</tt> from the {Ext JS Framework}[http://extjs.com].  TODO: make the field-names configurable.
+
+You can also define different sets of fields for different representations of your model.
+
+E.g. with the following definition:
+
+	class User < ActiveRecord::Base
+	  include ExtJS::Model
+
+	  sencha_fieldset :grid, [
+	    :name, 
+      :description, 
+	    {:company => [:name, :description]}
+	  ]
+
+	  sencha_fieldset :combo, [:full_name]
+	
+	  ##
+	  # computed field
+	  #
+	  def full_name
+	    "#{first_name} #{name}"
+	  end
+	end
+
+You can get store configs for both representations with
+    User.sencha_schema(:grid)
+or
+    User.sencha_schema(:combo)
+    
+And the corresponding data for the representations with
+    User.first.to_record(:grid)
+or
+    User.first.to_record(:combo)
+
+=== A Testing Mixin:  Sencha::TestMacros
+The <tt>sencha</tt> Gem includes a small set of testing macros to help unit-test models.
+Using this macro requires the 'Shoulda' gem from thoughtbot
+
+==== Usage
+In individual model unit tests:
+    class ModelTest < ActiveSupport::TestCase
+      should_have_sencha_fields_for_fieldset :fieldset_name, [:name, :email, :city]
+      #...
+      #other tests
+    end
+
+
+== 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 Chris Scott. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,26 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+begin
+  require 'rcov/rcovtask'
+  Rcov::RcovTask.new do |test|
+    test.libs << 'test'
+    test.pattern = 'test/**/*_test.rb'
+    test.verbose = true
+  end
+rescue LoadError
+  task :rcov do
+    abort "RCov is not available. In order to run rcov, you must: sudo gem install spicycode-rcov"
+  end
+end
+
+
+task :default => :test

data/VERSION

@@ -0,0 +1 @@
+0.4.0

data/lib/sencha-model.rb

@@ -0,0 +1,17 @@
+$:.unshift File.dirname(__FILE__)
+
+module Sencha
+  module Model
+    require 'sencha-model/model'
+
+    # Detect orm, include appropriate mixin.
+    if defined?(ActiveRecord)
+      require 'sencha-model/adapters/active_record'
+    elsif defined?(DataMapper)
+      require 'sencha-model/adapters/data_mapper'
+    elsif defined?(MongoMapper)
+      require 'sencha-model/adapters/mongo_mapper'
+    end
+  end
+end
+

data/lib/sencha-model/adapters/active_record.rb

@@ -0,0 +1,88 @@
+##
+# ActiveRecord adapter to Whorm::Model mixin.
+#
+module Sencha
+  module Model
+    module ClassMethods
+      def sencha_primary_key
+        self.primary_key.to_sym
+      end
+      
+      def sencha_column_names
+        self.column_names.map(&:to_sym)
+      end
+      
+      def sencha_columns_hash
+        self.columns_hash.symbolize_keys
+      end
+      
+      ##
+      # determine if supplied Column object is nullable
+      # @param {ActiveRecord::ConnectionAdapters::Column}
+      # @return {Boolean}
+      #
+      def sencha_allow_blank(col)
+        # if the column is the primary key always allow it to be blank.
+        # Otherwise we could not create new records with sencha because
+        # new records have no id and thus cannot be valid
+        col.name == self.primary_key || col.null
+      end
+      
+      ##
+      # returns the default value
+      # @param {ActiveRecord::ConnectionAdapters::Column}
+      # @return {Mixed}
+      #
+      def sencha_default(col)
+        col.default
+      end
+      
+      ##
+      # returns the corresponding column name of the type column for a polymorphic association
+      # @param {String/Symbol} the id column name for this association
+      # @return {Symbol}
+      def sencha_polymorphic_type(id_column_name)
+        id_column_name.to_s.gsub(/_id\Z/, '_type').to_sym
+      end
+      
+      ##
+      # determine datatype of supplied Column object
+      # @param {ActiveRecord::ConnectionAdapters::Column}
+      # @return {String}
+      #
+      def sencha_type(col)
+        type = col.type.to_s
+        case type
+          when "datetime", "date", "time", "timestamp"
+            type = "date"
+          when "text"
+            type = "string"
+          when "integer"
+            type = "int"
+          when "decimal"
+            type = "float"
+        end
+        type
+      end
+      
+      ##
+      # return a simple, normalized list of AR associations having the :name, :type and association class
+      # @return {Array}
+      #
+      def sencha_associations
+        @sencha_associations ||= self.reflections.inject({}) do |memo, (key, assn)|
+          type = (assn.macro === :has_many || assn.macro === :has_and_belongs_to_many) ? :many : assn.macro
+          memo[key.to_sym] = {
+            :name => key.to_sym, 
+            :type => type, 
+            :class => assn.options[:polymorphic] ? nil : assn.class_name.constantize,
+            :foreign_key => assn.association_foreign_key.to_sym,
+            :is_polymorphic => !!assn.options[:polymorphic]
+          }
+          memo
+        end
+      end
+    end
+  end
+end
+

data/lib/sencha-model/adapters/data_mapper.rb

@@ -0,0 +1,66 @@
+##
+# DataMapper adapter for Whorm::Model mixin
+#
+
+module Sencha
+  module Model
+    module ClassMethods
+      
+      def sencha_primary_key
+        self.key.first.name
+      end
+      
+      def sencha_column_names
+        self.properties.collect {|p| p.name.to_s }
+      end
+      
+      def sencha_columns_hash
+        if @sencha_columns_hash.nil?
+          @sencha_columns_hash = {}
+          self.properties.each do |p|
+            @sencha_columns_hash[p.name] = p
+          end
+        end
+        @sencha_columns_hash
+      end
+      
+      def sencha_allow_blank(col)
+         (col === self.key.first) ? true : col.nullable?
+      end
+      
+      def sencha_type(col)
+        type = ((col.type.respond_to?(:primitive)) ? col.type.primitive : col.type).to_s
+        case type
+          when "DateTime", "Date", "Time"
+            type = :date
+          when "String"
+            type = :string
+          when "Float"
+            type = :float
+          when "Integer", "BigDecimal"
+            type = :int
+          else
+            type = "auto"
+        end
+      end
+      
+      def sencha_associations
+        if @sencha_associations.nil?  
+          @sencha_associations = {}
+          self.relationships.keys.each do |key|
+            assn = self.relationships[key]
+            @sencha_associations[key.to_sym] = {
+              :name => key, 
+              :type => type = (assn.options[:max].nil? && assn.options[:min].nil?) ? :belongs_to : (assn.options[:max] > 1) ? :many : nil ,
+              :class => assn.parent_model,
+              :foreign_key => assn.child_key.first.name,
+              :is_polymorphic => false # <-- No impl. for DM is_polymorphic.  Anyone care to implement this?
+            }
+          end
+        end
+        @sencha_associations
+      end
+    end
+  end
+end
+

data/lib/sencha-model/adapters/mongo_mapper.rb

@@ -0,0 +1,64 @@
+##
+# MongoMapper adapter to Sencha::Model mixin
+#
+    
+module Sencha
+  module Model
+    ##
+    # ClassMethods
+    #
+    module ClassMethods
+
+      def sencha_primary_key
+        :id
+      end
+
+      def sencha_column_names
+        self.column_names
+      end
+
+      def sencha_columns_hash
+        self.keys
+      end
+
+      def sencha_associations
+        @sencha_associations ||= self.associations.inject({}) do |memo, (key, assn)|
+          memo[key.to_sym] = {
+            :name => key.to_sym,
+            :type => assn.type,
+            :class => assn.class_name.constantize,
+            :foreign_key => assn.foreign_key,
+            :is_polymorphic => false
+          }
+          memo
+        end
+      end
+
+      def sencha_type(col)
+        type = col.type.to_s
+        case type
+          when "DateTime", "Date", "Time"
+            type = :date
+          when "String"
+            type = :string
+          when "Float"
+            type = :float
+          when "Integer", "BigDecimal"
+            type = :int
+          else
+            type = "auto"
+        end
+      end
+
+      def sencha_allow_blank(col)
+        (col.name == '_id') || (col.options[:required] != true)
+      end
+      
+      def sencha_default(col)
+        col.default_value
+      end
+      
+    end
+  end
+end
+