extend_at 0.2.3 → 0.2.4

data/README.markdown

@@ -2,6 +2,10 @@
 
 This gem allows you to extend models without migrations: This way you can, i.e., develop your own content types, like in Drupal.
 
+For example, if you want to create an administration panel to add columns to a model, for example, you are working on
+a CMS, and you want to create a _"content type"_ and you need to set the _"columns"_ but you
+don't want to migrate the database, then, you can see [this](https://github.com/anga/extend_at#tips) little tutorial.
+
 ## Status:
 
 [![Build Status](https://secure.travis-ci.org/anga/extend_at.png)](http://travis-ci.org/anga/extend_at)
@@ -252,14 +256,15 @@ Comparations:
 ### Belongs to
 
 If you like to add a belongs_to relationship, you can do it in this way:
-  # app/models/toolbox.rb
-  class Toolbox
-  end
 
-  # app/model/tool.rb
-  class Tool
-    extend_at extra, columns => {}, :belongs_to => :toolbox
-  end
+    # app/models/toolbox.rb
+    class Toolbox
+    end
+
+    # app/model/tool.rb
+    class Tool
+      extend_at extra, columns => {}, :belongs_to => :toolbox
+    end
 
 <code>:belongs_to</code> parametter accept
 
@@ -273,7 +278,7 @@ If you like to add a belongs_to relationship, you can do it in this way:
 
 * Hash
 
-  :belongs_to => :onwer => {:class_name => "User"}
+  :belongs_to => {:onwer => {:class_name => "User"}}
 
 For now, hash only accept
 
@@ -317,7 +322,7 @@ If you like to do something more dynamic, like create columns and validations de
           columns[name.to_sym] = {
             :type => eval(config.class_type),
             :default => config.default_value,
-            :validate => get_validation(config.validation)
+            :validate => get_validation(config)
           }
         end
         
@@ -330,7 +335,52 @@ If you like to do something more dynamic, like create columns and validations de
       end
     end
 
-This code read the configuration of the columns when you access to the extra column.
+How works?
+    
+    serialize :columns_name
+    
+This make <code>columns_name</code> column work like YAML serialized object. In this case, is used to sotore an array of names of each column name. 
+(See [ActiveRecord::Base](http://api.rubyonrails.org/classes/ActiveRecord/Base.html))
+
+    extend_at :extra, :columns => :get_columns
+    
+This line will use the function <code>get_columns</code> to get the information about each column dynamically.
+This function returns a hash with the information about each column.
+
+    columns_name.each do |name|
+        #...
+    end
+    
+Iterate through each column stored in the column <code>columns_name</code>.
+
+    config = ColumConfig.where(:user_id => self.id, :column => name).first
+
+Search the column configuration stored in a separated model. By this way, we can configura each column easily, we can create a view to create columns and configure it easily.
+
+    columns[name.to_sym] = {
+        :type => eval(config.class_type),
+        :default => config.default_value,
+        :validate => get_validation(config)
+      }
+
+This lines configure the column.
+
+    :type => eval(config.class_type),
+    
+The model <code>ColumConfig</code> have a string column named <code>class_type</code>, can be <code>":integer"</code> or <code>"Fixnum"</code>.
+
+    :default => config.default_value,
+    
+The model <code>ColumConfig</code> have a serialized column named <code>default_valuee</code>, in this way we can sotre integer values, boolean, strings or datetime and time values without problems.
+
+    :validate => get_validation(config.validation)
+    
+This line execute the function <code>get_validation</code> to get a <code>Proc</code> with the validation code.
+This function can use a case/when for select the correct function or use the data of the model <code>config</code> to create a function.
+
+    columns
+    
+Finally we return the colums configuration.
 
 ## Bugs, recomendation, etc
 

data/extend_at.gemspec

@@ -19,10 +19,10 @@ Gem::Specification.new do |s|
   s.require_paths = ["lib"]
 
   s.add_runtime_dependency 'rails', '~> 3.1'
+  s.add_runtime_dependency "activesupport", '~> 3.1'
   s.add_development_dependency "rspec", '~> 2.8'
   s.add_development_dependency "rspec-core", '~> 2.8'
   s.add_development_dependency "rspec-expectations", '~> 2.8'
-  s.add_development_dependency "activesupport", '~> 3.1'
 #   s.add_development_dependency "rspec-mocks", '~> 2.8.0'
   s.add_development_dependency "database_cleaner", "~> 0.8"
   

data/lib/extend_at/version.rb

@@ -1,3 +1,3 @@
 module ExtendModelAt
-  VERSION = "0.2.3"
+  VERSION = "0.2.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: extend_at
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.4
   prerelease: 
 platform: ruby
 authors:
@@ -28,23 +28,23 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.1'
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: activesupport
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '2.8'
-  type: :development
+        version: '3.1'
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '2.8'
+        version: '3.1'
 - !ruby/object:Gem::Dependency
-  name: rspec-core
+  name: rspec
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
@@ -60,7 +60,7 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '2.8'
 - !ruby/object:Gem::Dependency
-  name: rspec-expectations
+  name: rspec-core
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
@@ -76,13 +76,13 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '2.8'
 - !ruby/object:Gem::Dependency
-  name: activesupport
+  name: rspec-expectations
   requirement: !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '2.8'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -90,7 +90,7 @@ dependencies:
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '3.1'
+        version: '2.8'
 - !ruby/object:Gem::Dependency
   name: database_cleaner
   requirement: !ruby/object:Gem::Requirement