schema_associations 0.1.1 → 0.1.2

data/README.rdoc

@@ -44,15 +44,36 @@ Then all you need for your models is:
 
 and SchemaAssociations defines the appropriate associations under the hood
 
-== What if I want something special?
+=== What if I want something special?
 
 You're always free to define associations yourself, if for example you want
 to pass special options.  SchemaAssociations won't clobber any existing
 definitions.
 
 You can also control the behavior with various options, globally via
-SchemaAssociations::setup or per-model via SchemaAssociations::ActiveRecord#schema_associations.  See
-SchemaAssociations::Config for the available options.
+SchemaAssociations::setup or per-model via SchemaAssociations::ActiveRecord#schema_associations, such as:
+
+    class Post < ActiveRecord::Base
+        schema_associations :concise_names => false
+    end
+
+See SchemaAssociations::Config for the available options.
+
+=== This seems cool, but I'm worried about too much automagic
+
+You can globally turn off automatic creation in <tt>config/initializers/schema_associations.rb</tt>:
+
+  SchemaAssociations.setup do |config|
+    config.auto_create = false
+  end
+
+Then in any model where you want automatic associations, just do
+
+  class Post < ActiveRecord::Base
+    schema_associations
+  end
+
+You can also pass options as per above.
 
 == Full Details
 
@@ -211,6 +232,22 @@ i.e. these associations would be defined:
 
 If you like the formality of using full names for the asociations, you can turn off concise names globally or per-model, see SchemaAssociations::Config
 
+=== Ordering +has_many+ using +position+
+
+If the target of a +has_many+ association has a column named +position+, SchemaAssociation will specify <tt>:order => :position</tt> for the association.  That is,
+
+    create_table :comments do |t|
+        t.integer post_id
+        t.integer position
+    end
+
+leads to
+
+    class Post < ActiveRecord::Base
+      has_many :comments, :order => :position
+    end
+
+
 == How do I know what it did?
 
 If you're curious (or dubious) about what associations SchemaAssociations defines, you can check the log file.  For every assocation that SchemaAssociations defines, it generates an info entry such as
@@ -250,7 +287,7 @@ full combo of tests, after you've forked & cloned:
   $ ./runspecs --install  # do this once to install gem dependencies for all versions (slow)
   $ ./runspecs # as many times as you like
 
-You can also pick a specific version of rails and ruby to use, such as:
+See <tt>./runspecs --help</tt> for other options.  You can also pick a specific version of rails and ruby to use, such as:
   $ rvm use 1.9.2
   $ export SCHEMA_ASSOCIATIONS_RAILS_VERSION=3.1
   $ bundle update rails --local

data/lib/schema_associations/active_record/associations.rb

@@ -42,8 +42,26 @@ module SchemaAssociations
       #     class MyModel < ActiveRecord::Base
       #         schema_associations :auto_create => false
       #     end
-      def schema_associations(opts)
-        @schema_associations_config = SchemaAssociations.config.merge(opts)
+      #
+      # If <tt>:auto_create</tt> is not specified, it is implicitly
+      # specified as true.  This allows the "non-invasive" style of using
+      # SchemaAssociations in which you set the global Config to
+      # <tt>auto_create = false</tt>, then in any model that you want auto
+      # associations you simply do:
+      #
+      #     class MyModel < ActiveRecord::Base
+      #         schema_associations
+      #     end
+      #
+      #  Of course other options can be passed, such as
+      #
+      #     class MyModel < ActiveRecord::Base
+      #         schema_associations :concise_names => false, :except_type => :has_and_belongs_to_many
+      #     end
+      #
+      #
+      def schema_associations(opts={})
+        @schema_associations_config = SchemaAssociations.config.merge({:auto_create => true}.merge(opts))
       end
 
       def schema_associations_config # :nodoc:

data/lib/schema_associations/version.rb

@@ -1,3 +1,3 @@
 module SchemaAssociations
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/runspecs

@@ -1,36 +1,58 @@
 #!/usr/bin/env ruby
 
 require 'optparse'
+require 'ostruct'
+
+PROJECT = File.basename(File.expand_path('..', __FILE__))
 
 RUBY_VERSIONS = %W[1.8.7 1.9.2]
 RAILS_VERSIONS = %W[2.3 3.0 3.1]
 
-options = {}
+o = OpenStruct.new
+o.ruby_versions = RUBY_VERSIONS
+o.rails_versions = RAILS_VERSIONS
+o.run_cmd = "rake spec"
+
 OptionParser.new do |opts|
     opts.banner = "Usage: #{$0} [options]"
 
     opts.on("--install", "Install gem dependencies") do |v|
-        options[:install] = v
+        o.install = v
+    end
+
+    opts.on("--ruby version", String, "Choose which version(s) of ruby to run.  Default is: #{o.ruby_versions.join(' ')}") do |ruby|
+        o.ruby_versions = ruby.split(' ')
+    end
+
+    opts.on("--rails version", String, "Choose which version(s) of rails to run.  Default is: #{o.rails_versions.join(' ')}") do |rails|
+        o.rails_versions = rails.split(' ')
+    end
+
+    opts.on("--quick", "quick run ruby #{RUBY_VERSIONS.last} and rails #{RAILS_VERSIONS.last}") do
+      o.ruby_versions  = [RUBY_VERSIONS.last]
+      o.rails_versions = [RAILS_VERSIONS.last]
     end
