subtledata 0.0.2

data/lib/monkey.rb

@@ -0,0 +1,90 @@
+# module Swagger
+  class Object 
+  
+    unless Object.method_defined? :blank?
+      def blank?
+        respond_to?(:empty?) ? empty? : !self
+      end
+    end
+  
+    unless Object.method_defined? :present?
+      def present?
+        !blank?
+      end
+    end
+
+  end
+
+  class String
+
+    unless String.method_defined? :underscore
+      def underscore
+        self.gsub(/::/, '/').
+        gsub(/([A-Z]+)([A-Z][a-z])/,'\1_\2').
+        gsub(/([a-z\d])([A-Z])/,'\1_\2').
+        tr("-", "_").
+        downcase
+      end
+    end
+  
+    unless String.method_defined? :camelize
+      def camelize(first_letter_in_uppercase = true)
+        if first_letter_in_uppercase != :lower
+          self.to_s.gsub(/\/(.?)/) { "::#{$1.upcase}" }.gsub(/(?:^|_)(.)/) { $1.upcase }
+        else
+          self.to_s[0].chr.downcase + camelize(self)[1..-1]
+        end
+      end
+    end
+
+  end
+
+  class Hash
+
+    unless Hash.method_defined? :stringify_keys    
+      def stringify_keys
+        inject({}) do |options, (key, value)|
+          options[key.to_s] = value
+          options
+        end
+      end
+    end
+    
+    unless Hash.method_defined? :stringify_keys!
+      def stringify_keys!
+        self.replace(self.stringify_keys)
+      end
+    end
+
+    unless Hash.method_defined? :symbolize_keys
+      def symbolize_keys
+        inject({}) do |options, (key, value)|
+          options[(key.to_sym rescue key) || key] = value
+          options
+        end
+      end
+    end
+  
+    unless Hash.method_defined? :symbolize_keys!
+      def symbolize_keys!
+        self.replace(self.symbolize_keys)
+      end
+    end
+
+    unless Hash.method_defined? :symbolize_and_underscore_keys
+      def symbolize_and_underscore_keys
+        inject({}) do |options, (key, value)|
+          options[(key.to_s.underscore.to_sym rescue key) || key] = value
+          options
+        end
+      end
+    end
+
+    unless Hash.method_defined? :symbolize_and_underscore_keys!
+      def symbolize_and_underscore_keys!
+        self.replace(self.symbolize_and_underscore_keys)
+      end
+    end
+  
+  end
+# end

data/lib/swagger/configuration.rb

@@ -0,0 +1,19 @@
+module Swagger
+
+  class Configuration
+    require 'swagger/version'    
+    
+    attr_accessor :format, :api_key, :username, :password, :auth_token, :scheme, :host, :base_path, :user_agent, :logger
+    
+    # Defaults go in here..
+    def initialize
+      @format = 'json'
+      @scheme = 'http'
+      @host = 'api.wordnik.com'
+      @base_path = '/v4'
+      @user_agent = "ruby-#{Swagger::VERSION}"
+    end
+
+  end
+
+end

data/lib/swagger/request.rb

