daisybill_api 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 7e8269993c99548a07b1677f02fe24b0adeaaecc
+  data.tar.gz: db4a9a11d1b9809c664d96e85c4d06e65422fd79
+SHA512:
+  metadata.gz: ff52d15f1e5243952fe6dd7b479ca0e06a1b552891bae4da761a1187cfd6537e0baadf7d0260d14d7579f5fd601a720dc29c62f5d3a7b46fd1971dd107f7821f
+  data.tar.gz: c3318559d318c167a6fe403d5e72681ead3541751a5152e85d491a260f899bebfaa32f0db4396ee010ff444657be8b3151421017121456becfcb4d6f9a094b4a

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2015 DaisyBill LLC
+
+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/Rakefile

@@ -0,0 +1,20 @@
+begin
+  require 'bundler/setup'
+rescue LoadError
+  puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+require "yard"
+
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.libs << 'test'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end
+
+task default: :test

data/lib/daisybill_api.rb

@@ -0,0 +1,53 @@
+require 'daisybill_api/data'
+require 'daisybill_api/configuration'
+require 'daisybill_api/ext'
+require 'daisybill_api/models'
+
+module DaisybillApi
+  # @private
+  ROOT = File.expand_path('../..', __FILE__)
+
+  class << self
+    attr_writer :configuration
+
+
+    # Returns the current configuration
+    #
+    #   DaisybillApi.configuration
+    #   # => #<DaisybillApi::Configuration:0x007fbf85e64e88 @host="go.daisybill.com", @port=443>
+    #
+    # @return [DaisybillApi::Configuration]
+    def configuration
+      @configuration ||= DaisybillApi::Configuration.new
+    end
+
+    # Allows configuration with a block
+    #
+    #   DaisybillApi.configure do |config|
+    #     config.host = "localhost"
+    #     config.port = 3000
+    #     config.api_token = "123abc"
+    #   end
+    def configure
+      yield configuration
+    end
+
+    # Resets the configuration
+    #
+    #   DaisybillApi.configuration.host = "localhost" # => "localhost"
+    #   DaisybillApi.configuration.port = 3000        # => 3000
+    #
+    #   DaisybillApi.reset_configuration              # => nil
+    #   DaisybillApi.configuration.host               # => "go.daisybill.com"
+    #
+    # @return [nil]
+    def reset_configuration
+      @configuration = nil
+    end
+
+    # @private
+    def logger
+      configuration.logger
+    end
+  end
+end

data/lib/daisybill_api/configuration.rb

@@ -0,0 +1,46 @@
+require 'logger'
+
+module DaisybillApi
+  class Configuration
+
+    # Sets and gets the API Token
+    #
+    #   DaisybillApi.configuration.api_token                     # => "987654321zyxwvu"
+    #   DaisybillApi.configuration.api_token = "123456789abcdef" # => "123456789abcdef"
+    #   DaisybillApi.configuration.api_token                     # => "123456789abcdef"'
+    #
+    # @return [String]
+    attr_accessor :api_token
+
+    # Sets and gets the host
+    #
+    #   DaisybillApi.configuration.host               # => "go.daisybill.com"
+    #   DaisybillApi.configuration.host = "localhost" # => "localhost"
+    #   DaisybillApi.configuration.host               # => "localhost"
+    #
+    # @return [String]
+    attr_accessor :host
+
+    # Sets and gets the port
+    #
+    #   DaisybillApi.configuration.port        # => 443
+    #   DaisybillApi.configuration.port = 3000 # => 3000
+    #   DaisybillApi.configuration.port        # => 3000
+    #
+    # @return [Integer]
+    attr_accessor :port
+
+    # @private
+    attr_writer :logger
+
+    def initialize
+      @port = 443
+      @host = 'go.daisybill.com'
+    end
+
+    # @private
+    def logger
+      @logger ||= Logger.new nil
+    end
+  end
+end

data/lib/daisybill_api/data.rb

