square 0.0.0 → 0.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4af0de4c8ca0b30d6a9016dbaeca0c1e14150972
-  data.tar.gz: 3ffac80d44746f500bf5eca525a389ddf517ef41
+  metadata.gz: 51faae3f912bb913a6fe96bba108f96c8bd1c7a9
+  data.tar.gz: a9965b78a6b816ba7c917c031708cae7ed167ca3
 SHA512:
-  metadata.gz: bafabb5eb1c1ac1b01212f305bca5874a8776ac784488dbfa78eca0c62388c3936b53075fab524114baafb7f3b12eeb014447182cf6ac31b0bc31eff181cc9d3
-  data.tar.gz: 90090c0b2c93cf236723178e37f50ae7ee39ba9ad79e186fbae523fe2b747dfc58b0c19e12d461aec9767531b4a1cb679ba0a504a2c14281443dda84dd60c44e
+  metadata.gz: 29c980d752c6233bfdcf61944a0a9f1ef8067aae82bb32e4a96de13f5e6cf16eeec74ee7821c08e46ec416dbe9bb1280f7d1955effa3392d8fff86a37d334ec9
+  data.tar.gz: 7bdf1820ef76298b907e3f41dd7daf52151915445dd2ece4a049d050c8eb9c49b94bc8b28e72b54e6384e80cf2731afd47a98ea1c8f6f6da2794a40543f4de83

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--format=documentation

data/Rakefile

@@ -1 +1,18 @@
 require "bundler/gem_tasks"
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+namespace :cover_me do
+  desc "Generates and opens code coverage report."
+  task :report do
+    require 'cover_me'
+    CoverMe.complete!
+  end
+end
+
+task :spec do
+  Rake::Task['cover_me:report'].invoke unless ENV['TRAVIS_RUBY_VERSION']
+end
+
+task :default => :spec

data/VERSION

@@ -1 +1 @@
-0.0.0
+0.0.1

data/lib/square.rb

@@ -1,3 +1,8 @@
+require 'rack/oauth2'
+
 module Square
-  # Your code goes here...
 end
+
+require 'square/exception'
+require 'square/oauth2'
+require 'square/connect'

data/lib/square/connect.rb

@@ -0,0 +1,15 @@
+module Square
+  module Connect
+    ROOT_URL = 'https://connect.squareup.com/v1'
+  end
+end
+
+require 'square/connect/error'
+require 'square/connect/node'
+
+require 'square/connect/device'
+require 'square/connect/itemization'
+require 'square/connect/money'
+require 'square/connect/refund'
+require 'square/connect/tax'
+require 'square/connect/tender'

data/lib/square/connect/connections.rb

@@ -0,0 +1,10 @@
+module Square
+  module Connect
+    module Connections
+    end
+  end
+end
+
+Dir[File.dirname(__FILE__) + '/connections/*.rb'].each do |file|
+  require file
+end

data/lib/square/connect/connections/bank_accounts.rb

@@ -0,0 +1,8 @@
+module Square
+  module Connect
+    module Connections
+      module BankAccounts
+      end
+    end
+  end
+end

data/lib/square/connect/connections/payments.rb

@@ -0,0 +1,19 @@
+module Square
+  module Connect
+    module Connections
+      module Payments
+        def payments
+          access_token_required!
+          payments = handle_response do
+            access_token.get endpoint_for(identifier, :payments)
+          end
+          payments.collect do |payment|
+            Payment.new payment.merge(
+              access_token: access_token
+            )
+          end
+        end
+      end
+    end
+  end
+end

data/lib/square/connect/connections/refunds.rb

@@ -0,0 +1,8 @@
+module Square
+  module Connect
+    module Connections
+      module Refunds
+      end
+    end
+  end
+end

data/lib/square/connect/connections/settlements.rb

@@ -0,0 +1,8 @@
+module Square
+  module Connect
+    module Connections
+      module Settlements
+      end
+    end
+  end
+end

data/lib/square/connect/device.rb

@@ -0,0 +1,12 @@
+module Square
+  module Connect
+    class Device
+      attr_accessor :identifier, :name
+
+      def initialize(attributes = {})
+        self.identifier = attributes[:id]
+        self.name = attributes[:name]
+      end
+    end
+  end
+end

