activerecord-import 1.0.0 → 1.0.5

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 8f5ca21d97ac6550f23697bb50649a0e3c04858e922b9e0c9034201b38eaeba9
4
- data.tar.gz: be99806f9a678aa8be4c9d06c904625ae49cab5be519dfced6300deab00adfe0
3
+ metadata.gz: 123bf726b813b21067d888221d627a03796f262de7e1b70c318def898b26d3c0
4
+ data.tar.gz: d6e6a3031944ac841587a8c29c701bc1a15667a888771333ad7198b085b2e8b4
5
5
  SHA512:
6
- metadata.gz: 749c050502f6b5edab4f46dcb6f8048bb652a825287278698b30328001a1d8be2eee4d68e1dc98b0d581c1ef090c957b2aa6918e43ca094818316c478c499c9b
7
- data.tar.gz: 554e93c8bd7693852f25a9fa777757d22a53a48d3e24fc98e9a44bcb2daa946d9b39eb4dabb8f20063dc48a17717cb91e3f5a0870c95c04557b605108868c2cf
6
+ metadata.gz: 4409c4e0f048ea6272329d34de680d6314168784fdd4f244712ea37725254c66e4f091d302c0598e8232c31fbb9b94152197ee5dd660aa36d5df937839bf197d
7
+ data.tar.gz: 5c0e49836fdf38e4f95c863aa5c0841592d169063b5a455a90d2a16c8a65736b8837e05f371227b9c8e4a23c406e990421e1e3f7a1cb37e1e4d3f9b91b36521e
@@ -1,30 +1,29 @@
1
1
  language: ruby
2
2
  cache: bundler
3
3
  rvm:
4
- - 2.3.7
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: jruby-9.1.14.0
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
- script:
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.3
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: trusty
68
+ dist: xenial
69
+
70
+ services:
71
+ - mysql
72
+ - postgresql
70
73
 
71
74
  sudo: required
@@ -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", "~> 1.3.10"
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
- Ruby is copyrighted free software by Yukihiro Matsumoto <matz@netlab.jp>.
2
- You can redistribute it and/or modify it under either the terms of the
3
- 2-clause BSDL (see the file BSDL), or the conditions below:
4
-
5
- 1. You may make and give away verbatim copies of the source form of the
6
- software without restriction, provided that you duplicate all of the
7
- original copyright notices and associated disclaimers.
8
-
9
- 2. You may modify your copy of the software in any way, provided that
10
- you do at least ONE of the following:
11
-
12
- a) place your modifications in the Public Domain or otherwise
13
- make them Freely Available, such as by posting said
14
- modifications to Usenet or an equivalent medium, or by allowing
15
- the author to include your modifications in the software.
16
-
17
- b) use the modified software only within your corporation or
18
- organization.
19
-
20
- c) give non-standard binaries non-standard names, with
21
- instructions on where to get the original software distribution.
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.
@@ -1,6 +1,6 @@
1
- # activerecord-import [![Build Status](https://travis-ci.org/zdennis/activerecord-import.svg?branch=master)](https://travis-ci.org/zdennis/activerecord-import)
1
+ # Activerecord-Import [![Build Status](https://travis-ci.org/zdennis/activerecord-import.svg?branch=master)](https://travis-ci.org/zdennis/activerecord-import)
2
2
 
3
- activerecord-import is a library for bulk inserting data using ActiveRecord.
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
- * activerecord-import can work with raw columns and arrays of values (fastest)
27
- * activerecord-import works with model objects (faster)
28
- * activerecord-import can perform validations (fast)
29
- * activerecord-import can perform on duplicate key updates (requires MySQL or Postgres 9.5+)
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! :name => "book #{i}"
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(:name => "book #{i}")
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', 'FooManChu'], ['Book2', 'Bob Jones'] ]
91
+ values = [ ['Book1', 'George Orwell'], ['Book2', 'Bob Jones'] ]
89
92
 
90
93
  # Importing without model validations
91
- Book.import columns, values, :validate => false
94
+ Book.import columns, values, validate: false
92
95
 
93
96
  # Import with model validations
94
- Book.import columns, values, :validate => true
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: 'FooManChu' }, { title: 'Book2', author: 'Bob Jones'}]
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: "FooManChu" },
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(:title => "Book 1", :author => "FooManChu"),
175
- Book.new(:title => "Book 2", :author => "Bob Jones")
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, :validate => false
182
+ Book.import books, validate: false
180
183
 
181
184
  # with validations
182
- Book.import books, :validate => true
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(:title => "Book 1", :author => "FooManChu"),
193
- Book.new(:title => "Book 2", :author => "Bob Jones")
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, :validate => false
201
+ Book.import columns, books, validate: false
199
202
 
200
203
  # with validations
201
- Book.import columns, books, :validate => true
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(:title => "Book 1", :author => "FooManChu"),
221
- Book.new(:title => "Book 2", :author => "Bob Jones"),
222
- Book.new(:title => "Book 1", :author => "John Doe"),
223
- Book.new(:title => "Book 2", :author => "Richard Wright")
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, :batch_size => 2
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(:name => "book #{i}")
241
- book.reviews.build(:title => "Excellent")
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` | Throws an exception if there are invalid records. `import!` is a shortcut for this.
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: "FooManChu"
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 # => "FooManChu" (stayed the same)
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: "FooManChu"
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 # => "FooManChu" (stayed the same)
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: "FooManChu"
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: "FooManChu"
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: "FooManChu", edition: 3, published_at: nil
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 # => "FooManChu" (stayed the same)
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), returning: :title # => #<struct ActiveRecord::Import::Result
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
- `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.
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 activerecord-import please see its wiki: https://github.com/zdennis/activerecord-import/wiki
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 [![Open Source Helpers](https://www.codetriage.com/zdennis/activerecord-import/badges/users.svg)](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 ruby license.
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