verm-client 1.1.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: b0944a2110fde443b969980a417fe24fc9e3c142
-  data.tar.gz: c880b7919042d31f450957f1f57f058d8499be9a
+  metadata.gz: 0ce2084d3b2424bcc2e768dd946436af8e38925a
+  data.tar.gz: 8be9a875f01d58e946f7c3671cf3178c01f7a922
 SHA512:
-  metadata.gz: 93b9676a8d0736cda53c432b44404bfd1b0f37c5bda67c4d7f38d8d2c2d9e454b225b8a874854c2ddaa4879cf2e33f8bacfdea55b5eabebaa4e1661274975bb1
-  data.tar.gz: d1a8c4feff6b62811eed414f511dd2bbea3d1d71e008775535a1a8326ab9efdab9218b159e545f81da7c304b1a2a62e70dc798d612ee3745842e3781b5c4c5ca
+  metadata.gz: 1d462b82e2eaaf10e7c466d020a02b94e592c1a76f842bb3cc667b0364b640451f85257c25d9acff3f092abe44e1612d18ee675283f2cc9124d0899b3bad1ac8
+  data.tar.gz: 58294b9e7814e6fc2a5d2eb41acec6c53a43ac8fd5fb394295205c7fefea3d90041f6d25e58978fb7d08d81d3be4057b9ebb5e4f0f30884ae5d4b63db77b5921

data/README.md

@@ -113,3 +113,20 @@ VERM_CLIENT = Verm::Client.new("my-verm-server", timeout: 60)
 ```
 
 Like Net::HTTP, this timeout applies to individual network operations, not the whole method.
+
+
+Reusing connections
+-------------------
+
+By default, Ruby's Net::HTTP client will open a new connection for each request.  This makes it very safe with regards to forking or threading, but it can become a bottleneck if you are doing a bulk upload or download from Verm.  You can explicitly start a connection to work around this:
+
+```ruby
+VERM_CLIENT.http_client.start do
+  100.times do
+    VERM_CLIENT.store(...)
+    VERM_CLIENT.load(...)
+  end
+end
+```
+
+If you'd like to use another gem that manages connection reuse automatically, note that you can also substitute any HTTP client class that supports the Net::HTTP API, by providing the `http_class` option to `Verm::Client.new`.

data/lib/verm/client.rb

@@ -8,8 +8,8 @@ module Verm
 
     attr_reader :http_client
 
-    def initialize(hostname, port: 3404, timeout: 15)
-      @http_client = Net::HTTP.new(hostname, port)
+    def initialize(hostname, port: 3404, timeout: 15, http_class: Net::HTTP)
+      @http_client = http_class.new(hostname, port)
       @http_client.open_timeout = timeout
       @http_client.read_timeout = timeout
       @http_client.ssl_timeout = timeout

data/lib/verm/version.rb

@@ -1,3 +1,3 @@
 module Verm
-  VERSION = '1.1.1'
+  VERSION = '1.2.0'
 end

data/test/verm_test.rb

@@ -120,4 +120,15 @@ class TestVerm < Minitest::Test
     assert_equal uncompressed_content, result
     assert chunks > 1, "should have been given the content in multiple chunks"
   end
+
+  def test_reuses_socket_under_start
+    @client.http_client.start do
+      content, type = "this is a test", "text/plain"
+      assert_equal [content, type], @client.load(@client.store("/test/files_to_load", content, type))
+      @socket = @client.http_client.instance_variable_get("@socket")
+
+      assert_equal [content, type], @client.load(@client.store("/test/files_to_load", content, type))
+      assert_equal @socket, @client.http_client.instance_variable_get("@socket")
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: verm-client
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.0
 platform: ruby
 authors:
 - Will Bryant
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-03-04 00:00:00.000000000 Z
+date: 2015-08-06 00:00:00.000000000 Z
 dependencies: []
 description: |
   Adds one-line methods for storing files in Verm and retrieving them again.