has_one_autocreate 1.0.0

data/CHANGELOG

@@ -0,0 +1,4 @@
+v1.0.0. Minor improvements to project and relased to gemcutter.
+v0.0.3. Bumping version for no good reason!
+v0.0.2. Initial gem, cleaned up project and abstracted tests some.
+v0.0.1. Initial release.

data/Manifest

@@ -0,0 +1,9 @@
+CHANGELOG
+init.rb
+lib/has_one_autocreate.rb
+Manifest
+Rakefile
+README.rdoc
+spec/has_one_autocreate_spec.rb
+spec/models.rb
+spec/spec_helper.rb

data/README.rdoc

@@ -0,0 +1,45 @@
+= Has One Autocreate
+
+Automatic creation of a has_one associated object when it is first accessed. 
+
+== Examples
+
+  class User < ActiveRecord::Base
+    has_one :profile, :autocreate => true
+  end
+
+  class Profile < ActiveRecord::Base
+    belongs_to :user
+  end
+
+  # make a single user
+  >> user = User.create(:name => 'Dr. User')
+  => #<User id: 1, name: "Dr. User">
+
+  # look for any profile objects
+  >> Profile.count
+  => 0
+  
+  # access the user's profile object to see it automatically created
+  >> user.profile
+  => #<Profile id: 1, title: nil, user_id: 1>
+
+
+== Install
+
+As a Rails plugin.
+
+  ./script/plugin install git://github.com/jqr/has_one_autocreate.git
+
+Prefer gems? Add this to your environment.rb and run the following command.
+
+  config.gem 'has_one_autocreate'
+
+  $ rake gems:install
+  
+== Docs
+
+http://rdoc.info/projects/jqr/has_one_autocreate  
+
+Homepage:: http://github.com/jqr/has_one_autocreate
+License:: Copyright (c) 2008 Elijah Miller <mailto:elijah.miller@gmail.com>, released under the MIT license.

data/Rakefile

@@ -0,0 +1,18 @@
+require 'spec/rake/spectask'
+
+require 'echoe'
+Echoe.new 'has_one_autocreate' do |p|
+  p.description     = "Automatic creation and building for has_one relationships."
+  p.url             = "http://github.com/jqr/has_one_autocreate"
+  p.author          = "Elijah Miller"
+  p.email           = "elijah.miller@gmail.com"
+  p.retain_gemspec  = true
+  p.need_tar_gz     = false
+  p.extra_deps      = [
+  ]
+  p.ignore_pattern  = ['spec/test.sqlite3']
+end
+
+desc 'Default: run specs'
+task :default => :spec
+task :test => :spec

