activerecord-devkit 1.0.0

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Sergey Tokarenko
+
+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.md

@@ -0,0 +1,57 @@
+Activerecord Devkit
+===================
+[![Version](https://badge.fury.io/rb/activerecord-devkit.svg)](http://badge.fury.io/rb/activerecord-devkit)
+[![Build](https://travis-ci.org/stokarenko/activerecord-devkit.svg?branch=master)](https://travis-ci.org/stokarenko/activerecord-devkit)
+[![Climate](https://codeclimate.com/github/stokarenko/activerecord-devkit/badges/gpa.svg)](https://codeclimate.com/github/stokarenko/activerecord-devkit)
+[![Coverage](https://codeclimate.com/github/stokarenko/activerecord-devkit/badges/coverage.svg)](https://codeclimate.com/github/stokarenko/activerecord-devkit/coverage)
+
+ActiveRecord DevKit is a package of utility Ruby Features for ActiveRecord.
+
+## requirements
+* Ruby >= 1.9.3
+* [ruby-features](https://github.com/stokarenko/ruby-features) >= 1.1.1
+* ActiveRecord >= 3.2.13
+
+## Getting started
+Add to your Gemfile:
+
+```ruby
+gem 'activerecord-devkit'
+```
+
+Run the bundle command to install it.
+
+For Rails projects, gun generator:
+```console
+rails generate ruby_features:install
+```
+
+and apply required features in `config/initializers/ruby-features.rb`:
+```ruby
+RubyFeatures.apply('activerecord_devkit/association_soft_build')
+```
+
+For no-Rails usage, apply required features just like:
+```ruby
+require 'activerecord-devkit'
+
+RubyFeatures.apply('activerecord_devkit/association_soft_build')
+```
+
+## Features
+### activerecord_devkit/association_soft_build
+Makes possible to build associated object without affecting to parent object's association scope:
+```ruby
+user = User.first
+
+## Regular build, user.roles.size going to be incremented
+new_role = user.roles.build
+
+## Soft build, user.roles.size will stay as is
+new_role = user.roles.soft_build
+# or
+new_role = user.association(:roles).soft_build
+```
+
+## License
+MIT License. Copyright (c) 2015 Sergey Tokarenko

data/lib/activerecord-devkit.rb

@@ -0,0 +1,5 @@
+require 'activerecord-devkit/version'
+
+require 'ruby-features'
+
+RubyFeatures.find_in_path(File.expand_path('../activerecord-devkit/features', __FILE__))

data/lib/activerecord-devkit/features/association_soft_build_feature.rb

@@ -0,0 +1,29 @@
+RubyFeatures.define 'activerecord_devkit/association_soft_build' do
+  condition(:activerecord_3){ ActiveRecord::VERSION::MAJOR == 3 }
+
+  apply_to 'ActiveRecord::Associations::CollectionProxy' do
+    applied do
+      delegate :soft_build, to: :@association
+    end
+  end
+
+  apply_to 'ActiveRecord::Associations::CollectionAssociation' do
+    instance_methods if: :activerecord_3 do
+      def soft_build(attributes = {}, options = {}, &block)
+        build_record(attributes, options, &block).tap do |record|
+          yield(record) if block_given?
+          set_inverse_instance record
+        end
+      end
+    end
+
+    instance_methods unless: :activerecord_3 do
+      def soft_build(attributes = {}, &block)
+        build_record(attributes, &block).tap do |record|
+          yield(record) if block_given?
+        end
+      end
+    end
+
+  end
+end

data/lib/activerecord-devkit/version.rb

@@ -0,0 +1,3 @@
+module ActiveRecordDevkit
+  VERSION = '1.0.0'.freeze
+end

data/spec/association_soft_build_spec.rb

@@ -0,0 +1,35 @@
+describe 'association_soft_build' do
+  before(:all) { RubyFeatures.apply 'activerecord_devkit/association_soft_build' }
+
+  subject { User.create! }
+
+  it 'should set user`s id after creation' do
+    expect(subject.id).to be_kind_of(Integer)
+  end
+
+  it 'should has emplty associations set' do
+    expect(subject.roles).to be_empty
+  end
+
+  it 'should build associations as usually' do
+    role = subject.roles.build
+    expect(role.user_id).to eq(subject.id)
+    expect(role.user.object_id).to eq(subject.object_id)
+    expect(subject.roles).to_not be_empty
+  end
+
+  it 'should build associations without affecting to parent object' do
+    role = subject.association(:roles).soft_build
+    expect(role.user_id).to eq(subject.id)
+    expect(role.user.object_id).to eq(subject.object_id)
+    expect(subject.roles).to be_empty
+  end
+
+  it 'should build associations by relation without affecting to parent object' do
+    role = subject.roles.soft_build
+    expect(role.user_id).to eq(subject.id)
+    expect(role.user.object_id).to eq(subject.object_id)
+    expect(subject.roles).to be_empty
+  end
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+require 'codeclimate-test-reporter'
+CodeClimate::TestReporter.start
+
+require 'bundler/setup'
+Bundler.require(:default)
+
+require 'active_record'
+
+Dir["#{File.dirname(__FILE__)}/support/**/*.rb"].each { |f| require f }

data/spec/support/database.rb

@@ -0,0 +1,24 @@
+RSpec.configure do |config|
+  config.before(:all) do
+    create_database
+  end
+
+  def create_database
+    ActiveRecord::Migration.verbose = false
+    ActiveRecord::Base.establish_connection(adapter: 'sqlite3', database: ':memory:')
+    ActiveRecord::Schema.define(version: 1) do
+      create_table :users
+      create_table :roles do |t|
+        t.references :user
+      end
+    end
+  end
+end
+
+class User < ActiveRecord::Base
+  has_many :roles, inverse_of: :user
+end
+
+class Role < ActiveRecord::Base
+  belongs_to :user
+end

metadata

@@ -0,0 +1,104 @@
+--- !ruby/object:Gem::Specification
+name: activerecord-devkit
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+  prerelease: 
+platform: ruby
+authors:
+- Sergey Tokarenko
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-24 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: ruby-features
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.1.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.1.1
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.13
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 3.2.13
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Collection of utility Ruby Features for ActiveRecord.
+email: private.tokarenko.sergey@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/activerecord-devkit/features/association_soft_build_feature.rb
+- lib/activerecord-devkit/version.rb
+- lib/activerecord-devkit.rb
+- LICENSE
+- README.md
+- spec/association_soft_build_spec.rb
+- spec/spec_helper.rb
+- spec/support/database.rb
+homepage: https://github.com/stokarenko/activerecord-devkit
+licenses:
+- MIT
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.9.3
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23.2
+signing_key: 
+specification_version: 3
+summary: Collection of utility Ruby Features for ActiveRecord.
+test_files:
+- spec/association_soft_build_spec.rb
+- spec/spec_helper.rb
+- spec/support/database.rb