@@ -0,0 +1,186 @@
+module Swagger
+
+  class Request
+    require 'uri'
+    require 'addressable/uri'
+    require 'typhoeus'
+    require "swagger/version"
+
+    attr_accessor :host, :path, :format, :params, :body, :http_method, :headers
+
+
+    # All requests must have an HTTP method and a path
+    # Optionals parameters are :params, :headers, :body, :format, :host
+    # 
+    def initialize(http_method, path, attributes={})
+      attributes[:format] ||= Swagger.configuration.format
+      attributes[:params] ||= {}
+
+      # Set default headers
+      default_headers = {
+        'Content-Type' => "application/#{attributes[:format].downcase}",
+        :api_key => Swagger.configuration.api_key
+      }
+
+      # api_key from headers hash trumps the default, even if its value is blank
+      if attributes[:headers].present? && attributes[:headers].has_key?(:api_key)
+        default_headers.delete(:api_key)
+      end
+      
+      # api_key from params hash trumps all others (headers and default_headers)
+      if attributes[:params].present? && attributes[:params].has_key?(:api_key)
+        default_headers.delete(:api_key)
+        attributes[:headers].delete(:api_key) if attributes[:headers].present?
+      end
+      
+      # Merge argument headers into defaults
+      attributes[:headers] = default_headers.merge(attributes[:headers] || {})
+      
+      # Stick in the auth token if there is one
+      if Swagger.authenticated?
+        attributes[:headers].merge!({:auth_token => Swagger.configuration.auth_token})
+      end
+            
+      self.http_method = http_method.to_sym
+      self.path = path
+      attributes.each do |name, value|
+        send("#{name.to_s.underscore.to_sym}=", value)
+      end
+    end
+
+    # Construct a base URL
+    #
+    def url(options = {})  
+      u = Addressable::URI.new(
+        :scheme => Swagger.configuration.scheme,
+        :host => Swagger.configuration.host,
+        :path => self.interpreted_path,
+        :query => self.query_string.sub(/\?/, '')
+      ).to_s
+      
+      # Drop trailing question mark, if present
+      u.sub! /\?$/, ''
+      
+      # Obfuscate API key?
+      u.sub! /api\_key=\w+/, 'api_key=YOUR_API_KEY' if options[:obfuscated]
+      
+      u
+    end
+
+    # Iterate over the params hash, injecting any path values into the path string
+    #
+    # e.g. /word.{format}/{word}/entries => /word.json/cat/entries
+    def interpreted_path
+      p = self.path.dup
+
+      # Fill in the path params
+      self.params.each_pair do |key, value|
+        p = p.gsub("{#{key}}", value.to_s)
+      end
+
+      # Stick a .{format} placeholder into the path if there isn't
+      # one already or an actual format like json or xml
+      # e.g. /words/blah => /words.{format}/blah
+      unless ['.json', '.xml', '{format}'].any? {|s| p.downcase.include? s }
+        p = p.sub(/^(\/?\w+)/, "\\1.#{format}")
+      end
+
+      p = p.sub("{format}", self.format.to_s)
+      
+      URI.encode [Swagger.configuration.base_path, p].join("/").gsub(/\/+/, '/')
+    end
+  
+    # Massage the request body into a state of readiness
+    # If body is a hash, camelize all keys then convert to a json string
+    #
+    def body=(value)      
+      if value.is_a?(Hash)
+        value = value.inject({}) do |memo, (k,v)|
+          memo[k.to_s.camelize(:lower).to_sym] = v
+          memo
+        end
+      end
+      @body = value
+    end
+    
+    # If body is an object, JSONify it before making the actual request.
+    # 
+    def outgoing_body
+      body.is_a?(String) ? body : body.to_json
+    end
+    
+    # Construct a query string from the query-string-type params
+    def query_string
+
+      # Iterate over all params,
+      # .. removing the ones that are part of the path itself.
+      # .. stringifying values so Addressable doesn't blow up.
+      query_values = {}
+      self.params.each_pair do |key, value|
+        next if self.path.include? "{#{key}}"                                   # skip path params
+        next if value.blank? && value.class != FalseClass                       # skip empties
+        key = key.to_s.camelize(:lower).to_sym unless key.to_sym == :api_key    # api_key is not a camelCased param
+        query_values[key] = value.to_s
+      end
+    
+      # We don't want to end up with '?' as our query string
+      # if there aren't really any params
+      return "" if query_values.blank?
+    
+      # Addressable requires query_values to be set after initialization..
+      qs = Addressable::URI.new
+      qs.query_values = query_values
+      qs.to_s
+    end
+  
+    def make
+      logger = Logger.new STDOUT
+      logger.debug self.url
+      response = case self.http_method.to_sym
+      when :get,:GET
+        Typhoeus::Request.get(
+          self.url,
+          :headers => self.headers.stringify_keys,
+        )
+
+      when :post,:POST
+        Typhoeus::Request.post(
+          self.url,
+          :body => self.outgoing_body,
+          :headers => self.headers.stringify_keys,
+        )
+
+      when :put,:PUT
+        Typhoeus::Request.put(
+          self.url,
+          :body => self.outgoing_body,
+          :headers => self.headers.stringify_keys,
+        )
+      
+      when :delete,:DELETE
+        Typhoeus::Request.delete(
+          self.url,
+          :body => self.outgoing_body,
+          :headers => self.headers.stringify_keys,
+        )
+      end
+      Response.new(response)
+    end
+  
+    def response
+      self.make
+    end
+  
+    def response_code_pretty
+      return unless @response.present?
+      @response.code.to_s    
+    end
+  
+    def response_headers_pretty
+      return unless @response.present?
+      # JSON.pretty_generate(@response.headers).gsub(/\n/, '<br/>') # <- This was for RestClient
+      @response.headers.gsub(/\n/, '<br/>') # <- This is for Typhoeus
+    end
+
+  end
+end

