em-connectify 0.2

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    MWVlNTYwYjNiOGE1Y2FmMGIzYzU2YmFlMTkyNjQ0MzUxMjAwODFkMg==
+  data.tar.gz: !binary |-
+    MzU4MzE1MTI0MjIyZWU5MmYzMWU3YWQ3MTFhMThlMzA5MGE0NmE3NQ==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    MTM2NGI0ZTg2YjBkOGMwZWUwODhkNWM5Y2FmZmY3ZTc5Zjg0ZTY2OWY0MTM3
+    YWI1MWZkMzc2YTc1MzU4OTcwYzNiY2Q3NjdhMzcyZmZhYWM4YjA1NjU5OWJj
+    MDg5MGFhZmVmOGJkNmNiMjZjOTEyY2NiOWE1MDVjZTY5M2UwMmQ=
+  data.tar.gz: !binary |-
+    ODRlOTg0YmU0MDg5MTNhOTI0MjVjOGJmMWY5ZGY1M2IzMjNjZTg1MDE5YTcz
+    ODg4MjVmNmFlZGJmZjgzNWIyMDAwNGRmMmRhYWNiNWVhNTFiMjllYWQ1NGQ2
+    OTllNzVmNGYxYWY0NWJjMjk0MTg5NWU1NjFiN2NiZGI4YWY2ZjI=

data/LICENSE.MIT

@@ -0,0 +1,20 @@
+Copyright © 2013 Conrad Irwin
+Includes substantial portions of em-socksify, Copyright © 2011 Ilya Grigorik
+
+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 @@
+# EM-Connectify: Transparent CONNECT support for any EventMachine protocol
+
+Heavily based on igrigorik's [em-socksify](https://github.com/igrigorik/em-socksify), em-connectify provides a simple shim to send an eventmachine connection via an HTTP CONNECT proxy.
+
+## Example
+```ruby
+class Handler < EM::Connection
+  include EM::Connectify
+
+  def connection_completed
+    connectify('google.ca', 80) do
+      send_data "GET / HTTP/1.1\r\nConnection:close\r\nHost: google.ca\r\n\r\n"
+    end
+  end
+
+  def receive_data
+    p data
+  end
+end
+
+EM.run do
+  EventMachine.connect PROXY_HOST, PROXY_PORT, Handler
+end
+```
+
+What's happening here? First, we open a raw TCP connection to the CONNECT proxy (after all, all data will flow through it). Then, we provide a Handler connection class, which includes "EM::Connectify". Once the TCP connection is established, EventMachine calls the **connection_completed** method in our handler. Here, we call connectify with the actual destination host & port (address that we actually want to get to), and the module does the rest.
+
+After you call connectify, the module temporarily intercepts your receive_data callbacks, negotiates the connection, and then once all is done, returns the control back to your code. Simple as that.
+
+### Authorization
+
+If you need to log into your proxy server, pass the username and password to `connectify` and em-connectify will send a `Proxy-Authorization: Basic` header.
+
+```ruby
+connectify('google.ca', 80, 'username', 'password')
+```

data/em-connectify.gemspec

@@ -0,0 +1,21 @@
+Gem::Specification.new do |s|
+  s.name        = "em-connectify"
+  s.version     = "0.2"
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Conrad Irwin"]
+  s.email       = ["conrad.irwin@gmail.com"]
+  s.homepage    = "http://github.com/ConradIrwin/em-connectify"
+  s.summary     = "EventMachine CONNECTify shim: adds CONNECT support to any protocol"
+  s.description = s.summary + '.'
+  s.license     = 'MIT'
+
+  s.rubyforge_project = "em-connectify"
+
+  s.add_dependency "eventmachine", ">= 1.0.0.beta.4"
+  s.add_development_dependency "rspec"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/lib/em-connectify.rb

@@ -0,0 +1,12 @@
+require 'eventmachine'
+require 'base64'
+require File.expand_path('em-connectify/connectify.rb', File.dirname(__FILE__))
+require File.expand_path('em-connectify/connect.rb', File.dirname(__FILE__))
+require File.expand_path('em-connectify/errors.rb', File.dirname(__FILE__))
+
+unless Base64.respond_to?(:strict_encode64)
+  # Backport from ruby-1.9 to ruby-1.8 (which doesn't support pack('m0') either)
+  def Base64.strict_encode64(str)
+    Base64.encode64(str).gsub("\n", "")
+  end
+end

