activerecord-import 1.0.0 → 1.0.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/.travis.yml +17 -14
- data/CHANGELOG.md +65 -0
- data/Gemfile +4 -1
- data/LICENSE +21 -56
- data/README.markdown +54 -59
- data/activerecord-import.gemspec +2 -2
- data/gemfiles/6.0.gemfile +1 -0
- data/gemfiles/6.1.gemfile +1 -0
- data/lib/activerecord-import/adapters/abstract_adapter.rb +8 -2
- data/lib/activerecord-import/adapters/mysql_adapter.rb +4 -5
- data/lib/activerecord-import/adapters/postgresql_adapter.rb +11 -12
- data/lib/activerecord-import/adapters/sqlite3_adapter.rb +15 -20
- data/lib/activerecord-import/base.rb +8 -1
- data/lib/activerecord-import/import.rb +41 -36
- data/lib/activerecord-import/synchronize.rb +1 -1
- data/lib/activerecord-import/version.rb +1 -1
- data/test/import_test.rb +5 -0
- data/test/schema/postgresql_schema.rb +16 -0
- data/test/support/postgresql/import_examples.rb +44 -0
- data/test/support/shared_examples/on_duplicate_key_update.rb +10 -0
- data/test/support/shared_examples/recursive_import.rb +38 -0
- data/test/support/sqlite3/import_examples.rb +2 -15
- metadata +7 -6
    
        checksums.yaml
    CHANGED
    
    | @@ -1,7 +1,7 @@ | |
| 1 1 | 
             
            ---
         | 
| 2 2 | 
             
            SHA256:
         | 
| 3 | 
            -
              metadata.gz:  | 
| 4 | 
            -
              data.tar.gz:  | 
| 3 | 
            +
              metadata.gz: 123bf726b813b21067d888221d627a03796f262de7e1b70c318def898b26d3c0
         | 
| 4 | 
            +
              data.tar.gz: d6e6a3031944ac841587a8c29c701bc1a15667a888771333ad7198b085b2e8b4
         | 
| 5 5 | 
             
            SHA512:
         | 
| 6 | 
            -
              metadata.gz:  | 
| 7 | 
            -
              data.tar.gz:  | 
| 6 | 
            +
              metadata.gz: 4409c4e0f048ea6272329d34de680d6314168784fdd4f244712ea37725254c66e4f091d302c0598e8232c31fbb9b94152197ee5dd660aa36d5df937839bf197d
         | 
| 7 | 
            +
              data.tar.gz: 5c0e49836fdf38e4f95c863aa5c0841592d169063b5a455a90d2a16c8a65736b8837e05f371227b9c8e4a23c406e990421e1e3f7a1cb37e1e4d3f9b91b36521e
         | 
    
        data/.travis.yml
    CHANGED
    
    | @@ -1,30 +1,29 @@ | |
| 1 1 | 
             
            language: ruby
         | 
| 2 2 | 
             
            cache: bundler
         | 
| 3 3 | 
             
            rvm:
         | 
| 4 | 
            -
              - 2. | 
| 4 | 
            +
              - 2.5.5
         | 
| 5 5 |  | 
| 6 6 | 
             
            env:
         | 
| 7 7 | 
             
              global:
         | 
| 8 8 | 
             
                # https://github.com/discourse/discourse/blob/master/.travis.yml
         | 
| 9 9 | 
             
                - RUBY_GC_MALLOC_LIMIT=50000000
         | 
| 10 10 | 
             
              matrix:
         | 
| 11 | 
            -
                - AR_VERSION=3.2
         | 
| 12 | 
            -
                - AR_VERSION=4.0
         | 
| 13 | 
            -
                - AR_VERSION=4.1
         | 
| 14 | 
            -
                - AR_VERSION=4.2
         | 
| 15 | 
            -
                - AR_VERSION=5.0
         | 
| 16 11 | 
             
                - AR_VERSION=5.1
         | 
| 17 12 | 
             
                - AR_VERSION=5.2
         | 
| 13 | 
            +
                - AR_VERSION=6.0
         | 
| 18 14 |  | 
| 19 15 | 
             
            matrix:
         | 
| 20 16 | 
             
              include:
         | 
| 21 | 
            -
                - rvm:  | 
| 17 | 
            +
                - rvm: 2.3.8
         | 
| 18 | 
            +
                  env: AR_VERSION=3.2
         | 
| 19 | 
            +
                - rvm: 2.3.8
         | 
| 20 | 
            +
                  env: AR_VERSION=4.0
         | 
| 21 | 
            +
                - rvm: 2.3.8
         | 
| 22 | 
            +
                  env: AR_VERSION=4.1
         | 
| 23 | 
            +
                - rvm: 2.3.8
         | 
| 22 24 | 
             
                  env: AR_VERSION=4.2
         | 
| 23 | 
            -
             | 
| 24 | 
            -
                   | 
| 25 | 
            -
                    - bundle exec rake test:jdbcsqlite3
         | 
| 26 | 
            -
                    - bundle exec rake test:jdbcmysql
         | 
| 27 | 
            -
                    - bundle exec rake test:jdbcpostgresql
         | 