data/lib/swagger/response.rb

@@ -0,0 +1,70 @@
+module Swagger
+
+  class Response
+    require 'json'
+
+    attr_accessor :raw
+
+    def initialize(raw)
+      self.raw = raw
+
+      case self.code
+      when 500..510 then raise(ServerError, self.error_message)
+      when 299..426 then raise(ClientError, self.error_message)
+      end
+    end
+
+    def code
+      raw.code
+    end
+    
+    # Account for error messages that take different forms...
+    def error_message
+      body['message']
+    rescue
+      body
+    end
+
+    # If body is JSON, parse it
+    # Otherwise return raw string
+    def body
+      JSON.parse raw.body
+    rescue
+      raw.body
+    end
+
+    # `headers_hash` is a Typhoeus-specific extension of Hash, 
+    # so simplify it back into a regular old Hash.
+    def headers
+      h = {}
+      raw.headers_hash.each {|k,v| h[k] = v }
+      h
+    end
+
+    # Extract the response format from the header hash
+    # e.g. {'Content-Type' => 'application/json'}
+    def format
+      headers['Content-Type'].split("/").last.downcase
+    end
+
+    def json?
+      format == 'json'
+    end
+
+    def xml?
+      format == 'xml'
+    end
+
+    def pretty_body
+      return unless body.present?
+      case format
+      when 'json' then JSON.pretty_generate(body).gsub(/\n/, '<br/>')
+      end
+    end
+
+    def pretty_headers
+      JSON.pretty_generate(headers).gsub(/\n/, '<br/>')
+    end
+    
+  end
+end

data/lib/swagger/version.rb

@@ -0,0 +1,5 @@
+module Swagger
+  VERSION = "4.06.08"
+end
+
+

data/lib/swagger.rb

@@ -0,0 +1,84 @@
+require 'monkey'
+require 'swagger/configuration'
+require 'swagger/request'
+require 'swagger/response'
+require 'swagger/version'
+require 'logger'
+
+module Swagger
+    
+  class << self
+    attr_accessor :logger
+    
+    # A Swagger configuration object. Must act like a hash and return sensible
+    # values for all Swagger configuration options. See Swagger::Configuration.
+    attr_accessor :configuration
+
+    attr_accessor :resources
+    
+    # Call this method to modify defaults in your initializers.
+    #
+    # @example
+    #   Swagger.configure do |config|
+    #     config.api_key = '1234567890abcdef'     # required
+    #     config.username = 'wordlover'           # optional, but needed for user-related functions
+    #     config.password = 'i<3words'            # optional, but needed for user-related functions
+    #     config.format = 'json'                  # optional, defaults to 'json'
+    #   end
+    #
+    def configure
+      self.configuration ||= Configuration.new
+      yield(configuration) if block_given?
+
+      # Configure logger.  Default to use Rails
+      self.logger ||= configuration.logger || (defined?(Rails) ? Rails.logger : Logger.new(STDOUT))
+
+      # remove :// from scheme
+      configuration.scheme.sub!(/:\/\//, '')
+
+      # remove http(s):// and anything after a slash
+      configuration.host.sub!(/https?:\/\//, '')
+      configuration.host = configuration.host.split('/').first
+
+      # Add leading and trailing slashes to base_path
+      configuration.base_path = "/#{configuration.base_path}".gsub(/\/+/, '/')
+      configuration.base_path = "" if configuration.base_path == "/"
+    end
+    
+    def authenticated?
+      Swagger.configuration.auth_token.present?
+    end
+    
+    def de_authenticate
+      Swagger.configuration.auth_token = nil
+    end
+    
+    def authenticate
+      return if Swagger.authenticated?
+      
+      if Swagger.configuration.username.blank? || Swagger.configuration.password.blank?
+        raise ClientError, "Username and password are required to authenticate."
+      end
+      
+      request = Swagger::Request.new(
+        :get, 
+        "account/authenticate/{username}", 
+        :params => {
+          :username => Swagger.configuration.username, 
+          :password => Swagger.configuration.password
+        }
+      )
+      
+      response_body = request.response.body
+      Swagger.configuration.auth_token = response_body['token']
+    end
+
+  end
+  
+end
+
+class ServerError < StandardError
+end
+
+class ClientError < StandardError
+end