data/lib/square/connect/error.rb

@@ -0,0 +1,13 @@
+module Square
+  module Connect
+    class Error < StandardError
+      attr_accessor :status, :type
+
+      def initialize(status, error)
+        self.status = status
+        self.type = error[:type]
+        super error[:message]
+      end
+    end
+  end
+end

data/lib/square/connect/itemization.rb

@@ -0,0 +1,11 @@
+module Square
+  module Connect
+    class Itemization
+      attr_accessor :name, :quantity, :item_detail, :notes, :item_variation_name, :total_money, :single_quantity_money, :gross_sales_money, :discount_money, :taxes, :discounts
+
+      def initialize(attributes = {})
+        # TODO
+      end
+    end
+  end
+end

data/lib/square/connect/merchant.rb

@@ -0,0 +1,29 @@
+require 'square/connect/connections'
+
+module Square
+  module Connect
+    class Merchant < Node
+      include Connections::Payments
+      include Connections::Refunds
+      include Connections::Settlements
+      include Connections::BankAccounts
+
+      attr_accessor :name, :email, :country_code, :language_code
+
+      def initialize(*args)
+        super do |attributes|
+          self.name = attributes[:name]
+          self.email = attributes[:email]
+          self.country_code = attributes[:country_code]
+          self.language_code = attributes[:language_code]
+        end
+      end
+
+      class << self
+        def me(access_token)
+          new :me, access_token
+        end
+      end
+    end
+  end
+end

data/lib/square/connect/money.rb

@@ -0,0 +1,12 @@
+module Square
+  module Connect
+    class Money
+      attr_accessor :amount, :currency_code
+
+      def initialize(attributes = {})
+        self.amount = attributes[:amount]
+        self.currency_code = attributes[:currency_code]
+      end
+    end
+  end
+end

data/lib/square/connect/node.rb

@@ -0,0 +1,79 @@
+module Square
+  module Connect
+    class Node
+      attr_accessor :identifier, :endpoint, :access_token
+
+      def initialize(*args)
+        attributes = args.extract_options!
+        self.identifier = attributes[:id] || attributes[:identifier] || args.first
+        self.access_token = tokenize attributes[:access_token] || args.second
+        self.endpoint = endpoint_for identifier
+        yield attributes if block_given?
+      end
+
+      def fetch
+        access_token_required!
+        attributes = handle_response do
+          access_token.get endpoint
+        end
+        self.class.new attributes.merge(
+          access_token: access_token
+        )
+      end
+
+      private
+
+      def access_token_required!
+        raise Exception.new('access_token required') unless access_token
+      end
+
+      def endpoint_for(*path_elements)
+        File.join ROOT_URL, *path_elements.collect(&:to_s)
+      end
+
+      def tokenize(access_token)
+        case access_token
+        when OAuth2::AccessToken
+          access_token
+        when String
+          OAuth2::AccessToken.new access_token
+        end
+      end
+
+      def handle_response
+        response = yield
+        case response.status
+        when 200..201
+          handle_success_response response
+        else
+          handle_error_response response
+        end
+      end
+
+      def handle_success_response(response)
+        parse_json response.body
+      end
+
+      def handle_error_response(response)
+        error = parse_json response.body
+        raise Error.new(response.status, error)
+      end
+
+      def parse_json(raw_json)
+        json = MultiJson.load(raw_json)
+        case json
+        when Hash
+          json.with_indifferent_access
+        when Array
+          json.collect(&:with_indifferent_access)
+        else
+          {}
+        end
+      end
+    end
+  end
+end
+
+require 'square/connect/connections'
+require 'square/connect/merchant'
+require 'square/connect/payment'

data/lib/square/connect/payment.rb