data/lib/em-connectify/connect.rb

@@ -0,0 +1,28 @@
+module EventMachine
+  module Connectify
+    module CONNECT
+      def connect_send_handshake
+        header =  "CONNECT #{@connect_target_host}:#{@connect_target_port} HTTP/1.0\r\n"
+        if @connect_username || @connect_password
+          encoded_credentials = Base64.strict_encode64([@connect_username, @connect_password].join(":"))
+          header << "Proxy-Authorization: Basic #{encoded_credentials}\r\n"
+        end
+
+        header << "\r\n"
+        send_data(header)
+      end
+
+      private
+
+      def connect_parse_response
+        unless @connect_data =~ %r{\AHTTP/1\.[01] 200 .*\r\n\r\n}m
+          raise CONNECTError.new, "Unexpected response: #{@connect_data}"
+        end
+
+        connect_unhook
+      rescue => e
+        @connect_deferrable.fail e
+      end
+    end
+  end
+end

data/lib/em-connectify/connectify.rb

@@ -0,0 +1,42 @@
+
+module EventMachine
+
+  module Connectify
+    def connectify(host, port, username=nil, password=nil, &blk)
+      @connect_target_host = host
+      @connect_target_port = port
+      @connect_username = username
+      @connect_password = password
+      @connect_data = ''
+
+      connect_hook
+      connect_send_handshake
+
+      @connect_deferrable = DefaultDeferrable.new
+      @connect_deferrable.callback(&blk) if blk
+      @connect_deferrable
+    end
+
+    def connect_hook
+      extend CONNECT
+
+      class << self
+        alias receive_data connect_receive_data
+      end
+    end
+
+    def connect_unhook
+      class << self
+        remove_method :receive_data
+      end
+
+      @connect_deferrable.succeed
+    end
+
+    def connect_receive_data(data)
+      @connect_data << data
+      connect_parse_response
+    end
+  end
+
+end

data/lib/em-connectify/errors.rb

@@ -0,0 +1,5 @@
+module EM
+  module Connectify
+    class CONNECTError < RuntimeError; end
+  end
+end

data/spec/connectify_spec.rb

@@ -0,0 +1,43 @@
+require File.expand_path('../lib/em-connectify', File.dirname(__FILE__))
+
+describe EventMachine do
+
+  it "should negotiate a connect connection" do
+
+    class Handler < EM::Connection
+      include EM::Connectify
+
+      def post_init
+        puts "asdhi"
+      end
+
+      def connection_completed
+        connectify('google.ca', 80, 'conrad', 'conrad') do
+          puts "ping"
+          send_data "GET / HTTP/1.1\r\nConnection:close\r\nHost: google.ca\r\n\r\n"
+        end.callback do
+          puts "ping"
+        end.errback do |e|
+          puts e
+        end
+      end
+
+      def receive_data(data)
+        @received ||= ''
+        @received << data
+      end
+
+      def unbind
+        @received.size.should > 0
+        @received[0,4].should == 'HTTP'
+        EM.stop
+      end
+    end
+
+    EM::run do
+      EventMachine.connect '127.0.0.1', 3129, Handler
+    end
+
+  end
+
+end

metadata

@@ -0,0 +1,82 @@
+--- !ruby/object:Gem::Specification
+name: em-connectify
+version: !ruby/object:Gem::Version
+  version: '0.2'
+platform: ruby
+authors:
+- Conrad Irwin
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: eventmachine
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0.beta.4
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.0.0.beta.4
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! 'EventMachine CONNECTify shim: adds CONNECT support to any protocol.'
+email:
+- conrad.irwin@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE.MIT
+- README.md
+- em-connectify.gemspec
+- lib/em-connectify.rb
+- lib/em-connectify/connect.rb
+- lib/em-connectify/connectify.rb
+- lib/em-connectify/errors.rb
+- spec/connectify_spec.rb
+homepage: http://github.com/ConradIrwin/em-connectify
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: em-connectify
+rubygems_version: 2.0.3
+signing_key: 
+specification_version: 4
+summary: ! 'EventMachine CONNECTify shim: adds CONNECT support to any protocol'
+test_files:
+- spec/connectify_spec.rb
+has_rdoc: