initial commit

Author: buzz1710

.gitignore

@@ -0,0 +1,15 @@
+/.bundle/
+/.yardoc
+/Gemfile.lock
+/_yardoc/
+/coverage/
+/doc/
+/pkg/
+/spec/reports/
+/tmp/
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log
+.DS_Store

.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

Gemfile

@@ -0,0 +1,12 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in sageone.gemspec
+gemspec
+
+group :test do
+  gem "guard-rspec", require: false
+  gem 'webmock'
+  gem 'pry'
+  gem 'simplecov'
+  gem 'vcr'
+end

Guardfile

@@ -0,0 +1,33 @@
+# A sample Guardfile
+# More info at https://github.com/guard/guard#readme
+
+# Note: The cmd option is now required due to the increasing number of ways
+#       rspec may be run, below are examples of the most common uses.
+#  * bundler: 'bundle exec rspec'
+#  * bundler binstubs: 'bin/rspec'
+#  * spring: 'bin/rsspec' (This will use spring if running and you have
+#                          installed the spring binstubs per the docs)
+#  * zeus: 'zeus rspec' (requires the server to be started separetly)
+#  * 'just' rspec: 'rspec'
+guard :rspec, cmd: 'bundle exec rspec' do
+  watch(%r{^spec/.+_spec\.rb$})
+  watch(%r{^lib/(.+)\.rb$})     { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch('spec/spec_helper.rb')  { "spec" }
+
+  # Rails example
+  watch(%r{^app/(.+)\.rb$})                           { |m| "spec/#{m[1]}_spec.rb" }
+  watch(%r{^app/(.*)(\.erb|\.haml|\.slim)$})          { |m| "spec/#{m[1]}#{m[2]}_spec.rb" }
+  watch(%r{^app/controllers/(.+)_(controller)\.rb$})  { |m| ["spec/routing/#{m[1]}_routing_spec.rb", "spec/#{m[2]}s/#{m[1]}_#{m[2]}_spec.rb", "spec/acceptance/#{m[1]}_spec.rb"] }
+  watch(%r{^spec/support/(.+)\.rb$})                  { "spec" }
+  watch('config/routes.rb')                           { "spec/routing" }
+  watch('app/controllers/application_controller.rb')  { "spec/controllers" }
+  watch('spec/rails_helper.rb')                       { "spec" }
+
+  # Capybara features specs
+  watch(%r{^app/views/(.+)/.*\.(erb|haml|slim)$})     { |m| "spec/features/#{m[1]}_spec.rb" }
+
+  # Turnip features and steps
+  watch(%r{^spec/acceptance/(.+)\.feature$})
+  watch(%r{^spec/acceptance/steps/(.+)_steps\.rb$})   { |m| Dir[File.join("**/#{m[1]}.feature")][0] || 'spec/acceptance' }
+end
+

LICENSE

@@ -20,4 +20,3 @@ 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.
-

README.md

@@ -0,0 +1,55 @@
+# SageoneSdk
+
+The `sageone_sdk` gem provides Ruby methods for accessing the Sage One API endpoints.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'sageone_sdk'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install sageone_sdk
+
+## Usage
+
+To create a `SageoneSdk::Client`, you need to provide your access_token and signing_secret:
+
+```
+@client = SageoneSdk::Client.new({access_token: @access_token,
+                                  signing_secret: @signing_secret})
+```
+
+Further information about obtaining these is available [here](https://developers.sageone.com/docs/en/v1#overview).
+
+You can then call the required method on the `@client`:
+
+```
+@client.bank_accounts
+=> #<SageoneSdk::SDataResponse:0x007faaa9eb1760
+   @data=
+    {"$totalResults"=>2,
+     "$startIndex"=>0,
+     "$itemsPerPage"=>20,
+     "$resources"=>
+      [{"id"=>214227,
+        "account_name"=>"Current",
+        #...}]
+    }>
+```
+
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/sageone/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

Rakefile

@@ -0,0 +1,2 @@
+require "bundler/gem_tasks"
+

lib/sageone_sdk.rb

@@ -0,0 +1,16 @@
+require "sageone_sdk/client"
+require "sageone_sdk/default"
+
+module SageoneSdk
+  autoload :SDataResponse, "sageone_sdk/sdata_response"
+  class << self
+    include SageoneSdk::Configurable
+
+    def client
+      @client = SageoneSdk::Client.new unless defined?(@client)
+      @client
+    end
+  end
+end
+
+SageoneSdk.setup

lib/sageone_sdk/authentication.rb

@@ -0,0 +1,7 @@
+module SageoneSdk
+  module Authentication
+    def token_authenticated?
+      !!@access_token
+    end
+  end
+end

lib/sageone_sdk/client.rb

@@ -0,0 +1,116 @@
+require "sawyer"
+require "faraday_middleware"
+require "sageone_sdk/authentication"
+require "sageone_sdk/configurable"
+require "sageone_sdk/middleware"
+require "sageone_sdk/client/account_types"
+require "sageone_sdk/client/bank_accounts"
+require "sageone_sdk/client/chart_of_accounts"
+require "sageone_sdk/client/contact_types"
+require "sageone_sdk/client/contacts"
+require "sageone_sdk/client/countries"
+require "sageone_sdk/client/expenditures"
+require "sageone_sdk/client/expense_methods"
+require "sageone_sdk/client/expense_types"
+require "sageone_sdk/client/financial_settings"
+require "sageone_sdk/client/income_methods"
+require "sageone_sdk/client/income_types"
+require "sageone_sdk/client/incomes"
+require "sageone_sdk/client/journals"
+require "sageone_sdk/client/ledger_accounts"
+require "sageone_sdk/client/payment_statuses"
+require "sageone_sdk/client/period_types"
+require "sageone_sdk/client/purchase_invoices"
+require "sageone_sdk/client/products"
+require "sageone_sdk/client/sales_invoices"
+require "sageone_sdk/client/services"
+require "sageone_sdk/client/tax_rates"
+require "sageone_sdk/client/transactions"
+
+module SageoneSdk
+  class Client
+    include SageoneSdk::Authentication
+    include SageoneSdk::Configurable
+    include SageoneSdk::Client::AccountTypes
+    include SageoneSdk::Client::BankAccounts
+    include SageoneSdk::Client::ChartOfAccounts
+    include SageoneSdk::Client::ContactTypes
+    include SageoneSdk::Client::Contacts
+    include SageoneSdk::Client::Countries
+    include SageoneSdk::Client::Expenditures
+    include SageoneSdk::Client::ExpenseMethods
+    include SageoneSdk::Client::ExpenseTypes
+    include SageoneSdk::Client::FinancialSettings
+    include SageoneSdk::Client::IncomeMethods
+    include SageoneSdk::Client::IncomeTypes
+    include SageoneSdk::Client::Incomes
+    include SageoneSdk::Client::Journals
+    include SageoneSdk::Client::LedgerAccounts
+    include SageoneSdk::Client::PaymentStatuses
+    include SageoneSdk::Client::PeriodTypes
+    include SageoneSdk::Client::PurchaseInvoices
+    include SageoneSdk::Client::Products
+    include SageoneSdk::Client::SalesInvoices
+    include SageoneSdk::Client::Services
+    include SageoneSdk::Client::TaxRates
+    include SageoneSdk::Client::Transactions
+
+    def initialize(options = {})
+      SageoneSdk::Configurable.keys.each do |key|
+        instance_variable_set(:"@#{key}", options[key] || SageoneSdk.instance_variable_get(:"@#{key}"))
+      end
+    end
+
+    def last_response
+      @last_response if defined? @last_response
+    end
+
+    def paginate(resource, options = {})
+      data = get(resource, options)
+      data
+    end
+
+    def get(path, data={})
+      request(:get, path, data)
+    end
+
+    def post(path, data={})
+      request(:post, path, data)
+    end
+
+    def put(path, data={})
+      request(:put, path, data)
+    end
+
+    def delete(path, data={})
+      request(:delete, path, data)
+    end
+
+    def request(method, path, data, options = {})
+      path = File.join("accounts", "v1", path)
+      @last_response = response = agent.public_send(method, URI::Parser.new.escape(path.to_s), data, options)
+      response.body
+    end
+
+    def agent
+      @agent ||= Faraday.new(api_endpoint, faraday_options) do |builder|
+        builder.request :url_encoded
+        builder.headers['Accept'] = default_media_type
+        builder.headers['Content-Type'] = "application/x-www-form-urlencoded"
+        builder.headers['User-Agent'] = user_agent
+        if token_authenticated?
+          builder.authorization 'Bearer', @access_token
+        end
+        builder.use SageoneSdk::Middleware::Signature, access_token, signing_secret
+        builder.use SageoneSdk::Middleware::SDataParser
+        builder.adapter Faraday.default_adapter
+      end
+    end
+
+    private
+
+    def faraday_options
+      {}
+    end
+  end
+end