activerecord-bulkwrite 1.0.2 → 1.0.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 817cfb76e57ece716264df8d981e4213ab4f1bfd
-  data.tar.gz: 446888807fa68849c579e477b61cf89f0d394d3c
+  metadata.gz: 369fdcf6f6d5955174b39d47708116a848fccbfd
+  data.tar.gz: 85dc264492bd79912e3f5261da2cf21656fd0350
 SHA512:
-  metadata.gz: 6c1f8abff0010ee2825bb301a73bebbb046213dc4965942994d5f66b00af8f4202b69c2bb38182c9ac4c7ac6b138112199dad8f11abf87ddfdd8824b67fd6d5c
-  data.tar.gz: 97f4b4da0b899df0b58fdf1d27f28ee4ddd0bafa3d3b5dc82a853aa6ee635847735c7c144c743b7cb910d66d331bbe4d730b97240d8f04ab9500d1f9aada37c5
+  metadata.gz: b7a44baf90e1ee46a3bb9a7ec8bb7164b7ad0ceb660e32a464ebf95afa97fbc71420d363f2ae9591e809a6bfae7b2a8c26d3cd52085c757e3d55f1eb01713274
+  data.tar.gz: fd02168bc0bc8ec34726f31d76c763b7522e830866f7d9965959469179d0cb9ea8dce02d5f6c45e4a205e62948b33a6b39d2884162be40579dc4e82aad6060df

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2016 Robert(louirobert@gmail.com)
+
+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,71 @@
+中文文档请看这里：http://ask.githuber.cn/t/activerecord-bulk-write/1723
+---
+# activerecord-bulkwrite
+Bulk write/upsert for ActiveRecord!
+
+# Requirement
+PostgreSQL 9.5 and higher
+
+# Installation
+
+```
+gem install activerecord-bulkwrite
+```
+
+# Usage
+
+Suppose a table definition:
+
+```ruby
+create table users (
+  id integer primary key,
+  name text,
+  hireable bool,
+  created_at date_time,
+  foo text,
+  bar text,
+)
+```
+
+## Bulk Insert
+
+```ruby
+require "activerecord/bulkwrite"
+
+fields = %w(id name hireable created_at)
+rows = [
+  [1, "Bob's", true, Time.now.utc],
+  [2, nil, "false", Time.now.utc.iso8601],
+  # ...
+]
+
+# The result is the effected(inserted) rows.
+result = User.bulk_write(fields, rows)
+```
+
+The values of rows are sent to database as-is, and their to_s method is called when necessary. So here you need to *pay attention to datetime values: it must be in UTC time, not in local time*, since there's no time zone conversion.
+
+## Bulk Upsert
+
+You do upsert like:
+
+```ruby
+result = User.bulk_write(fields, rows, :conflict => [:id])
+```
+
+The statement above reinserted `rows` and thus failed on unique violation. But this time we specified an `:conflict` option meaning when the given fields conflict then do update with the rest fields. We can also explicitly specify the fields to update:
+
+```ruby
+result = User.bulk_write(fields, rows, :conflict => [:id],  :update => %w(name created_at))
+```
+
+We can even specify conditions under which to do update:
+
+```ruby
+result = User.bulk_write(fields, rows, :conflict => [:id],  :where => "users.hireable = TRUE"))
+```
+
+The upsert function depends on PostgreSQL 9.5's upsert. See here for more: https://www.postgresql.org/docs/9.5/static/sql-insert.html#SQL-ON-CONFLICT
+
+# Compatible Rails Versions and Test
+It's tested against ActiveRecord 4.2, but should also work on 4.x as well as 5.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: activerecord-bulkwrite
 version: !ruby/object:Gem::Version
-  version: 1.0.2
+  version: 1.0.3
 platform: ruby
 authors:
 - Robert Zhang
@@ -14,14 +14,14 @@ dependencies:
   name: activerecord
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '4.0'
 description: 
@@ -30,6 +30,8 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- LICENSE
+- README.md
 - lib/activerecord/bulkwrite.rb
 homepage: https://github.com/coin8086/activerecord-bulkwrite
 licenses:
@@ -51,7 +53,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.1
+rubygems_version: 2.4.8
 signing_key: 
 specification_version: 4
 summary: Bulk write/upsert for ActiveRecord