| 25 | 
            +
                - rvm: 2.3.8
         | 
| 26 | 
            +
                  env: AR_VERSION=5.0
         | 
| 28 27 |  | 
| 29 28 | 
             
              fast_finish: true
         | 
| 30 29 |  | 
| @@ -38,7 +37,7 @@ addons: | |
| 38 37 | 
             
                  - sqlite3
         | 
| 39 38 | 
             
                  - mysql-server
         | 
| 40 39 | 
             
                  - mysql-client
         | 
| 41 | 
            -
                  - postgresql-9.5-postgis-2. | 
| 40 | 
            +
                  - postgresql-9.5-postgis-2.4
         | 
| 42 41 |  | 
| 43 42 | 
             
            before_install:
         | 
| 44 43 | 
             
              - gem update --system
         | 
| @@ -66,6 +65,10 @@ script: | |
| 66 65 | 
             
              - bundle exec rake test:sqlite3
         | 
| 67 66 | 
             
              - bundle exec rubocop
         | 
| 68 67 |  | 
| 69 | 
            -
            dist:  | 
| 68 | 
            +
            dist: xenial
         | 
| 69 | 
            +
             | 
| 70 | 
            +
            services:
         | 
| 71 | 
            +
              - mysql
         | 
| 72 | 
            +
              - postgresql
         | 
| 70 73 |  | 
| 71 74 | 
             
            sudo: required
         | 
    
        data/CHANGELOG.md
    CHANGED
    
    | @@ -1,3 +1,68 @@ | |
| 1 | 
            +
            ## Changes in 1.0.5
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            ### Fixes
         | 
| 4 | 
            +
             | 
| 5 | 
            +
            * Allow serialized attributes to be returned from import. Thanks to @timanovsky, @jkowens via \#660.
         | 
| 6 | 
            +
            * Return ActiveRecord::Connection from
         | 
| 7 | 
            +
              ActiveREcord::Base#establish_connection. Thanks to @reverentF via
         | 
| 8 | 
            +
            \#663.
         | 
| 9 | 
            +
            * Support PostgreSQL array. Thanks to @ujihisa via \#669.
         | 
| 10 | 
            +
            * Skip loading association ids when column changed. Thanks to @Aristat
         | 
| 11 | 
            +
              via \#673.
         | 
| 12 | 
            +
             | 
| 13 | 
            +
            ## Changes in 1.0.4
         | 
| 14 | 
            +
             | 
| 15 | 
            +
            ### Fixes
         | 
| 16 | 
            +
             | 
| 17 | 
            +
            * Use prepend pattern for ActiveRecord::Base#establish_connection patching. Thanks to @dombesz via \#648.
         | 
| 18 | 
            +
            * Fix NoMethodError when using PostgreSQL ENUM types. Thanks to @sebcoetzee via \#651.
         | 
| 19 | 
            +
            * Fix issue updating optimistic lock in Postgres. Thanks to @timanovsky
         | 
| 20 | 
            +
              via \#656.
         | 
| 21 | 
            +
             | 
| 22 | 
            +
            ## Changes in 1.0.3
         | 
| 23 | 
            +
             | 
| 24 | 
            +
            ### New Features
         | 
| 25 | 
            +
             | 
| 26 | 
            +
            * Add support for ActiveRecord 6.1.0.alpha. Thanks to @imtayadeway via
         | 
| 27 | 
            +
              \#642.
         | 
| 28 | 
            +
             | 
| 29 | 
            +
            ### Fixes
         | 
| 30 | 
            +
             | 
| 31 | 
            +
            * Return an empty array for results instead of nil when importing empty
         | 
| 32 | 
            +
              array. Thanks to @gyfis via \#636.
         | 
| 33 | 
            +
             | 
| 34 | 
            +
            ## Changes in 1.0.2
         | 
| 35 | 
            +
             | 
| 36 | 
            +
            ### New Features
         | 
| 37 | 
            +
             | 
| 38 | 
            +
            * Add support for CockroachDB adapter. Thanks to @willie via \#605.
         | 
| 39 | 
            +
            * Add support for ActiveRecord 6.0.0.rc1. Thanks to @madeindjs, @bill-filler,
         | 
| 40 | 
            +
              @jkowens via \#619, \#623.
         | 
| 41 | 
            +
             | 
| 42 | 
            +
            ### Fixes
         | 
| 43 | 
            +
             | 
| 44 | 
            +
            * Fixes NoMethodError when attempting to use nil logger. Thanks to @MattMecel,
         | 
| 45 | 
            +
              @khiav22357.
         | 
| 46 | 
            +
            * Fix issue validating STI models. Thanks to @thejbsmith, @jkowens via
         | 
| 47 | 
            +
              \#626.
         | 
| 48 | 
            +
             | 
| 49 | 
            +
            ## Changes in 1.0.1
         | 
| 50 | 
            +
             | 
| 51 | 
            +
            ### Fixes
         | 
| 52 | 
            +
             | 
| 53 | 
            +
            * Raise an error with a helpful message if array of values exceeds the number of
         | 