+
 end.parse!
 
-cmds = if options [:install]
+cmds = if o.install
            ['bundle update']
        else
-           ['bundle update --local rails | grep rails', 'rake spec']
+           ['bundle update --local rails | grep rails', o.run_cmd]
        end
 
 n = 1
-total = RUBY_VERSIONS.size * RAILS_VERSIONS.size
-RUBY_VERSIONS.each do |ruby|
-    RAILS_VERSIONS.each do |rails|
+total = o.ruby_versions.size * o.rails_versions.size
+o.ruby_versions.each do |ruby|
+    o.rails_versions.each do |rails|
         puts "\n\n*** ruby version #{ruby} - rails version #{rails}  [#{n} of #{total}]\n\n"
         n += 1
         allcmds = []
         allcmds << "rvm use #{ruby}"
-        allcmds << "export SCHEMA_ASSOCIATIONS_RAILS_VERSION=#{rails}"
+        allcmds << "export #{PROJECT.upcase}_RAILS_VERSION=#{rails}"
         allcmds += cmds
         allcmds << 'exit'
         system %Q{echo '#{allcmds.join(' \n ')}' | bash -i} or abort "aborting #{$0}"
     end
 end
+

data/spec/association_spec.rb

@@ -178,7 +178,7 @@ describe ActiveRecord::Base do
 
   end
 
-  it "should override auto_create positively" do
+  it "should override auto_create positively explicitly" do
     with_associations_auto_create(false) do
       create_tables(
         "posts", {}, {},
@@ -193,6 +193,21 @@ describe ActiveRecord::Base do
     end
   end
 
+  it "should override auto_create positively implicitly" do
+    with_associations_auto_create(false) do
+      create_tables(
+        "posts", {}, {},
+        "comments", {}, { :post_id => {} }
+      )
+      class Post < ActiveRecord::Base
+        schema_associations
+      end
+      class Comment < ActiveRecord::Base ; end
+      Post.reflect_on_association(:comments).should_not be_nil
+      Comment.reflect_on_association(:post).should be_nil
+    end
+  end
+
 
   context "with unique index" do
     before(:each) do

data/spec/connection.rb

@@ -8,3 +8,4 @@ ActiveRecord::Base.configurations = {
 }
 
 ActiveRecord::Base.establish_connection 'schema_associations'
+ActiveRecord::Base.connection.execute "PRAGMA synchronous = OFF"

metadata

@@ -1,12 +1,8 @@
 --- !ruby/object:Gem::Specification 
 name: schema_associations
 version: !ruby/object:Gem::Version 
-  prerelease: false
-  segments: 
-  - 0
-  - 1
-  - 1
-  version: 0.1.1
+  prerelease: 
+  version: 0.1.2
 platform: ruby
 authors: 
 - Ronen Barzel
@@ -15,18 +11,17 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-07-27 00:00:00 +02:00
+date: 2011-08-02 00:00:00 -07:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: schema_plus
   prerelease: false
   requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        segments: 
-        - 0
         version: "0"
   type: :runtime
   version_requirements: *id001
@@ -34,13 +29,10 @@ dependencies:
   name: rake
   prerelease: false
   requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        segments: 
-        - 0
-        - 8
-        - 7
         version: 0.8.7
   type: :development
   version_requirements: *id002
@@ -48,11 +40,10 @@ dependencies:
   name: rspec
   prerelease: false
   requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        segments: 
-        - 0
         version: "0"
   type: :development
   version_requirements: *id003
@@ -60,11 +51,10 @@ dependencies:
   name: sqlite3
   prerelease: false
   requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        segments: 
-        - 0
         version: "0"
   type: :development
   version_requirements: *id004
@@ -72,11 +62,10 @@ dependencies:
   name: simplecov
   prerelease: false
   requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        segments: 
-        - 0
         version: "0"
   type: :development
   version_requirements: *id005
@@ -84,14 +73,24 @@ dependencies:
   name: simplecov-gem-adapter
   prerelease: false
   requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
-        segments: 
-        - 0
         version: "0"
   type: :development
   version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: ruby-debug19
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id007
 description: SchemaAssociations extends ActiveRecord to automatically create associations by inspecting the database schema.  This is more more DRY than the standard behavior, for which in addition to specifying the foreign key in the migration, you must also specify complementary associations in two model files (e.g. a :belongs_to and a :has_many).
 email: 
 - ronen@barzel.org
@@ -128,25 +127,25 @@ rdoc_options: []
 require_paths: 
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      segments: 
-      - 0
       version: "0"
 required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      segments: 
-      - 0
       version: "0"
 requirements: []
 
 rubyforge_project: schema_associations
-rubygems_version: 1.3.6
+rubygems_version: 1.6.2
 signing_key: 
 specification_version: 3
 summary: ActiveRecord extension that automatically (DRY) creates associations based on the schema
-test_files: []
-
+test_files: 
+- spec/association_spec.rb
+- spec/connection.rb
+- spec/spec_helper.rb