ethon 0.4.3 → 0.4.4

data/CHANGELOG.md

@@ -2,11 +2,15 @@
 
 ## Master
 
-[Full Changelog](http://github.com/typhoeus/ethon/compare/v0.4.3...master)
+[Full Changelog](http://github.com/typhoeus/ethon/compare/v0.4.4...master)
+
+## 0.4.4
+
+[Full Changelog](http://github.com/typhoeus/ethon/compare/v0.4.3...v0.4.4)
 
 Enhancements:
 
-Bugfixes:
+* Prepare multi explicit like easy
 
 ## 0.4.3
 

data/lib/ethon/multi.rb

@@ -28,6 +28,54 @@ module Ethon
     # Create a new multi. Initialize curl in case
     # it didn't happen before.
     #
+    # @example Create a new Multi.
+    #   Multi.new
+    #
+    # @param [ Hash ] options The options.
+    #
+    # @option options :socketdata [String]
+    #  Pass a pointer to whatever you want passed to the
+    #  curl_socket_callback's forth argument, the userp pointer. This is not
+    #  used by libcurl but only passed-thru as-is. Set the callback pointer
+    #  with CURLMOPT_SOCKETFUNCTION.
+    # @option options :pipelining [Boolean]
+    #  Pass a long set to 1 to enable or 0 to disable. Enabling pipelining
+    #  on a multi handle will make it attempt to perform HTTP Pipelining as
+    #  far as possible for transfers using this handle. This means that if
+    #  you add a second request that can use an already existing connection,
+    #  the second request will be "piped" on the same connection rather than
+    #  being executed in parallel. (Added in 7.16.0)
+    # @option options :timerfunction [Proc]
+    #  Pass a pointer to a function matching the curl_multi_timer_callback
+    #  prototype. This function will then be called when the timeout value
+    #  changes. The timeout value is at what latest time the application
+    #  should call one of the "performing" functions of the multi interface
+    #  (curl_multi_socket_action(3) and curl_multi_perform(3)) - to allow
+    #  libcurl to keep timeouts and retries etc to work. A timeout value of
+    #  -1 means that there is no timeout at all, and 0 means that the
+    #  timeout is already reached. Libcurl attempts to limit calling this
+    #  only when the fixed future timeout time actually changes. See also
+    #  CURLMOPT_TIMERDATA. This callback can be used instead of, or in
+    #  addition to, curl_multi_timeout(3). (Added in 7.16.0)
+    # @option options :timerdata [String]
+    #  Pass a pointer to whatever you want passed to the
+    #  curl_multi_timer_callback's third argument, the userp pointer. This
+    #  is not used by libcurl but only passed-thru as-is. Set the callback
+    #  pointer with CURLMOPT_TIMERFUNCTION. (Added in 7.16.0)
+    # @option options :maxconnects [Integer]
+    #  Pass a long. The set number will be used as the maximum amount of
+    #  simultaneously open connections that libcurl may cache. Default is
+    #  10, and libcurl will enlarge the size for each added easy handle to
+    #  make it fit 4 times the number of added easy handles.
+    #  By setting this option, you can prevent the cache size from growing
+    #  beyond the limit set by you.
+    #  When the cache is full, curl closes the oldest one in the cache to
+    #  prevent the number of open connections from increasing.
+    #  This option is for the multi handle's use only, when using the easy
+    #  interface you should instead use the CURLOPT_MAXCONNECTS option.
+    #  (Added in 7.16.3)
+    #
+    #
     # @return [ Multi ] The new multi.
     def initialize(options = {})
       Curl.init
@@ -41,8 +89,6 @@ module Ethon
     # @example Set options.
     #   multi.set_attributes(options)
     #
-    # @param [ Hash ] options The options.
-    #
     # @raise InvalidOption
     #
     # @see initialize

data/lib/ethon/multi/operations.rb

@@ -43,7 +43,6 @@ module Ethon
       # @example Perform multi.
       #   multi.perform
       def perform
-        set_options
         Ethon.logger.debug("ETHON: started MULTI") if Ethon.logger
         while ongoing?
           run
@@ -56,6 +55,14 @@ module Ethon
         nil
       end
 
+      # Prepare multi.
+      #
+      # @example Prepare multi.
+      #   multi.prepare
+      def prepare
+        set_options
+      end
+
       # Get timeout.
       #
       # @example Get timeout.

data/lib/ethon/version.rb

@@ -1,5 +1,5 @@
 module Ethon
 
   # Ethon version.
-  VERSION = '0.4.3'
+  VERSION = '0.4.4'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: ethon
 version: !ruby/object:Gem::Version
-  version: 0.4.3
+  version: 0.4.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-09-09 00:00:00.000000000 Z
+date: 2012-09-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ffi
@@ -121,7 +121,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: '0'
       segments:
       - 0
-      hash: 1139806787949437669
+      hash: 3523421791018447107
 required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
   requirements: