multiplex 0.0.1 → 0.0.2

data/README.md

@@ -1,11 +1,14 @@
 Multiplex
 =========
 
-Multiplex lets you bind Net::HTTP requests to non-default local IP
-addresses. If you are craving cURL's interface option, this is what
+Multiplex gently monkey-patches TCPSocket to bind a Net::HTTP request to a
+non-default local IP address.
+
+If you are craving cURL's `--interface` option to fire HTTP requests over
+multiple local IPs and are looking for a native Ruby solution, this is what
 you need.
 
-[gatling gun](http://upload.wikimedia.org/wikipedia/commons/6/6c/Gatling_gun.jpg)
+![tellier](http://totallywiredradio.files.wordpress.com/2009/09/tellier.jpg?w=450&h=450)
 
 Usage
 -----

data/lib/multiplex.rb

@@ -1,14 +1,19 @@
 require 'net/http'
 
+# Multiplex gently monkey-patches TCPSocket to bind a Net::HTTP request to a
+# non-default local IP address.
+#
+# If you are craving cURL's `interface` option, this is what you need.
 module Multiplex
-  def bind(local_ip)
-    TCPSocket.instance_eval do
-      (class << self; self; end).instance_eval do
-        alias_method :original_open, :open
 
-        define_method(:open) do |conn_address, conn_port|
-          original_open(conn_address, conn_port, local_ip)
-        end
+  # Binds to a local IP address.
+  #
+  # If given a block, unbinds at the end of the block.
+  def bind(local_ip)
+    (class << TCPSocket; self; end).instance_eval do
+      alias_method :original_open, :open
+      define_method(:open) do |conn_address, conn_port|
+        original_open(conn_address, conn_port, local_ip)
       end
     end
 
@@ -21,18 +26,13 @@ module Multiplex
     end
   end
 
+  # Unbinds from the local IP address specified in earlier call to `bind`.
   def unbind
-    TCPSocket.instance_eval do
-      (class << self; self; end).instance_eval do
-        alias_method :open, :original_open
-        remove_method :original_open
-      end
+    (class << TCPSocket; self; end).instance_eval do
+      alias_method :open, :original_open
+      remove_method :original_open
     end
   end
 end
 
-module Net
-  class HTTP
-    extend Multiplex
-  end
-end
+class Net::HTTP; extend Multiplex; end

data/lib/multiplex/version.rb

@@ -1,3 +1,3 @@
 module Multiplex
-  VERSION = "0.0.1"
+  VERSION = '0.0.2'
 end

data/test/multiplex_test.rb

@@ -53,4 +53,9 @@ class TestMultiplex < Test::Unit::TestCase
       TCPSocket.original_open
     end
   end
+
+  def test_bind_nil
+    Net::HTTP.bind(nil)
+    assert_equal @@old_ip, find_ip
+  end
 end

metadata

@@ -2,7 +2,7 @@
 name: multiplex
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors: 
 - Paper Cavalier
@@ -10,7 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-03-11 00:00:00 +00:00
+date: 2011-03-18 00:00:00 +00:00
 default_executable: 
 dependencies: []