xio 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d91bf05d24c78225d24b871a651e2f16490511ca
+  data.tar.gz: 8a56ae6132b59d92996366886053334c1ed7e2a3
+SHA512:
+  metadata.gz: d6f622fd3c7eea662a7baff03a2e87ea01a199dbd0e19fc37c1c88cdb18b65f990f62e7b7fece4a9bb9feee32be152bb3124ca6863c09a46b37c870fa51889dc
+  data.tar.gz: eac7810ffdf6f92d795721d6cd589689c70fd67ac352447fcce773ce8f42ddbecb1368dfee40b910f1379ef53a081cf821ac02ad8fc28443e25f279bc7a582df

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (C) 2014 OTOY, Inc.
+
+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.markdown

@@ -0,0 +1,3 @@
+# X.IO
+
+This needs to be filled out...

data/Rakefile

@@ -0,0 +1,11 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/*_test.rb'
+  test.verbose = true
+end
+
+task :default => :test

data/lib/xio.rb

@@ -0,0 +1,20 @@
+# Standard Library
+require 'cgi'
+require 'net/https'
+require 'timeout'
+
+# JSON serialization
+require 'multi_json'
+
+# X.IO
+require 'xio/version'
+require 'xio/serializer'
+require 'xio/xio'
+require 'xio/resource'
+require 'xio/http/net_http'
+require 'xio/http/typhoeus'
+require 'xio/http'
+require 'xio/errors'
+require 'xio/stream'
+require 'xio/response'
+require 'xio/version'

data/lib/xio/errors.rb

@@ -0,0 +1,45 @@
+module Xio
+  class Error < StandardError
+
+    def initialize(error_or_message)
+      if error_or_message.is_a?(Exception)
+        @error = error_or_message
+      else
+        @message = error_or_message
+      end
+    end
+
+    def message
+      @message || "#{@error.class} (wrapped in a #{self.class}) - #{@error.message}"
+    end
+
+    def backtrace
+      if @error
+        error_backtrace = ["--- Backtrace from #{@error.class} ---"] + (@error.backtrace || [])
+        wrapper_backtrace = ["--- Backtrace from #{self.class} ---"] + (super || [])
+        error_backtrace + wrapper_backtrace
+      else
+        super
+      end
+    end
+
+    def inspect
+      if @error
+        "#{@error.inspect} (wrapped in a #{self.class})"
+      else
+        super
+      end
+    end
+
+    def to_s
+      if @error
+        "#{@error.class} (wrapped in a #{self.class}) - #{@error}"
+      else
+        super
+      end
+    end
+  end
+
+  class HTTPError < Error; end
+
+end

data/lib/xio/http.rb

@@ -0,0 +1,99 @@
+module Xio
+  class HTTP
+
+    include Xio::Serializer
+
+    attr_accessor :url, :options, :method
+
+    class << self
+      attr_accessor :default_options, :http_backend
+    end
+
+    self.http_backend = NetHTTP
+
+    self.default_options = {:timeout => 60000,
+                            :headers => {'Accept'       => 'application/json',
+                                         'Content-Type' => 'application/json',
+                                         'User-Agent'   => "Xio-rb v#{Xio::GEM_VERSION}"}}
+
+    def initialize(method, url, options={})
+      self.method  = method
+      self.url     = url
+      self.options = options
+    end
+
+    def self.post(url, body, options={})
+      new(:post, url, options.merge(:body => body)).perform_method
+    end
+
+    def self.put(url, body, options={})
+      new(:put, url, options.merge(:body => body)).perform_method
+    end
+
+    def self.get(url, options={})
+      new(:get, url, options).perform_method
+    end
+
+    def self.delete(url, options={})
+      new(:delete, url, options).perform_method
+    end
+
+    def perform_method
+      process(http_backend.send(method, url, options))
+    rescue StandardError => e
+      raise HTTPError.new(e)
+    end
+
+    def options=(value)
+      value ||= {}
+
+      # Hacky, deeper hash merge
+      default_options.keys.each do |key|
+        if value.has_key?(key)
+          if value[key].is_a?(Hash) && default_options[key].is_a?(Hash)
+            value[key] = default_options[key].merge(value[key])
+          end
+        else
+          value[key] = default_options[key]
+        end
+      end
+
+      @options = value
+    end
+
+    def options
+      @options || self.options = default_options
+    end
+
+    def http_backend
+      self.class.http_backend
+    end
+
+    def default_options
+      self.class.default_options
+    end
+
+    def inspect
+      "#{method.to_s.upcase} #{url}\nOptions: " + options.inspect
+    end
+
+  protected
+
+    def process(http_response)
+      response = Response.new
+      response.request = self
+      response.code = http_response.code
+
+      begin
+        response.body = decode(http_response.body.to_s)
+      rescue StandardError # Hack! Returns different exceptions depending on the decoding engine
+        response.body = http_response.body
+      end
+
+      response.raw_body = http_response.body
+      response.raw_response = http_response
+      response
+    end
+
+  end
+end

data/lib/xio/http/net_http.rb

@@ -0,0 +1,132 @@
+module Xio
+  class HTTP
+    class NetHTTP
+
+      attr_accessor :method, :url, :uri, :body, :params, :headers, :timeout, :skip_ssl_verify, :options, :ca_file, :ca_path
+
+      def initialize(method, url, options)
+        @method          = method
+        @url             = url
+        @options         = options.dup
+        @body            = @options.delete(:body)
+        @params          = @options.delete(:params)
+        @headers         = @options.delete(:headers)
+        @timeout         = @options.delete(:timeout)
+        @skip_ssl_verify = @options.delete(:skip_ssl_verify)
+        @ca_file         = @options.delete(:ca_file)
+        @ca_path         = @options.delete(:ca_path)
+      end
+
+      def self.post(url, options={})
+        new(:post, url, options).perform
+      end
+
+      def self.put(url, options={})
+        new(:put, url, options).perform
+      end
+
+      def self.get(url, options={})
+        new(:get, url, options).perform
+      end
+
+      def self.delete(url, options={})
+        new(:delete, url, options).perform
+      end
+
+      def perform
+        deliver(http, request)
+      end
+
+
+    protected
+
+      def deliver(http, request)
+        if timeout
+          Timeout.timeout(timeout / 1000.0) do
+            http.request(request)
+          end
+        else
+          http.request(request)
+        end
+      end
+
+      def http
+        u = uri
+
+        http = Net::HTTP.new(u.host, u.port)
+
+        if u.scheme == 'https'
+          http.use_ssl = true
+
+          if skip_ssl_verify
+            http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+          else
+            http.verify_mode = OpenSSL::SSL::VERIFY_PEER
+
+            http.cert_store = OpenSSL::X509::Store.new
+            http.cert_store.set_default_paths
+
+            if defined?(OpenSSL::X509::V_FLAG_CRL_CHECK_ALL)
+              http.cert_store.flags = OpenSSL::X509::V_FLAG_CRL_CHECK_ALL
+            end
+
+            http.cert_store.add_file(ca_file) if ca_file
+            http.cert_store.add_path(ca_path) if ca_path
+          end
+        end
+
+        http
+      end
+
+      def request
+        r = request_class.new(path)
+        if body
+          r.body = body
+        elsif [:post, :put].include?(@method)
+          r.body = ""
+        end
+
+        if headers
+          headers.each do |header, value|
+            r.add_field(header.to_s, value.to_s)
+          end
+        end
+        r
+      end
+
+      def uri
+        u = URI.parse(url)
+
+        if params
+          params_as_query = params.map{|k,v| "#{CGI.escape(k.to_s)}=#{CGI.escape(v.to_s)}"}.join('&')
+          if u.query.to_s.empty?
+            u.query = params_as_query
+          else
+            u.query = [u.query.to_s, params_as_query].join('&')
+          end
+        end
+
+        u
+      end
+
+      def path
+        u = uri
+
+        if u.path.empty?
+          u.path = '/'
+        end
+
+        if u.query.to_s.empty?
+          u.path
+        else
+          u.path + '?' + u.query.to_s
+        end
+      end
+
+      def request_class
+        Net::HTTP.const_get(method.to_s.capitalize)
+      end
+
+    end
+  end
+end

data/lib/xio/http/typhoeus.rb

@@ -0,0 +1,40 @@
+module Xio
+  class HTTP
+    class Typhoeus
+
+      def self.post(url, options={})
+        perform(:post, url, options)
+      end
+
+      def self.put(url, options={})
+        perform(:put, url, options)
+      end
+
+      def self.get(url, options={})
+        perform(:get, url, options)
+      end
+
+      def self.delete(url, options={})
+        perform(:delete, url, options)
+      end
+
+      def self.perform(method, url, options={})
+        options = options.dup
+        if options.delete(:skip_ssl_verify)
+          options[:disable_ssl_peer_verification] = true
+        end
+
+        if ca_file = options.delete(:ca_file)
+          options[:sslcert] = ca_file
+        end
+
+        if ca_path = options.delete(:ca_path)
+          options[:capath] = ca_path
+        end
+
+        ::Typhoeus::Request.send(method, url, options)
+      end
+
+    end
+  end
+end

data/lib/xio/resource.rb

@@ -0,0 +1,77 @@
+module Xio
+  class Resource
+
+    include Xio::Serializer
+
+    def self.api_key_id
+      Xio.api_key_id
+    end
+
+    def self.api_secret_key
+      Xio.api_secret_key
+    end
+
+    def self.base_url
+      Xio.base_url
+    end
+
+    def self.post(path, params={}, options={})
+      options = options.dup
+      url     = url_for(path, options)
+      body    = encode(params)
+      options = add_api_key_header(options)
+      HTTP.post(url, body, options)
+    end
+
+    def self.put(path, params={}, options={})
+      options = options.dup
+      url     = url_for(path, options)
+      body    = encode(params)
+      options = add_api_key_header(options)
+      HTTP.put(url, body, options)
+    end
+
+    def self.get(path, options={})
+      options = options.dup
+      url     = url_for(path, options)
+      options = add_api_key_header(options)
+      HTTP.get(url, options)
+    end
+
+    def self.delete(path, options={})
+      options = options.dup
+      url     = url_for(path)
+      options = add_api_key_header(options)
+      HTTP.delete(url, options)
+    end
+
+
+  protected
+
+    def self.url_for(path, options={})
+      File.join((options[:base_url] || base_url).to_s, path.to_s)
+    end
+
+    def self.add_api_key_header(options)
+      if options[:headers]
+        options[:headers] = options[:headers].dup
+      else
+        options[:headers] = {}
+      end
+      options[:headers]["XIO-API-Key-ID"] = api_key_id
+      options[:headers]["XIO-API-Secret-Key"] = api_secret_key
+
+      options
+    end
+
+    def self.merge_params(options, params)
+      if options[:params]
+        options[:params] = options[:params].merge(params)
+        options
+      else
+        options.merge(:params => params)
+      end
+    end
+
+  end
+end

data/lib/xio/response.rb

@@ -0,0 +1,33 @@
+module Xio
+  class Response
+
+    attr_accessor :request, :code, :body, :raw_body, :raw_response
+
+    def initialize(options={})
+      options.each do |k, v|
+        send("#{k}=", v) if respond_to?("#{k}=")
+      end
+    end
+
+    def success?
+      code.to_i > 199 && code.to_i < 300
+    end
+
+    def errors
+      if body.is_a?(Hash)
+        Array(body['errors']).compact
+      else
+        []
+      end
+    end
+
+    def body_without_wrapper
+      if body.is_a?(Hash) && body['api_response']
+        body['api_response']
+      else
+        body
+      end
+    end
+
+  end
+end

data/lib/xio/serializer.rb

@@ -0,0 +1,35 @@
+module Xio
+  module Serializer
+
+    extend self
+
+    def self.included(klass)
+      klass.extend(self)
+    end
+
+    def encode(content)
+      if content.is_a?(String) || content.nil?
+        content
+      else
+        if MultiJson.respond_to?(:dump)
+          MultiJson.dump(content)
+        else
+          MultiJson.encode(content)
+        end
+      end
+    end
+
+    def decode(content)
+      if content.is_a?(String)
+        if MultiJson.respond_to?(:dump)
+          MultiJson.load(content)
+        else
+          MultiJson.decode(content)
+        end
+      else
+        content
+      end
+    end
+
+  end
+end

data/lib/xio/stream.rb

@@ -0,0 +1,17 @@
+module Xio
+  class Stream < Resource
+
+    def self.create(params={}, options={})
+      post("/streams", params, options)
+    end
+
+    def self.details(stream_id, options={})
+      get("/streams/#{stream_id}", options)
+    end
+
+    def self.terminate(stream_id, options={})
+      delete("/streams/#{stream_id}", nil, options)
+    end
+
+  end
+end

data/lib/xio/version.rb

@@ -0,0 +1,3 @@
+module Xio
+  GEM_VERSION = '1.0.0'
+end

data/lib/xio/xio.rb

@@ -0,0 +1,23 @@
+module Xio
+
+  class << self
+    attr_accessor :api_key_id, :api_secret_key, :base_url
+  end
+
+  self.api_key_id     = nil
+  self.api_secret_key = nil
+  self.base_url       = 'https://api.x.io/v1'
+
+  def self.api_key_id
+    @api_key_id || ENV['XIO_API_KEY_ID']
+  end
+
+  def self.api_secret_key
+    @api_secret_key || ENV['XIO_API_SECRET_KEY']
+  end
+
+  def self.base_url(env=nil)
+    @base_url
+  end
+
+end

metadata

@@ -0,0 +1,70 @@
+--- !ruby/object:Gem::Specification
+name: xio
+version: !ruby/object:Gem::Version
+  version: 1.0.0
+platform: ruby
+authors:
+- Mike Christopher
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: multi_json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: X.IO <http://x.io> integration library.
+email: help@x.io
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- LICENSE
+- README.markdown
+- Rakefile
+- lib/xio.rb
+- lib/xio/errors.rb
+- lib/xio/http.rb
+- lib/xio/http/net_http.rb
+- lib/xio/http/typhoeus.rb
+- lib/xio/resource.rb
+- lib/xio/response.rb
+- lib/xio/serializer.rb
+- lib/xio/stream.rb
+- lib/xio/version.rb
+- lib/xio/xio.rb
+homepage: https://github.com/appslingr/xio-rb
+licenses: []
+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: xio
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: X.IO <http://x.io> integration library.
+test_files: []