ultrahook 0.1.0

data/LICENSE

@@ -0,0 +1,6 @@
+Copyright (c) 2013 Senvee Inc.
+
+Senvee Inc hereby grants you a non-exclusive commercial license to use and distribute the provided software.  You may not create derivative works of the provided 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/bin/ultrahook

@@ -0,0 +1,6 @@
+#!/usr/bin/env ruby
+$:.unshift File.expand_path('../../lib', __FILE__)
+
+require 'ultrahook'
+
+UltraHook::Client.new.start(*ARGV)

data/lib/ultrahook.rb

@@ -0,0 +1,2 @@
+require 'ultrahook/client'
+require 'ultrahook/version'

data/lib/ultrahook/client.rb

@@ -0,0 +1,170 @@
+require 'uri'
+require 'net/http'
+require 'json'
+require 'base64'
+require 'optparse'
+
+module UltraHook
+  class Client
+
+    def start(*args)
+      @options = {}
+
+      optparse = OptionParser.new do |o|
+        o.banner = "Usage: ultrahook [options] <subdomain> <destination>"
+
+        o.on("-k", "--key <api key>", String, "API Key") do |key|
+          @options["key"] =key
+        end
+
+        o.on_tail("-h", "--help", "Display this help") do
+          puts o
+          exit
+        end
+
+        o.on("-V", "--version", "Display client version") do
+          puts "UltraHook client version: #{UltraHook::VERSION}"
+          exit
+        end
+      end
+      optparse.parse!(args)
+
+      if @options["key"].nil? || @options["key"] == ""
+        @options["key"] = ENV["ULTRAHOOK_API_KEY"]
+      end
+
+      if @options["key"].nil? || @options["key"] == ""
+        path = "#{Dir.home}/.ultrahook"
+        if File.readable?(path)
+          if matchdata = /api_key:\s*([^\s]+)/.match(IO.read(path))
+            @options["key"] = matchdata.captures[0]
+          end
+        end
+      end
+
+      if @options["key"].nil? || @options["key"] == ""
+        error "An API key must be provided.  Get one from http://www.ultrahook.com"
+      end
+
+      if args.size != 2
+        puts optparse
+        exit
+      end
+
+      @options["host"] = ARGV[0].downcase
+      error "Subdomain can only contain alphanumeric characters and hyphen (-)" unless @options["host"] =~ /^[[:alnum:]\-]+$/
+      error "Subdomain cannot start or end with hyphens" if @options["host"] =~ /^\-/ || @options["host"] =~ /\-$/
+      error "Subdomain cannot contain consecutive hyphens" if @options["host"] =~ /\-\-/
+
+      @options["destination"] = parse_destination(ARGV[1])
+
+      retrieve_config
+      init_stream
+    end
+
+    def parse_destination(dest)
+      if dest =~ /^\d+/
+        "http://localhost:#{dest}"
+      elsif dest =~ /^[[:alnum:]\.\-]+:\d+$/
+        "http://#{dest}"
+      elsif dest =~ /^[[:alnum:]\.\-]+$/
+        "http://#{dest}"
+      elsif dest =~ /^http:\/\//
+        dest
+      else
+        error "Cannot parse destination url"
+      end
+    end
+
+    def process(msg)
+      begin
+        payload = JSON.parse(Base64.decode64(msg))
+      rescue
+        error "Cannot communicate with server."
+      end
+
+      method_name = "process_#{payload["type"]}"
+      send(method_name, payload) if respond_to?(method_name)
+    end
+
+    def process_init(payload)
+      puts "Forwarding activated..."
+      puts "http://#{@options["host"]}.#{@namespace}.ultrahook.com -> #{@options["destination"]}"
+    end
+
+    def process_error(payload)
+      error payload["message"]
+    end
+
+    def process_warning(payload)
+      puts "Warning: "+payload["message"]
+    end
+
+    def full_path(uri)
+      return "/" if uri.path == "" && uri.query == ""
+      return "/?#{uri.query}" if uri.path == "" && uri.query != ""
+      return "#{uri.path}" if uri.path != "" && uri.query == ""
+      return "#{uri.path}?#{uri.query}" if uri.path != "" && uri.query != ""
+      raise "huh? this is impossible!"
+    end
+
+    def process_request(payload)
+      uri = URI("#{@options["destination"]}#{payload["path"]}?#{payload["query"]}")
+      response = http_post(uri, payload["body"], payload["headers"])
+
+      puts "[#{Time.now.strftime("%Y-%m-%d %H:%M:%S")}] POST http://#{uri.host}:#{uri.port}#{full_path(uri)} - #{response.code}"
+    end
+
+    def http_post(uri, data, headers=nil)
+      Net::HTTP.new(uri.host, uri.port).post(full_path(uri), data, headers)
+    end
+
+    def retrieve_config
+      response = http_post(URI("http://www.ultrahook.com/init"), "key=#{@options["key"]}&host=#{@options["host"]}&version=#{UltraHook::VERSION}")
+
+      error "Could not retrieve config from server: #{response.code}" if response.code.to_i != 200
+
+      payload = JSON.parse(response.body)
+      if payload["success"] == true
+        @stream_url = payload["url"]
+        @namespace = payload["namespace"]
+
+        puts "Authenticated as #{@namespace}"
+      else
+        error payload["error"]
+      end
+    end
+
+    def init_stream
+      uri = URI(@stream_url)
+      Net::HTTP.start(uri.host, uri.port) do |http|
+        begin
+          request = Net::HTTP::Get.new "#{uri.path}?#{uri.query}"
+
+          http.read_timeout = 3660 # give server an extra 60 seconds to send disconnect
+          http.request request do |response|
+            io = ""
+            response.read_body do |chunk|
+              io += chunk
+
+              if idx = io.index("\n\n")
+                msg = io.slice!(0, idx+2)
+                process(msg)
+              end
+            end
+          end
+
+          error "Lost connection to UltraHook server"
+        rescue Interrupt
+          http.finish
+        end
+      end
+    end
+
+    def error(msg)
+      puts "Error: #{msg}"
+      exit -1
+    end
+  
+  end
+end

data/lib/ultrahook/version.rb

@@ -0,0 +1,3 @@
+module UltraHook
+  VERSION = "0.1.0"
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification
+name: ultrahook
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Vinay Sahni
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-15 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.8.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 1.8.0
+description: UltraHook is a simple command line tool that connects public endpoints
+  (provided by the ultrahook.com service) to private endpoints accessible from your
+  computer.  It relays any HTTP POST requests sent to the public endpoint.
+email: vinay@sahni.org
+executables:
+- ultrahook
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/ultrahook/client.rb
+- lib/ultrahook/version.rb
+- lib/ultrahook.rb
+- LICENSE
+- bin/ultrahook
+homepage: http://www.ultrahook.com
+licenses:
+- Commercial
+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.23
+signing_key: 
+specification_version: 3
+summary: A simple command line tool that enables you to receive webhooks while behind
+  firewalls
+test_files: []