@@ -0,0 +1,7 @@
+require 'daisybill_api/data/url'
+require 'daisybill_api/data/client'
+
+module DaisybillApi
+  module Data
+  end
+end

data/lib/daisybill_api/data/client.rb

@@ -0,0 +1,66 @@
+require 'rest-client'
+require 'daisybill_api/data/rest_client/payload'
+
+module DaisybillApi
+  # @private
+  module Data
+    class Client
+      class InternalServerError < Exception; end
+
+      class UnauthorizedError < Exception; end
+
+      def self.build(method, path, params = {})
+        client = new method, path, params
+        raise InternalServerError.new(client.response['error']) if client.error?
+        raise UnauthorizedError.new(client.response['error']) if client.unauthorized?
+        client
+      end
+
+      attr_reader :response, :request, :headers
+
+      def initialize(method, path, params = {})
+        DaisybillApi.logger.info "#{method.to_s.upcase} #{path}"
+        DaisybillApi.logger.debug params.inspect
+        url = DaisybillApi::Data::Url.build(path).to_s
+        data = {
+          method: method,
+          url: url,
+          payload: params,
+          headers: { 'Content-Type' => 'application/json' }
+        }
+        RestClient::Request.execute(data) { |response, request, status|
+          @headers = response.headers
+          @response = JSON.parse response
+          @request = request
+          @status = status
+          DaisybillApi.logger.info "Response status #{self.status}"
+          DaisybillApi.logger.debug @response.inspect
+        }
+      end
+
+      def status
+        @status.code
+      end
+
+      def success?
+        status == '200' || status == '201'
+      end
+
+      def bad_request?
+        status == '400'
+      end
+
+      def unauthorized?
+        status == '401'
+      end
+
+      def not_found?
+        status == '404'
+      end
+
+      def error?
+        status == '500'
+      end
+    end
+  end
+end

data/lib/daisybill_api/data/rest_client/payload.rb

@@ -0,0 +1,30 @@
+# @private
+module RestClient
+  module Payload
+    class Base
+      def flatten_params_array(value, calculated_key)
+        result = []
+        key = "#{calculated_key}[]"
+        value.each do |elem|
+          if elem.is_a? Hash
+            result += flatten_params(elem, key)
+          elsif elem.is_a? Array
+            result += flatten_params_array(elem, key)
+          else
+            result << [key, elem]
+          end
+        end
+        result
+      end
+    end
+
+    class UrlEncoded
+      def build_stream(params = nil)
+        @stream = StringIO.new(flatten_params(params).collect do |entry|
+            entry[1].nil? ? entry[0] : "#{entry[0]}=#{handle_key(entry[1])}"
+          end.join("&"))
+        @stream.seek(0)
+      end
+    end
+  end
+end

data/lib/daisybill_api/data/url.rb

@@ -0,0 +1,26 @@
+require 'uri/http'
+
+module DaisybillApi
+  module Data
+    module Url
+      DEFAULT_PATH = '/api/v1'
+
+      class << self
+        def build(path, params = {})
+          port = DaisybillApi.configuration.port
+          builder = port == 443 ? URI::HTTPS : URI::HTTP
+          builder.build({
+              host: DaisybillApi.configuration.host,
+              port: port,
+              path: "#{DEFAULT_PATH}#{path}",
+              query: to_query(params.merge api_token: DaisybillApi.configuration.api_token)
+            })
+        end
+
+        def to_query(hash)
+          URI.encode_www_form hash
+        end
+      end
+    end
+  end
+end

data/lib/daisybill_api/ext.rb

@@ -0,0 +1,20 @@
+require 'daisybill_api/ext/attributes'
+require 'daisybill_api/ext/links'
+require 'daisybill_api/ext/crud'
+require 'daisybill_api/ext/associations'
+require 'daisybill_api/ext/pageable_collection'
+
+module DaisybillApi
+  module Ext
+    class << self
+      def extended(base)
+        base.class_eval do
+          include DaisybillApi::Ext::Attributes
+          include DaisybillApi::Ext::Links
+          include DaisybillApi::Ext::CRUD
+          include DaisybillApi::Ext::Associations
+        end
+      end
+    end
+  end
+end