| 54 | 
            +
              columns for a table. Thanks to @golddranks via \#589.
         | 
| 55 | 
            +
            * Properly check if model responds to import before creating alias.
         | 
| 56 | 
            +
              Thanks to @jcw- via \#591.
         | 
| 57 | 
            +
            * No longer pass :returning option to child associations on recursive
         | 
| 58 | 
            +
              import. Thanks to @dmitriy-kiriyenko via \#595.
         | 
| 59 | 
            +
            * Fix import issue for models with Postgresql json/jsonb fields. Thanks
         | 
| 60 | 
            +
              to @stokarenko via \#594.
         | 
| 61 | 
            +
            * Fix issue importing models with timestamps that contain timezone
         | 
| 62 | 
            +
              information. Thaks to @dekaikiwi, @jkowens via \#598.
         | 
| 63 | 
            +
            * Ignore :no_returning when using :recursive option. Thanks to @dgollahon, @jkowens
         | 
| 64 | 
            +
              via \#599.
         | 
| 65 | 
            +
             | 
| 1 66 | 
             
            ## Changes in 1.0.0
         | 
| 2 67 |  | 
| 3 68 | 
             
            ### New Features
         | 
    
        data/Gemfile
    CHANGED
    
    | @@ -6,6 +6,8 @@ version = ENV['AR_VERSION'].to_f | |
| 6 6 |  | 
| 7 7 | 
             
            mysql2_version = '0.3.0'
         | 
| 8 8 | 
             
            mysql2_version = '0.4.0' if version >= 4.2
         | 
| 9 | 
            +
            sqlite3_version = '1.3.0'
         | 
| 10 | 
            +
            sqlite3_version = '1.4.0' if version >= 6.0
         | 
| 9 11 |  | 
| 10 12 | 
             
            group :development, :test do
         | 
| 11 13 | 
             
              gem 'rubocop', '~> 0.40.0'
         | 
| @@ -16,7 +18,7 @@ end | |
| 16 18 | 
             
            platforms :ruby do
         | 
| 17 19 | 
             
              gem "mysql2",                 "~> #{mysql2_version}"
         | 
| 18 20 | 
             
              gem "pg",                     "~> 0.9"
         | 
| 19 | 
            -
              gem "sqlite3",                "~>  | 
| 21 | 
            +
              gem "sqlite3",                "~> #{sqlite3_version}"
         | 
| 20 22 | 
             
              gem "seamless_database_pool", "~> 1.0.20"
         | 
| 21 23 | 
             
            end
         | 
| 22 24 |  | 
| @@ -45,6 +47,7 @@ end | |
| 45 47 |  | 
| 46 48 | 
             
            platforms :ruby do
         | 
| 47 49 | 
             
              gem "pry-byebug"
         | 
| 50 | 
            +
              gem "pry", "~> 0.12.0"
         | 
| 48 51 | 
             
              gem "rb-readline"
         | 
| 49 52 | 
             
            end
         | 
| 50 53 |  | 
    
        data/LICENSE
    CHANGED
    
    | @@ -1,56 +1,21 @@ | |
| 1 | 
            -
             | 
| 2 | 
            -
             | 
| 3 | 
            -
             | 
| 4 | 
            -
             | 
| 5 | 
            -
             | 
| 6 | 
            -
             | 
| 7 | 
            -
             | 
| 8 | 
            -
             | 
| 9 | 
            -
             | 
| 10 | 
            -
             | 
| 11 | 
            -
             | 
| 12 | 
            -
             | 
| 13 | 
            -
             | 
| 14 | 
            -
             | 
| 15 | 
            -
             | 
| 16 | 
            -
             | 
| 17 | 
            -
             | 
| 18 | 
            -
             | 
| 19 | 
            -
             | 
| 20 | 
            -
             | 
| 21 | 
            -
             | 
| 22 | 
            -
             | 
| 23 | 
            -
                   d) make other distribution arrangements with the author.
         | 
| 24 | 
            -
             | 
| 25 | 
            -
              3. You may distribute the software in object code or binary form,
         | 
| 26 | 
            -
                 provided that you do at least ONE of the following:
         | 
| 27 | 
            -
             | 
| 28 | 
            -
                   a) distribute the binaries and library files of the software,
         | 
| 29 | 
            -
            	  together with instructions (in the manual page or equivalent)
         | 
| 30 | 
            -
            	  on where to get the original distribution.
         | 
| 31 | 
            -
             | 
| 32 | 
            -
                   b) accompany the distribution with the machine-readable source of
         | 
| 33 | 
            -
            	  the software.
         | 
| 34 | 
            -
             | 
| 35 | 
            -
                   c) give non-standard binaries non-standard names, with
         | 
| 36 | 
            -
                      instructions on where to get the original software distribution.
         | 
| 37 | 
            -
             | 
| 38 | 
            -
                   d) make other distribution arrangements with the author.
         | 
| 39 | 
            -
             | 
| 40 | 
            -
              4. You may modify and include the part of the software into any other
         | 
| 41 | 
            -
                 software (possibly commercial).  But some files in the distribution
         | 