@@ -0,0 +1,75 @@
+module Square
+  module Connect
+    class Payment < Node
+      attr_accessor(
+        :merchant,
+        :creator,
+        :created_at,
+        :description,
+        :device,
+        :inclusive_tax_money,
+        :additive_tax_money,
+        :tax_money,
+        :tip_money,
+        :discount_money,
+        :total_collected_money,
+        :processing_fee_money,
+        :net_total_money,
+        :refunded_money,
+        :inclusive_tax,
+        :additive_tax,
+        :tender,
+        :refunds,
+        :itemizations
+      )
+
+      def initialize(*args)
+        super do |attributes|
+          self.merchant = attributes[:merchant] || Merchant.new(attributes[:merchant_id] || :me)
+          self.creator = attributes[:creator] || attributes[:creator_id] && Merchant.new(attributes[:creator_id])
+          self.created_at = if attributes[:created_at]
+            Time.parse attributes[:created_at]
+          end
+          self.description = attributes[:description]
+          self.device = if attributes[:device].present?
+            Device.new attributes[:device]
+          end
+          [
+            :inclusive_tax_money,
+            :additive_tax_money,
+            :tax_money,
+            :tip_money,
+            :discount_money,
+            :total_collected_money,
+            :processing_fee_money,
+            :net_total_money,
+            :refunded_money
+          ].each do |money_key|
+            if attributes[money_key].present?
+              self.send "#{money_key}=", Money.new(attributes[money_key])
+            end
+          end
+          [
+            :inclusive_tax,
+            :additive_tax
+          ].each do |tax_key|
+            taxes = Array(attributes[tax_key]).collect do |tax_attributes|
+              Tax.new tax_attributes
+            end
+            self.send "#{tax_key}=", taxes
+          end
+          self.tender = Array(attributes[:tender]).collect do |tender_attributes|
+            Tender.new tender_attributes
+          end
+          self.refunds = Array(attributes[:refunds]).collect do |refund_attributes|
+            Refund.new refund_attributes
+          end
+          self.itemizations = Array(attributes[:itemizations]).collect do |itemization_attributes|
+            Itemization.new itemization_attributes
+          end
+          self.endpoint = endpoint_for merchant.identifier, :payments, identifier
+        end
+      end
+    end
+  end
+end

data/lib/square/connect/refund.rb

@@ -0,0 +1,26 @@
+module Square
+  module Connect
+    class Refund < Node
+      attr_accessor :type, :reason, :refunded_money, :created_at, :processed_at, :payment
+
+      def initialize(*args)
+        super do |attributes|
+          self.type = attributes[:type]
+          self.reason = attributes[:reason]
+          self.refunded_money = if attributes[:refunded_money].present?
+            Money.new attributes[:refunded_money]
+          end
+          [
+            :created_at,
+            :processed_at
+          ].each do |time_key|
+            if attributes[time_key]
+              self.send "#{time_key}=", Time.parse(attributes[time_key])
+            end
+          end
+          self.payment = attributes[:payment] || attributes[:payment_id] && Payment.new(attributes[:payment_id])
+        end
+      end
+    end
+  end
+end

data/lib/square/connect/tax.rb

@@ -0,0 +1,16 @@
+module Square
+  module Connect
+    class Tax
+      attr_accessor :name, :applied_money, :rate, :inclusion_type
+
+      def initialize(attributes = {})
+        self.name = attributes[:name]
+        self.applied_money = if attributes[:applied_money].present?
+          Money.new attributes[:applied_money]
+        end
+        self.rate = attributes[:rate]
+        self.inclusion_type = attributes[:inclusion_type]
+      end
+    end
+  end
+end

data/lib/square/connect/tender.rb

@@ -0,0 +1,25 @@
+module Square
+  module Connect
+    class Tender
+      attr_accessor :type, :name, :card_brand, :pan_suffix, :entry_method, :payment_note, :total_money, :tendered_money, :change_back_money
+
+      def initialize(attributes = {})
+        self.type = attributes[:type]
+        self.name = attributes[:name]
+        self.card_brand = attributes[:card_brand]
+        self.pan_suffix = attributes[:pan_suffix]
+        self.entry_method = attributes[:entry_method]
+        self.payment_note = attributes[:payment_note]
+        [
+          :total_money,
+          :tendered_money,
+          :change_back_money
+        ].each do |money_attr|
+          if attributes[money_attr].present?
+            self.send "#{money_attr}=", Money.new(attributes[money_attr])
+          end
+        end
+      end
+    end
+  end
+end

data/lib/square/exception.rb

@@ -0,0 +1,4 @@
+module Square
+  class Exception < StandardError
+  end
+end