data/lib/daisybill_api/ext/associations.rb

@@ -0,0 +1,39 @@
+module DaisybillApi
+  module Ext
+    # @private
+    module Associations
+      module ClassMethods #TODO: Think about creating Association classes or Routing class
+        def foreign_key=(value)
+          @foreign_key = value
+        end
+
+        def foreign_key
+          @foreign_key
+        end
+
+        def has_many(name, options = {})
+          clazz = modulize options[:class]
+          define_method name do |params = {}|
+            params.merge!(:"#{self.class.singular_key}_id" => self.id)
+            clazz.constantize.all(params)
+          end
+        end
+
+        private
+
+        def modulize(name)
+          "DaisybillApi::Models::#{name}"
+        end
+      end
+
+      def self.included(base)
+        base.class_eval do
+          include DaisybillApi::Ext::Associations::InstanceMethods
+          extend DaisybillApi::Ext::Associations::ClassMethods
+        end
+      end
+
+      module InstanceMethods; end
+    end
+  end
+end

data/lib/daisybill_api/ext/attributes.rb

@@ -0,0 +1,103 @@
+require 'daisybill_api/ext/attributes/type_castings'
+require 'daisybill_api/ext/attributes/attribute'
+
+module DaisybillApi
+  module Ext
+    # @private
+    module Attributes
+      module ClassMethods
+        def attribute(name, type, options = {})
+          attrs[name.to_s] = Attribute.new(name, type, options)
+          class_eval do
+            define_method(name) { read_attribute name }
+            define_method(:"#{name}=") { |value| write_attribute name, value }
+          end
+        end
+
+        def attributes(attrs)
+          options = extract_options(attrs)
+          attrs.each { |name, type| attribute(name, type, options) }
+          attribute :created_at, :datetime, readonly: true
+          attribute :updated_at, :datetime, readonly: true
+        end
+
+        def attrs
+          @attrs ||= {}
+        end
+
+        def inspect
+          "<#{name} #{attrs.map{ |k, v| "#{k}: #{v.type}"}.join(', ')}>"
+        end
+
+        private
+
+        OPTION_KEYS = [:readonly]
+
+        def extract_options(attributes)
+          OPTION_KEYS.each_with_object({}) { |key, result|
+            result[key] = attributes.delete key
+          }
+        end
+      end
+
+      module InstanceMethods
+        def initialize(attributes = {})
+          class_attrs.each { |a| attrs[a.name.to_sym] = a.clone }
+          self.attributes = attributes
+        end
+
+        def attributes
+          class_attrs.each_with_object({}) { |attr, result|
+            result[attr.name] = read_attribute(attr.name)
+          }
+        end
+
+        def attributes=(attributes)
+          attributes.each { |name, value|
+            if attrs[name.to_sym]
+              write_attribute name, value
+            else
+              message = "Was trying to set non-existent attribute #{name.inspect} to #{value.inspect}"
+              DaisybillApi.logger.debug message
+            end
+          }
+        end
+
+        def to_params
+          attrs.values.each_with_object({}) { |attr, result|
+            result.merge! attr.to_param
+          }
+        end
+
+        def inspect
+          "<#{self.class.name} #{attributes.map { |k, v| "#{k}: #{v.inspect}" }.join(', ')}>"
+        end
+
+        private
+
+        def read_attribute(name)
+          attrs[name.to_sym].value
+        end
+
+        def write_attribute(name, value)
+          attrs[name.to_sym].value = value
+        end
+
+        def class_attrs
+          @class_attrs ||= self.class.attrs.values
+        end
+
+        def attrs
+          @attrs ||= {}
+        end
+      end
+
+      def self.included(base)
+        base.class_eval do
+          include DaisybillApi::Ext::Attributes::InstanceMethods
+          extend DaisybillApi::Ext::Attributes::ClassMethods
+        end
+      end
+    end
+  end
+end