data/has_one_autocreate.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{has_one_autocreate}
+  s.version = "1.0.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Elijah Miller"]
+  s.date = %q{2009-12-03}
+  s.description = %q{Automatic creation and building for has_one relationships.}
+  s.email = %q{elijah.miller@gmail.com}
+  s.extra_rdoc_files = ["CHANGELOG", "lib/has_one_autocreate.rb", "README.rdoc"]
+  s.files = ["CHANGELOG", "init.rb", "lib/has_one_autocreate.rb", "Manifest", "Rakefile", "README.rdoc", "spec/has_one_autocreate_spec.rb", "spec/models.rb", "spec/spec_helper.rb", "has_one_autocreate.gemspec"]
+  s.homepage = %q{http://github.com/jqr/has_one_autocreate}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Has_one_autocreate", "--main", "README.rdoc"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{has_one_autocreate}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{Automatic creation and building for has_one relationships.}
+
+  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
+    else
+    end
+  else
+  end
+end

data/init.rb

@@ -0,0 +1 @@
+require 'has_one_autocreate'

data/lib/has_one_autocreate.rb

@@ -0,0 +1,48 @@
+require 'rubygems'
+require 'activerecord'
+
+# Functional prototype of automatic create/build on a has_one relationship.
+# TODO: needs to be loaded before cache_fu extensions.
+module HasOneAutocreate
+  # TODO: alias_method_chainize these
+  module ClassMethods
+    def has_one(*args)
+      options = args.extract_options!
+      autocreate = options.delete(:autocreate)
+      args << options
+      super(*args)
+      
+      if autocreate
+        reflections[args.first].send "autocreate=", autocreate
+      end
+    end
+  end
+  
+  module InstanceMethods
+    # TODO: Move to find_target once we're in front of cache_fu.
+    def reload
+      value = find_target
+      if value
+        @target = value
+      elsif method = @reflection.send(:autocreate)
+        @target = 
+          case method
+            when true
+              create!
+            when Symbol, String
+              self.send(method)
+            when false
+              # nop
+            else
+              # default
+              # ActiveRecord::Associations::HasOneAssociation.autocreate
+          end
+      end
+      loaded
+    end
+  end
+end
+
+ActiveRecord::Base.extend HasOneAutocreate::ClassMethods
+ActiveRecord::Associations::HasOneAssociation.send :include, HasOneAutocreate::InstanceMethods
+ActiveRecord::Reflection::AssociationReflection.send :attr_accessor, :autocreate

data/spec/has_one_autocreate_spec.rb

@@ -0,0 +1,76 @@
+require File.join(File.dirname(__FILE__), 'spec_helper')
+
+
+describe HasOneAutocreate do
+  before(:all) do 
+    ActiveRecord::Base.establish_connection(:adapter => 'sqlite3',
+      :database => TEST_DATABASE_FILE)
+      
+    User.connection.create_table :users do |t|
+      t.string :name
+    end
+    
+    Profile.connection.create_table :profiles do |t|
+      t.integer :user_id
+    end
+  end
+  
+  after(:all) do
+    User.connection.drop_table(:users)
+    Profile.connection.drop_table(:profiles)
+    
+    FileUtils.rm(TEST_DATABASE_FILE) if File.exist?(TEST_DATABASE_FILE)
+  end
+  
+  before(:each) do
+    @user = User.create(:name => 'Dr. User')
+  end
+
+  describe 'before accessing the profile' do
+    it "has NOT created the profile" do
+      Profile.count.should == 0
+    end
+  end
+
+  describe 'after accessing the profile' do
+    before(:each) do
+      @profile = @user.profile
+    end
+    
+    it "creates the profile" do
+      Profile.count.should_not == 0
+    end
+    
+    it "is a profile" do
+      @profile.should be_kind_of(Profile)
+    end
+  end
+
+  describe 'with an unsaved user' do
+
+    before(:each) do
+      @user = User.new(:name => 'Dr. User')
+    end
+
+    describe 'before accessing the profile' do
+      it "has NOT created the profile" do
+        Profile.count.should == 0
+      end
+    end
+
+    describe 'after accessing the profile' do
+      before(:each) do
+        @profile = @user.profile
+      end
+      
+      it "does not create the profile" do
+        Profile.count.should_not == 0
+      end
+      
+      it "is a profile" do
+        @profile.should be_kind_of(Profile)
+      end
+    end
+  
+  end
+end

data/spec/models.rb

@@ -0,0 +1,7 @@
+class User < ActiveRecord::Base
+  has_one :profile, :autocreate => true
+end
+
+class Profile < ActiveRecord::Base
+  belongs_to :user
+end

data/spec/spec_helper.rb

@@ -0,0 +1,12 @@
+require 'spec'
+require 'fileutils'
+
+require File.join(File.dirname(__FILE__), '..', 'lib', 'has_one_autocreate')
+
+require File.join(File.dirname(__FILE__), 'models')
+
+TEST_DATABASE_FILE = File.join(File.dirname(__FILE__), 'test.sqlite3')
+
+Spec::Runner.configure do |config|
+  
+end

metadata

@@ -0,0 +1,71 @@
+--- !ruby/object:Gem::Specification 
+name: has_one_autocreate
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Elijah Miller
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-03 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: Automatic creation and building for has_one relationships.
+email: elijah.miller@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- CHANGELOG
+- lib/has_one_autocreate.rb
+- README.rdoc
+files: 
+- CHANGELOG
+- init.rb
+- lib/has_one_autocreate.rb
+- Manifest
+- Rakefile
+- README.rdoc
+- spec/has_one_autocreate_spec.rb
+- spec/models.rb
+- spec/spec_helper.rb
+- has_one_autocreate.gemspec
+has_rdoc: true
+homepage: http://github.com/jqr/has_one_autocreate
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Has_one_autocreate
+- --main
+- README.rdoc
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: has_one_autocreate
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Automatic creation and building for has_one relationships.
+test_files: []
+