dumpable 0.2.6 → 0.2.7

data/README.rdoc

@@ -1,8 +1,31 @@
 = dumpable
 
-Output all the sql commands necessary to generate a database row and its relationships.
+The situation is all too common. There is an error in production that you want to reproduce in your local
+development environment. Only problem is that the production environment has database data that you don't have locally. 
+
+So then you generally only have one option: dump your entire production database, or a subset of your production
+database to a sql file and import the dump into your local database.
+
+What if time is of the essense, and the production database is huge? What if you could dump only the
+specific records and their associations that you need to reproduce the record causing problems in your local database. 
+
+Dumpable allows you to do just that. You can dump single rows (or a collection of rows), 
+and choose which associations to dump with those rows.
+
+== Installation
+Add the following to your Gemfile:
+  gem 'dumpable'
 
 == Usage
+The dumpable gem will automatically add the class method #dumpable and the instance method #dump into all your 
+ActiveRecord models.
+
+By default, calling dump on any record will output the sql insert statement necessary to create that record.
+It will not generate the insert statements for any of the record's associations. These can either be specified
+class level by calling #dumpable with the set of assocations to dump or a run-time in your call to #dump.
+
+Both cases will be demonstrated below.
+
   class User < ActiveRecord::Base
     has_many :posts
     has_many :roles
@@ -26,21 +49,29 @@ Then, from the console, you can do something like:
   User.first.dump
 This will spit out all the MySQL insertion code for the user, it's roles, it's posts, and each post's comments
 
-If you want all to pad the ids generated in the insertion code, this can be done as follows:
+If you want each record to pad the ids generated in the insertion code, this can be done as follows:
   User.first.dump(:id_padding => 1000)
 This will ensure that the id of the above user is padded by 1000, so a user id of 1 will generate an insert statement with an id of 1001.
 
-You may wonder why the id is included as part of the insert statement. This is to ensure that all associations maintain their relations to one another.
-For example, if TODO
+You may wonder why the id is included as part of the insert statement. This is to ensure that all associations maintain their relationship to one another.
 
 All ActiveRecord models are dumpable automatically, so you could also call:
   Post.dump
+  # or
+  Post.dump(:dumps => :comments)
 
 You can also dump all the entries in the table by calling:
   Post.dump
-  # or
+  # or with conditions
   Post.where(:published => true).dump
 
+== Dumping to a sql file
+  User.dump(:file => PATH_TO_FILE)
+
+== Dumping multiple different record types
+  Dumpable.dump(Post, Comment.limit(10), Role.where(:active => true)) # will output to console
+  Dumpable.dump(Post, Comment.limit(10), Role.where(:active => true), :file => "dump.sql") # will output to file
+
 == Gotchas
 At the moment, Dumpable will not work on any complex relationships. This includes has_many :through, and has_and_belongs_to_many.
 It also will not work on models that have a different primary key than id or on models with complex keys.

data/VERSION

@@ -1 +1 @@
-0.2.6
+0.2.7

data/dumpable.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = "dumpable"
-  s.version = "0.2.6"
+  s.version = "0.2.7"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Andrew Hunter"]
-  s.date = "2013-11-07"
+  s.date = "2014-01-17"
   s.description = "Generate the SQL to insert a single record and all of its dependencies"
   s.email = "andrew.hunter@livingsocial.com"
   s.extra_rdoc_files = [

data/lib/dumpable/dumper.rb

@@ -63,10 +63,13 @@ module Dumpable
 
     # http://invisipunk.blogspot.com/2008/04/activerecord-raw-insertupdate.html
     def generate_insert_query(object)
+      skip_columns = Array(@options[:skip_columns] || (object.class.respond_to?(:dumpable_options) && object.class.dumpable_options[:skip_columns])).map(&:to_s)
       cloned_attributes = object.attributes.clone
       return nil unless cloned_attributes["id"].present?
       cloned_attributes["id"] += @id_padding
-      key_values = cloned_attributes.collect{ |key,value| [key, dump_value_string(value)] }
+      key_values = cloned_attributes.collect do |key,value|
+        [key, dump_value_string(value)] unless skip_columns.include?(key.to_s)
+      end.compact
       keys = key_values.collect{ |item| "`#{item[0]}`" }.join(", ")
       values = key_values.collect{ |item| item[1].to_s }.join(", ")
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: dumpable
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.2.7
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-11-07 00:00:00.000000000 Z
+date: 2014-01-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -145,7 +145,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: -3194922257888431227
+      hash: -4228121051279904829
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: