toy-attributes 0.0.1 → 0.0.2

data/README.md

@@ -0,0 +1,83 @@
+Toy Attributes
+==============
+
+Toy Attributes is a component of [Toy Locomotive](https://github.com/Mortaro/Toy-Locomotive]), but can be used independently outside Toy Locomotive.
+
+
+Getting Started
+---------------
+
+All you need to start using Toy Attributes is to add the following line to your application's Gemfile:
+
+    gem "toy-attributes"
+
+
+Declaring Attributes
+--------------------
+
+This gem allows to assign attributes directly inside ActiveRecord models without having to write migrations. In order to make it happen, your model will have access to the following class methods:
+
+
+    string, text, integer, float, decimal, datetime, timestamp, time, date, binary, boolean, references
+
+Let's say your application is about warriors and all your warriors have a name, the code bellow will do the trick:
+
+    class Warrior < ActiveRecord::Base
+      string :name
+    end
+
+With this snippet, Toy Attributes will create the table `warriors` if it does not exist already, and add the `string` column `name` to it. You can also pass more than one column at a time to your method, for example:
+
+    class Weapon < ActiveRecord::Base
+      integer :min_damage, :max_damage
+    end
+
+Now both `min_damage` and `max_damage` will be present on `weapons` table's schema and ready to use.
+
+*All attributes generated with Toy are declared as `attr_accessible`, making them mass-assignable.*
+
+
+Dealing with Relations
+----------------------
+
+Toy also deals with model relations in a simple way, so you won't have to worry about their migrations either.
+
+    class Warrior < ActiveRecord::Base
+      string :name
+      has_many :weapons
+    end
+
+    class Weapon < ActiveRecord::Base
+      integer :min_damage, :max_damage
+    end
+
+Note that you won't have to declare that weapon `belongs_to` a warrior, Toy will automatically generate the foreign key and set up the relation; the same works to `has_one` relations.
+
+You can also declare multiple relations in a single line and even pass a hash of options:
+
+    class Warrior < ActiveRecord::Base
+      has_many :weapons, :items, :dependent => :destroy
+    end
+
+*All relations generated by Toy Attributes will `accept_nested_attributes_for` and receive `attr_accessible` on related model's attributes.*
+
+
+Changing Columns
+----------------
+
+At development mode, any change on your models will be automatically detected and instantly applied:
+
+    class Weapon < ActiveRecord::Base
+      float :min_damage, :max_damage
+    end
+
+This will result on a change of column type at the very moment it's identified on development mode or in the startup in production mode.
+
+TO-DO
+-----
+
+* Add a rake task to clean unused columns;
+* Allow more options on columns creation;
+* Generate hardcoded migrations on db/migrations and make them reversible;
+* Add support to habtm relations;
+* Make automatic mass-assignment configurable via initializer.

data/lib/toy-attributes/relations.rb

@@ -6,9 +6,12 @@ module ToyAttributes::Relations
       alias :_has_many :has_many
       alias :_has_one :has_one
 
-      def has_many model
-        self._has_many model
-        enforce_relation_with model
+      def has_many *models
+        options = models.extract_options!
+        models.each do |model|
+          self._has_many model, options
+          enforce_relation_with model
+        end
       end
 
       def has_one model

data/lib/toy-attributes/version.rb

@@ -1,3 +1,3 @@
 module ToyAttributes
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: toy-attributes
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-18 00:00:00.000000000 Z
+date: 2013-01-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
-  requirement: &29994228 !ruby/object:Gem::Requirement
+  requirement: &30063924 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *29994228
+  version_requirements: *30063924
 - !ruby/object:Gem::Dependency
   name: rspec-rails
-  requirement: &29993676 !ruby/object:Gem::Requirement
+  requirement: &30063408 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *29993676
+  version_requirements: *30063408
 - !ruby/object:Gem::Dependency
   name: shoulda
-  requirement: &29993160 !ruby/object:Gem::Requirement
+  requirement: &30063156 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *29993160
+  version_requirements: *30063156
 - !ruby/object:Gem::Dependency
   name: sqlite3
-  requirement: &29992668 !ruby/object:Gem::Requirement
+  requirement: &30079272 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,7 +54,7 @@ dependencies:
         version: '0'
   type: :development
   prerelease: false
-  version_requirements: *29992668
+  version_requirements: *30079272
 description: Allows to assign attributes directly inside ActiveRecord models without
   having to write migrations
 email:
@@ -72,7 +72,7 @@ files:
 - lib/toy-attributes.rb
 - MIT-LICENSE
 - Rakefile
-- README.rdoc
+- README.md
 homepage: https://github.com/Mortaro/Toy-Attributes
 licenses: []
 post_install_message: 
@@ -87,7 +87,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1030857843
+      hash: -539771597
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements:
@@ -96,7 +96,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1030857843
+      hash: -539771597
 requirements: []
 rubyforge_project: 
 rubygems_version: 1.8.16

data/README.rdoc

@@ -1,3 +0,0 @@
-= ToyAttributes
-
-This project rocks and uses MIT-LICENSE.