net-http-local 0.1.0

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,2 @@
+source 'http://rubygems.org'
+gemspec

data/LICENSE

@@ -0,0 +1,22 @@
+(The MIT License)
+
+Copyright (c) 2012 Hakan Ensari
+
+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,36 @@
+Net::HTTP::Local
+================
+
+Net::HTTP::Local allows TCPSocket to bind a Net::HTTP request to a specified
+local address and port.
+
+If you are craving cURL's `interface` option, this is what you need.
+
+Installation
+------------
+
+```sh
+gem install net-http-local'
+```
+
+Usage
+-----
+
+```ruby
+require 'net/http'
+require 'net/http/local'
+
+# Bind to 10.1.1.3 in a block.
+Net::HTTP.bind '10.1.1.3' do
+  res = Net::HTTP.get_response uri
+  p JSON.parse(res.body)['ip'] # => 10.1.1.3
+end
+
+# Bind and unbind without a block.
+Net::HTTP.bind '10.1.1.3'
+
+res = Net::HTTP.get_response(uri)
+p JSON.parse(res.body)['ip'] # => 10.1.1.3
+
+Net::HTTP.unbind
+```

data/Rakefile

@@ -0,0 +1,11 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+task :default => :test
+
+desc 'Run the test suite'
+task :test do
+  Dir['test/**/*_test.rb'].each do |f|
+    ruby(f)
+  end
+end

data/lib/net/http/local.rb

@@ -0,0 +1,43 @@
+# Net::HTTP::Local allows TCPSocket to bind a Net::HTTP request to a specified
+# local address and port.
+#
+# If you are craving cURL's `interface` option, this is what you need.
+module Net::HTTP::Local
+  # Binds to a local IP address.
+  #
+  # local_address - A local IP address or hostname.
+  # local_port    - A local port (default: nil).
+  #
+  # If given a block, unbinds after the block executes.
+  #
+  # Returns nothing.
+  def bind(local_address, local_port = nil)
+    (class << TCPSocket; self; end).instance_eval do
+      alias_method :open_with_local, :open
+      define_method(:open) do |conn_address, conn_port|
+        open_with_local conn_address, conn_port, local_address, local_port
+      end
+    end
+
+    if block_given?
+      begin
+        yield
+      ensure
+        unbind
+      end
+    end
+  end
+
+  # Unbinds from the local address and port.
+  #
+  # Returns nothing.
+  def unbind
+    (class << TCPSocket; self; end).instance_eval do
+      alias_method :open, :open_with_local
+      remove_method :open_with_local
+    end
+  end
+end
+
+Net::HTTP.extend Net::HTTP::Local if defined? Net::HTTP
+Net::HTTPS.extend Net::HTTP::Local if defined? Net::HTTPS

data/lib/net/http/local/version.rb

@@ -0,0 +1,3 @@
+module Net::HTTP::Local
+  VERSION = '0.1.0'
+end

data/net-http-local.gemspec

@@ -0,0 +1,20 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path('../lib', __FILE__)
+require 'net/http'
+require 'net/http/local/version'
+
+Gem::Specification.new do |s|
+  s.name        = 'net-http-local'
+  s.version     = Net::HTTP::Local::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Hakan Ensari']
+  s.email       = ['hakan.ensari@papercavalier.com']
+  s.homepage    = 'http://github.com/hakanensari/net-http-local'
+  s.summary     = %q{ Binds Net::HTTP requests to a local address and port }
+  s.description = %q{ Net::HTTP::Local allows TCPSocket to bind Net::HTTP
+                      requests to a local address and port. }
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.require_paths = ['lib']
+end

data/test/net_http_local_test.rb

@@ -0,0 +1,62 @@
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+
+require 'test/unit'
+require 'json'
+require 'net/http'
+require 'net/http/local'
+
+class TestNetHTTPLocal < Test::Unit::TestCase
+  def find_ip
+    uri = URI.parse 'http://jsonip.com'
+    res = Net::HTTP.start(uri.host, uri.port) do |http|
+      http.get '/'
+    end
+
+    JSON.parse(res.body)['ip']
+  end
+
+  def setup
+    unless defined? @@old_ip
+      @@old_ip = find_ip
+      print "Change #{@@old_ip} to: "
+      @@new_ip = STDIN.gets.chomp
+    end
+  end
+
+  def teardown
+    Net::HTTP.unbind if TCPSocket.respond_to? :open_with_local
+  end
+
+  def test_bind_without_block
+    Net::HTTP.bind @@new_ip
+    assert_equal @@new_ip, find_ip
+
+    Net::HTTP.unbind
+    assert_equal @@old_ip, find_ip
+  end
+
+  def test_bind_with_block
+    Net::HTTP.bind @@new_ip do
+      assert_equal @@new_ip, find_ip
+    end
+
+    assert_equal @@old_ip, find_ip
+  end
+
+  def test_do_not_unbind_when_bind_not_given_block
+    Net::HTTP.bind @@new_ip
+    assert_respond_to TCPSocket, :open_with_local
+  end
+
+  def test_unbind_when_bind_given_block
+    Net::HTTP.bind(@@new_ip) {}
+    assert_raise NoMethodError do
+      TCPSocket.open_with_local
+    end
+  end
+
+  def test_bind_nil
+    Net::HTTP.bind nil
+    assert_equal @@old_ip, find_ip
+  end
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification
+name: net-http-local
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Hakan Ensari
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-04-13 00:00:00.000000000 Z
+dependencies: []
+description: ! " Net::HTTP::Local allows TCPSocket to bind Net::HTTP\n                      requests
+  to a local address and port. "
+email:
+- hakan.ensari@papercavalier.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- lib/net/http/local.rb
+- lib/net/http/local/version.rb
+- net-http-local.gemspec
+- test/net_http_local_test.rb
+homepage: http://github.com/hakanensari/net-http-local
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: Binds Net::HTTP requests to a local address and port
+test_files:
+- test/net_http_local_test.rb