tachyon 0.1.0 → 0.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 77f52369d61841d8260f1d964ca268d8cf448844
-  data.tar.gz: dc2c8b41b22e17fff55d2c604e9890ef904c02fa
+  metadata.gz: a99e7af845eb71839bb8ea359d658ea027e1b260
+  data.tar.gz: 21cf9fa3a7cb668ecbef0c8045b2e4b61c5e089f
 SHA512:
-  metadata.gz: 41fb8d56a0c6ca6762f74ed9a4fbe5f96923f857e4ef6229dd53e8bad7f5df23474b1729030700fc31abbeaa21b1a54d09425deb07d57493a832ca5dddfbad40
-  data.tar.gz: 92c1668f3acd7e7d975faaedcef6f965e3a925cca9e5c171e25a8a932e413059c0758065d05ce2fd47b9ebe9af6654175530bad2e541788aa6e707b428662e74
+  metadata.gz: be59050806901dab5b6c6a92d2fe8b1c444d38bcff2a622b43a44742d5ab4ee89786c61803e661ab0519f8a808fc4f63183f030490ab9bfc3289ff9aea3f761b
+  data.tar.gz: 39b87a3eb721882aa46a10e5728ac3412bcb1ec67db7b93e91d1810cb935dbdcbaf4974abd4b7341dd1edee174fc7861afb13f111c7752ff4a05c1c4ccc6faa1

data/.gitignore

@@ -10,3 +10,5 @@
 
 # rspec failure tracking
 .rspec_status
+*.gem
+.DS_Store

data/README.md

@@ -1,5 +1,39 @@
 # Tachyon
 
+Tachyon is a simple library designed to insert rows into any DB managed by ActiveRecord as fast as possible. Tachyon does not do validations. Tachyon does not throw errors on duplicate keys. Tachyon simply gets records into the DB as fast as possible. This is very useful in the case when you need to bulk-insert data for some reason, but it really shouldn't be used to replace your normal ActiveRecord DB operations.
+
+Tachyon is roughly as fast as executing raw SQL statements, but with a much more readable syntax. Tachyon uses Arel to geneate the SQL statements and to manage type-casting, this helps to avoid the fragility that can come with manually generating SQL.
+
+## How fast is it?
+
+The goal is to be roughly as fast as executing raw SQL via `ActiveRecord::Base.connection`. Tachyon still falls a little short of this mark, but future optimizations will close the gap.
+
+```
+Benchmark Results (inserting 5,000 rows):
+-------------------------------------------
+User.create()               : 4.461711 secs
+Raw SQL                     : 0.597918 secs
+Tachyon.insert(User, Hash)  : 1.127233 secs
+Tachyon.insert(User, Array) : 1.078880 secs
+```
+
+## Usage
+
+To insert a single row, simply supply the model class along with a hash of attributes:
+
+```ruby
+Tachyon.insert(Article, id: 13, title: "Brand new article")
+```
+
+To do a bulk insert, supply the model class and an array of attribute hashes. Tachyon will wrap multiple inserts in a transaction for an extra speed boost:
+
+```ruby
+Tachyon.insert(Comment, [
+  {id: 1, article_id: 34, title: "Super comment"},
+  {id: 2, article_id: 12, title: "Another one"},
+  {id: 3, article_id: 90, title: "Comment duex"},
+])
+```
 
 
 ## Installation
@@ -18,17 +52,7 @@ Or install it yourself as:
 
     $ gem install tachyon
 
-## Usage
-
-```ruby
-Tachyon.insert(Article, id: 13, title: "Brand new article")
 
-Tachyon.insert(Comment, [
-  {id: 1, article_id: 34, title: "Super comment"},
-  {id: 2, article_id: 12, title: "Another one"},
-  {id: 3, article_id: 90, title: "Comment duex"},
-])
-```
 
 ## License
 

data/lib/tachyon.rb

@@ -13,8 +13,10 @@ class Tachyon
   end
 
   def self.insert_record(klass, data)
-    defaults = { created_at: Time.now, updated_at: Time.now }
-    data = defaults.merge(data)
+    if klass.has_attribute?(:created_at) && klass.has_attribute?(:updated_at)
+      defaults = { created_at: Time.now, updated_at: Time.now }
+      data = defaults.merge(data)
+    end
 
     table = klass.arel_table
     mapped_data = data.map do |key, value|

data/lib/tachyon/version.rb

@@ -1,3 +1,3 @@
 class Tachyon
-  VERSION = "0.1.0"
+  VERSION = "0.1.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tachyon
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.1.1
 platform: ruby
 authors:
 - Aaron Gough