| 42 | 
            -
                 are not written by the author, so that they are not under these terms.
         | 
| 43 | 
            -
             | 
| 44 | 
            -
                 For the list of those files and their copying conditions, see the
         | 
| 45 | 
            -
                 file LEGAL.
         | 
| 46 | 
            -
             | 
| 47 | 
            -
              5. The scripts and library files supplied as input to or produced as 
         | 
| 48 | 
            -
                 output from the software do not automatically fall under the
         | 
| 49 | 
            -
                 copyright of the software, but belong to whomever generated them, 
         | 
| 50 | 
            -
                 and may be sold commercially, and may be aggregated with this
         | 
| 51 | 
            -
                 software.
         | 
| 52 | 
            -
             | 
| 53 | 
            -
              6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
         | 
| 54 | 
            -
                 IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
         | 
| 55 | 
            -
                 WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
         | 
| 56 | 
            -
                 PURPOSE.
         | 
| 1 | 
            +
            The MIT License (MIT)
         | 
| 2 | 
            +
             | 
| 3 | 
            +
            Copyright (c) 2020 Zach Dennis <zach.dennis@gmail.com>
         | 
| 4 | 
            +
             | 
| 5 | 
            +
            Permission is hereby granted, free of charge, to any person obtaining a copy
         | 
| 6 | 
            +
            of this software and associated documentation files (the "Software"), to deal
         | 
| 7 | 
            +
            in the Software without restriction, including without limitation the rights
         | 
| 8 | 
            +
            to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
         | 
| 9 | 
            +
            copies of the Software, and to permit persons to whom the Software is
         | 
| 10 | 
            +
            furnished to do so, subject to the following conditions:
         | 
| 11 | 
            +
             | 
| 12 | 
            +
            The above copyright notice and this permission notice shall be included in
         | 
| 13 | 
            +
            all copies or substantial portions of the Software.
         | 
| 14 | 
            +
             | 
| 15 | 
            +
            THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
         | 
| 16 | 
            +
            IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
         | 
| 17 | 
            +
            FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
         | 
| 18 | 
            +
            AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
         | 
| 19 | 
            +
            LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
         | 
| 20 | 
            +
            OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
         | 
| 21 | 
            +
            THE SOFTWARE.
         | 
    
        data/README.markdown
    CHANGED
    
    | @@ -1,6 +1,6 @@ | |
| 1 | 
            -
            #  | 
| 1 | 
            +
            # Activerecord-Import [](https://travis-ci.org/zdennis/activerecord-import)
         | 
| 2 2 |  | 
| 3 | 
            -
             | 
| 3 | 
            +
            Activerecord-Import is a library for bulk inserting data using ActiveRecord.
         | 
| 4 4 |  | 
| 5 5 | 
             
            One of its major features is following activerecord associations and generating the minimal
         | 
| 6 6 | 
             
            number of SQL insert statements required, avoiding the N+1 insert problem. An example probably
         | 
| @@ -23,10 +23,10 @@ an 18 hour batch process to <2 hrs. | |
| 23 23 |  | 
| 24 24 | 
             
            The gem provides the following high-level features:
         | 
| 25 25 |  | 
| 26 | 
            -
            *  | 
| 27 | 
            -
            *  | 
| 28 | 
            -
            *  | 
| 29 | 
            -
            *  | 
| 26 | 
            +
            * Works with raw columns and arrays of values (fastest)
         | 
| 27 | 
            +
            * Works with model objects (faster)
         | 
| 28 | 
            +
            * Performs validations (fast)
         | 
| 29 | 
            +
            * Performs on duplicate key updates (requires MySQL, SQLite 3.24.0+, or Postgres 9.5+)
         | 
| 30 30 |  | 
| 31 31 | 
             
            ## Table of Contents
         | 
