saasu2 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 00d34d8d6d01b5a1ba07efb6a978829a6ca8e78f
-  data.tar.gz: 8864f8c57abb79e676cfc465e85f571e17f15c9c
+  metadata.gz: 04c42e83273f4aaa849e084a3f85fe1d9ca19774
+  data.tar.gz: d73f74df0a87b3a0b463b1067f065dd912b6435f
 SHA512:
-  metadata.gz: e9289d659a6c7f098d3b1a85c3f81483b2fa699af3adce974b377d8ee899f94fa6ff850107aaffb7a82178fb2cf0c86474204e751c4f0e41f8f5b9a3cd2648e8
-  data.tar.gz: 87af3716b0aabaa9db71677d66322bf6100f293c7507fdc7e7e010e8986bba9fe25b244442741dd546f27a9d4a3b2c5c945532f911127cfe96030f00280c0cc3
+  metadata.gz: 2d18a43735d99b4b4a5b818065d6d272079b5d35fdabfa6ad641d02d5d42a9411c5ed7001a2967c57bca36d279a3586ed582ee4f0325aa9f830493d25f79da47
+  data.tar.gz: a158fd956c0e7e482db051cd3d4cc876757045df7662050a6c604ae51da79e9a253118d7765c187a6aa4a6f6736cf504e2999a8bb9317bc04823b470d3379150

data/CHANGELOG.rdoc

@@ -0,0 +1,4 @@
+==== Version 0.1.2
+Features:
+* Add support #create, #update, #destroy methods for /Items API
+* Add support for /Search endpoint

data/README.md

@@ -24,7 +24,7 @@ require 'saasu'
 Saasu::Config.configure do |c|
   c.username = 'username@email.com'
   c.password = 'password'
-  c.file_id = 1234 # Your Saasu FileId can be found at
+  c.file_id = 1234 # Your Saasu FileId can be found at https://secure.saasu.com/a/net/webservicessettings.aspx
 end
 ```
 
@@ -41,6 +41,7 @@ You can access the following objects:
 - Saasu::Item
 - Saasu::Payment
 - Saasu::TaxCode
+- Saasu::Search
 
 Usage examples:
 
@@ -74,6 +75,14 @@ contact['GivenName'] = 'John'
 
 # get all attributes
 contact.attributes
+
+# Search. Available scopes: All, Transactions, Contacts, InventoryItems.
+query = Saasu::Search.new(keywords: 'Book', scope: 'All')
+query.perform
+
+query.contacts
+query.items
+query.invoices
 ```
 
 Note - Saasu uses .NET naming convention for fields and filters eg. GivenName, LastModifiedDate

data/lib/saasu/item.rb

@@ -1,4 +1,4 @@
 class Saasu::Item < Saasu::Base
-  allowed_methods :show, :index
+  allowed_methods :show, :index, :destroy, :update, :create
   filter_by %W(ItemType SearchMethod SearchText)
 end

data/lib/saasu/search.rb

@@ -0,0 +1,55 @@
+module Saasu
+  class Search
+    VALID_SCOPES = %W(All Transactions Contacts InventoryItems)
+    attr_accessor :scope, :keywords
+
+    def initialize(scope: nil, keywords:)
+      @scope = scope
+      @keywords = keywords
+
+      validate_scope!
+    end
+
+    def perform
+      perform_search!
+      { contacts: search_results['TotalContactsFound'], invoices: search_results['TotalTransactionsFound'], items: search_results['TotalInventoryItemsFound'] }
+    end
+
+    def contacts
+      search_results["Contacts"].map do |contact|
+        Saasu::Contact.new(contact)
+      end
+    end
+
+    def invoices
+      search_results["Transactions"].map do |contact|
+        Saasu::Invoice.new(contact)
+      end
+    end
+
+    def items
+      search_results["InventoryItems"].map do |contact|
+        Saasu::Item.new(contact)
+      end
+    end
+
+    private
+    def perform_search!
+      @search_results = Saasu::Client.request(:get, 'search', { Scope: scope, Keywords: @keywords, IncludeSearchTermHighlights: false })
+    end
+
+    def scope
+      @scope ||= 'All'
+    end
+
+    def search_results
+      @search_results ||= perform_search!
+    end
+
+    def validate_scope!
+      unless scope.in? VALID_SCOPES
+        raise "Invalid scope argument. Valid values are: #{VALID_SCOPES.join(', ')}"
+      end
+    end
+  end
+end

data/lib/saasu/version.rb

@@ -1,3 +1,3 @@
 module Saasu
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

data/lib/saasu.rb

@@ -11,6 +11,7 @@ require "saasu/account"
 require "saasu/tax_code"
 require "saasu/config"
 require "saasu/auth"
+require "saasu/search"
 
 module Saasu
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: saasu2
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Nick Sinenko
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-07-30 00:00:00.000000000 Z
+date: 2015-09-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -161,6 +161,7 @@ files:
 - ".rspec"
 - ".ruby-version"
 - ".travis.yml"
+- CHANGELOG.rdoc
 - CODE_OF_CONDUCT.md
 - Gemfile
 - LICENSE.txt
@@ -180,6 +181,7 @@ files:
 - lib/saasu/invoice_attachment.rb
 - lib/saasu/item.rb
 - lib/saasu/payment.rb
+- lib/saasu/search.rb
 - lib/saasu/tax_code.rb
 - lib/saasu/version.rb
 - saasu2.gemspec