| 32 32 |  | 
| @@ -54,16 +54,19 @@ The gem provides the following high-level features: | |
| 54 54 | 
             
            * [More Information](#more-information)
         | 
| 55 55 | 
             
            * [Contributing](#contributing)
         | 
| 56 56 | 
             
              * [Running Tests](#running-tests)
         | 
| 57 | 
            +
              * [Issue Triage](#issue-triage)
         | 
| 57 58 |  | 
| 58 59 | 
             
            ### Examples
         | 
| 59 60 |  | 
| 60 61 | 
             
            #### Introduction
         | 
| 61 62 |  | 
| 63 | 
            +
            This gem adds an `import` method (or `bulk_import`, for compatibility with gems like `elasticsearch-model`; see [Conflicts With Other Gems](#conflicts-with-other-gems)) to ActiveRecord classes.
         | 
| 64 | 
            +
             | 
| 62 65 | 
             
            Without `activerecord-import`, you'd write something like this:
         | 
| 63 66 |  | 
| 64 67 | 
             
            ```ruby
         | 
| 65 68 | 
             
            10.times do |i|
         | 
| 66 | 
            -
              Book.create! : | 
| 69 | 
            +
              Book.create! name: "book #{i}"
         | 
| 67 70 | 
             
            end
         | 
| 68 71 | 
             
            ```
         | 
| 69 72 |  | 
| @@ -72,7 +75,7 @@ This would end up making 10 SQL calls. YUCK!  With `activerecord-import`, you ca | |
| 72 75 | 
             
            ```ruby
         | 
| 73 76 | 
             
            books = []
         | 
| 74 77 | 
             
            10.times do |i|
         | 
| 75 | 
            -
              books << Book.new(: | 
| 78 | 
            +
              books << Book.new(name: "book #{i}")
         | 
| 76 79 | 
             
            end
         | 
| 77 80 | 
             
            Book.import books    # or use import!
         | 
| 78 81 | 
             
            ```
         | 
| @@ -85,13 +88,13 @@ The `import` method can take an array of column names (string or symbols) and an | |
| 85 88 |  | 
| 86 89 | 
             
            ```ruby
         | 
| 87 90 | 
             
            columns = [ :title, :author ]
         | 
| 88 | 
            -
            values = [ ['Book1', ' | 
| 91 | 
            +
            values = [ ['Book1', 'George Orwell'], ['Book2', 'Bob Jones'] ]
         | 
| 89 92 |  | 
| 90 93 | 
             
            # Importing without model validations
         | 
| 91 | 
            -
            Book.import columns, values, : | 
| 94 | 
            +
            Book.import columns, values, validate: false
         | 
| 92 95 |  | 
| 93 96 | 
             
            # Import with model validations
         | 
| 94 | 
            -
            Book.import columns, values, : | 
| 97 | 
            +
            Book.import columns, values, validate: true
         | 
| 95 98 |  | 
| 96 99 | 
             
            # when not specified :validate defaults to true
         | 
| 97 100 | 
             
            Book.import columns, values
         | 
| @@ -102,7 +105,7 @@ Book.import columns, values | |
| 102 105 | 
             
            The `import` method can take an array of hashes. The keys map to the column names in the database.
         | 
| 103 106 |  | 
| 104 107 | 
             
            ```ruby
         | 
| 105 | 
            -
            values = [{ title: 'Book1', author: ' | 
| 108 | 
            +
            values = [{ title: 'Book1', author: 'George Orwell' }, { title: 'Book2', author: 'Bob Jones'}]
         | 
| 106 109 |  | 
| 107 110 | 
             
            # Importing without model validations
         | 
| 108 111 | 
             
            Book.import values, validate: false
         | 
| @@ -119,7 +122,7 @@ The `import` method can take an array of column names and an array of hash objec | |
| 119 122 |  | 
| 120 123 | 
             
            ```ruby
         | 
| 121 124 | 
             
            books = [
         | 
| 122 | 
            -
              { title: "Book 1", author: " | 
| 125 | 
            +
              { title: "Book 1", author: "George Orwell" },
         | 
| 123 126 | 
             
              { title: "Book 2", author: "Bob Jones" }
         | 
| 124 127 | 
             
            ]
         | 
| 125 128 | 
             
            columns = [ :title ]
         | 
| @@ -171,15 +174,15 @@ The `import` method can take an array of models. The attributes will be pulled o | |
| 171 174 |  | 
| 172 175 | 
             
            ```ruby
         | 
| 173 176 | 
             
            books = [
         | 
| 174 | 
            -
              Book.new(: | 
| 175 | 
            -
              Book.new(: | 
| 177 | 
            +
              Book.new(title: "Book 1", author: "George Orwell"),
         | 
| 178 | 
            +
              Book.new(title: "Book 2", author: "Bob Jones")
         | 
| 176 179 | 
             
            ]
         | 
| 177 180 |  | 
| 178 181 | 
             
            # without validations
         | 
| 179 | 
            -
            Book.import books, : | 
| 182 | 
            +
            Book.import books, validate: false
         | 
| 180 183 |  | 
| 181 184 | 
             
            # with validations
         | 
| 182 | 
            -
            Book.import books, : | 
| 185 | 
            +
            Book.import books, validate: true
         | 
| 183 186 |  | 
| 184 187 | 
             
            # when not specified :validate defaults to true
         | 
| 185 188 | 
             
            Book.import books
         | 
| @@ -189,16 +192,16 @@ The `import` method can take an array of column names and an array of models. Th | |
| 189 192 |  | 
| 190 193 | 
             
            ```ruby
         | 
| 191 194 | 
             
            books = [
         | 
| 192 | 
            -
              Book.new(: | 
| 193 | 
            -
              Book.new(: | 
| 195 | 
            +
              Book.new(title: "Book 1", author: "George Orwell"),
         | 
| 196 | 
            +
              Book.new(title: "Book 2", author: "Bob Jones")
         | 
| 194 197 | 
             
            ]
         | 
| 195 198 | 
             
            columns = [ :title ]
         | 
| 196 199 |  | 
| 197 200 | 
             
            # without validations
         | 
| 198 | 
            -
            Book.import columns, books, : | 
| 201 | 
            +
            Book.import columns, books, validate: false
         | 
| 199 202 |  | 
| 200 203 | 
             
            # with validations
         | 
| 201 | 
            -
            Book.import columns, books, : | 
| 204 | 
            +
            Book.import columns, books, validate: true
         | 
| 202 205 |  | 
| 203 206 | 
             
            # when not specified :validate defaults to true
         | 
| 204 207 | 
             
            Book.import columns, books
         | 
| @@ -217,28 +220,29 @@ The `import` method can take a `batch_size` option to control the number of rows | |
| 217 220 |  | 
| 218 221 | 
             
            ```ruby
         | 
| 219 222 | 
             
            books = [
         | 
| 220 | 
            -
              Book.new(: | 
| 221 | 
            -
              Book.new(: | 
| 222 | 
            -
              Book.new(: | 
| 223 | 
            -
              Book.new(: | 
| 223 | 
            +
              Book.new(title: "Book 1", author: "George Orwell"),
         | 
| 224 | 
            +
              Book.new(title: "Book 2", author: "Bob Jones"),
         | 
| 225 | 
            +
              Book.new(title: "Book 1", author: "John Doe"),
         | 
| 226 | 
            +
              Book.new(title: "Book 2", author: "Richard Wright")
         | 
| 224 227 | 
             
            ]
         | 
| 225 228 | 
             
            columns = [ :title ]
         | 
| 226 229 |  | 
| 227 230 | 
             
            # 2 INSERT statements for 4 records
         | 
| 228 | 
            -
            Book.import columns, books, : | 
| 231 | 
            +
            Book.import columns, books, batch_size: 2
         | 
| 229 232 | 
             
            ```
         | 
| 230 233 |  | 
| 231 234 | 
             
            #### Recursive
         | 
| 232 235 |  | 
| 233 | 
            -
            NOTE: This only works with PostgreSQL.
         | 
| 236 | 
            +
            NOTE: This only works with PostgreSQL and ActiveRecord objects. This won't work with
         | 
| 237 | 
            +
            hashes or arrays as recursive inputs.
         | 
| 234 238 |  | 
| 235 239 | 
             
            Assume that Books <code>has_many</code> Reviews.
         | 
| 236 240 |  | 
| 237 241 | 
             
            ```ruby
         | 
| 238 242 | 
             
            books = []
         | 
| 239 243 | 
             
            10.times do |i|
         | 
| 240 | 
            -
              book = Book.new(: | 
| 241 | 
            -
              book.reviews.build(: | 
| 244 | 
            +
              book = Book.new(name: "book #{i}")
         | 
| 245 | 
            +
              book.reviews.build(title: "Excellent")
         | 
| 242 246 | 
             
              books << book
         | 
| 243 247 | 
             
            end
         | 
| 244 248 | 
             
            Book.import books, recursive: true
         | 
| @@ -248,8 +252,9 @@ Book.import books, recursive: true | |
| 248 252 |  | 
| 249 253 | 
             
            Key                     | Options               | Default            | Description
         | 
| 250 254 | 
             
            ----------------------- | --------------------- | ------------------ | -----------
         | 
| 251 | 
            -
            :validate               | `true`/`false`        | `true`             | Whether or not to run `ActiveRecord` validations (uniqueness skipped).
         | 
| 255 | 
            +
            :validate               | `true`/`false`        | `true`             | Whether or not to run `ActiveRecord` validations (uniqueness skipped). This option will always be true when using `import!`.
         | 
| 252 256 | 
             
            :validate_uniqueness    | `true`/`false`        | `false`            | Whether or not to run uniqueness validations, has potential pitfalls, use with caution (requires `>= v0.27.0`).
         | 
| 257 | 
            +
            :validate_with_context  | `Symbol`              |`:create`/`:update` | Allows passing an ActiveModel validation context for each model. Default is `:create` for new records and `:update` for existing ones. 
         | 
| 253 258 | 
             
            :on_duplicate_key_ignore| `true`/`false`        | `false`            | Allows skipping records with duplicate keys. See [here](https://github.com/zdennis/activerecord-import/#duplicate-key-ignore) for more details.
         | 
| 254 259 | 
             
            :ignore                 | `true`/`false`        | `false`            | Alias for :on_duplicate_key_ignore.
         | 
| 255 260 | 
             
            :on_duplicate_key_update| :all, `Array`, `Hash` | N/A                | Allows upsert logic to be used. See [here](https://github.com/zdennis/activerecord-import/#duplicate-key-update) for more details.
         | 
| @@ -257,8 +262,8 @@ Key                     | Options               | Default            | Descripti | |
| 257 262 | 
             
            :timestamps             | `true`/`false`        | `true`             | Enables/disables timestamps on imported records.
         | 
| 258 263 | 
             
            :recursive              | `true`/`false`        | `false`            | Imports has_many/has_one associations (PostgreSQL only).
         | 
| 259 264 | 
             
            :batch_size             | `Integer`             | total # of records | Max number of records to insert per import
         | 
| 260 | 
            -
            :raise_error            | `true`/`false`        | `false`            |  | 
| 261 | 
            -
             | 
| 265 | 
            +
            :raise_error            | `true`/`false`        | `false`            | Raises an exception at the first invalid record. This means there will not be a result object returned. The `import!` method is a shortcut for this.
         | 
| 266 | 
            +
            :all_or_none            | `true`/`false`        | `false`            | Will not import any records if there is a record with validation errors.
         | 
| 262 267 |  | 
| 263 268 | 
             
            #### Duplicate Key Ignore
         | 
| 264 269 |  | 
| @@ -267,14 +272,14 @@ Key                     | Options               | Default            | Descripti | |
| 267 272 | 
             
            For Postgres 9.5+ it adds `ON CONFLICT DO NOTHING`, for MySQL it uses `INSERT IGNORE`, and for SQLite it uses `INSERT OR IGNORE`. Cannot be enabled on a recursive import. For database adapters that normally support setting primary keys on imported objects, this option prevents that from occurring.
         | 
| 268 273 |  | 
| 269 274 | 
             
            ```ruby
         | 
| 270 | 
            -
            book = Book.create! title: "Book1", author: " | 
| 275 | 
            +
            book = Book.create! title: "Book1", author: "George Orwell"
         | 
| 271 276 | 
             
            book.title = "Updated Book Title"
         | 
| 272 277 | 
             
            book.author = "Bob Barker"
         | 
| 273 278 |  | 
| 274 279 | 
             
            Book.import [book], on_duplicate_key_ignore: true
         | 
| 275 280 |  | 
| 276 281 | 
             
            book.reload.title  # => "Book1"     (stayed the same)
         | 
| 277 | 
            -
            book.reload.author # => " | 
| 282 | 
            +
            book.reload.author # => "George Orwell" (stayed the same)
         | 
| 278 283 | 
             
            ```
         | 
| 279 284 |  | 
| 280 285 | 
             
            The option `:on_duplicate_key_ignore` is bypassed when `:recursive` is enabled for [PostgreSQL imports](https://github.com/zdennis/activerecord-import/wiki#recursive-example-postgresql-only).
         | 
| @@ -290,7 +295,7 @@ This will use MySQL's `ON DUPLICATE KEY UPDATE` or Postgres/SQLite `ON CONFLICT | |
| 290 295 | 
             
            Basic Update
         | 
| 291 296 |  | 
| 292 297 | 
             
            ```ruby
         | 
| 293 | 
            -
            book = Book.create! title: "Book1", author: " | 
| 298 | 
            +
            book = Book.create! title: "Book1", author: "George Orwell"
         | 
| 294 299 | 
             
            book.title = "Updated Book Title"
         | 
| 295 300 | 
             
            book.author = "Bob Barker"
         | 
| 296 301 |  | 
| @@ -304,13 +309,13 @@ Book.import [book], on_duplicate_key_update: {conflict_target: [:id], columns: [ | |
| 304 309 | 
             
            Book.import [book], on_duplicate_key_update: [:title]
         | 
| 305 310 |  | 
| 306 311 | 
             
            book.reload.title  # => "Updated Book Title" (changed)
         | 
| 307 | 
            -
            book.reload.author # => " | 
| 312 | 
            +
            book.reload.author # => "George Orwell"          (stayed the same)
         | 
| 308 313 | 
             
            ```
         | 
| 309 314 |  | 
| 310 315 | 
             
            Using the value from another column
         | 
| 311 316 |  | 
| 312 317 | 
             
            ```ruby
         | 
| 313 | 
            -
            book = Book.create! title: "Book1", author: " | 
| 318 | 
            +
            book = Book.create! title: "Book1", author: "George Orwell"
         | 
| 314 319 | 
             
            book.title = "Updated Book Title"
         | 
| 315 320 |  | 
| 316 321 | 
             
            # MySQL version
         | 
| @@ -328,7 +333,7 @@ book.reload.author # => "Updated Book Title" (changed) | |
| 328 333 | 
             
            Using Custom SQL
         | 
| 329 334 |  | 
| 330 335 | 
             
            ```ruby
         | 
| 331 | 
            -
            book = Book.create! title: "Book1", author: " | 
| 336 | 
            +
            book = Book.create! title: "Book1", author: "George Orwell"
         | 
| 332 337 | 
             
            book.author = "Bob Barker"
         | 
| 333 338 |  | 
| 334 339 | 
             
            # MySQL version
         | 
| @@ -349,7 +354,7 @@ book.reload.author # => "Bob Barker" (changed) | |
| 349 354 | 
             
            PostgreSQL Using constraints
         | 
| 350 355 |  | 
| 351 356 | 
             
            ```ruby
         | 
| 352 | 
            -
            book = Book.create! title: "Book1", author: " | 
| 357 | 
            +
            book = Book.create! title: "Book1", author: "George Orwell", edition: 3, published_at: nil
         | 
| 353 358 | 
             
            book.published_at = Time.now
         | 
| 354 359 |  | 
| 355 360 | 
             
            # in migration
         | 
| @@ -363,7 +368,7 @@ Book.import [book], on_duplicate_key_update: {constraint_name: :for_upsert, colu | |
| 363 368 |  | 
| 364 369 |  | 
| 365 370 | 
             
            book.reload.title  # => "Book1"          (stayed the same)
         | 
| 366 | 
            -
            book.reload.author # => " | 
| 371 | 
            +
            book.reload.author # => "George Orwell"      (stayed the same)
         | 
| 367 372 | 
             
            book.reload.edition # => 3               (stayed the same)
         | 
| 368 373 | 
             
            book.reload.published_at # => 2017-10-09 (changed)
         | 
| 369 374 | 
             
            ```
         | 
| @@ -383,7 +388,7 @@ articles = [ | |
| 383 388 | 
             
              Article.new(author_id: 3, content: '')
         | 
| 384 389 | 
             
            ]
         | 
| 385 390 |  | 
| 386 | 
            -
            demo = Article.import(articles | 
| 391 | 
            +
            demo = Article.import(articles, returning: :title) # => #<struct ActiveRecord::Import::Result
         | 
| 387 392 |  | 
| 388 393 | 
             
            demo.failed_instances
         | 
| 389 394 | 
             
            => [#<Article id: 3, author_id: 3, title: nil, content: "", created_at: nil, updated_at: nil>]
         | 
| @@ -397,7 +402,7 @@ demo.ids | |
| 397 402 |  | 
| 398 403 | 
             
            demo.results
         | 
| 399 404 | 
             
            => ["First Article", "Second Article"] # for Postgres
         | 
| 400 | 
            -
            => [] for other DBs
         | 
| 405 | 
            +
            => [] # for other DBs
         | 
| 401 406 | 
             
            ```
         | 
| 402 407 |  | 
| 403 408 | 
             
            ### Counter Cache
         | 
| @@ -552,7 +557,7 @@ When rubygems pushes the `lib` folder onto the load path a `require` will now fi | |
| 552 557 |  | 
| 553 558 | 
             
            ### Conflicts With Other Gems
         | 
| 554 559 |  | 
| 555 | 
            -
             | 
| 560 | 
            +
            Activerecord-Import adds the `.import` method onto `ActiveRecord::Base`. There are other gems, such as `elasticsearch-rails`, that do the same thing. In conflicts such as this, there is an aliased method named `.bulk_import` that can be used interchangeably.
         | 
| 556 561 |  | 
| 557 562 | 
             
            If you are using the `apartment` gem, there is a weird triple interaction between that gem, `activerecord-import`, and `activerecord` involving caching of the `sequence_name` of a model. This can be worked around by explcitly setting this value within the model. For example:
         | 
| 558 563 |  | 
| @@ -579,7 +584,7 @@ See https://github.com/zdennis/activerecord-import/issues/233 for further discus | |
| 579 584 |  | 
| 580 585 | 
             
            ### More Information
         | 
| 581 586 |  | 
| 582 | 
            -
            For more information on  | 
| 587 | 
            +
            For more information on Activerecord-Import please see its wiki: https://github.com/zdennis/activerecord-import/wiki
         | 
| 583 588 |  | 
| 584 589 | 
             
            To document new information, please add to the README instead of the wiki. See https://github.com/zdennis/activerecord-import/issues/397 for discussion.
         | 
| 585 590 |  | 
| @@ -605,24 +610,14 @@ AR_VERSION=4.2 bundle exec rake test:postgresql test:sqlite3 test:mysql2 | |
| 605 610 |  | 
| 606 611 | 
             
            Once you have pushed up your changes, you can find your CI results [here](https://travis-ci.org/zdennis/activerecord-import/).
         | 
| 607 612 |  | 
| 613 | 
            +
            ## Issue Triage [](https://www.codetriage.com/zdennis/activerecord-import)
         | 
| 614 | 
            +
             | 
| 615 | 
            +
            You can triage issues which may include reproducing bug reports or asking for vital information, such as version numbers or reproduction instructions. If you would like to start triaging issues, one easy way to get started is to [subscribe to activerecord-import on CodeTriage](https://www.codetriage.com/zdennis/activerecord-import).
         | 
| 616 | 
            +
             | 
| 608 617 | 
             
            # License
         | 
| 609 618 |  | 
| 610 | 
            -
            This is licensed under the  | 
| 619 | 
            +
            This is licensed under the MIT license.
         | 
| 611 620 |  | 
| 612 621 | 
             
            # Author
         | 
| 613 622 |  | 
| 614 623 | 
             
            Zach Dennis (zach.dennis@gmail.com)
         | 
| 615 | 
            -
             | 
| 616 | 
            -
            # Contributors
         | 
| 617 | 
            -
             | 
| 618 | 
            -
            * Jordan Owens (@jkowens)
         | 
| 619 | 
            -
            * Erik Michaels-Ober (@sferik)
         | 
| 620 | 
            -
            * Blythe Dunham
         | 
| 621 | 
            -
            * Gabe da Silveira
         | 
| 622 | 
            -
            * Henry Work
         | 
| 623 | 
            -
            * James Herdman
         | 
| 624 | 
            -
            * Marcus Crafter
         | 
| 625 | 
            -
            * Thibaud Guillaume-Gentil
         | 
| 626 | 
            -
            * Mark Van Holstyn
         | 
| 627 | 
            -
            * Victor Costan
         | 
| 628 | 
            -
            * Dillon Welch
         |